OkHttp使用详解

最新推荐文章于 2024-05-13 13:41:26 发布
最新推荐文章于 2024-05-13 13:41:26 发布
阅读量1.2k 收藏
点赞数
分类专栏： Android 开源库
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/feather_wch/article/details/51009871
版权

转载请注明链接: https://blog.csdn.net/feather_wch/article/details/51009871

本文介绍OkHttp的介绍、特点、基本使用、进阶使用(拦截器、Cookie管理)等内容。

如果有帮助的话，请点个赞！万分感谢！

友情链接：OkHttp源码详解

OkHttp使用详解

版本：2018/8/26-1(21:20)

介绍(4)

1、OkHttp是什么?

  1. 一个处理网络请求的开源项目
  2. Android上最火热的轻量级框架
  3. 由移动支付Square公司贡献

特点

2、OkHttp的特点

  1. 支持同步、异步请求
  2. 支持GZIP减少数据流量
  3. 缓存响应数据：从而减少重复的网络请求
  4. 自动重连：处理了代理服务器问题和SSL握手失败问题
  5. 支持SPDY：1.共享同一个Socket来处理同一个服务器的请求。 2.若SPDY不可用，则通过连接池来减少请求延时
  6. 请求、处理速度快：基于NIO和Okio。
  7. API使用方便简单：需要进一步封装。
  8. 能够从许多连接问题中，自动恢复。如：服务器配置了多个IP，第一个IP连接失败后okhttp会自动尝试下一个IP

3、OkHttp的特点在源代码中的体现

  1. 异步：enqueue开启异步请求，内部有线程池，通过Dispatcher调度，AsyncCall就是异步请求。
  2. 同步：execute开启同步请求，内部会直接调用RealCall的 getResponseWithInterceptorChain()进行请求，然后返回。
  3. GZIP压缩：在HTTP1.1开始，Web客户端可以通过Acceppt-Encoding头来标识对压缩的支持。HttpEngine.java的readReponse()中无论是使用缓存的Response还是网络的Response，会通过unzip(userResponse)解压缩并且返回。
  4. 缓存相应数据：OkHttpClient中Cache对reponse进行缓存，内部采用DiskLruCache实现。
  5. 自动重连：RealCall的getResponse中，会进行网络请求。调用HttpEngine的sendRequest或者readResponse时，如果出现RouteException或者IOException，会通过HttpEngine的recover进行恢复。然后继续去请求。
  6. 支持SPDY—共享同一个Socket来处理同一个服务器的请求。
  7. 复用连接池：ConnectionPool会管理连接池的复用，最大idle连接为5个，keepAlive=5分钟。建立连接时会将connection存储到队列中，再次发起请求时，会去队列寻找host一致的connection并且返回，最后进行请求。

4、OkHttp的应用场景

数据量大的重量级网络请求

基本使用(11)

1、OkHttp集成

okio是okhttp的io基础，因此也需要集成

//build.gradle
compile 'com.squareup.okhttp3:okhttp:3.2.0'
compile 'com.squareup.okio:okio:1.7.0'

2、Okio是什么？

square基于IO、NIO的一个高效处理数据流的开源库。

3、NIO是什么？

非阻塞性IO

GET请求

4、OkHttp的GET请求

//1. 通过Builder构建Request
Request.Builder requestBuilder = new Request.Builder().url("https://www.baidu.com/");
//2. 设定方法=GET
requestBuilder.method("GET", null);
//3. 构建Request
Request request = requestBuilder.build();
//4. 创建OKHttpClient客户端
OkHttpClient okHttpClient = new OkHttpClient();
//5. 创建Call请求
Call call = okHttpClient.newCall(request);
//6. 通过call的enqueue将请求入队(enqueue为异步方法， execute为同步方法)
call.enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
    }
    @Override
    public void onResponse(Call call, Response response) throws IOException {
         //TODO 接收返回值并进行处理
        String str = response.body().string();
        //注意！该回调不在UI线程中
        Log.d("HttpActivity", str);
    }
});
  1. 通过RequestBuilder构造Request
  2. 创建OkHttpClient
  3. 通过OkHttpClient的newCall方法，构建Call。
  4. Call.enqueue/execute 进行异步/同步请求

POST请求

5、OkHttp的POST请求(提交表单)

//1. 通过FormBody创建RequestBody
        RequestBody requestBody = new FormBody.Builder()
                .add("ip", getIPAddress(this)) //本机IP
                .build();
        //2. 创建Request
        Request request = new Request.Builder()
                .url("http://ip.taobao.com/service/getIpInfo.php")
                .post(requestBody)
                .build();
        //3. 创建OKHttpClient客户端
        OkHttpClient okHttpClient = new OkHttpClient();
        //4. 创建Call请求
        Call call = okHttpClient.newCall(request);
        //5. 通过call的enqueue将请求入队(enqueue为异步方法， execute为同步方法)
        call.enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                //TODO 接收返回值并进行处理
                String str = response.body().string();
                //注意！该回调不在UI线程中
                Log.d("HttpActivity", str);
            }
        });

获取本机IP的方法（需要网络权限）

    public static String getIPAddress(Context context) {
        NetworkInfo info = ((ConnectivityManager) context
                .getSystemService(Context.CONNECTIVITY_SERVICE)).getActiveNetworkInfo();
        if (info != null && info.isConnected()) {
            if (info.getType() == ConnectivityManager.TYPE_MOBILE) {//当前使用2G/3G/4G网络
                try {
                    //Enumeration<NetworkInterface> en=NetworkInterface.getNetworkInterfaces();
                    for (Enumeration<NetworkInterface> en = NetworkInterface.getNetworkInterfaces(); en.hasMoreElements(); ) {
                        NetworkInterface intf = en.nextElement();
                        for (Enumeration<InetAddress> enumIpAddr = intf.getInetAddresses(); enumIpAddr.hasMoreElements(); ) {
                            InetAddress inetAddress = enumIpAddr.nextElement();
                            if (!inetAddress.isLoopbackAddress() && inetAddress instanceof Inet4Address) {
                                return inetAddress.getHostAddress();
                            }
                        }
                    }
                } catch (SocketException e) {
                    e.printStackTrace();
                }

            } else if (info.getType() == ConnectivityManager.TYPE_WIFI) {//当前使用无线网络
                WifiManager wifiManager = (WifiManager) context.getSystemService(Context.WIFI_SERVICE);
                WifiInfo wifiInfo = wifiManager.getConnectionInfo();
                String ipAddress = intIP2StringIP(wifiInfo.getIpAddress());//得到IPV4地址
                return ipAddress;
            }
        } else {
            //当前无网络连接,请在设置中打开网络
        }
        return null;
    }

    /**
     * 将得到的int类型的IP转换为String类型
     */
    public static String intIP2StringIP(int ip) {
        return (ip & 0xFF) + "." +
                ((ip >> 8) & 0xFF) + "." +
                ((ip >> 16) & 0xFF) + "." +
                (ip >> 24 & 0xFF);
    }
  1. 通过FormBody构造requestBody
  2. 通过requestBuilder和requestBody构造Request
  3. 创建OkHttpClient
  4. 通过OkHttpClient的newCall方法，构建Call。
  5. Call.enqueue/execute 进行异步/同步请求

6、OkHttp的POST请求(提交Json)

相比于表单方式，只是构造RequestBody的方式不同。

//MediaType  设置Content-Type 标头中包含的媒体类型值
RequestBody requestBody = FormBody.create(MediaType.parse("application/json; charset=utf-8")
                , json); //Json

上传文件

7、OkHttp上传文件

//1. 创建媒体类型
    public static final MediaType MEDIA_TYPE_MARKDOWN = MediaType.parse("text/x-markdown; charset=utf-8");
    public void upload(String url, String filename){
        String filepath = "";
        //2. 获取到SD卡根目录中的文件
        if(Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)){
            filepath = Environment.getExternalStorageDirectory().getAbsolutePath();
        }else{
            return;
        }
        File file = new File(filepath, filename);
        //3. 创建请求(传入需要上传的File)
        Request request = new Request.Builder()
                .url(url) //"https://www.baidu.com"
                .post(RequestBody.create(MEDIA_TYPE_MARKDOWN, file))
                .build();
        //4. 异步上传文件(同步上传需要用execute())
        new OkHttpClient().newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
            }
            @Override
            public void onResponse(Call call, Response response) throws IOException {
                //TODO 接收返回值并进行处理.注意！该回调不在UI线程中
                String str = response.body().string();
                Log.d("HttpActivity", str);
            }
        });
    }

异步下载

8、OkHttp异步下载

public void download(String url, final String filename){
    //1. 创建请求(目标的url)
    Request request = new Request.Builder()
            .url(url) //"https://.../xxxx.jpg"
            .build();
    //2. 异步下载文件
    new OkHttpClient().newCall(request).enqueue(new Callback() {
        @Override
        public void onFailure(Call call, IOException e) {
        }
        @Override
        public void onResponse(Call call, Response response) throws IOException {
            //3. 得到Response中的流
            InputStream inputStream = response.body().byteStream();
            //4. 创建保存网络数据的文件
            String filepath = "";
            if(Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)){
                filepath = Environment.getExternalStorageDirectory().getAbsolutePath();
            }else{
                filepath = Environment.getDataDirectory().getAbsolutePath();
            }
            File file = new File(filepath, filename);
            //5. 下载数据到文件中
            if(null != file){
                FileOutputStream fileOutputStream = new FileOutputStream(file);
                byte[] buffer = new byte[2048];
                int len = 0;
                while((len = inputStream.read(buffer)) != -1){
                    fileOutputStream.write(buffer, 0, len);
                }
                fileOutputStream.flush();
            }
            Log.d("HttpActivity", "Downloaded");
        }
    });
}

多份数据上传

9、OKHttp同时上传多份数据(字符串、图片等等)

//1. 创建媒体类型
public static final MediaType MEDIA_TYPE_PNG = MediaType.parse("image/png");
public void multiUpload(String url){
    //2. 请求主体：同时上传字符串数据和图片数据
    RequestBody requestBody = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("title", "some jpg") //上传的字符串(key, value)
            .addFormDataPart("image"  //* key值
                    ,"feather.jpg" //* 文件名
                    , RequestBody.create(MEDIA_TYPE_PNG, new File("/sdcard/feather.jpg")) //* 需要上传的文件
                 ) //同时也上传图片
            .build();
    //3. 创建请求
    Request request = new Request.Builder()
            .header("Authorization", "Client-ID" + "...")
            .url(url) //"https://www.baidu.com"
            .post(requestBody)
            .build();
    //4. 异步上传数据和文件(同步上传需要用execute())
    new OkHttpClient().newCall(request).enqueue(new Callback() {
        @Override
        public void onFailure(Call call, IOException e) {
        }
        @Override
        public void onResponse(Call call, Response response) throws IOException {
            //TODO 接收返回值并进行处理.注意！该回调不在UI线程中
            String str = response.body().string();
            Log.d("HttpActivity", str);
        }
    });
}

超时时间与缓存

10、OkHttp设置连接、读取、写入的超时时间，以及设置缓存

int cacheSize = 10 * 1024 * 1024;
File sdcacheFile = getExternalCacheDir();
//1. 需要通过Builder创建OkHttpClient客户端---才能设置超时和缓存
OkHttpClient.Builder builder = new OkHttpClient.Builder()
        .connectTimeout(15, TimeUnit.SECONDS)
        .writeTimeout(20, TimeUnit.SECONDS)
        .readTimeout(20, TimeUnit.SECONDS)
        .cache(new Cache(sdcacheFile.getAbsoluteFile(), cacheSize));
OkHttpClient okHttpClient = builder.build();

取消请求

11、OkHttp如何取消请求

  1. OkHttp3的Callback的回调方法里面有个参数是Call 这个call可以单独取消相应的请求，随便在onFailure或者onResponse方法内部执行call.cancel()都可以。
  2. 如果想取消所有的请求，则可以okHttpClient.dispatcher().cancelAll();进行取消。

进阶使用(11)

Interceptors

1、什么是Interceptors拦截器？

  1. 是一种强大的机制，可以监视、重写、重试call请求。
  2. 通常情况下，用于添加、移除、转换请求和响应的头部信息。

2、最简单拦截器的实现方法

//会拦截 请求和返回的数据
public class SignInInterceptor implements Interceptor{
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();

        long t1 = System.nanoTime();
        Logger.getGlobal().info(String.format("Sending request %s on %s%n%s",
                request.url(), chain.connection(), request.headers()));

        Response response = chain.proceed(request);

        long t2 = System.nanoTime();
        Logger.getGlobal().info(String.format("Received response for %s in %.1fms%n%s",
                response.request().url(), (t2 - t1) / 1e6d, response.headers()));

        return response;
    }
}

3、拦截器的分类和在流程上的区别

  1. 应用拦截器：拦截OkHttp核心和应用间的请求与响应。不需要关心重定向和重试的中间响应。
  2. 网络拦截器：拦截OkHttp核心和网络之前的请求与响应。
    interceptors

4、添加应用拦截器: addInterceptor

OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(new SignInInterceptor())
    .build();

5、添加网络拦截器: addNetworkInterceptor

OkHttpClient client = new OkHttpClient.Builder()
    .addNetworkInterceptor(new SignInInterceptor())
    .build();

6、拦截器的应用场景

  1. 可以在拦截器中进行请求体压缩(如果Web服务端支持请求体的压缩)。
  2. 可以将域名替换为IP地址
  3. 可以在在请求头中添加host属性
  4. 可以在请求头中添加应用相关的公共参数：设备ID、版本号等

7、应用拦截器是在哪里进行处理的？

  1. RealCall的getResponseWithInterceptorCahin()中
  2. 大致流程：从拦截器链中取出拦截器，依次进行递归调用。
 //RealCall.java
private Response getResponseWithInterceptorChain(){...}

Cookie管理

8、如何持久化Cookie？

  1. 手动保存Cookie，从Response中取出Header里面的Cookie，保存到本地(SharePreference)。发送请求时利用Interceptor拦截器添加到头部(保存Cookie也可以采用拦截器拦截，然后本地保存)。为了对应不同域名，可以将域名作为key对Cookie进行保存。
  2. OkHttp3的Cookie管理。

9、OkHttp3新增的CookieJar

  1. okhttp3中对Cookie管理提供了额外的支持
  2. 实现CookieJar接口中的两个方法(发送请求/接到响应)，实现Cookie的内存or本地缓存。
CookieJar的使用

10、CookieJar的实现

1-实现

public class MyCookieJar implements CookieJar{

    private static HashMap<String, List<Cookie>> mCookieStore = new HashMap<>();

    @Override
    public void saveFromResponse(HttpUrl url, List<Cookie> cookies) {
        mCookieStore.put(url.host(), cookies);
    }

    @Override
    public List<Cookie> loadForRequest(HttpUrl url) {
        List<Cookie> cookies = mCookieStore.get(url.host());
        return cookies != null ? cookies : new ArrayList<Cookie>();
    }
}

2-使用

OkHttpClient client = new OkHttpClient.Builder()
                            .cookieJar(new MyCookieJar())
                            .build();

11、CookieJar的saveFromeResponse()在哪里被调用？

  1. HttpClient.readResponse()->receiveHeaders(networkResponse.headers())
  2. receiveHeaders()中从response的headers中解析出Cookie

12、CookieJar的loadForRequest()在哪里被调用？

  1. HttpClient.sendRequest()->networkRequest(): 向request添加headers的时候
  2. 调用loadForRequest()获取到cookie列表，添加到header中。
    List<Cookie> cookies = client.cookieJar().loadForRequest(request.url());
    if (!cookies.isEmpty()) {
      result.header("Cookie", cookieHeader(cookies));
    }

参考资料

  1. OkHttp拦截器-官方github-wiki
  2. OKHTTP结合官网示例分析两种自定义拦截器的区别
  3. http中的204和205
  4. HTTP协议探索之Cache-Control
  5. Http ETag是什么？
猎羽
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 1
    评论
专栏目录
OKHttp开源框架学习十：ConnectionPool连接池
songzi1228的博客
06-27 4253
目录 系列文章： 简介： 以下是几个重要的参数： 接下来，我们来看ConnectionPool的构造方法： ConnectionPool的get方法： ConnectionPool的put方法： ConnectionPool的回收： 我们知道okhttp是可以通过连接池来减少请求延时的，那么这一点是怎么实现的呢？ 系列文章： OKHttp开源框架学习一：同步请求总结 OKH...
Android OkHttp基本使用详解
08-27
"Android OkHttp基本使用详解" OkHttp是一个相对成熟的解决方案，需要的朋友可以参考下。Android系统提供了两种HTTP通信类，HttpURLConnection和HttpClient。尽管Google在大部分安卓版本中推荐使用...
okhttp之ConnectionPool
103style
10-08 3412
转载请以链接形式标明出处： 本文出自:103style的博客 base on 3.12.0 目录 简介 ConnectionPool 的成员变量 ConnectionPool 的构造函数 ConnectionPool 的相关方法 小结 简介 ConnectionPool 即连接池，用来管理 HTTP 和 HTTP/2 连接的重用，以减少网络延迟。 相同的 HTTP 请求可以共用一个连...
最全OkHttp源码解析（小白必看，建议收藏），聪明人已经收藏了
最新发布
2301_79099287的博客
05-13 949
由于篇幅原因，就不多做展示了本文已被CODING开源项目：【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】收录需要这份系统化的资料的朋友，可以点击这里获取4、响应码1** 信息，服务器收到请求，需要请求者继续执行操作2** 成功，操作被成功接收并处理3** 重定向，需要进一步的操作以完成请求4** 客户端错误，请求包含语法错误或无法完成请求5** 服务器错误，服务器在处理请求的过程中发生了错误5、socket 概念。
Okhttp的连接池ConnectionPool(三)
qq_37321098的博客
11-02 3776
目录 1.get()方法 2.put() Okhttp3使用及解析:https://mp.csdn.net/postedit/83339916 okhttp系统拦截器:https://mp.csdn.net/postedit/83536609 Okhttp的连接池ConnectionPool:https://mp.csdn.net/postedit/83650740   Okhttp...
Okhttp之连接池ConnectionPool简单分析（一）
热门推荐
菜鸟博客
07-05 2万+
ConnectionPool
OKHttp源码解析-ConnectionPool对Connection重用机制&Http/Https/SPDY协议选择
u014592587的专栏
06-29 1776
OKHttp
OkHttp3使用详解
03-27
OkHttp3 使用详解 OkHttp3 是一个功能强大且灵活的网络请求库，它提供了许多实用的特性来帮助开发者快速构建网络应用程序。下面将详细介绍 OkHttp3 的使用方法。 OkHttp3 的基本使用 OkHttp3 的基本使用主要包括...
Android中okhttp3使用详解
08-29
Android 中 OkHttp3 使用详解 OkHttp3 是一个流行的基于 HTTP/2 的网络请求库，由 Square 公司开发，广泛应用于 Android 和 Java 项目中。OkHttp3 提供了强大的网络请求功能，支持同步和异步请求，能够满足大多数的...
OkHttp详解
11-05
### OkHttp详解 #### 一、概述 **OkHttp** 是一个高效的 HTTP 客户端库，被广泛应用于 Android 开发以及其他 Java 应用程序中。它提供了多种特性来优化网络请求性能，包括但不限于 HTTP/2 支持、连接池管理、GZIP ...
OkHttp源码详解
11-30
详细讲解OKHttp的实现。。。。。。在网络请求的小节中，我们已经看到了Interceptor的布局，在负责和服务器建立连接的ConnectInterceptor之前，就是CacheInterceptor。他们执行过程就是：在建立连接之前，我们检查...
okhttp中连接池实现
08-29
代码中包含okhhtp中连接池的设计，包含连接对象的添加，连接对象何时被移除。
Android Activity间共享数据
11-29
一些Activity间共享数据的代码实例，用于开发时参考。
android不同activity之间共享数据解决方法
09-05
最近做局域网socket连接问题，要在多个activity之间公用一个socket连接，就在网上搜了下资料，感觉还是application方法好用，帖出来需要的朋友可以参考下
OkHttp3——连接池
如若、然的专栏
10-15 4457
ConnectionPool --> RealConnectionPool(里面包含List<Realconnection>) 连接池具有以下特点： 连接池管理所有Socket连接，当有新的请求时从池中分配一个链路。 默认支持5个并发keepalive，链路生命为5分钟（链路数据传输完成，保持5分钟的存活时间）。 自动清除线程，将超过5分钟的链路关闭socket。 OkHttp真正的连接是在ConnectInterceptor中通过 Transmitter（realC...
OkHttp 工具包 创建了太多 ConnectionPool 对象导致内存爆炸
mrathena
03-04 5744
博文目录 文章目录问题说明问题解决 问题说明 OkHttp ConnectionPool 对象居然有近2000个, 占用了太多的内存, 导致宕机 理论上讲, 既然都使用连接池了, 那连接池对象有1个应该就够了, 为什么这里会有近2000个? 原来是自己封装的 OkHttp 工具包的设计和使用上出了问题 该工具包支持传入 OkHttpClient 对象, 也支持创建默认的 OkHttpClient 对象, 由于小伙伴们直接使用了不传参数的方式, 导致每次调用都会新建一个 OkHttpClient 对象.
OkHttp3的连接池及连接建立过程分析
tq08g2z的专栏
08-17 3363
如我们前面在 OkHttp3 HTTP请求执行流程分析 中的分析，OkHttp3通过Interceptor链来执行HTTP请求，整体的执行过程大体如下： OkHttp Flow 这些Interceptor中每一个的职责，这里不再赘述。 在OkHttp3中，StreamAllocation是用来建立执行HTTP请求所需网络设施的组件，如其名字所显示的那样，分配Stream。但它具体做的事情根据是
OkHttp3源码详解之 okhttp连接池复用机制（一）
egrhef的博客
04-05 642
面试是一个不断学习、不断自我提升的过程，有机会还是出去面面，至少能想到查漏补缺效果，而且有些知识点，可能你自以为知道，但让你说，并不一定能说得很好。有些东西有压力才有动力，而学到的知识点，都是钱（因为技术人员大部分情况是根据你的能力来定级、来发薪水的），技多不压身。附上我的面试各大专题整理： 面试指南，满满的都是干货，希望对大家有帮助！《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门即可获取！
okhttp排至详解
08-03
在使用OkHttp时，可以通过创建一个OkHttpClient实例来配置网络请求的一些参数，例如连接超时时间、读取超时时间等。然后，可以使用OkHttpClient创建一个Request对象，该对象包含了请求的URL、请求头和请求体等信息。...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

猎羽

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值