Java 用 Azure Core OkHttp HTTP プラグイン ライブラリ - バージョン 1.11.16
Azure Core OkHttp HTTP クライアントは、HTTP クライアント API の azure-core
プラグインです。
作業の開始
前提条件
- Java Development Kit (JDK) バージョン 8 以降。
パッケージを組み込む
BOM ファイルを含める
ライブラリの一般提供 (GA) バージョンに依存するには、azure-sdk-bom をプロジェクトに含めてください。 次のスニペットでは、{bom_version_to_target} プレースホルダーをバージョン番号に置き換えます。 BOM の詳細については、 AZURE SDK BOM README に関するページを参照してください。
<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>
次に、バージョン タグのない依存関係セクションに直接依存関係を含めます。
<dependencies>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-core-http-okhttp</artifactId>
</dependency>
</dependencies>
直接依存関係を含める
BOM に存在しない特定のバージョンのライブラリに依存する場合は、次のように直接依存関係をプロジェクトに追加します。
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-core-http-okhttp</artifactId>
<version>1.11.16</version>
</dependency>
主要な概念
例
次のセクションでは、最も一般的なクライアント構成シナリオの一部をカバーするいくつかのコード スニペットを示します。
単純なクライアントを作成する
60 秒の接続タイムアウトと 120 秒の読み取りタイムアウトを使用して、OkHttp クライアントを作成します。
HttpClient client = new OkHttpAsyncHttpClientBuilder().build();
プロキシを使用してクライアントを作成する
プロキシを使用している OkHttp クライアントを作成します。
HttpClient client = new OkHttpAsyncHttpClientBuilder()
.proxy(new ProxyOptions(ProxyOptions.Type.HTTP, new InetSocketAddress("<proxy-host>", 8888)))
.build();
HTTP/2 サポートを使用してクライアントを作成する
HTTP/1.1 プロトコルと HTTP/2 プロトコルの両方をサポートする OkHttp クライアントを作成します。HTTP/2 が優先プロトコルです。
// 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();
HTTP/2 のみをサポートする OkHttp クライアントを作成することもできます。
// Constructs an HttpClient that only supports HTTP/2.
HttpClient client = new OkHttpAsyncHttpClientBuilder(new OkHttpClient.Builder()
.protocols(Collections.singletonList(Protocol.H2_PRIOR_KNOWLEDGE))
.build())
.build();
次のステップ
Azure Core を使用して構築された Azure ライブラリの使用を開始します。
トラブルシューティング
バグが発生した場合は、 GitHub の問題 を使用して問題を報告するか、 Azure Java SDK の StackOverflow をチェックアウトしてください。
ログ記録の有効化
Azure SDK for Java には、アプリケーション エラーのトラブルシューティングと解決の迅速化に役立つ一貫したログ記録のストーリーが用意されています。 生成されたログでは、最終状態に達する前のアプリケーションのフローがキャプチャされ、根本原因を特定するのに役立ちます。 ログ記録の有効化に関するガイダンスについては、ログ Wiki を参照してください。
共同作成
このリポジトリへの投稿の詳細については、 投稿ガイドを参照してください。
- フォーク
- 機能ブランチを作成する (
git checkout -b my-new-feature
) - 変更をコミットする (
git commit -am 'Add some feature'
) - ブランチにプッシュする (
git push origin my-new-feature
) - 新しい Pull Request を作成する