Retrofit examples

https://square.github.io/retrofit/
Retrofit是一个基于Java的RESTful API库，它可以让开发者更加方便地处理HTTP请求和响应。

使用例子

以下是一个简单的 Retrofit 框架使用示例：

首先，在项目的 build.gradle 文件中添加 Retrofit 依赖：

dependencies {
implementation ‘com.squareup.retrofit2:retrofit:2.9.0’
implementation ‘com.squareup.retrofit2:converter-gson:2.9.0’
}

创建一个接口来定义 API 请求：

public interface ApiService {
@GET(“users/{userId}”)
Call getUser(@Path(“userId”) String userId);
}

创建 Retrofit 实例，并使用它来创建一个 ApiService 的实例：

Retrofit retrofit = new Retrofit.Builder()
.baseUrl(“https://api.github.com/”)
.addConverterFactory(GsonConverterFactory.create())
.build();

ApiService apiService = retrofit.create(ApiService.class);

使用 ApiService 实例来发起 API 请求：

Call call = apiService.getUser(“octocat”);
call.enqueue(new Callback() {
@Override
public void onResponse(Call call, Response response) {
User user = response.body();
// 处理响应
}

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

});

在这个示例中，我们使用 Retrofit 框架来获取 GitHub 上的用户信息。我们首先定义了一个 ApiService 接口，用于定义请求的方法和参数。然后，我们创建了一个 Retrofit 实例，并使用它来创建 ApiService 的实例。最后，我们使用 ApiService 实例来发起 API 请求，并在回调函数中处理响应。

Pros and Cons

优点：

简化了网络请求的过程，提高了开发效率。

支持多种网络请求协议，包括HTTP、WebSocket等。

支持多种数据解析格式，包括JSON、XML等。

支持自定义拦截器，可以对请求和响应进行处理和修改。

支持RxJava，可以方便地进行异步操作和线程切换。

支持缓存，可以对请求结果进行缓存，减少网络请求次数，提高响应速度。

支持动态URL，可以在运行时动态修改URL。

缺点：

对初学者不太友好，需要一定的学习成本。

由于是基于注解的方式，代码可读性可能会降低。

由于使用了动态代理技术，可能会对性能有一定影响。

不支持自动重试，需要手动处理网络请求失败的情况。