Biblioteca de plug-in HTTP do Azure Core Netty para Java – versão 1.13.10

Artigo
11/09/2023

O cliente HTTP do Azure Core Netty é 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 o 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-netty</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 no BOM, adicione a dependência direta ao seu projeto da seguinte maneira.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core-http-netty</artifactId>
    <version>1.13.10</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 com suporte a HTTP/2
Criar um cliente com tamanho máximo de parte personalizado

Criar um cliente simples

Crie um HttpClient do Netty que usa a porta 80 e não tem proxy.

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

Criar um cliente com proxy

Crie um HttpClient do Netty que esteja usando um proxy.

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

Criar um cliente com suporte a HTTP/2

Crie um HttpClient do Netty 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.
HttpClient client = new NettyAsyncHttpClientBuilder(reactor.netty.http.client.HttpClient.create()
    .protocol(HttpProtocol.HTTP11, HttpProtocol.H2))
    .build();

Também é possível criar um HttpClient do Netty que dê suporte apenas a HTTP/2.

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

Criar um cliente com tamanho máximo de parte personalizado

Crie um HttpClient do Netty que usa um tamanho máximo de parte personalizado.

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

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 registro em log consistente para ajudar a solucionar problemas de erros do aplicativo e agilizar sua 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