一.OkHttp的介绍和基本用法
OkHttp是一个流行的开源Java和Android应用程序的HTTP客户端。它由Square Inc.开发，提供了一种简单高效的方式来进行应用程序中的HTTP请求。要在Java或Android项目中使用OkHttp，您需要将OkHttp依赖项添加到您的build.gradle文件中。然后，您可以创建一个OkHttpClient实例，并使用它来进行HTTP请求。OkHttp提供了各种类和方法，用于构建和执行请求、处理响应。使用OkHttp的时候，需要引入：implementation 'com.squareup.okhttp3:okhttp:4.10.0'，别忘了添加网络权限！
由于在进行网络请求的时候，我们主要用到get和post两种方式，下面就以这两个为例进行代码展示。
1.Get方式：GET请求将参数附加在URL的查询字符串中，即在URL后面使用?符号连接参数键值对。get方式中又可以分为两种情况，分别是同步请求和异步请求；同步请求在进行请求的时候，当前线程会阻塞住，直到得到服务器的响应后，后面的代码才会执行；而异步请求不会阻塞当前线程，它采用了回调的方式，请求是在另一个线程中执行的，不会影响当前的线程。下面给出代码：
public void getSync(){//同步请求
new Thread(new Runnable() {
@Override
public void run() {
OkHttpClient okHttpClient=new OkHttpClient();
Request request=new Request.Builder()
.url("https://www.httpbin.org/get?a=1&b=2")
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
try {
Response response = call.execute();
Log.i("getSync",response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
}
}).start();
}
public void getAsync(){//异步请求
OkHttpClient okHttpClient=new OkHttpClient();
Request request=new Request.Builder()
.url("https://www.httpbin.org/get?a=1&b=2")
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
//异步请求
call.enqueue(new Callback() {
@Override
public void onFailure(@NonNull Call call, @NonNull IOException e) {
}
@Override
public void onResponse(@NonNull Call call, @NonNull Response response) throws IOException {
if(response.isSuccessful()){
Log.i("getAsync",response.body().string());
}
}
});
}2.Post方式：POST请求将参数放在请求的主体中，不会直接显示在URL中。Post请求也分为同步和异步方式，和get方式用法相同，代码如下：
代码语言：javascript复制public void postSync(){//同步请求
new Thread(new Runnable() {
@Override
public void run() {
OkHttpClient okHttpClient=new OkHttpClient();
FormBody formBody=new FormBody.Builder()
.add("a","1")
.add("b","2")
.build();
Request request=new Request.Builder()
.post(formBody)
.url("https://www.httpbin.org/post")
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
try {
Response response = call.execute();
Log.i("postSync",response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
}
}).start();
}
public void postAsync(){//异步请求
OkHttpClient okHttpClient=new OkHttpClient();
FormBody formBody=new FormBody.Builder()
.add("a","1")
.add("b","2")
.build();
Request request=new Request.Builder()
.post(formBody)
.url("https://www.httpbin.org/post")
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(@NonNull Call call, @NonNull IOException e) {
}
@Override
public void onResponse(@NonNull Call call, @NonNull Response response) throws IOException {
if(response.isSuccessful()){
Log.i("postAsync",response.body().string());
}
}
});
}上面是通过表单的方式将数据提交给服务器，那如果要上传文件给服务器呢？使用Multipart。
代码语言：javascript复制//提交多个文件给服务器
public void postFiles(){
OkHttpClient okHttpClient=new OkHttpClient();
File file1=new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM).getAbsolutePath() File.separator "a.jpg");
File file2=new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM).getAbsolutePath() File.separator "b.jpg");
RequestBody requestBody1=RequestBody.create(file1, MediaType.parse("application/x-jpg"));
RequestBody requestBody2=RequestBody.create(file2, MediaType.parse("application/x-jpg"));
MultipartBody multipartBody=new MultipartBody.Builder()
.addFormDataPart("a.jpg",file1.getName(),requestBody1)
.addFormDataPart("b.jpg",file2.getName(),requestBody2)
.build();
Request request=new Request.Builder()
.post(multipartBody)
.url("https://www.httpbin.org/post")
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(@NonNull Call call, @NonNull IOException e) {
}
@Override
public void onResponse(@NonNull Call call, @NonNull Response response) throws IOException {
if(response.isSuccessful()){
Log.i("postFiles",response.body().string());
}
}
});
}如果要查看各个文件类型所对应的Content-type字符串，可以访问以下这个网址：https://www.runoob.com/http/http-content-type.html
提交Json字符串给服务器：
代码语言：javascript复制//提交json数据
public void postJson(){
OkHttpClient okHttpClient=new OkHttpClient();
RequestBody requestBody=RequestBody.create("{"a":1,"b":2}",MediaType.parse("application/json"));//记得使用转义字符处理内部的双引号
Request request=new Request.Builder()
.post(requestBody)
.url("https://www.httpbin.org/post")
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(@NonNull Call call, @NonNull IOException e) {
}
@Override
public void onResponse(@NonNull Call call, @NonNull Response response) throws IOException {
if(response.isSuccessful()){
Log.i("postJson",response.body().string());
}
}
});
}3.拦截器的使用：OkHttp的拦截器（Interceptors）提供了强大的自定义和修改HTTP请求和响应的能力。拦截器允许在发送请求前、收到响应后以及其他阶段对HTTP流量进行拦截和处理。例如：拦截器可以修改请求的URL、请求方法、请求头部、请求体等。这对于添加身份验证头、设置缓存控制头等场景很有用。用法如下：
代码语言：javascript复制public void interceptor(){
OkHttpClient okHttpClient=new OkHttpClient.Builder()//添加拦截器的使用OkHttpClient的内部类Builder
.addInterceptor(new Interceptor() {//使用拦截器可以对所有的请求进行统一处理，而不必每个request单独去处理
@NonNull
@Override
public Response intercept(@NonNull Chain chain) throws IOException {
//前置处理，以proceed方法为分割线：提交请求前
Request request = chain.request().newBuilder()
.addHeader("id", "first request")
.build();
Response response = chain.proceed(request);
//后置处理：收到响应后
return response;
}
})
.addNetworkInterceptor(new Interceptor() {//这个在Interceptor的后面执行，无论添加顺序如何
@NonNull
@Override
public Response intercept(@NonNull Chain chain) throws IOException {
Log.i("id",chain.request().header("id"));
return chain.proceed(chain.request());
}
})
.cache(new Cache(new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM).getAbsolutePath() "/cache"),1024*1024))//添加缓存
.build();
Request request=new Request.Builder()
.url("https://www.httpbin.org/get?a=1&b=2")
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
//异步请求
call.enqueue(new Callback() {
@Override
public void onFailure(@NonNull Call call, @NonNull IOException e) {
}
@Override
public void onResponse(@NonNull Call call, @NonNull Response response) throws IOException {
if(response.isSuccessful()){
Log.i("interceptor",response.body().string());
}
}
});
}4.Cookie的使用：大家应该有这样的经历，就是有些网站的好多功能都需要用户登录之后才能访问，而这个功能可以用cookie实现，在客户端登录之后，服务器给客户端发送一个cookie，由客户端保存；然后客服端在访问需要登录之后才能访问的功能时，只要携带这个cookie，服务器就可以识别该用户是否登录。用法如下：
代码语言：javascript复制public void cookie(){
Map<String,List<Cookie>> cookies=new HashMap<>();
new Thread(new Runnable() {
@Override
public void run() {
OkHttpClient okHttpClient=new OkHttpClient.Builder()
.cookieJar(new CookieJar() {
@Override
public void saveFromResponse(@NonNull HttpUrl httpUrl, @NonNull List<Cookie> list) {//保存服务器发送过来的cookie
cookies.put("cookies",list);
}
@NonNull
@Override
public List<Cookie> loadForRequest(@NonNull HttpUrl httpUrl) {//请求的时候携带cookie
if(httpUrl.equals("www.wanandroid.com")){
return cookies.get("cookies");
}
return new ArrayList<>();
}
})
.build();
FormBody formBody=new FormBody.Builder()
.add("username","ibiubiubiu")
.add("password","Lhh823924.")
.build();
Request request=new Request.Builder() //模拟登录
.url("https://wanandroid.com/user/lg")
.post(formBody)
.build();
//准备好请求的Call对象
Call call = okHttpClient.newCall(request);
try {
Response response = call.execute();
Log.i("login",response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
//请求收藏页面，必须登录之后才能访问到
request=new Request.Builder()
.url("https://wanandroid.com/lg/collect")
.build();
//准备好请求的Call对象
call = okHttpClient.newCall(request);
try {
Response response = call.execute();
Log.i("collect",response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
}
}).start();
}二.Retrofit的介绍和基本使用
Retrofit是一个基于OkHttp的强大且易于使用的网络请求库，用于在Android和Java应用程序中进行网络通信。它有以下的优点：
1.简化的API: Retrofit提供了一个简洁、直观的API，使得定义和执行网络请求变得非常容易。您可以使用注解来描述请求方法、URL路径、请求参数以及响应类型等信息，从而减少了样板代码的编写。
2.拦截器支持: Retrofit完全兼容OkHttp拦截器，这使得您可以使用OkHttp的拦截器来自定义和修改请求和响应。这为您提供了更大的灵活性和定制能力。
3.文件上传和下载: Retrofit支持文件上传和下载，并提供了进度回调机制，方便跟踪上传和下载进度。
Retrofit的基本用法如下：
1.添加依赖项：在您的Android或Java项目中的build.gradle文件中添加Retrofit的依赖项
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
2.创建API接口：定义一个包含请求方法的接口，该接口描述了请求的类型、URL路径、请求参数和响应类型。使用注解来配置请求方法的特性。
代码语言：javascript复制/**
* 服务器域名：https://www.httpbin.org/
* 接口：post，参数username,password
* 接口：get,参数username,password
*/
//第一步，根据http接口创建java接口
public interface HttpbinService {
@GET("get") //这是GET请求的相对路径。它指定了在基本URL之后所附加的路径，以构建完整的请求URL。例如，如果基本URL为https://api.example.com/，那么最终的请求URL将是https://api.example.com/get
Call<ResponseBody> get(@Query("username") String username, @Query("password") String password);//注意get请求用@Query注解标注请求参数
@POST("post")
@FormUrlEncoded
Call<ResponseBody> post(@Field("username") String username,@Field("password") String password);//post请求用@Field注解
@GET
Call<ResponseBody> download(@Url String url);//使用Url注解需要提供完整的资源路径，这时设置的baseUrl就不起作用了
@POST("post")
@Multipart
Call<ResponseBody> upload(@Part MultipartBody.Part file);
}3.创建Retrofit实例：使用Builder模式创建Retrofit实例，并配置基本的URL以及其他可选的设置，如转换器、拦截器等。
代码语言：javascript复制 private Retrofit retrofit;
private HttpbinService httpbinService;
retrofit=new Retrofit.Builder()
.baseUrl("https://httpbin.org/")
.build();
httpbinService=retrofit.create(HttpbinService.class); 4.创建API实现：通过Retrofit创建接口的实现，并使用它来执行网络请求。
代码语言：javascript复制public void post(){
Call<ResponseBody> call = httpbinService.post("jack", "123456");
call.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
try {
Log.i("post",response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
}
@Override
public void onFailure(Call<ResponseBody> call, Throwable t) {
}
});
}
public void get(){
new Thread(new Runnable() {
@Override
public void run() {
Call<ResponseBody> call = httpbinService.get("jack", "password");
try {
Response<ResponseBody> response = call.execute();
Log.i("get",response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
}
}).start();
}文件的上传和下载：
代码语言：javascript复制public void download(){
Call<ResponseBody> call = httpbinService.download("https://nginx.org/download/nginx-1.20.2.tar.gz");
call.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
if(response.isSuccessful()){
try {
InputStream inputStream = response.body().byteStream();
//context.getExternalFilesDir(null)是一个用于获取本应用程序的外部存储目录的方法，需要注意的是从Android11开始，应用程序不能直接访问SD卡的根目录，Android应用程序只能在应用的私有目录或特定的公共目录中存储文件
FileOutputStream out=new FileOutputStream(context.getExternalFilesDir(null).getAbsolutePath() "/nginx.tar.gz");
byte[] data=new byte[4096];
int len=0;
while((len=inputStream.read(data))!=-1){
out.write(data,0,len);
}
out.close();
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
}
@Override
public void onFailure(Call<ResponseBody> call, Throwable t) {
}
});
}
public void upload(){
MultipartBody.Part video = MultipartBody.Part.createFormData("video", "video.mp4", RequestBody.create(MediaType.parse("video/mpeg4"), new File(Environment.getExternalStorageDirectory().getAbsolutePath() "/video.mp4")));
Call<ResponseBody> call = httpbinService.upload(video);
call.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
try {
Log.i("video",response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
}
@Override
public void onFailure(Call<ResponseBody> call, Throwable t) {
}
});
}转换器的使用：在以上的例子中，服务器返回给我们的结果要么是字符串形式，要么是输入流的形式；那如果服务器给我们返回Json格式的数据，并且我们要求程序将Json自动转换成对应的javaBean呢，那么这时就可以用到转换器了。
比如，服务器给我们返回的Json字符串如下：
代码语言：javascript复制{
"code": 0,
"msg": "ok",
"message": "ok",
"data": []
}那么，首先我们编写对应的javaBean，可以自己手写，也可以找网上的一些转换工具。
代码语言：javascript复制public class Bean{
private Integer code;
private String msg;
private String message;
private List<String> data;
public Integer getCode() {
return this.code;
}
public void setCode(Integer code) {
this.code = code;
}
public String getMsg() {
return this.msg;
}
public void setMsg(String msg) {
this.msg = msg;
}
public String getMessage() {
return this.message;
}
public void setMessage(String message) {
this.message = message;
}
public List<String> getData() {
return this.data;
}
public void setData(List<String> data) {
this.data = data;
}
@Override
public String toString() {
return "Bean{"
"code=" code
", msg='" msg '''
", message='" message '''
", data=" data
'}';
}
}创建Api接口：
代码语言：javascript复制public interface Bilibili {
@GET("api/tooltip/query.list.do")
Call<Bean> get(); //将Call当中的泛型类型改为想要返回的javaBean类型
}进行网络请求并得到响应结果：
代码语言：javascript复制public void converter(){
Retrofit retrofit=new Retrofit.Builder()
.baseUrl("https://message.bilibili.com/")
.addConverterFactory(GsonConverterFactory.create())
.build();
Bilibili bilibili = retrofit.create(Bilibili.class);
Call<Bean> call = bilibili.get();
call.enqueue(new Callback<Bean>() {
@Override
public void onResponse(Call<Bean> call, Response<Bean> response) {
Bean bean = response.body();//响应结果自动转成了javaBean类型
Log.i("bean",bean.toString());
}
@Override
public void onFailure(Call<Bean> call, Throwable t) {
}
});
}以上就是OkHttp和Retrofit的基本用法了。
