Pustaka ini menyediakan API untuk mengirim/menerima pesan ke/dari proses aplikasi lain (lokal atau jarak jauh) untuk protokol tanpa koneksi.
Ketika alamat host lokal atau alamat IP tidak diberikan ke kolom localHost
opsional, alamat localhost
terikat secara default. Nomor port port lokal yang digunakan untuk terhubung ke server jarak jauh ditentukan secara acak (port ephemeral).
udp:Client
digunakan untuk berinteraksi dengan host UDP jarak jauh dan dapat didefinisikan sebagai berikut:
udp : Client socketClient = check new ;
udp : Datagram datagram = {
remoteHost : " localhost " ,
remotePort : 48829 ,
data : " Hello Ballerina " . toBytes ()
};
check socketClient -> sendDatagram ( datagram );
readonly & udp : Datagram result = check socketClient -> receiveDatagram ();
check socketClient -> close ();
udp:ConnectClient
dikonfigurasi dengan menyediakan remoteHost
dan remotePort
sehingga hanya menerima data dari dan mengirimkan data ke host jarak jauh yang dikonfigurasi. Setelah terhubung, data mungkin tidak diterima atau dikirim ke host lain mana pun. Klien tetap terhubung sampai ditutup secara eksplisit. Jika jumlah byte yang diberikan ke metode writeBytes
lebih besar dari ukuran data yang diizinkan oleh datagram, metode ini akan mengirimkan semua byte dengan beberapa datagram secara berulang.
udp : ConnectClient socketClient = check new ( " localhost " , 48829 );
string msg = " Hello Ballerina " ;
check socketClient -> writeBytes ( msg . toBytes ());
readonly & byte [] result = check socketClient -> readBytes ();
check socketClient -> close ();
udp:Listener
digunakan untuk mendengarkan permintaan soket yang masuk.
udp:Listener
dapat memiliki metode berikut.
onBytes(readonly & byte[] data, udp:Caller caller)
atau onDatagram(readonly & udp:Datagram, udp:Caller)
: Metode jarak jauh ini dipanggil setelah konten diterima dari klien. Klien diwakili menggunakan udp:Caller
.
onError(readonly & udp:Error err)
: Metode jarak jauh ini dipanggil dalam situasi kesalahan.
udp:Listener
dapat didefinisikan sebagai berikut:
service on new udp:Listener( 48829 ) {
remote function onDatagram( readonly & udp : Datagram datagram )
returns udp : Datagram | udp : Error ? {
// Handle the content received from the client
}
remote function onError( udp : Error err ) {
// Handle the error situation
}
}
Tab Masalah dan Proyek dinonaktifkan untuk repositori ini karena ini adalah bagian dari Perpustakaan Standar Ballerina. Untuk melaporkan bug, meminta fitur baru, memulai diskusi baru, melihat papan proyek, dll. silakan kunjungi repositori induk Perpustakaan Standar Ballerina.
Repositori ini hanya berisi kode sumber untuk paket tersebut.
Unduh dan instal Java SE Development Kit (JDK) versi 21 (dari salah satu lokasi berikut).
Peramal
BukaJDK
Catatan: Setel variabel lingkungan JAVA_HOME ke nama jalur direktori tempat Anda menginstal JDK.
Jalankan perintah di bawah ini untuk membangun dari sumbernya.
Untuk membuat paket:
./gradlew clean build
Untuk menjalankan tes:
./gradlew clean test
Untuk menjalankan sekelompok tes
./gradlew clean test -Pgroups=<test_group_names>
Untuk membangun tanpa tes:
./gradlew clean build -x test
Untuk men-debug implementasi paket:
./gradlew clean build -Pdebug=<port>
Untuk melakukan debug dengan bahasa Ballerina:
./gradlew clean build -PbalJavaDebug=<port>
Publikasikan artefak yang dihasilkan ke repositori pusat Ballerina lokal:
./gradlew clean build -PpublishToLocalCentral=true
Publikasikan artefak yang dihasilkan ke repositori pusat Ballerina:
./gradlew clean build -PpublishToCentral=true
Sebagai proyek sumber terbuka, Ballerina menyambut baik kontribusi dari komunitas.
Untuk informasi lebih lanjut, buka pedoman kontribusi.
Semua kontributor didorong untuk membaca Kode Etik Ballerina.
udp
.