Biblioteca de plug-ins HTTP OkHttp do Azure Core para Java – versão 1.11.16

Artigo
11/03/2023

O cliente HTTP do Azure Core OkHttp é um plug-in para a azure-core API do cliente HTTP.

Introdução

Pré-requisitos

Um Java Development Kit (JDK) versão 8 ou posterior.

Incluir o pacote

Incluir o arquivo da BOM

Inclua o azure-sdk-bom em seu projeto para assumir a dependência da versão ga (disponibilidade geral) da biblioteca. No trecho a seguir, substitua o espaço reservado {bom_version_to_target} pelo número de versão. Para saber mais sobre a BOM, consulte o BOM README do SDK do AZURE.

<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>

Depois, inclua a dependência direta na seção de dependências sem a marca de versão.

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

Incluir dependência direta

Se você quiser assumir a dependência de uma versão específica da biblioteca que não está presente na BOM, adicione a dependência direta ao seu projeto da seguinte maneira.

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

Principais conceitos

Exemplos

As seções a seguir fornecem vários snippets de código que abrangem alguns dos cenários de configuração de cliente mais comuns.

Criar um cliente simples
Criar um cliente com proxy

Criar um cliente simples

Crie um cliente OkHttp usando um tempo limite de conexão de 60 segundos e um tempo limite de leitura de 120 segundos.

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

Criar um cliente com proxy

Crie um cliente OkHttp que esteja usando um proxy.

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

Criar um cliente com suporte a HTTP/2

Crie um cliente OkHttp que dê suporte aos protocolos HTTP/1.1 e HTTP/2, sendo HTTP/2 o protocolo preferencial.

// 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();

Também é possível criar um cliente OkHttp que dá suporte apenas a HTTP/2.

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

Próximas etapas

Introdução às bibliotecas do Azure criadas usando o Azure Core.

Solução de problemas

Se você encontrar bugs, registre problemas por meio de Problemas do GitHub ou check-out do StackOverflow para o SDK do Java do Azure.

Habilitando o registro em log

Os SDKs do Azure para Java fornecem uma história de log consistente para ajudar a solucionar problemas de erros do aplicativo e agilizar a resolução. Os logs produzidos capturam o fluxo de um aplicativo antes que acessem o estado do terminal para ajudar a localizar o problema raiz. Exiba o wiki de log para obter diretrizes sobre como habilitar o registro em log.

Participante

Para obter detalhes sobre como contribuir para esse repositório, consulte o guia de contribuição.

Bifurcar
Criar seu branch de recurso (git checkout -b my-new-feature)
Confirmar suas alterações (git commit -am 'Add some feature')
Enviar por push para o branch (git push origin my-new-feature)
Criar nova solicitação de pull

Impressões

Partilhar via