Biblioteca de complementos HTTP de Azure Core Netty para Java: versión 1.13.10

El cliente HTTP de Azure Core Netty es un complemento para la API de azure-core cliente HTTP.

Introducción

Requisitos previos

• Un kit de desarrollo de Java (JDK), versión 8 o posterior.

Inclusión del paquete

Inclusión del archivo BOM

Incluya azure-sdk-bom en el proyecto para depender de la versión de disponibilidad general (GA) de la biblioteca. En el fragmento de código siguiente, reemplace el marcador de posición {bom_version_to_target} por el número de versión. Para más información sobre la lista de materiales, consulte EL ARCHIVO LÉAME BOM del SDK de 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>

y, luego, incluya la dependencia directa en la sección de dependencias sin la etiqueta de versión.

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

Inclusión de dependencias directas

Si quiere depender de una versión determinada de la biblioteca que no está presente en la lista de materiales, agregue la dependencia directa al proyecto como se indica a continuación.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core-http-netty</artifactId>
    <version>1.13.10</version>
</dependency>

Conceptos clave

Ejemplos

En las secciones siguientes se proporcionan varios fragmentos de código que abarcan algunos de los escenarios de configuración de cliente más comunes.

• Crear un cliente simple
• Creación de un cliente con proxy
• Creación de un cliente con compatibilidad con HTTP/2
• Crear un cliente con tamaño de fragmento máximo personalizado

Crear un cliente simple

Cree un HttpClient de Netty que use el puerto 80 y no tenga ningún proxy.

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

Creación de un cliente con proxy

Cree un HttpClient de Netty que use un proxy.

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

Creación de un cliente con compatibilidad con HTTP/2

Cree un HttpClient de Netty que admita los protocolos HTTP/1.1 y HTTP/2, siendo HTTP/2 el protocolo preferido.

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

También es posible crear un HttpClient de Netty que solo admita HTTP/2.

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

Crear un cliente con tamaño de fragmento máximo personalizado

Cree un objeto HttpClient de Netty que use un tamaño de fragmento máximo 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();

Pasos siguientes

Introducción a las bibliotecas de Azure compiladas mediante Azure Core.

Solución de problemas

Si encuentra algún error, envíe problemas a través de problemas de GitHub o consulte StackOverflow para el SDK de Java de Azure.

Habilitar el registro

Los SDK de Azure para Java proporcionan un artículo de registro coherente para ayudar a solucionar errores de aplicación y acelerar su resolución. Los registros generados capturarán el flujo de una aplicación antes de alcanzar el estado terminal para ayudar a encontrar el problema raíz. Vea la wiki de registro para obtener instrucciones sobre cómo habilitar el registro.

Contribuciones

Para más información sobre cómo contribuir a este repositorio, consulte la guía de contribución.

1. Bifurcación
2. Creación de la rama de características (git checkout -b my-new-feature)
3. Confirmar los cambios (git commit -am 'Add some feature')
4. Inserción en la rama (git push origin my-new-feature)
5. Creación de una nueva solicitud de incorporación de cambios