OkHttp的基本使用（二）Post请求

上篇【OkHttp的基本使用一】介绍了OkHttp的Get请求方式，也是OkHttp基本使用的开端，如果是第一次使用OkHttp的同学可以先从OkHttp的基本使用一开始阅读，此篇主要介绍OkHttp的Post请求方式。
在介绍OkHttp的Post请求的基本使用之前，我们需要了解什么是Post，以及什么是Get?对于android程序员来说，对这2个概念不像web工程师那样熟悉，在这里我们先简要说明Post和Get请求的区别：

• Post或者Get只是Http协议中向后台服务器发送数据的一种机制，是Http协议的一个组成部分。
• Post请求是将要提交到后台服务器的数据放在Http包的包体中。
• Get请求是将数据放在URL之后，比如http://androidxx.cn/forum.php?mo ... d=11&extra=page%3D1，可以看到此URL由2部分组成，分别是http://androidxx.cn/forum.php和？后面的参数。这就是典型的Get请求方式。
• 因为Get请求时直接将参数放在URL后面，而URL的长度是有一定的限制，所以当传递的数据特别大的时候，Get请求就不能完成。
• 相比较，Post请求的参数是放在Http包的内部，不能轻易被看到；Get请求的参数直接是跟在URL之后，可以很容易被用户获取。所以，相对而言，Post的请求方式更安全。

在实际项目开发过程中，什么时候使用Get、什么时候使用Post呢？
Post(当涉及到参数的安全问题或者参数比较大的时候，应该使用Post请求方式)，比如：

• 登陆
• 注册
• 上传
• 支付
• 下单
• ...

Get(Get就是获取的意思，项目开发中，如果是相对简单的查询类接口可以使用Get请求方式)，比如：

• 获取图片
• 获取文章详情
• ...

以上就是Get和Post的一个简单的介绍，对刚入门的android程序员应该会有点帮助。然后，接下来我们开始OkHttp的Post请求方式的学习。

• Post的同步请求方式（在android的主线程中，需要将下面的代码放在new Thread的run方法中执行，否则报错（错误详见））

1. OkHttpClient okHttpClient = new OkHttpClient();
2.         //Form表单格式的参数传递
3.         FormBody formBody = new FormBody
4.                 .Builder()
5.                 .add("goodsId","2799")//设置参数名称和参数值
6.                 .build();
7.         Request request = new Request
8.                 .Builder()
9. <font color="royalblue">                .post(formBody)//Post请求的参数传递，此处是和Get请求相比，多出的一句代码</font>
10. .url(Config.POST_URL)
11.                 .build();
12.         try {
13.             Response response = okHttpClient.newCall(request).execute();
14.             String result = response.body().string();
15.             Log.d("androixx.cn",result);
16.             response.body().close();
17.         } catch (IOException e) {
18.             e.printStackTrace();
19.         }

复制代码

以上是一个Post同步请求方式代码。Post请求的重点在参数的传递方式，也就是代码的第9行.post()方法。post()方法中的参数是要传递到后台服务器的参数，是一个RequestBody类型的参数。其他的代码同Get请求的基本一致。
在实际项目开发中，只要是使用Post请求方式的，都涉及参数传递。文章开头也说了，Post和Get请求的最大的不同点就在参数传递，所以接下来我们介绍一下Post的各种格式的参数传递。（注意：对于初学者，将视线重点放在Post和Get的参数传递方式上来学习OkHttp请求可能要更直观一些，也可能更容易理解）。

• Form表单数据的传递（上面的代码中的FormBody就是表单参数的设置方式，表单数据的传递就不重复帖代码，代码同上）
• Json格式数据的传递

1. //设置媒体类型。application/json表示传递的是一个json格式的对象
2.         MediaType mediaType = MediaType.parse("application/json");
3.         //使用JSONObject封装参数
4.         JSONObject jsonObject = new JSONObject();
5.         try {
6.             jsonObject.put("参数名","参数值");
7.         } catch (JSONException e) {
8.             e.printStackTrace();
9.         }
10.         //创建RequestBody对象，将参数按照指定的MediaType封装
11.         RequestBody requestBody = RequestBody.create(mediaType,jsonObject.toString());
12.         Request request = new Request
13.                 .Builder()
14.                 .post(requestBody)//Post请求的参数传递
15.                 .url(Config.POST_URL)
16.                 .build();
17.         try {
18.             Response response = okHttpClient.newCall(request).execute();
19.             String result = response.body().string();
20.             Log.d("androixx.cn",result);
21.             response.body().close();
22.         } catch (IOException e) {
23.             e.printStackTrace();
24.         }

复制代码

以上代码就是Json格式的数据传递。代码中的MediaType指定传递的数据类型，是一种MIME类型，比如application/json、application/octet-stream、application/xml等详细参考这里。
对比Form表单数据传递和Json格式数据传递，对于纯粹的android程序员来说，可能觉得一个使用的是FormBody、一个使用的是RequestBody+Json，好像没有什么不同，都是key：value格式。但是对于Web后台接收的方式会有所不同，所以将原本应该是Form表单参数改成Json参数传递，后台将接受不到前端传递的参数，因为其媒体类型（MediaType）不一样。

• String字符串传递

如果传递的就是一个纯粹的String字符串，可以将MediaType类型换成“text/plain".
说明：对于android程序员怎么知道该使用Form表单格式的数据传递方式，还是Json格式的数据传递方式？这个问题取决于后台的数据接收逻辑；所以，在实际开发中如果没有特殊说明的情况下，默认采用表单格式的数据传递；如果有特殊说明，那根据说明内容进行传递。不过，目前大多数公司要么采用form表单，要么采用Json（说白了，Json其实就是一个特殊格式的String对象）。

• Post异步请求

Post异步请求只需要将同步请求中的execute方法换成enqueue方法。

1. OkHttpClient okHttpClient = new OkHttpClient();
2.         //Form表单格式的参数传递
3.         FormBody formBody = new FormBody
4.                 .Builder()
5.                 .add("username","androidxx.cn")//设置参数名称和参数值
6.                 .build();
7.         Request request = new Request
8.                 .Builder()
9.                 .post(formBody)//Post请求的参数传递
10.                 .url(Config.LOCALHOST_POST_URL)
11.                 .build();
12.         okHttpClient.newCall(request).enqueue(new Callback() {
13.             @Override
14.             public void onFailure(Call call, IOException e) {}
16.             @Override
17.             public void onResponse(Call call, Response response) throws IOException {
18.                 //此方法运行在子线程中，不能在此方法中进行UI操作。
19.                 String result = response.body().string();
20.                 Log.d("androixx.cn", result);
21.                 response.body().close();
22.             }
23.         });

复制代码

• 总结

OkHttp是一个类似HttpUrlConnection的一个框架。
OkHttp是一个可以在Java项目和Android项目中使用的框架。所以其内部并没有Handler类来完成线程间的通信。所以，对于android而言，其返回的结果都是在子线程中。需要程序人自己写Handler完成数据传递。
OkHttp的Post和Get请求都有2中方式：同步和异步。其中同步请求不能直接在UI线程中进行。
Get和Post只是Http协议中的一块，2者的主要区别在数据的传递。学些的时候，可以从数据的传递入手去理解它们。
OkHttp使用建议在一个项目中只有一个OkHttp对象。使用前可以对OkHttp进行封装。

• 简易封装代码如下：

1. /**
2. * Created by yangjw on 2016/4/24.
3. * url：androidxx.cn
4. * desc：TODO
5. */
6. public class OkHttpUtil {
8.     //保证OkHttpClient是唯一的
9.     private static OkHttpClient okHttpClient;
11.     static Handler mHandler = new Handler();
13.     static {
14.         if (okHttpClient == null) {
15.             okHttpClient = new OkHttpClient();
16.         }
17.     }
19.     /**
20.      * Get请求
21.      * @param url
22.      * @param callback 回调函数
23.      */
24.     public static void httpGet(String url, final IOkCallBack callback) {
26.         if (callback == null) throw new NullPointerException("callback is null");
28.         Request request = new Request.Builder().url(url).build();
29.         okHttpClient.newCall(request).enqueue(new Callback() {
30.             @Override
31.             public void onFailure(Call call, final IOException e) {
32.                 mHandler.post(new Runnable() {
33.                     @Override
34.                     public void run() {
35.                         callback.onException(e);
36.                     }
37.                 });
38.             }
40.             @Override
41.             public void onResponse(Call call, Response response) throws IOException {
42.                 final String result = response.body().string();
43.                 mHandler.post(new Runnable() {
44.                     @Override
45.                     public void run() {
46.                         callback.onSuccess(result);
47.                     }
48.                 });
49.                 response.body().close();
50.             }
51.         });
52.     }
54.     /**
55.      * Post请求
56.      * @param url
57.      * @param params 参数
58.      * @param callback 回调函数
59.      */
60.     public static void httpPost(String url,Map<String,String> params,final IOkCallBack callback) {
61.         if (callback == null) throw new NullPointerException("callback is null");
62.         if (params == null) throw new NullPointerException("params is null");
64.         FormBody.Builder formBodyBuilder = new FormBody.Builder();
65.         Set<String> keySet = params.keySet();
66.         for(String key:keySet) {
67.             String value = params.get(key);
68.             formBodyBuilder.add(key,value);
69.         }
70.         FormBody formBody = formBodyBuilder.build();
72.         Request request = new Request
73.                 .Builder()
74.                 .post(formBody)
75.                 .url(url)
76.                 .build();
77.         okHttpClient.newCall(request).enqueue(new Callback() {
78.             @Override
79.             public void onFailure(Call call, final IOException e) {
80.                 mHandler.post(new Runnable() {
81.                     @Override
82.                     public void run() {
83.                         callback.onException(e);
84.                     }
85.                 });
87.             }
89.             @Override
90.             public void onResponse(Call call, Response response) throws IOException {
91.                 final String result = response.body().string();
92.                 mHandler.post(new Runnable() {
93.                     @Override
94.                     public void run() {
95.                         callback.onSuccess(result);
96.                     }
97.                 });
98.                 response.body().close();
99.             }
100.         });
101.     }
102. }

复制代码

本文章的源码：Github