Wie man eine Textnachricht in 5 Zeilen Java sendet

Einführung

Wenn Sie ein Java-Entwickler sind, haben Sie vielleicht schon von folgenden Themen gehört JEP 445: Unbenannte Klassen und Instanz-Hauptmethoden. Diese in Java 21 eingeführte Vorschaufunktion reduziert den für das Schreiben eines einfachen "Hello, World!"-Programms erforderlichen Boilerplate-Code erheblich. Obwohl die meisten professionellen Entwickler nur selten eine Ein-Methoden-Anwendung schreiben müssen, kann dies manchmal nützlich sein, um reproduzierbare Minimalbeispiele zu erstellen oder um zu testen, ob Ihre Umgebung korrekt eingerichtet ist. In diesem Artikel werde ich diese neue Syntax demonstrieren, indem ich Ihnen zeige, wie Sie eine Textnachricht in nur fünf Codezeilen unter Verwendung unserer Messages API.

Voraussetzungen

• Laden Sie Java 21 herunter und installieren Sie es. Sie finden Early-Access-Builds finden, bevor es GA wird. Wenn Sie dies nach September 2023 lesen, können Sie Builds von JDK 21 an verschiedenen Stellen finden, zum Beispiel bei, Eclipse Temurin oder Oracle.

• Öffnen Sie ein Terminal und navigieren Sie zu / erstellen Sie ein geeignetes Arbeitsverzeichnis. Zum Beispiel, cd ~/Projects && mkdir vonage-java-demo.

• Stellen Sie JDK 21 als Ihre Java-Version ein. Wie Sie dies tun, hängt von Ihrem Betriebssystem ab, aber es sollte theoretisch nicht komplizierter sein als die Aktualisierung Ihrer JAVA_HOME Umgebungsvariable zu aktualisieren, damit sie auf das in Schritt 1 heruntergeladene JDK verweist. Sie können überprüfen, welches JDK Sie verwenden, indem Sie java --version in Ihr Terminal eingeben.

• Anmeldung für einen Vonage Account.

• Laden Sie das Java SDK mit allen seinen Abhängigkeiten herunter und speichern Sie es in Ihrem Arbeitsverzeichnis. Ersetzen Sie die im Link angegebene Versionsnummer durch die neueste Version, die Sie auf der Seite GitHub Releases.

Der Kodex

Nachfolgend finden Sie den Code zum Senden einer SMS. Erstellen Sie eine Java-Datei in Ihrem Arbeitsverzeichnis - z.B., VonageTextDemo.java. Fügen Sie dann den unten stehenden Code in die Datei ein und speichern Sie sie. Ersetzen Sie die Nummer in to durch Ihre Telefonnummer, apiKey durch Ihren API-Schlüssel und apiSecret durch Ihr Geheimnis (verfügbar im dem Entwickler-Dashboard).

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());
}

Der Code funktioniert folgendermaßen.

• Zeile 1 importiert die Klassen aus den für die Kompilierung erforderlichen Paketen.

• Zeile 2 ist die neue Syntax, die in Java 21 eingeführt wurde. Obwohl das Weglassen einer Paketdeklaration schon immer möglich war, musste bis Java 21 die main-Methode innerhalb einer Klasse enthalten sein und genau als public static void main(String[] args) (oder sogar public static void main(String… args)). Mehr über die neue Syntax erfahren Sie in Inside Java Rundschau #49.

• In Zeile 3 wird der Vonage-Client mit Ihrem API-Schlüssel und Geheimnis als Authentifizierungsmethode erstellt. Dies ist der einfachste Weg, um mit der Messages API zu beginnen, aber wir empfehlen, dass Sie eine Anwendungs-ID und einen privaten Schlüssel in einer Produktionsumgebung verwenden.

• In Zeile 4 wird die Nachricht sowohl erstellt als auch gesendet. Die Methode com.vonage.client.messages.MessagesClient#sendMessage(MessageRequest) Methode wird aufgerufen mit einer SmsTextRequest - einer Unterklasse von MessageRequest. Alle Nachrichtenanforderungen folgen dem Builder-Muster (Sie können mehr darüber lesen in einem meiner früheren Blogbeiträge]. Dies ermöglicht eine deklarative Konstruktion der Nutzlast der Nachricht. Schließlich, der Vollständigkeit halber.

• Zeile 5 ist natürlich die schließende Klammer für die in Zeile 2 deklarierte main-Methode.

Wenn Sie einen Text über WhatsApp senden möchten, ersetzen Sie SmsTextRequest durch WhatsappTextRequest und aktualisieren Sie den Import. Beachten Sie, dass Sie die Messages API Sandbox verwenden müssen, um eine Nachricht über WhatsApp zu senden; andernfalls müssen Sie einen WhatsApp Business Account einrichten und diese Nummer verwenden. Das Java SDK bietet die useSandboxEndpoint() Methode auf MessagesClient für die Bequemlichkeit.

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());
}

Genauso können Sie einen Text über Viber wie folgt senden:

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());
}

Und hier das Gleiche für Facebook Messenger - verwenden Sie Ihre Empfänger-ID in to und die Sandbox-ID der Nachricht in 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());
}

Kompilieren & Ausführen

Geben Sie in Ihrem Arbeitsverzeichnis den folgenden Befehl ein:

Natürlich, ersetzen Sie client-7.6.0-all.jar mit dem Namen der JAR-Datei, die Sie heruntergeladen haben, ebenso mit "VonageTextDemo" - dies sollte der Name sein, den Sie der Datei gegeben haben, die Sie zuvor erstellt haben. Wenn die Kompilierung erfolgreich war, sollten Sie eine .class Datei in Ihrem Arbeitsverzeichnis erzeugt werden, z.B., VonageTextDemo.class. Nun können Sie sie wie folgt ausführen:

Wenn du jetzt auf dein Handy schaust, solltest du eine SMS bekommen!

Weitere Beispiele finden Sie in unserem Java-Code-Snippets-Repository. Die Messages API unterstützt nicht nur Textnachrichten, sondern auch Multimedia wie Dateien, Bilder, Audio, Video und mehr.

Abmeldung

Das war's für den Moment! Wenn Sie auf irgendwelche Probleme stoßen oder Verbesserungsvorschläge haben, können Sie gerne einen Fehler auf GitHub zu meldenoder erreichen Sie uns auf Twitter oder schauen Sie bei unserem Gemeinschaft Slack wenn Sie Feedback haben oder einfach nur Hallo sagen wollen. Ich wünsche Ihnen viel Spaß mit den Vonage APIs in Java!