Azure Core Netty HTTP-Plug-In-Bibliothek für Java– Version 1.13.10

Artikel
11/03/2023

Der Azure Core Netty HTTP-Client ist ein Plug-In für die azure-core HTTP-Client-API.

Erste Schritte

Voraussetzungen

Java Development Kit (JDK), Version 8 oder höher.

Einschließen des Pakets

BOM-Datei einfügen

Fügen Sie azure-sdk-bom in Ihr Projekt ein, um von der Allgemeinverfügbarkeitsversion der Bibliothek abhängig zu sein. Ersetzen Sie im folgenden Codeausschnitt den Platzhalter {bom_version_to_target} durch die Versionsnummer. Weitere Informationen zur BOM finden Sie in der INFODATEI FÜR AZURE SDK-STÜCKLISTEN.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure</groupId>
            <artifactId>azure-sdk-bom</artifactId>
            <version>{bom_version_to_target}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

und fügen Sie dann die direkte Abhängigkeit ohne Versions-Tag in den Abschnitt „Abhängigkeit“ ein.

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core-http-netty</artifactId>
  </dependency>
</dependencies>

Direkte Abhängigkeiten einfügen

Wenn Sie eine Abhängigkeit von einer bestimmten Version der Bibliothek annehmen möchten, die nicht in der BoM vorhanden ist, fügen Sie die direkte Abhängigkeit wie folgt zu Ihrem Projekt hinzu.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core-http-netty</artifactId>
    <version>1.13.10</version>
</dependency>

Wichtige Begriffe

Beispiele

Die folgenden Abschnitte enthalten mehrere Codeausschnitte, die einige der gängigsten Clientkonfigurationsszenarien abdecken.

Erstellen eines einfachen Clients
Erstellen eines Clients mit Proxy
Erstellen eines Clients mit HTTP/2-Unterstützung
Erstellen eines Clients mit benutzerdefinierter max. Blockgröße

Erstellen eines einfachen Clients

Erstellen Sie einen Netty HttpClient, der Port 80 verwendet und über keinen Proxy verfügt.

HttpClient client = new NettyAsyncHttpClientBuilder().build();

Erstellen eines Clients mit Proxy

Erstellen Sie einen Netty HttpClient, der einen Proxy verwendet.

HttpClient client = new NettyAsyncHttpClientBuilder()
    .proxy(new ProxyOptions(ProxyOptions.Type.HTTP, new InetSocketAddress("<proxy-host>", 8888)))
    .build();

Erstellen eines Clients mit HTTP/2-Unterstützung

Erstellen Sie einen Netty HttpClient, der sowohl das HTTP/1.1- als auch das HTTP/2-Protokoll unterstützt, wobei HTTP/2 das bevorzugte Protokoll ist.

// Constructs an HttpClient that supports both HTTP/1.1 and HTTP/2 with HTTP/2 being the preferred protocol.
HttpClient client = new NettyAsyncHttpClientBuilder(reactor.netty.http.client.HttpClient.create()
    .protocol(HttpProtocol.HTTP11, HttpProtocol.H2))
    .build();

Es ist auch möglich, einen Netty HttpClient zu erstellen, der nur HTTP/2 unterstützt.

// Constructs an HttpClient that only supports HTTP/2.
HttpClient client = new NettyAsyncHttpClientBuilder(reactor.netty.http.client.HttpClient.create()
    .protocol(HttpProtocol.H2))
    .build();

Erstellen eines Clients mit benutzerdefinierter max. Blockgröße

Erstellen Sie einen Netty HttpClient, der eine benutzerdefinierte maximale Blockgröße verwendet.

// Constructs an HttpClient with a modified max chunk size.
// Max chunk size modifies the maximum size of ByteBufs returned by Netty (later converted to ByteBuffer).
// Changing the chunk size can positively impact performance of APIs such as Storage's download to file methods
// provided in azure-storage-blob, azure-storage-file-datalake, and azure-storage-file-shares (32KB - 64KB have
// shown the most consistent improvement).
HttpClient httpClient = new NettyAsyncHttpClientBuilder(reactor.netty.http.client.HttpClient.create()
    .httpResponseDecoder(httpResponseDecoderSpec -> httpResponseDecoderSpec.maxChunkSize(64 * 1024)))
    .build();

Nächste Schritte

Erste Schritte mit Azure-Bibliotheken, die mit Azure Core erstellt werden.

Problembehandlung

Wenn Fehler auftreten, melden Sie Probleme über GitHub Issues oder checken Sie StackOverflow für das Azure Java SDK aus.

Aktivieren der Protokollierung

Azure SDKs für Java bieten einen konsistenten Protokollierungsverlauf, um die Problembehandlung von Anwendungsfehlern zu unterstützen und deren Lösung zu beschleunigen. Die erstellten Protokolle erfassen den Flow einer Anwendung, bevor sie den Endzustand erreichen. Dies trägt zur Ermittlung der Grundursache bei. Informationen zum Aktivieren der Protokollierung finden Sie im Protokollierungswiki.

Mitwirken

Ausführliche Informationen zum Mitwirken an diesem Repository finden Sie im Leitfaden zum Mitwirken.

Verzweigen sie
Erstellen Ihrer Featurebranch (git checkout -b my-new-feature)
Committen Ihrer Änderungen (git commit -am 'Add some feature')
Pushen in den Branch (git push origin my-new-feature)
Erstellen eines neuen Pull Requests

Aufrufe

Freigeben über