Comment envoyer un message texte en 5 lignes de Java

Introduction

Si vous êtes un développeur Java, vous avez peut-être entendu parler de JEP 445 : Classes sans nom et méthodes principales d'instance. Cette fonctionnalité de prévisualisation introduite dans Java 21 réduit considérablement le code de base nécessaire à l'écriture d'un simple programme "Hello, World". Bien que la plupart des développeurs professionnels aient rarement besoin d'écrire une application à méthode unique, cela peut parfois être utile pour créer des exemples minimaux reproductibles ou pour tester que votre environnement est correctement configuré. Dans cet article, je vais démontrer cette nouvelle syntaxe en vous montrant comment envoyer un message texte en seulement cinq lignes de code à l'aide de notre Messages API.

Pré-requis

• Téléchargez et installez Java 21. Vous pouvez trouver des versions d'accès anticipé avant qu'il ne soit GA. Si vous lisez ceci après septembre 2023, vous pouvez trouver des versions du JDK 21 à plusieurs endroits, par exemple, Eclipse Temurin ou Oracle.

• Ouvrez un terminal et naviguez jusqu'à / créez un répertoire de travail approprié. Par exemple, cd ~/Projects && mkdir vonage-java-demo.

• Définissez JDK 21 comme version de Java. La manière de procéder dépend de votre système d'exploitation, mais en théorie, cela ne devrait pas être plus compliqué que de mettre à jour votre variable d'environnement JAVA_HOME pour qu'elle pointe vers le JDK que vous avez téléchargé à l'étape 1. Vous pouvez vérifier quel JDK vous utilisez en tapant java --version dans votre terminal.

• S'inscrire à un compte Vonage.

• Téléchargez le SDK Java avec toutes ses dépendances et enregistrez-le dans votre répertoire de travail. Remplacez le numéro de version fourni dans le lien par la dernière version, qui peut être trouvée sur la page GitHub Releases.

Le code

Vous trouverez ci-dessous le code permettant d'envoyer un SMS. Créez un fichier Java dans votre répertoire de travail - par exemple, VonageTextDemo.java. Collez ensuite le code ci-dessous dans le fichier et enregistrez-le. Remplacez le numéro dans to par votre numéro de téléphone, apiKey par votre clé API, et apiSecret par votre secret (disponible dans le tableau de bord du développeur).

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.sms.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().sendMessage(SmsTextRequest.builder().from("Vonage Java").to("447418360119").text("Hello, World!").build());
}

Voici comment fonctionne le code.

• La ligne 1 importe les classes des paquets nécessaires à la compilation.

• La ligne 2 correspond à la nouvelle syntaxe introduite dans Java 21. Bien qu'il ait toujours été possible d'omettre une déclaration de package, jusqu'à Java 21, la méthode main devait être contenue dans une classe et devait être déclarée exactement comme public static void main(String[] args) (ou même public static void main(String… args)). Pour en savoir plus sur la nouvelle syntaxe, voir Inside Java Newscast #49.

• La ligne 3 construit le client Vonage en utilisant votre clé API et votre secret comme méthode d'authentification. Il s'agit de la méthode la plus simple pour commencer à utiliser l'API Messages, mais nous vous recommandons d'utiliser un identifiant d'application et une clé privée dans un environnement de production.

• La ligne 4 est l'endroit où le message est construit et envoyé. La méthode com.vonage.client.messages.MessagesClient#sendMessage(MessageRequest) est invoquée à l'aide d'une méthode SmsTextRequest - une sous-classe de MessageRequest. Toutes les demandes de messages suivent le modèle Builder (vous pouvez en savoir plus à ce sujet dans l'un de mes précédents articles de blog]. Cela permet une construction déclarative de la charge utile du message. Enfin, pour être complet.

• La ligne 5 est, bien entendu, l'accolade fermante de la méthode main déclarée à la ligne 2.

Si vous souhaitez envoyer un texte via WhatsApp, remplacez SmsTextRequest par WhatsappTextRequest et mettez à jour l'importation. Notez que vous devrez utiliser l'API Sandbox de Messages API Sandbox pour envoyer un message depuis WhatsApp ; sinon, vous devrez créer un WhatsApp Business Account et utiliser ce numéro. Le SDK Java fournit la méthode useSandboxEndpoint() sur MessagesClient pour plus de commodité.

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.whatsapp.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().useSandboxEndpoint().sendMessage(WhatsappTextRequest.builder().from("14157386102").to("447418360119").text("Hello, World!").build());
}

De même, vous pouvez envoyer un texte sur Viber de la manière suivante :

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.viber.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().useSandboxEndpoint().sendMessage(ViberTextRequest.builder().from("My Company").to("447418360119").text("Hello, World!").build());
}

Et voici la même chose pour Facebook Messenger - utilisez votre ID de destinataire dans to et l'ID de l'Environnement de travail des messages dans from:

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.messenger.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().useSandboxEndpoint().sendMessage(MessengerTextRequest.builder().from("107083064136738").to("6573130892744564").text("Hello, World!").build());
}

Compiler et exécuter

Dans votre répertoire de travail, tapez la commande suivante :

Bien sûr, remplacez client-7.6.0-all.jar par le nom du fichier JAR que vous avez téléchargé, de même que "VonageTextDemo" - il doit s'agir du nom que vous avez donné au fichier que vous avez créé plus tôt. Si la compilation est réussie, vous devriez voir un fichier .class généré dans votre répertoire de travail, par exemple, VonageTextDemo.class. Vous pouvez maintenant l'exécuter comme suit :

Si vous consultez maintenant votre téléphone, vous devriez avoir un message !

Vous pouvez consulter d'autres exemples dans notre référentiel d'extraits de code Java. L'API Messages prend en charge non seulement les messages texte, mais aussi les éléments multimédias tels que les fichiers, les images, l'audio, la vidéo, etc.

Signature

C'est tout pour l'instant ! Si vous rencontrez des problèmes ou si vous avez des suggestions d'amélioration, n'hésitez pas à soulever un problème sur GitHubou de nous contacter sur Twitter ou de passer par notre Communauté Slack si vous avez des commentaires ou si vous voulez simplement dire bonjour. J'espère que vous aurez une bonne expérience en utilisant les API de Vonage dans Java !