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.                 .post(formBody)//Post请求的参数传递，此处是和Get请求相比，多出的一句代码
   
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) {}
    
15. 
    
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 {
   
7. 
   
8.     //保证OkHttpClient是唯一的
   
9.     private static OkHttpClient okHttpClient;
   
10. 
    
11.     static Handler mHandler = new Handler();
    
12. 
    
13.     static {
    
14.         if (okHttpClient == null) {
    
15.             okHttpClient = new OkHttpClient();
    
16.         }
    
17.     }
    
18. 
    
19.     /**
    
20.      * Get请求
    
21.      * @param url
    
22.      * @param callback 回调函数
    
23.      */
    
24.     public static void httpGet(String url, final IOkCallBack callback) {
    
25. 
    
26.         if (callback == null) throw new NullPointerException("callback is null");
    
27. 
    
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.             }
    
39. 
    
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.     }
    
53. 
    
54.     /**
    
55.      * Post请求
    
56.      * @param url
    
57.      * @param params 参数
    
58.      * @param callback 回调函数
    
59.      */
    
60.     public static void httpPost(String url,Map params,final IOkCallBack callback) {
    
61.         if (callback == null) throw new NullPointerException("callback is null");
    
62.         if (params == null) throw new NullPointerException("params is null");
    
63. 
    
64.         FormBody.Builder formBodyBuilder = new FormBody.Builder();
    
65.         Set 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();
    
71. 
    
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.                 });
    
86. 
    
87.             }
    
88. 
    
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