Lib HttpClient Utils: Uma biblioteca Java para simplificar requisições HTTP

Com o crescente uso de aplicações web e serviços RESTful, a manipulação eficiente de requisições e respostas HTTP tornou-se crucial no desenvolvimento de software. No entanto, lidar com essas operações de forma simples e otimizada nem sempre é uma tarefa fácil. É nesse contexto que a biblioteca Lib HttpClient Utils surge como uma solução poderosa e personalizada para desenvolvedores Java.

Neste artigo, exploraremos em detalhes a biblioteca Lib HttpClient Utils, uma ferramenta desenvolvida por mim para simplificar e aprimorar a manipulação de requisições HTTP em projetos Java. Com a Lib HttpClient Utils, você poderá reduzir a complexidade do código, aumentar a produtividade e obter um desempenho excepcional nas comunicações HTTP.

Ao longo deste artigo, discutiremos os principais recursos e funcionalidades da Lib HttpClient Utils, apresentaremos exemplos práticos de uso e destacaremos os benefícios que ela oferece. Se você é um desenvolvedor Java em busca de uma solução elegante e eficiente para lidar com requisições HTTP, continue lendo e descubra como a Lib HttpClient Utils pode transformar sua experiência de desenvolvimento.

1. Importação da Biblioteca

Maven

<dependency>
    <!-- Outras dependências do seu projeto -->
    <groupId>io.github.jusebandtec</groupId>
    <artifactId>lib-httpclient-utils</artifactId>
    <version>1.1.6</version>
</dependency>

Gradle

dependencies {
    // Outras dependências do seu projeto

    implementation 'io.github.jusebandtec:lib-httpclient-utils:1.1.6'
}

2. Exemplo

Para utilizar é bem simples. A biblioteca é composto em 4 módulos principais:

1. HttpRepository
2. HttpConnection
3. HttpRequest
4. HttpResponse

Estaremos utilizando o contexto do Via Cep como exemplo. No qual fazemos a requisição:
HTTP GET - Cep 01001000

E vem a seguinte resposta:

{
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "complemento": "lado ímpar",
  "bairro": "Sé",
  "localidade": "São Paulo",
  "uf": "SP",
  "ibge": "3550308",
  "gia": "1004",
  "ddd": "11",
  "siafi": "7107"
}

Com a Lib HttpClient Utils é bem fácil reproduzir o comportamento.

É só fazer uma classe e herdar o módulo de HttpRepository para obter as funcionalidades de doRequest().

Veja:

@Component
public class TesteHttpClientUtils extends HttpRepository {

    @Autowired
    public TesteHttpClientUtils(HttpConnection httpConnection) {
        super(httpConnection);
    }
}

Note que ela não vai funcionar de primeira, é necessário criar um Bean da classe HttpConnection, dessa forma:

@Configuration
public class HttpClientLibConfiguration {

    @Bean
    public HttpConnection httpRepository() {
        return new HttpConnectionImpl(HttpClient.newBuilder().build());
    }
}

Agora podemos prosseguir.

Precisamos construir nossos objetos de Request e Response:

public class ObterCepHttpRequest extends HttpRequest {
    public ObterCepHttpRequest(String cep) {
        this.setUriRelative(String.format("https://viacep.com.br/ws/%s/json", cep));
        this.setHttpMethod(HttpMethod.GET);
        this.setTimeout(5000);
    }
}

Aqui tem somente alguns exemplos do que o HttpRequest tem, mas tem muito mais, como:

• String payload;
• Map headers;
• Map stringMediaTypeMap;

Dependendo da sua requisição, você pode utilizar.

E a classe de Response:

public class ObterCepHttpResponse implements HttpResponse {

    public ObterCepHttpResponseData obterCepHttpResponseData;

    @Override
    public HttpResponse handle(HttpRequest httpRequest, java.net.http.HttpResponse<?> httpResponse) {
        if (httpResponse.statusCode() != 200)
            return null;

        obterCepHttpResponseData = new JsonHelper<ObterCepHttpResponseData>().deserializeFromString(httpResponse.body().toString(), ObterCepHttpResponseData.class);
        return this;
    }

    public ObterCepHttpResponseData getObterCepHttpResponseData() {
        return obterCepHttpResponseData;
    }
}

Vou explicar como é chamado esse método handle() no próximo bloco.

A biblioteca já leva um módulo de JsonHelper no qual você pode serializar e desserializar objetos dependendo do que você deseja.

2.1 Fazendo a requisição

Vamos fazer um método para realizar a requisição e obter a resposta na classe que criamos como exemplo. Segue:

public ObterCepHttpResponseData obterCep(String cep) {
        try {
            var request = new ObterCepHttpRequest(cep);
            var response = this.doRequest(request, new ObterCepHttpResponse());
            System.out.println(response.toJson());
            return response.obterCepHttpResponseData;
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

Veja que é chamado o método doRequest(request, new ObterCepHttpResponse(), assim que esse método é chamado, ele realiza a requisição passando os parametros que especificamos na classe ObterCepHttpRequest, e assim que realizar a request, ele chama a classe ObterCepHttpResponse, passando a response pra lá, e é assim que conseguimos obter a resposta.

A biblioteca foi desenvolvida por mim, eu espero muito que tenham gostado. A mesma pode ser encontrada aqui:

Lib HttpClient Utils

Até mais.