Retrofit 的核心概念
注解
Retrofit 使用注解来描述 HTTP 请求的参数、URL 和请求方法。以下是常见的注解:
@GET
:发送 GET 请求@POST
:发送 POST 请求@Path
:替换 URL 中的参数@Query
:添加查询参数@Body
:发送请求体
public interface ApiService {
@GET("posts/{id}")
Call<Post> getPostById(@Path("id") int postId);
}
CallAdapter
CallAdapter 是 Retrofit 的核心组件之一,用于将网络请求的结果转换为我们所需的数据类型。Retrofit 内置了常见的 CallAdapter,如 RxJavaCallAdapter 和 LiveDataCallAdapter,同时我们也可以自定义 CallAdapter,以满足特定需求。
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.build();
Converter
Converter 是 Retrofit 的另一个核心组件,负责将网络请求的结果转换为我们需要的数据格式。Retrofit 内置了常见的 Converter,如 GsonConverter 和 JacksonConverter,同时我们也可以根据需求自定义 Converter。
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.addConverterFactory(GsonConverterFactory.create())
.build();
Retrofit 的高级使用
自定义注解
Retrofit 允许我们根据需求自定义注解,简化网络请求的定义。通过自定义注解,我们能够指定 URL、请求方法和参数,从而提升代码的可读性和简洁性。
@GET("posts")
Call<List<Post>> getPostsByUserId(@Query("userId") int userId);
拦截器
Retrofit 支持拦截器的添加,以对网络请求进行处理。拦截器常用于添加公共参数、记录日志等操作,从而增加网络请求的灵活性和可维护性。
OkHttpClient client = new OkHttpClient.Builder()
.addInterceptor(new LoggingInterceptor())
.build();
错误处理与 RxJava 结合
在处理网络请求时,错误处理是至关重要的。Retrofit 与 RxJava 结合使用,能够更好地处理异步操作和错误。我们可以使用 RxJava 的 Observable
来包装 Call
,并利用其强大的错误处理能力。
apiService.getPostById(postId)
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Observer<Post>() {
@Override
public void onSubscribe(Disposable d) { }
@Override
public void onNext(Post post) {
// 处理成功响应
}
@Override
public void onError(Throwable e) {
// 处理错误情况
}
@Override
public void onComplete() { }
});
文件上传和下载
Retrofit 支持文件上传和下载功能。我们可以使用 @Multipart
注解来发送文件上传请求,使用 @Streaming
注解来处理大文件的下载。
@Multipart
@POST("upload")
Call<ResponseBody> uploadFile(@Part MultipartBody.Part filePart);
实际应用场景
认证
在某些情况下,需要在每个请求中添加认证信息(如 Token)。可以通过自定义 OkHttp 的拦截器,在请求中添加认证头,以实现认证功能。
OkHttpClient.Builder httpClient = new OkHttpClient.Builder();
httpClient.addInterceptor(chain -> {
Request originalRequest = chain.request();
Request newRequest = originalRequest.newBuilder()
.header("Authorization", "Bearer " + authToken)
.build();
return chain.proceed(newRequest);
});
Retrofit retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.client(httpClient.build())
.build();
![](https://img-blog.csdnimg.cn/img_convert/e1da94e835178c2d0c85c81d021c200c.webp?x-oss-process=image/format,png)
![](https://img-blog.csdnimg.cn/img_convert/983d768091a56171b1f59b7ab1721ac6.png)
**网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。**
**[需要这份系统化学习资料的朋友,可以戳这里获取](https://bbs.csdn.net/topics/618156601)**
**一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!**
这份系统化学习资料的朋友,可以戳这里获取](https://bbs.csdn.net/topics/618156601)**
**一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!**