Freigeben über


Azure Core OkHttp HTTP-Plug-In-Bibliothek für Java – Version 1.11.16

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

Erste Schritte

Voraussetzungen

Einschließen des Pakets

BOM-Datei einfügen

Fügen Sie das azure-sdk-bom in Ihr Projekt ein, um die Abhängigkeit von der General Availability (GA)-Version der Bibliothek zu übernehmen. Ersetzen Sie im folgenden Codeausschnitt den Platzhalter {bom_version_to_target} durch die Versionsnummer. Weitere Informationen zur Stückliste finden Sie in der AZURE SDK-BOM-INFODATEI.

<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-okhttp</artifactId>
  </dependency>
</dependencies>

Direkte Abhängigkeiten einfügen

Wenn Sie abhängigkeiten von einer bestimmten Version der Bibliothek übernehmen möchten, die in der Stückliste nicht vorhanden ist, fügen Sie die direkte Abhängigkeit wie folgt zu Ihrem Projekt hinzu.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core-http-okhttp</artifactId>
    <version>1.11.16</version>
</dependency>

Wichtige Begriffe

Beispiele

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

Erstellen eines einfachen Clients

Erstellen Sie einen OkHttp-Client mit einem Verbindungstimeout von 60 Sekunden und einem Lesetimeout von 120 Sekunden.

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

Erstellen eines Clients mit Proxy

Erstellen Sie einen OkHttp-Client, der einen Proxy verwendet.

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

Erstellen eines Clients mit HTTP/2-Unterstützung

Erstellen Sie einen OkHttp-Client, der sowohl die Protokolle HTTP/1.1 als auch HTTP/2 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.
// This is the default handling for OkHttp.
HttpClient client = new OkHttpAsyncHttpClientBuilder(new OkHttpClient.Builder()
    .protocols(Arrays.asList(Protocol.HTTP_2, Protocol.HTTP_1_1))
    .build())
    .build();

Es ist auch möglich, einen OkHttp-Client zu erstellen, der nur HTTP/2 unterstützt.

// Constructs an HttpClient that only supports HTTP/2.
HttpClient client = new OkHttpAsyncHttpClientBuilder(new OkHttpClient.Builder()
    .protocols(Collections.singletonList(Protocol.H2_PRIOR_KNOWLEDGE))
    .build())
    .build();

Nächste Schritte

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

Problembehandlung

Wenn Fehler auftreten, senden 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 eine konsistente Protokollierung, die bei der Behandlung von Anwendungsfehlern und deren Lösung hilft. 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 zu diesem Repository finden Sie im Leitfaden zur Mitarbeit.

  1. Fork
  2. Erstellen Ihres Featurebranch (git checkout -b my-new-feature)
  3. Commit für Ihre Änderungen (git commit -am 'Add some feature')
  4. Pushen an den Branch (git push origin my-new-feature)
  5. Erstellen eines neuen Pull Request

Aufrufe