module ballerina udp

Bibliothèque UDP Ballerine

Cette bibliothèque fournit des API pour envoyer/recevoir des messages vers/depuis un autre processus d'application (local ou distant) pour les protocoles sans connexion.

Lorsque l'adresse de l'hôte local ou l'adresse IP n'est pas fournie dans le champ localHost facultatif, l'adresse localhost est liée par défaut. Le numéro de port du port local, utilisé pour se connecter au serveur distant, est déterminé de manière aléatoire (port éphémère).

Client

Le udp:Client est utilisé pour interagir avec l'hôte UDP distant et il peut être défini comme suit :

 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 ();

ConnecterClient

Le udp:ConnectClient est configuré en fournissant le remoteHost et remotePort afin qu'il reçoive et envoie uniquement des données à l'hôte distant configuré. Une fois connectées, les données ne peuvent pas être reçues ou envoyées à d'autres hôtes. Le client reste connecté jusqu'à sa fermeture explicite. Si le nombre d'octets donné à la méthode writeBytes est supérieur à la taille des données autorisée par un datagramme, elle enverra de manière itérative tous les octets avec plusieurs datagrammes.

 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 ();

Auditeur

Le udp:Listener est utilisé pour écouter la demande de socket entrante.

Le udp:Listener peut avoir les méthodes suivantes.

onBytes(readonly & byte[] data, udp:Caller caller) ou onDatagram(readonly & udp:Datagram, udp:Caller) : Ces méthodes distantes sont invoquées une fois le contenu reçu du client. Le client est représenté à l'aide de udp:Caller .

onError(readonly & udp:Error err) : Cette méthode distante est invoquée dans une situation d'erreur.

Un udp:Listener peut être défini comme suit :

 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
    }
}

Enjeux et projets

Les onglets Problèmes et Projets sont désactivés pour ce référentiel car il fait partie de la bibliothèque standard Ballerina. Pour signaler des bogues, demander de nouvelles fonctionnalités, démarrer de nouvelles discussions, afficher les tableaux de projets, etc., veuillez visiter le référentiel parent de Ballerina Standard Library.

Ce référentiel contient uniquement le code source du package.

Construire à partir de la source

Mise en place des prérequis

1. Téléchargez et installez la version 21 du kit de développement Java SE (JDK) (à partir de l'un des emplacements suivants).

   • Oracle

   • OuvrirJDK

     Remarque : définissez la variable d'environnement JAVA_HOME sur le nom de chemin du répertoire dans lequel vous avez installé JDK.

Construire la source

Exécutez les commandes ci-dessous pour construire à partir de la source.

1. Pour créer le package :

    ./gradlew clean build
   

2. Pour exécuter les tests :

    ./gradlew clean test
   

3. Pour exécuter un groupe de tests

    ./gradlew clean test -Pgroups=<test_group_names>
   

4. Pour construire le sans les tests :

    ./gradlew clean build -x test
   

5. Pour déboguer l’implémentation du package :

    ./gradlew clean build -Pdebug=<port>
   

6. Pour déboguer avec le langage Ballerina :

    ./gradlew clean build -PbalJavaDebug=<port>
   

7. Publiez les artefacts générés dans le référentiel central Ballerina local :

    ./gradlew clean build -PpublishToLocalCentral=true
   

8. Publiez les artefacts générés dans le référentiel central Ballerina :

    ./gradlew clean build -PpublishToCentral=true
   

Contribuer à Ballerine

En tant que projet open source, Ballerina accueille les contributions de la communauté.

Pour plus d’informations, consultez les directives de contribution.

Code de conduite

Tous les contributeurs sont encouragés à lire le Code de conduite des ballerines.

Liens utiles

• Pour plus d'informations, accédez à la bibliothèque udp .
• Pour des exemples de démonstrations d'utilisation, rendez-vous sur Ballerine par exemples.
• Discutez en direct avec nous via notre serveur Discord.
• Publiez toutes les questions techniques sur Stack Overflow avec la balise #ballerina.