retrofit 请求接口

Retrofit是一个基于OkHttp的RESTful风格的网络请求框架，它可以将一个HTTP API转换为Java接口。在Retrofit中，我们需要定义一个Java接口来描述HTTP API，然后通过Retrofit.create()方法来创建该接口的实例。下面是一个简单的示例：

假设我们有一个HTTP API，它的URL为https://example.com/api，请求方式为GET，请求参数为id和name，返回类型为JSON格式的字符串。那么我们可以定义一个Java接口来描述这个API：

public interface MyApi {
    @GET("/api")
    Call<String> getData(@Query("id") String id, @Query("name") String name);
}

在这个接口中，我们使用了@GET注解来指定请求方式和URL，使用@Query注解来指定请求参数，使用Call<String>来指定返回类型。

接下来，我们可以使用Retrofit.create()方法来创建该接口的实例：

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("https://example.com")
        .build();
MyApi myApi = retrofit.create(MyApi.class);

在这个示例中，我们首先创建了一个Retrofit实例，并通过baseUrl()方法指定了API的基础URL。然后，我们调用create()方法来创建MyApi接口的实例。

最后，我们可以使用该实例来发起网络请求：

Call<String> call = myApi.getData("123", "test");
call.enqueue(new Callback<String>() {
    @Override
    public void onResponse(Call<String> call, Response<String> response) {
        String data = response.body();
        // 处理返回数据
    }

    @Override
    public void onFailure(Call<String> call, Throwable t) {
        // 处理请求失败
    }
});

在这个示例中，我们调用了MyApi接口的getData()方法来发起网络请求，并通过enqueue()方法来异步处理请求结果。在请求成功时，我们可以通过response.body()方法获取返回的数据，在请求失败时，我们可以在onFailure()方法中处理请求失败的情况。