Wie man eine SMS in Scala plant

Der einfachste Weg, eine geplante SMS von Scala 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 wird eine Nachricht im JSON-Format enthalten. Das SMS-Gateway sendet diese SMS an das Telefon des Empfängers und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

wie man eine sms in scala plant
Abbildung 1 - Wie man eine SMS in Scala plant

Scala-Code zum Senden einer geplanten SMS an ein Mobiltelefon

Das folgende Scala-SMS-Codebeispiel zeigt, wie Sie eine geplante SMS mit der HTTP-Rest-SMS-API des Ozeki SMS Gateways unter Verwendung der Scala-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.

SendScheduledSms.scala
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import Ozeki.Libs.Rest.{Configuration, Message, MessageApi}
import java.time.LocalDateTime
import java.time.format.DateTimeFormatter
 
 
object main  {
  def main(args: Array[String]): Unit = {
 
    val DateFormat = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")
 
    val configuration = Configuration(
      Username = "http_user",
      Password = "qwe123",
      ApiUrl = "http://127.0.0.1:9509/api"
    )
 
    val msg = Message(
      ToAddress = "+36201111111",
      Text = "Hallo Welt!",
      TimeToSend = LocalDateTime.parse("2021-07-14 16:30:00", DateFormat)
 
    )
 
    val api = MessageApi(configuration)
 
    val result = api.Send(msg)
 
    println(result)
  }
}
     

Code 1 - SendScheduledSms.scala

Wie man das Scala-SMS-Beispiel verwendet:

Dieses Scala-SMS-Beispiel kann in jeder Scala-Anwendung verwendet werden. Um es zu verwenden, müssen Sie die Ozeki.Libs.Rest-Bibliothek herunterladen. Nachdem die Bibliothek heruntergeladen wurde, müssen Sie einen Verweis darauf in Ihrem Scala-Quellcode hinzufügen. Dies ermöglicht Ihnen die Verwendung der Klassen, die von der Ozeki.Libs.Rest-Bibliothek bereitgestellt werden. Sie können die Message-Klasse verwenden, um die SMS zu erstellen. Sie können die MessageApi-Klasse verwenden, 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.

SendScheduledSms.scala herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: SendScheduledSms.scala.zip (91.4Kb)

Was befindet sich in der SendScheduledSms.scala.zip-Datei?

In der SendScheduledSms.scala.zip finden Sie die Datei SendScheduledSms.scala, die den Beispielcode enthält, der Ihnen zeigt, wie Sie eine SMS senden können. Dieser Beispielcode ist unten aufgeführt.

Abbildung 2 - Was befindet sich in SendScheduledSms.scala.zip

Wie man SMS von Scala aus sendet (Einfache Anleitung)

Um SMS von Scala aus zu senden:

  1. Installieren Sie einen HTTP-API-Benutzer
  2. Aktivieren Sie "Log communication events" auf der Registerkarte "Advanced"
  3. Richten Sie Visual Studio ein
  4. Laden Sie die Datei SendScheduledSms.scala.zip herunter und entpacken Sie sie
  5. Öffnen Sie das SendScheduledSms.scala-Projekt mit der IntelliJ IDE
  6. Starten Sie die Ozeki SMS Gateway App
  7. Führen Sie den Scala-Code SendScheduledSms.scala aus, indem Sie ihn in der IntelliJ IDE ausführen
  8. Überprüfen Sie die Protokolle, um zu sehen, ob die SMS gesendet wurde

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

Um SMS von Scala aus senden zu können, müssen Sie zunächst Ozeki SMS Gateway installieren. Das SMS-Gateway kann auf demselben Computer installiert werden, auf dem Sie Ihren Scala-Code in einem beliebigen Texteditor wie Windows Notepad entwickeln. Nach der Installation ist der nächste Schritt, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können eine Test-SMS von der Ozeki-GUI senden, um zu überprüfen, ob Ihre Mobilfunknetzverbindung funktioniert. Der letzte Schritt zur Vorbereitung Ihrer Umgebung ist die Erstellung eines HTTP-SMS-API-Benutzerkontos. 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 Scala-Code ausführen.

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

Um SMS von Scala aus zu senden, muss Ihre Scala-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 Ozeki SMS Gateway auf demselben Computer installiert ist, auf dem die R-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.

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

HTTP-Authentifizierung zum Senden von SMS von Scala aus

Um den Scala-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 Scala können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen:

1
2
3
4
val usernamePassword = "%s:%s".format(Username, Password).getBytes()
val usernamePasswordEncoded = Base64.getEncoder.encodeToString(usernamePassword)
"Basic %s".format(usernamePasswordEncoded)
     

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

HTTP-Anforderungsheader zum Senden von SMS aus Scala

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

1
2
3
Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
     

HTTP-Anforderung zum Senden einer geplanten SMS aus Scala

Um die SMS zu übermitteln, sendet Ihre Scala-Anwendung eine HTTP-Anforderung ähnlich der untenstehenden. Beachten Sie, dass diese Anforderung einen HTTP-Header-Teil und einen HTTP-Body-Teil enthält. Der HTTP-Body ist eine JSON-kodierte Datenzeichenfolge. Sie enthält die Empfängernummer, die Textnachricht und auch den Zeitpunkt, zu dem die SMS gesendet werden soll.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
POST /api?action=sendmsg HTTP/1.1
HTTP2-Settings: AAEAAEAAAAIAAAABAAMAAABkAAQBAAAAAAUAAEAA
Connection: Upgrade, HTTP2-Settings
Upgrade: h2c
Content-Length: 320
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":"e2f650ee-90cc-43c5-885b-5ea4a0458381",
            "to_address":"+36201111111",
            "text":"Hallo Welt!",
            "create_date":"2021-07-15T10:32:42",
            "valid_until":"2021-07-22T10:32:42",
            "time_to_send":"2021-07-15T11:00:00",
            "submit_report_requested": true,
            "view_report_requested": true,
            "delivery_report_requested": true
        }
    ]
}
     

HTTP-Antwort, die vom Scala-SMS-Beispiel empfangen wird

Sobald das SMS-Gateway diese Anforderung erhält, wird es eine HTTP-Antwort generieren. Die HTTP-Antwort enthält einen Statuscode, um anzuzeigen, ob die SMS-Übermittlungsanforderung erfolgreich war oder nicht. Sie gibt auch eine JSON-kodierte Struktur zurück, die Ihnen nützliche Details über die Übermittlung der Nachricht liefert.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 15 Jul 2021 10:26:26 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked
 
{
    "http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "Nachrichten wurden für die Zustellung in die Warteschlange gestellt.",
    "data": {
      "total_count": 1,
      "success_count": 1,
      "failed_count": 0,
      "messages": [
        {
          "message_id": "e2f650ee-90cc-43c5-885b-5ea4a0458381",
          "from_station": "%",
          "to_address": "+36201111111",
          "to_station": "%",
          "text": "Hallo Welt!",
          "create_date": "2021-07-15 10:32:42",
          "valid_until": "2021-07-22 10:32:42",
          "time_to_send": "2021-07-15 11:00:00",
          "submit_report_requested": true,
          "delivery_report_requested": true,
          "view_report_requested": false,
          "tags": [
            {
              "name": "Typ",
              "value": "SMS:TEXT"
            }
          ],
          "status": "SUCCESS"
        }
      ]
    }
}
     

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

Dieses Video zeigt Ihnen, wie Sie die Datei SendScheduledSms.scala.zip von dieser Seite herunterladen. Wenn Sie das Video ansehen, werden Sie feststellen, dass die Inhalte der SendScheduledSms.scala.zip auf den Windows-Desktop platziert werden. Sie werden auch sehen, dass wir die Eingabeaufforderung verwenden, um die SMS zu senden.

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

Scala-SMS-Beispiel: SendScheduledSms.scala

Der Beispielcode unten ist Teil der SendScheduledSms.scala.

Beispielcode zum Senden einer geplanten SMS mit Scala
Abbildung 3 - SendScheduledSms.scala-Datei

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 in der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen.

Video 2 - Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde (Video-Tutorial)

Zusammenfassung

Die Hauptfunktion dieses Artikels war es, die Schritte der SMS-Planung in Scala mit Hilfe von Ozeki SMS Gateway zu erklären. Wenn alles sorgfältig gelesen wurde, sollte die SMS-Planung sehr einfach sein. Der perfekte Zeitpunkt für die Informationsübermittlung ist wichtig, wenn Sie mit hoher Leistung arbeiten möchten, da Sie auf diese Weise die geschäftigen Zeiten der Kunden vermeiden können, sodass sie Ihre Nachrichten nicht ignorieren. Ozeki SMS Gateway ermöglicht es Ihnen, die SMS-Kosten zu verwalten und den SMS-Verkehr im Auge zu behalten.

Stellen Sie sicher, dass Sie auf der Tutorial-Seite von Ozeki weiterlesen, wo Sie weitere Informationen zu Themen wie SMS-Löschen in Scala finden.

Jetzt müssen Sie nur noch Ozeki SMS Gateway herunterladen und die Arbeit kann beginnen!

More information