Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Služba Azure Web PubSub je služba spravovaná v Azure, která vývojářům pomáhá snadno vytvářet webové aplikace s funkcemi v reálném čase a vzorem publikování a odběru. Jakýkoli scénář, který vyžaduje zasílání zpráv publikování a odběru v reálném čase mezi servery a klienty nebo mezi klienty, může používat službu Azure Web PubSub. Tradiční funkce v reálném čase, které často vyžadují dotazování ze serveru nebo odesílání požadavků HTTP, můžou také používat službu Azure Web PubSub.
Tento článek popisuje klientskou knihovnu služby Azure Web PubSub.
Tuto knihovnu můžete v aplikaci na straně serveru použít ke správě připojení klienta WebSocket, jak je znázorněno v tomto diagramu:
Pomocí této knihovny můžete:
- Odesílání zpráv do center a skupin
- Posílejte zprávy konkrétním uživatelům a kontaktům.
- Uspořádejte uživatele a připojení do skupin.
- Zavření připojení
- Udělení, odvolání a kontrola oprávnění pro existující připojení
Další informace najdete tady:
- Java SDK pro klientskou knihovnu Azure Web PubSub
- Referenční dokumentace ke klientské knihovně Azure Web PubSub
- Ukázky klientské knihovny Azure Web PubSub pro Javu
- Dokumentace ke službě Azure Web PubSub
Začínáme
Požadavky
- Vyžaduje se účet Azure s aktivním předplatným. Pokud ho ještě nemáte, můžete si zdarma vytvořit účet.
- Sada Java Development Kit (JDK) verze 8 nebo novější.
Přidat balíček
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-messaging-webpubsub</artifactId>
<version>1.0.0</version>
</dependency>
Vytvořte WebPubSubServiceClient pomocí připojovacího řetězce
WebPubSubServiceClient webPubSubServiceClient = new WebPubSubServiceClientBuilder()
.connectionString("{connection-string}")
.hub("chat")
.buildClient();
Vytvořte WebPubSubServiceClient s přístupovým klíčem
WebPubSubServiceClient webPubSubServiceClient = new WebPubSubServiceClientBuilder()
.credential(new AzureKeyCredential("{access-key}"))
.endpoint("<Insert endpoint from Azure Portal>")
.hub("chat")
.buildClient();
Examples
- Všesměrová zpráva do celého centra
- Vysílání zprávy skupině
- Odeslání zprávy do připojení
- Odeslání zprávy uživateli
Hromadná zpráva do celého uzlu
webPubSubServiceClient.sendToAll("Hello world!", WebPubSubContentType.TEXT_PLAIN);
Vysílání zprávy skupině
webPubSubServiceClient.sendToGroup("java", "Hello Java!", WebPubSubContentType.TEXT_PLAIN);
Odeslání zprávy do připojení
webPubSubServiceClient.sendToConnection("myconnectionid", "Hello connection!", WebPubSubContentType.TEXT_PLAIN);
Odeslání zprávy uživateli
webPubSubServiceClient.sendToUser("Andy", "Hello Andy!", WebPubSubContentType.TEXT_PLAIN);
Řešení problémů
Povolit protokolování klienta
Proměnnou AZURE_LOG_LEVEL prostředí můžete nastavit tak, aby zobrazovala příkazy protokolování provedené v klientské knihovně. Například nastavení AZURE_LOG_LEVEL=2 by zobrazovalo všechny informační zprávy, upozornění a chybové zprávy protokolu. Úrovně protokolů najdete tady: úrovně protokolů.
Výchozí klient HTTP
Všechny klientské knihovny ve výchozím nastavení používají klienta Netty HTTP. Přidání výše uvedené závislosti automaticky nakonfiguruje klientskou knihovnu tak, aby používala klienta Netty HTTP. Konfigurace nebo změna klienta HTTP je popsána na wikiwebu klientů HTTP.
Výchozí knihovna SSL
Ve výchozím nastavení všechny klientské knihovny používají nativní knihovnu BORING SSL tomcat k povolení výkonu na nativní úrovni pro operace SSL. Boring SSL library je uber jar obsahující nativní knihovny pro Linux / macOS / Windows a poskytuje lepší výkon v porovnání s výchozí implementací SSL v rámci sady JDK. Další informace, včetně toho, jak zmenšit velikost závislosti, najdete v tématu [ladění výkonu][https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning].
Pomocí těchto prostředků můžete začít vytvářet vlastní aplikaci: