Kako izbrisati SMS u Kotlinu

Najjednostavniji način za slanje SMS-a iz Kotlina je korištenje ugrađenog HTTP/Rest SMS API-ja Ozeki SMS Gatewaya. Kada koristite ovaj API, slat ćete SMS poruke slanjem HTTP Post zahtjeva SMS gatewayu. HTTP Post zahtjev će sadržavati poruku formatiranu u json formatu. SMS gateway će poslati ovaj SMS primatelju, a vratit će HTTP 200 OK odgovor na vaš zahtjev. (Slika 1)

kako izbrisati sms u kotlinu
Slika 1 - Kako izbrisati SMS u Kotlinu

Kotlin kod za brisanje SMS-a

Kotlin SMS primjer koda u nastavku pokazuje kako možete izbrisati SMS poruku(e) koristeći http rest sms api Ozeki SMS Gatewaya s Kotlin Ozeki.Libs.Rest bibliotekom. Ova biblioteka vam je dostupna besplatno, a možete je koristiti i mijenjati u bilo kojem od vaših projekata.

Video 1 - Kako preuzeti DeleteSms.kt.zip primjer (Video tutorial)

MainActivity.kt 
package delete.sms

import Ozeki.Libs.Rest.Configuration
import Ozeki.Libs.Rest.Folder
import Ozeki.Libs.Rest.MessageApi
import Ozeki.Libs.Rest.Message
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.text.method.ScrollingMovementMethod
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val folderCategories:android.widget.Spinner = findViewById(R.id.folderCategories)
        val ID:android.widget.EditText = findViewById(R.id.inputId)
        val btnSendRequest:android.widget.Button = findViewById(R.id.btnSendRequest)
        val logBox:android.widget.TextView = findViewById(R.id.logBox)
        logBox.movementMethod = ScrollingMovementMethod()

        val configuration = Configuration(
            username = "http_user",
            password = "qwe123",
            apiurl = "http://10.0.2.2:9509/api"
        )

        val api = MessageApi(configuration)

        btnSendRequest.setOnClickListener {
            if (ID.text.toString() != "") {

                val msg = Message()
                msg.ID = ID.text.toString()

                val folder: Folder

                when (folderCategories.selectedItem.toString()) {
                    "Outbox" -> folder = Folder.Outbox;
                    "Sent" -> folder = Folder.Sent;
                    "Not sent" -> folder = Folder.NotSent;
                    "Deleted" -> folder = Folder.Deleted;
                    else -> folder = Folder.Inbox
                }
                GlobalScope.launch(Dispatchers.IO) {
                    val response = api.Delete(folder, msg)
                    logBox.text = String.format("%s\n%s", logBox.text, response.toString())
                }
                ID.text.clear()
            }
        }
    }
}
main_activity.xml 
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/textId"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="36dp"
        android:text="ID:"
        android:textSize="20dp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.494"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <EditText
        android:id="@+id/inputId"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="40dp"
        android:ems="10"
        android:hint="4c24263b-dacc-48d1-b179-b7e64f08eb26"
        android:inputType="textPersonName"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.494"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textId" />

    <Spinner
        android:id="@+id/folderCategories"
        android:layout_width="320dp"
        android:layout_height="50dp"
        android:layout_marginTop="40dp"
        android:entries="@array/folders"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.494"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/inputId" />

    <Button
        android:id="@+id/btnSendRequest"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:text="Izbriši"
        app:layout_constraintEnd_toEndOf="parent"
        android:backgroundTint="#FF3F3F"
        app:layout_constraintHorizontal_bias="0.505"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/logBox" />

    <TextView
        android:id="@+id/logBox"
        android:layout_width="320dp"
        android:layout_height="250dp"
        android:layout_marginTop="40dp"
        android:scrollbars="vertical"
        android:text="Dnevnici:"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/folderCategories" />
</androidx.constraintlayout.widget.ConstraintLayout>

Kako koristiti Kotlin SMS primjer:

Možete koristiti klasu MessageApi za brisanje SMS poruka(e) iz SMS gatewaya. Vaš zahtjev bit će proslijeđen SMS Gatewayu s vašeg uređaja putem interneta.

Preuzmi DeleteSms.kt

Izvorni kod objašnjen u ovom članku može se besplatno preuzeti, koristiti i mijenjati.
Preuzmi: DeleteSms.kt.zip (149Kb)

Što se nalazi u datoteci DeleteSms.kt.zip?

Datoteka DeleteSms.kt.zip sadrži primjerni projekt, koji uključuje Ozeki.Libs.Rest biblioteku. S ovom bibliotekom možete slati, brisati, označavati i primati SMS poruke stvaranjem MessageApi i korištenjem metoda Send(), Delete(), Mark() i Receive(). (Slika 2)

primjerni projekt za brisanje SMS-a koristeći Kotlin
Slika 2 - Direktorij DeleteSms.kt

Kako izbrisati SMS s Kotlinom (Brzi koraci)

Za brisanje SMS-a s Kotlinom:

  1. Instalirajte Ozeki SMS Gateway
  2. Povežite Ozeki SMS Gateway s mobilnom mrežom
  3. Pošaljite testni SMS iz Ozeki GUI-a
  4. Kreirajte HTTP SMS API korisnika
  5. Android Studio
  6. Preuzmite gore navedeni primjerni projekt
  7. Kreirajte SMS stvaranjem novog Message objekta
  8. Kreirajte API za brisanje SMS poruke
  9. Koristite metodu Delete za brisanje vaše poruke
  10. Pročitajte odgovor na konzoli
  11. Provjerite zapisnike u SMS gatewayu

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli brisati SMS s Kotlinom, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj Kotlin kod u Android Studiju. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya s mobilnom mrežom. Možete poslati testni SMS iz Ozeki GUI-a kako biste potvrdili da vaša mobilna mrežna veza radi. Konačni korak za pripremu vašeg okruženja je kreiranje HTTP SMS API korisničkog računa. Kreirajte korisnika s korisničkim imenom "http_user" i lozinkom "qwe123" kako bi primjer radio bez izmjena.

Nakon što je okruženje postavljeno, možete pokrenuti svoj Kotlin kod.

HTTP API URL za slanje SMS-a iz Kotlina

Da biste izbrisali SMS s Kotlinom, vaš Kotlin će morati poslati HTTP zahtjev SMS gatewayu. API URL je prikazan u nastavku. Imajte na umu da IP adresa (127.0.0.1) treba biti zamijenjena IP adresom vašeg SMS gatewaya. Ako je Ozeki SMS Gateway instaliran na istom računalu gdje se pokreće JavaScript SMS aplikacija, ovo može biti 127.0.0.1. Ako je instaliran na drugom računalu, treba biti IP adresa tog računala. 

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

HTTP autentifikacija za brisanje SMS-a s Kotlinom

Da biste autentificirali Kotlin SMS klijent, morate poslati korisničko ime i lozinku u base64 kodiranom stringu na poslužitelj u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U Kotlinu možete koristiti sljedeći kod za ovo kodiranje: 

var usernamePassword = "%s:%s".format(username, password)
return "Basic %s".format(Base64.getEncoder().encodeToString(usernamePassword.toByteArray()))

Na primjer, ako kodirate korisničko ime 'http_user' i lozinku 'qwe123', dobit ćete sljedeći base64 kodirani string: aHR0cF91c2VyOnF3ZTEyMw==. Za slanje

HTTP zaglavlje zahtjeva za brisanje SMS-a iz Kotlina

Da biste izbrisali SMS poruku(e), morate uključiti sljedeće retke kao zaglavlja u HTTP zahtjevu. Imajte na umu da uključujemo content type i Authorization zaglavlje. 

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

HTTP zahtjev za primanje SMS-a s Kotlinom

Da biste izbrisali SMS, vaša Kotlin aplikacija će poslati HTTP zahtjev sličan onome u nastavku. Imajte na umu da ovaj zahtjev sadrži dio HTTP zaglavlja i dio HTTP tijela. HTTP tijelo je JSON kodirani podatkovni string. Sadrži ID-ove poruka koje želite izbrisati. 

POST /api?action=deletemsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 73
Content-Type: application/json; charset=utf-8
Accept-Encoding: gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 10.0.2.2:9509
User-Agent: okhttp/4.2.2

{
	"folder":	"inbox",
	"message_ids":	[
		"f07b71e9-6c4c-8ff1-88a5-3aa9fec74966"
	]
}

HTTP odgovor primljen od Kotlin SMS primjera

Nakon što SMS gateway primi ovaj zahtjev, generirat će HTTP odgovor. HTTP odgovor će sadržavati statusni kod, kako bi naznačio je li zahtjev za slanje SMS-a bio uspješan ili ne. Također će vratiti JSON kodiranu strukturu kako bi vam pružila korisne pojedinosti o slanju poruke. 

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

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "f07b71e9-6c4c-8ff1-88a5-3aa9fec74966"
	  ]
	}
}

Kako izbrisati SMS poruke s Kotlinom koristeći SMS API i gornji primjer projekta (Video tutorial)

Ovaj video pokazuje kako preuzeti i koristiti projekt DeleteSms.kt. Nakon što otvorite primjer projekta, možete primijetiti da postoji paket pod nazivom Ozeki.Libs.Rest. To je paket koji sadrži MessageApi i sve što vam je potrebno za brisanje SMS poruka koristeći Kotlin.

Video 2 - Kako izbrisati SMS s gornjim Kotlin kodom (Video tutorial)

Kako provjeriti je li zahtjev prihvaćen od strane HTTP korisnika

Nakon što je SMS poslan, dobro je provjeriti vaš SMS gateway kako biste vidjeli što je primio. Možete provjeriti log otvaranjem detalja HTTP korisnika iz Ozeki SMS Gateway upravljačke konzole. Na kraju gornjeg videa možete vidjeti kako provjeriti je li zahtjev primljen od strane http_user. (Slika 3)

kotlin projekt za primanje sms poruka
Slika 3 - DeleteSms.kt projekt u Android Studiju

Korištenje aplikacije na telefonu

Na slici 4 možete vidjeti kako izgleda brisanje SMS poruke kada koristite aplikaciju na telefonu. Zalijepite ID poruke u tekstualno polje 'ID' i pritisnite gumb 'Izbriši'. To će izbrisati odabranu poruku. Ako je proces uspješno obavljen, vidjet ćete poruku 'true' u odjeljku 'Logs'.

primjer kotlin aplikacije za primanje sms poruka
Slika 4 - Primjer aplikacije DeleteSms prije i nakon preuzimanja poruka

Kako dodati Ozeki.Libs.Rest u vlastiti projekt

Ozeki.Libs.Rest knjižnicu možete besplatno preuzeti, koristiti i mijenjati.
Preuzimanje: Ozeki.Libs.Rest.kt.zip (7.66Kb)

Ako odlučite izraditi svoju aplikaciju samostalno samo s Ozeki.Libs.Rest knjižnicom, postoji nekoliko stvari koje trebate promijeniti u osnovnoj aplikaciji. Da biste koristili Ozeki.Libs.Rest knjižnicu, morate je staviti u java mapu glavnog direktorija.
U sljedećem videu pokazat ću vam kako preuzeti i dodati Ozeki.Libs.Rest knjižnicu u vlastiti projekt.

Video 3 - Kako dodati Ozeki.Libs.Rest knjižnicu u vlastitu aplikaciju (Video tutorial)

Ovisnosti

Važno je napomenuti da Ozeki.Libs.Rest knjižnica ima neke ovisnosti. Da biste je koristili, morate dodati te ovisnosti u Gradle Scripts. 

implementation "com.squareup.okhttp3:okhttp:4.2.2"
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.5.0'
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.0'

Kod 1 - Popis ovisnosti koje trebate uključiti.

Kako dodati potrebne ovisnosti (Video tutorial)

U ovom videu prikazujemo vam proces dodavanja ovisnosti u vaš projekt. Video će započeti kopiranjem koda s ove stranice tutoriala i završiti s ovisnostima u projektu. Ove ovisnosti su ključni dijelovi projekta. Bez njih, Ozeki.Libs.Rest neće raditi. Ovaj video traje samo 53 sekunde, ali je lako razumjeti i pratiti.

Video 4 - Kako dodati potrebne ovisnosti (Video tutorial)

Pristup internetu

Kako bi vaša aplikacija mogla poslati HTTP zahtjev, morate omogućiti aplikaciji pristup internetu.
U sljedećem videu pokazat ću vam kako omogućiti pristup internetu za vašu Kotlin aplikaciju. 

<uses-permission android:name="android.permission.INTERNET" />

Kod 2 - Omogućavanje pristupa internetu za vašu Kotlin aplikaciju.

android:usesCleartextTraffic="true"

Kod 3 - Omogućavanje slanja HTTP zahtjeva

Kako dodati internetsku vezu u svoj projekt (Video tutorial)

Morate dodati obje ove linije u datoteku AndroidManifest.xml.
U sljedećem videu pokazat ću vam gdje trebate unijeti gornje kodove. Video će započeti kopiranjem koda i odvesti vas do uspješno dodane internetske veze. Ovaj video je precizan i lako ga je pratiti.

Video 5 - Kako omogućiti pristup internetu za vašu aplikaciju (Video tutorial)

Završne misli

Ovaj članak vam pokazuje kako koristiti dani Kotlin kod za brisanje SMS poruka s HTTP korisnikom Ozeki SMS Gatewaya. Ako se svakodnevno morate nositi s mnogo SMS poruka, a neke od njih su neželjene, ovdje prikazani postupak bitan je za vas. Često čišćena, a time i uravnotežena pohrana vrlo je važna u svim područjima, jer omogućuje dinamičniji i učinkovitiji rad.

Nastavite ovaj poučan put na web stranici Ozeki, odaberite jedan od mnogih drugih članaka. Pročitajmo članak pod naslovom Github: Kotlin SMS API, koji govori o jednom od repozitorija koje možete slobodno koristiti.

Preuzmite Ozeki SMS Gateway sada i iskoristite ono što ste naučili!

More information