このライブラリは、コネクションレス型プロトコルの別のアプリケーション プロセス (ローカルまたはリモート) との間でメッセージを送受信するための API を提供します。
ローカル ホスト アドレスまたは IP アドレスがオプションのlocalHost
フィールドに指定されていない場合、デフォルトでlocalhost
アドレスがバインドされます。リモート サーバーへの接続に使用されるローカル ポートのポート番号はランダムに決定されます (エフェメラル ポート)。
udp:Client
リモート UDP ホストと対話するために使用され、次のように定義できます。
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
、 remoteHost
とremotePort
提供することによって構成され、構成されたリモート ホストとの間でデータの送受信のみを行うようになります。接続すると、他のホストとの間でデータを送受信することはできません。クライアントは、明示的に閉じられるまで接続されたままになります。 writeBytes
メソッドに指定されたバイト数がデータグラムで許可されるデータ サイズより大きい場合、複数のデータグラムですべてのバイトが繰り返し送信されます。
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
、受信ソケット要求をリッスンするために使用されます。
udp:Listener
次のメソッドを含めることができます。
onBytes(readonly & byte[] data, udp:Caller caller)
またはonDatagram(readonly & udp:Datagram, udp:Caller)
: これらのリモート メソッドは、コンテンツがクライアントから受信されると呼び出されます。クライアントはudp:Caller
使用して表されます。
onError(readonly & udp:Error err)
: このリモート メソッドはエラー状況で呼び出されます。
udp:Listener
次のように定義できます。
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
}
}
このリポジトリは Ballerina 標準ライブラリの一部であるため、[問題] タブと [プロジェクト] タブは無効になっています。バグの報告、新機能のリクエスト、新しいディスカッションの開始、プロジェクトボードの表示などを行うには、Ballerina Standard Library の親リポジトリにアクセスしてください。
このリポジトリには、パッケージのソース コードのみが含まれます。
Java SE Development Kit (JDK) バージョン 21 を (次のいずれかの場所から) ダウンロードしてインストールします。
オラクル
OpenJDK
注: JAVA_HOME 環境変数を、JDK をインストールしたディレクトリのパス名に設定します。
以下のコマンドを実行してソースからビルドします。
パッケージをビルドするには:
./gradlew clean build
テストを実行するには:
./gradlew clean test
テストのグループを実行するには
./gradlew clean test -Pgroups=<test_group_names>
テストを行わずに をビルドするには:
./gradlew clean build -x test
パッケージ実装をデバッグするには:
./gradlew clean build -Pdebug=<port>
Ballerina 言語でデバッグするには:
./gradlew clean build -PbalJavaDebug=<port>
生成されたアーティファクトをローカルの Ballerina 中央リポジトリに公開します。
./gradlew clean build -PpublishToLocalCentral=true
生成されたアーティファクトを Ballerina 中央リポジトリに公開します。
./gradlew clean build -PpublishToCentral=true
オープンソース プロジェクトとして、Ballerina はコミュニティからの貢献を歓迎します。
詳細については、投稿ガイドラインを参照してください。
すべての寄稿者はバレリーナ行動規範を読むことが推奨されます。
udp
ライブラリを参照してください。