【框架】OkHttp网络操作框架

1、历史

    java最早封装了用于IO的包java.io，后来到java.nio，后来就有okio。

2、ByteString

    顾名思义，字节串，是okio封装的处理数据的类型，可以通过encode等一系列封装的方法从字符串、base64编码、输入流中创建ByteString对象，使用该对象可以直接获取md5值、base64编码等。

3、Okio中的输入输出流

    类似于Java中的输入流，Source是okio封装的输入流接口，它主要的方法有：

read(Buffer sink, long byteCount)

timeout()

close()

    类似于Java中的输出流，Sink是okio封装的输出流接口，它的主要方法有：

write(Buffer source, long byteCount)

flush()

timeout()

close()

    okio中封装了Buffer类来进行数据的读写。代码示例如下：

Buffer buffer = new Buffer();
buffer.writeUtf8("abc");    //写入数据后，buffer的size变为3。
while (!buffer.exhausted()) {
    //每次读出一个字节的数据，每次读出一次后buffer的size都会-1。
    //如：第一次读取，读出一个a，此时buffer的size为2，内容为bc。
    System.out.println(buffer.readUtf8(1));   
}


输出：
a
b
c

//将in.png中的数据读出写入out.png中。
Buffer buffer = new Buffer();
buffer.readFrom(new FileInputStream("in.png"));
buffer.writeTo(new FileOutputStream("out.png"));

    okio中BufferedSource和BufferedSink分别实现了Source和Sink接口，生成这两个类的对象的方法都是使用Okio.buffer()方法获取，buffer()方法中需要传入一个参数，参数类型为Source或Sink。

使用Okio.source()方法和Okio.sink()方法可以获得Source和Sink对象，这两个方法可以接受的数据类型有四种，如下图所示。

代码实例如下：

//读取in.txt的内容拷贝到out.txt中。
BufferedSource source = Okio.buffer(Okio.source(new File("in.txt")));
BufferedSink sink = Okio.buffer(Okio.sink("out.text"));
source.readAll(sink);
source.close();
sink.close();

4、Http Client历史

    最早的有Apache的HttpClient、后来有Java的HttpURLConnection、再后来就有OkHttp。

它们的作用都是一样的：

5、OkHttp使用

    1、请求类Request

请求类由4部分组成：URL、method（get或post）、headers（请求头）、body（请求体）。

    2、相应类Response

响应类由3部分组成：code（结果码）、headers、body。

    private void testGet() {
        ExecutorService executorService = Executors.newSingleThreadExecutor();
        executorService.submit(new Runnable() {
            @Override
            public void run() {
                OkHttpClient client = new OkHttpClient();

                Request.Builder builder = new Request.Builder();
                builder.url("https://raw.githubusercontent.com/square/okhttp/master/README.md");
                Request request = builder.build();
                //request默认调用get方法。

                Call call = client.newCall(request);
                try {
                    //execute()方法是阻塞的等待响应。
                    //如果想要不阻塞的，可以使用call.enqueue()方法，传入callBack。
                    Response response = call.execute();
                    //判断请求是否成功。
                    if (response.isSuccessful()) {
                        if (response.body() != null) {
                            String str = response.body().string();
                            Log.d("test", str);
                        }
                    }
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        });
    }