Azure Web PubSub szolgáltatás ügyféloldali kódtára Java-hoz

Az Azure Web PubSub szolgáltatás egy Azure által felügyelt szolgáltatás, amellyel a fejlesztők egyszerűen készíthetnek webalkalmazásokat valós idejű funkciókkal és közzétételi feliratkozási mintával. Az Azure Web PubSub szolgáltatást minden olyan forgatókönyv használhatja, amely valós idejű közzétételi-előfizetési üzenetküldést igényel a kiszolgáló és az ügyfelek között, vagy az ügyfelek között. Az Azure Web PubSub szolgáltatást is használhatják a hagyományos valós idejű funkciók, amelyek gyakran igényelnek lekérdezést a kiszolgálóról vagy HTTP-kérések elküldéséhez.

Ez a cikk az Azure Web PubSub szolgáltatás ügyfélkódtárát ismerteti.

Ezt a tárat a kiszolgálóoldali alkalmazásban használhatja a WebSocket-ügyfélkapcsolatok kezeléséhez, ahogyan az alábbi ábrán látható:

Használja ezt a tárat a következőre:

• Üzenetek küldése központoknak és csoportoknak.
• Üzenetek küldése adott felhasználóknak és kapcsolatoknak.
• Felhasználók és kapcsolatok csoportosítása csoportokba.
• Kapcsolatok bezárása
• Meglévő kapcsolat engedélyeinek megadása, visszavonása és ellenőrzése

További információkért lásd:

• Azure Web PubSub ügyfélkönyvtár Java SDK
• Az Azure Web PubSub ügyféloldali kódtár referenciadokumentációja
• Azure Web PubSub ügyfélkódtár-minták Java-hoz
• Az Azure Web PubSub szolgáltatás dokumentációja

Kezdő lépések

Előfeltételek

• Aktív előfizetéssel rendelkező Azure-fiókra van szükség. Ha még nem rendelkezik ilyen fiókkal, ingyenesen létrehozhat egy fiókot.
• A Java Development Kit (JDK) 8-es vagy újabb verziója.

A csomag belefoglalása

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-messaging-webpubsub</artifactId>
    <version>1.0.0</version>
</dependency>

Hozzon létre egy WebPubSubServiceClient egy kapcsolati sztring használatával

WebPubSubServiceClient webPubSubServiceClient = new WebPubSubServiceClientBuilder()
    .connectionString("{connection-string}")
    .hub("chat")
    .buildClient();

Hozz létre egy WebPubSubServiceClient hozzáférési kulcsot.

WebPubSubServiceClient webPubSubServiceClient = new WebPubSubServiceClientBuilder()
    .credential(new AzureKeyCredential("{access-key}"))
    .endpoint("<Insert endpoint from Azure portal>")
    .hub("chat")
    .buildClient();

Példák

• Üzenet közvetítése a teljes központba
• Üzenet közvetítése csoportnak
• Üzenet küldése egy kapcsolatnak
• Üzenet küldése felhasználónak

Üzenet közvetítése a teljes központba

webPubSubServiceClient.sendToAll("Hello world!", WebPubSubContentType.TEXT_PLAIN);

Üzenet közvetítése csoportnak

webPubSubServiceClient.sendToGroup("java", "Hello Java!", WebPubSubContentType.TEXT_PLAIN);

Üzenet küldése egy kapcsolatnak

webPubSubServiceClient.sendToConnection("myconnectionid", "Hello connection!", WebPubSubContentType.TEXT_PLAIN);

Üzenet küldése felhasználónak

webPubSubServiceClient.sendToUser("Andy", "Hello Andy!", WebPubSubContentType.TEXT_PLAIN);

Hibaelhárítás

Ügyfélnaplózás engedélyezése

Beállíthatja a környezeti változót az AZURE_LOG_LEVEL ügyfélkódtárban tett naplózási utasítások megtekintésére. A beállítás AZURE_LOG_LEVEL=2 például az összes tájékoztató, figyelmeztető és hibaüzenetet megjeleníti. A naplószintek itt találhatók: naplószintek.

Alapértelmezett HTTP-ügyfél

Minden ügyfélkódtár alapértelmezés szerint a Netty HTTP-ügyfelet használja. A fenti függőség hozzáadása automatikusan konfigurálja az ügyfélkódtárat a Netty HTTP-ügyfél használatára. A HTTP-ügyfél konfigurálását vagy módosítását a HTTP-ügyfelek wikije ismerteti.

Alapértelmezett SSL-kódtár

Alapértelmezés szerint az összes ügyfélkódtár a Tomcat-natív unalmas SSL-kódtárat használja az SSL-műveletek natív szintű teljesítményének engedélyezéséhez. Az Unalmas SSL-kódtár egy uber jar, amely natív kódtárakat tartalmaz Linux/ macOS / Windows rendszerhez, és jobb teljesítményt nyújt a JDK alapértelmezett SSL-implementációjához képest. További információ, beleértve a függőség méretének csökkentését, lásd: [teljesítmény-finomhangolás][https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning].

Használja ezeket az erőforrásokat a saját alkalmazás létrehozásához: