retrofit

Integração HTTP com Retrofit — Addon Studio 2.0

Stack oficial para integração HTTP externa: Retrofit + Moshi + OkHttp. Substitui HttpClient nativo, URLConnection, Apache HTTP Client.

Esta skill cobre: declaração de deps no Gradle, interface client, wiring Guice, interceptors. Decisões arquiteturais (factory wrapper vs builder direto, retry, URL dinâmica) são do projeto — a skill mostra patterns válidos sem opinar.

---

1. Dependências (build.gradle do módulo)

NÃO declarar no build.gradle raiz. Vai no build.gradle do módulo (model/build.gradle, etc.).

Use somente moduleLib — a configuração custom do plugin br.com.sankhya.addonstudio já adiciona o JAR ao classpath de compilação e empacota no EJB final. Não duplicar com implementation.

dependencies {
    // Retrofit + Moshi (JSON) — padrão para APIs REST.
    moduleLib 'com.squareup.retrofit2:retrofit:2.12.0'
    moduleLib 'com.squareup.retrofit2:converter-moshi:2.12.0'
    moduleLib 'com.squareup.moshi:moshi:1.15.2'

    // OkHttp — cliente HTTP subjacente (obrigatório).
    moduleLib 'com.squareup.okhttp3:okhttp:3.14.9'
}

Conversores opcionais

Conversor	Quando usar	Dependência
converter-moshi	JSON (padrão)	com.squareup.retrofit2:converter-moshi:2.12.0
converter-scalars	Body String cru (SOAP/XML/texto)	com.squareup.retrofit2:converter-scalars:2.12.0
converter-jaxb	XML via JAXB	usar fábrica externa (JaxbConverterFactory de pacote terceiro)

Para testes com MockWebServer, adicionar em testImplementation:

testImplementation 'com.squareup.okhttp3:mockwebserver:3.14.9'

---

2. Interface do client

Declare a API como interface anotada com Retrofit. Sempre retorno Call<T> (síncrono — executor trata .execute()).

import retrofit2.Call;
import retrofit2.http.Body;
import retrofit2.http.GET;
import retrofit2.http.Headers;
import retrofit2.http.POST;
import retrofit2.http.Path;
import retrofit2.http.Query;

public interface ParceiroApi {

    @GET("v1/produtos/{id}")
    Call<ProdutoDto> buscarProduto(@Path("id") Long id);

    @GET("v1/produtos")
    Call<ListaProdutosDto> listarProdutos(@Query("limit") Integer limit,
                                          @Query("offset") Integer offset);

    @POST("v1/pedidos")
    @Headers("Content-Type: application/json")
    Call<PedidoCriadoDto> criarPedido(@Body NovoPedidoDto pedido);
}