V2AS问路
网络请求-Android篇(Okhttp和Retrofit)
阅读原文时间：2023年08月26日阅读：1

一.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方式用法相同，代码如下：

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。

//提交多个文件给服务器
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字符串给服务器：

//提交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、请求方法、请求头部、请求体等。这对于添加身份验证头、设置缓存控制头等场景很有用。用法如下：

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，服务器就可以识别该用户是否登录。用法如下：

public void cookie(){
Map> 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 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路径、请求参数和响应类型。使用注解来配置请求方法的特性。

/**
* 服务器域名：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 get(@Query("username") String username, @Query("password") String password);//注意get请求用@Query注解标注请求参数
@POST("post")
@FormUrlEncoded
Call post(@Field("username") String username,@Field("password") String password);//post请求用@Field注解
@GET
Call download(@Url String url);//使用Url注解需要提供完整的资源路径，这时设置的baseUrl就不起作用了
@POST("post")
@Multipart
Call upload(@Part MultipartBody.Part file);
}

　　3.创建Retrofit实例：使用Builder模式创建Retrofit实例，并配置基本的URL以及其他可选的设置，如转换器、拦截器等。　　

private Retrofit retrofit;  
private HttpbinService httpbinService;  
retrofit=new Retrofit.Builder()  
            .baseUrl("https://httpbin.org/")  
            .build();  
httpbinService=retrofit.create(HttpbinService.class);　　

　　4.创建API实现：通过Retrofit创建接口的实现，并使用它来执行网络请求。

public void post(){
Call call = httpbinService.post("jack", "123456");
call.enqueue(new Callback() {
@Override
public void onResponse(Call call, Response 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();  
}

　　文件的上传和下载：

public void download(){
Call call = httpbinService.download("https://nginx.org/download/nginx-1.20.2.tar.gz");
call.enqueue(new Callback() {
@Override
public void onResponse(Call call, Response 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字符串如下：

{
"code": 0,
"msg": "ok",
"message": "ok",
"data": []
}

　　那么，首先我们编写对应的javaBean，可以自己手写，也可以找网上的一些转换工具。

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接口：

public interface Bilibili {
@GET("api/tooltip/query.list.do")
Call get(); //将Call当中的泛型类型改为想要返回的javaBean类型
}

　进行网络请求并得到响应结果：

public void converter(){
Retrofit retrofit=new Retrofit.Builder()
.baseUrl("https://message.bilibili.com/")
.addConverterFactory(GsonConverterFactory.create())
.build();
Bilibili bilibili = retrofit.create(Bilibili.class);
Call call = bilibili.get();
call.enqueue(new Callback() {
@Override
public void onResponse(Call call, Response response) {
Bean bean = response.body();//响应结果自动转成了javaBean类型
Log.i("bean",bean.toString());
}

        @Override  
        public void onFailure(Call<Bean> call, Throwable t) {

        }  
    });  
}

　　以上就是OkHttp和Retrofit的基本用法了。

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器

你可能感兴趣的文章

Controller 层代码技巧
【Netty】03-进阶
Android RIL&IMS源码分析

4

从头到尾说一次 Spring 事务管理（器）

5

AuthenticationException异常无法被全局异常捕获的解决办法

6

java多线程使用详解与案例，超详细

7

我是如何使用Spring Retry减少1000 行代码

8

Tomcat处理http请求之源码分析

9

SpringBoot 测试实践 - 2：单元测试与集成测试

10

解放生产力orm并发更新下应该这么处理求求你别再用UpdateById了