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
- Java Development Kit (JDK), Version 8 oder höher.
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.
- Fork
- Erstellen Ihres Featurebranch (
git checkout -b my-new-feature
) - Commit für Ihre Änderungen (
git commit -am 'Add some feature'
) - Pushen an den Branch (
git push origin my-new-feature
) - Erstellen eines neuen Pull Request