Wie man SMS von Java aus sendet

Der einfachste Weg, SMS von Java aus zu senden, ist die Verwendung der integrierten HTTP/Rest-SMS-API des Ozeki SMS Gateways. Wenn Sie diese API verwenden, senden Sie SMS-Nachrichten, indem Sie eine HTTP-Post-Anfrage an das SMS-Gateway stellen. Die HTTP-Post-Anfrage enthält eine Nachricht im JSON-Format. Das SMS-Gateway sendet diese SMS an die Empfängertelefonnummer und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

wie man eine SMS von Java aus sendet
Abbildung 1 - Wie man eine SMS von Java aus sendet

Java-Code zum Senden von SMS an Mobiltelefone

Das folgende Java-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API des Ozeki SMS Gateways unter Verwendung der Java Ozeki.Libs.Rest-Bibliothek senden können. Diese Bibliothek wird Ihnen kostenlos zur Verfügung gestellt, und Sie können sie in Ihren Projekten verwenden und modifizieren.

Main.java 
import Ozeki.Libs.Rest.*;

public class Main {

    public static void main(String[] args) {

        var configuration = new Configuration();
        configuration.Username = "http_user";
        configuration.Password = "qwe123";
        configuration.ApiURL = "http://127.0.0.1:9509/api";

        var msg = new Message();
        msg.ToAddress = "+36201111111";
        msg.Text = "Hello world";

        var api = new MessageApi(configuration);
        
        var result = api.Send(msg);
        
        System.out.println(result);
    }
}

Wie man das Java-SMS-Beispiel verwendet:

Sie können die Message-Klasse verwenden, um die SMS zu erstellen, und die MessageApi-Klasse, um die SMS an das SMS-Gateway zu senden. Das SMS-Gateway leitet Ihre Nachricht entweder über eine drahtlose Verbindung oder über das Internet an das Mobilfunknetz weiter.

SendSms.java herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendSms.java.zip (89,3Kb)

Was befindet sich in der SendSms.java.zip-Datei?

Die SendSms.java.zip-Datei enthält die Ozeki-Bibliothek, die Ihnen alle notwendigen Werkzeuge zum Senden und Empfangen von SMS-Nachrichten bietet. Sie finden dort auch eine Main.java-Datei im Projekt, die den Beispielcode enthält, der Ihnen zeigt, wie Sie eine SMS senden können. Dieser Beispielcode ist unten aufgeführt.

SendSms Java-Verzeichnis
Abbildung 2 - SendSms.java-Verzeichnis

Wie man SMS von Java aus sendet (Schnelle Schritte)

Um SMS von Java aus zu senden:

  1. Installieren Sie das Ozeki SMS Gateway
  2. Verbinden Sie das Ozeki SMS Gateway mit dem Mobilfunknetz
  3. Senden Sie eine Test-SMS über die Ozeki GUI
  4. Erstellen Sie einen HTTP-SMS-API-Benutzer
  5. Apache NetBeans
  6. Erstellen Sie ein Projekt namens SendSms
  7. Fügen Sie den Code in eine neu erstellte Main.java-Datei ein oder verwenden Sie die Main.java-Datei in der .zip-Datei
  8. Erstellen Sie die SMS, indem Sie ein neues Message-Objekt erstellen
  9. Erstellen Sie eine API, um Ihre Nachricht zu senden
  10. Verwenden Sie die Send-Methode, um Ihre Nachricht zu senden
  11. Lesen Sie die Antwortnachricht auf der Konsole
  12. Überprüfen Sie die Protokolle im SMS-Gateway

Installieren Sie das Ozeki SMS Gateway und erstellen Sie einen HTTP-API-Benutzer

Um SMS von Java aus senden zu können, müssen Sie zunächst das Ozeki SMS Gateway installieren. Das SMS-Gateway kann auf demselben Computer installiert werden, auf dem Sie Ihren Java-Code in Apache NetBeans entwickeln. Nach der Installation besteht der nächste Schritt darin, das Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können einen HTTP-SMS-API-Benutzer zu erstellen. Erstellen Sie einen Benutzer mit dem Benutzernamen "http_user" und dem Passwort "qwe123", damit das Beispiel ohne Änderungen funktioniert.

Nachdem die Umgebung eingerichtet ist, können Sie Ihren Java-Code ausführen.

HTTP-API-URL zum Senden von SMS von Java aus

Um SMS von Java aus zu senden, muss Ihre Java-Anwendung eine HTTP-Anfrage an das SMS-Gateway stellen. Die API-URL wird unten angezeigt. Beachten Sie, dass die IP-Adresse (127.0.0.1) durch die IP-Adresse Ihres SMS-Gateways ersetzt werden sollte. Wenn das Ozeki SMS Gateway auf demselben Computer installiert ist, auf dem die Java-SMS-Anwendung läuft, kann dies 127.0.0.1 sein. Wenn es auf einem anderen Computer installiert ist, sollte es die IP-Adresse dieses Computers sein. 

http://127.0.0.1:9509/api?action=rest

HTTP-Authentifizierung zum Senden von SMS von Java aus

Um den Java-SMS-Client zu authentifizieren, müssen Sie den Benutzernamen und das Passwort in einer base64-kodierten Zeichenkette an den Server in einer HTTP-Anfrage senden. Das verwendete Format lautet: base64(Benutzername+":"+Passwort). In Java können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen: 

var usernamePassword = username + ":" + password;
var encodedUsernamePassword = usernamePassword.getBytes();
return "Basic " + Base64.getEncoder().encodeToString(encodedUsernamePassword);

Wenn Sie beispielsweise den Benutzernamen 'http_user' und das Passwort 'qwe123' kodieren, erhalten Sie die folgende base64-kodierte Zeichenkette: aHR0cF91c2VyOnF3ZTEyMw==. Zum Senden

HTTP-Anfrageheader zum Senden von SMS von Java aus

Um die SMS-Nachrichten zu senden, müssen Sie die folgenden Zeilen als Header in die HTTP-Anfrage aufnehmen. Beachten Sie, dass wir einen Content-Type- und einen Authorization-Header einfügen. 

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

HTTP-Anfrage zum Senden von SMS aus Java

Um die SMS zu übermitteln, sendet Ihre Java-Anwendung eine HTTP-Anfrage ähnlich der untenstehenden. Beachten Sie, dass diese Anfrage einen HTTP-Header-Teil und einen HTTP-Body-Teil enthält. Der HTTP-Body ist ein JSON-kodierter Datenstring. Er enthält die Nummer des Empfängers und den Text der Nachricht. 

POST /api?action=sendmsg HTTP/1.1
HTTP2-Settings: AAEAAEAAAAIAAAABAAMAAABkAAQBAAAAAAUAAEAA
Connection: Upgrade, HTTP2-Settings
Upgrade: h2c
Content-Length: 319
Content-Type: application/json
Accept: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Java-http-client/16.0.1
  
{
	"messages":	[
		{
			"message_id":"f5035474-77d7-4be0-9ace-14bf3105940e",
			"submit_report_requested":true,
			"view_report_requested":true,
			"valid_until":"2021-06-18 13:37:47",
			"time_to_send":"2021-06-11 13:37:47",
			"to_address":"+36201111111",
			"text":"Hello world",
			"create_date":"2021-06-11 13:37:47",
			"delivery_report_requested":true
		}
	]
}

HTTP-Antwort, die vom Java-SMS-Beispiel empfangen wurde

Sobald das SMS-Gateway diese Anfrage empfängt, generiert es eine HTTP-Antwort. Die HTTP-Antwort enthält einen Statuscode, der anzeigt, ob die SMS-Übermittlungsanfrage erfolgreich war oder nicht. Sie gibt auch eine JSON-kodierte Struktur zurück, die Ihnen nützliche Details über die Übermittlung der Nachricht liefert. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 11 Jun 2021 13:37:11 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked

{
"http_code": 200,
"response_code": "SUCCESS",
"response_msg": "Messages queued for delivery.",
"data": {
  "total_count": 1,
  "success_count": 1,
  "failed_count": 0,
  "messages": [
    {
      "message_id": "f5035474-77d7-4be0-9ace-14bf3105940e",
      "from_station": "%",
      "to_address": "+36201111111",
      "to_station": "%",
      "text": "Hello world",
      "create_date": "2021-06-11 13:37:47",
      "valid_until": "2021-06-18 13:37:47",
      "time_to_send": "2021-06-11 13:37:47",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": false,
      "tags": [
        {
          "name": "Type",
          "value": "SMS:TEXT"
        }
      ],
      "status": "SUCCESS"
    }
  ]
}
}

Wie man SMS aus Java mit der Java-SMS-API sendet (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie ein neues Projekt in Apache NetBeans erstellen und es in SendSms benennen. Sobald die Lösung erstellt ist, werden Sie möglicherweise bemerken, dass es einen Ordner namens <default package> in Ihrem Projekt innerhalb des Source Packages-Ordners gibt. Hier werden Sie die Main.java-Datei erstellen oder einfügen. Dann müssen Sie den Ozeki-Ordner in den Source Packages-Ordner einfügen und das sind alle Vorbereitungen, die Sie benötigen, um eine SMS mit Java zu senden.

Video 1 - Wie man SMS aus Java mit der Java-SMS-API sendet (Video-Tutorial)

Java-SMS-Beispiel: Main.java

Abbildung 3 - SendSms-Projekt

Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde

Nachdem die SMS übermittelt wurde, ist es eine gute Idee, Ihr SMS-Gateway zu überprüfen, um zu sehen, was es empfangen hat. Sie können das Protokoll überprüfen, indem Sie die Details des HTTP-Benutzers aus der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen.

Video 2 - Wie man SMS mit dem obigen Java-Code sendet (Video-Tutorial)

Wie man überprüft, ob die SMS an das Mobilfunknetz gesendet wurde

Der letzte Schritt zur Überprüfung des Verfahrens besteht darin, die Protokolle der Mobilfunknetzverbindung zu betrachten. Möglicherweise müssen Sie die Protokollierung in der Konfiguration der Verbindung aktivieren, bevor Sie die Nachricht senden, um die Protokolle zu sehen. Wenn die Protokollierung aktiviert ist, sehen Sie die Telefonnummer und den Text der Nachricht, die Sie gesendet haben.

Video 3 - Wie man die Protokollierung im Ozeki SMS Gateway aktiviert (Video-Tutorial)

Um die Protokollierung im http_user zu aktivieren, müssen Sie die gleichen Anweisungen befolgen.

Fazit

Dieser Artikel erklärte die Grundlagen des SMS-Versands in Java mit Hilfe des Ozeki SMS Gateways. Wenn die oben genannten Schritte sorgfältig befolgt wurden, sollte die Nachrichtenübertragung in Java keine Probleme bereiten. Das Ozeki SMS Gateway bietet hohe Leistung, was bedeutet, dass es bis zu 1000 SMS pro Sekunde senden kann, und hilft somit Ihrem Unternehmen, einen hohen Standard zu halten.

Stellen Sie sicher, dass Sie die Lektüre hier nicht beenden, besuchen Sie die Tutorial-Seite von Ozeki und erfahren Sie mehr über Dinge wie das Löschen von SMS in Java.

Jetzt müssen Sie nur noch das Ozeki SMS Gateway herunterladen und loslegen!

More information