Android基础05——网络
RESTful
RESTful：表现层状态转换。大意为资源以某种表现形式在互联网之间传递，而表现形式则是JSON、JEPG、XML等格式，状态转换则通过HTTP协议实现。这是一种互联网转件架构风格。
为了软件能够找到资源的位置，需要定义URI(Uniform Resource Identifier)标准资源识别符。URL就是一种具体的URI。
JSON
JSON是现在常用的数据传输格式。Android处理JSON可以使用JSONObject或者GSON。
JSONObject
来自Java的JSON对象类。
创建：既可以先new一个空的JSONObject对象再手动添加内容，也支持从JSON格式的字符串中自动转换为一个JSON对象。下面是添加属性的例子：
1JSONObject jsonObject = new JSONObject();
2
3// JSON中，对象属性的值可以是另一个对象
4JSONObject tempJson = new JSONObject();
5tempJson.put("min", 11.34);
6tempJson.put("max", 19.01);
7jsonObject.put("temp", tempJson);
8
9// 对象属性的值也可以是string、int、boolean
10jsonObject.put("success", true);
11
12// 或者是一个数组
13JSONArray jsonArray = new JSONArray();
14jsonArray.put("Adam");
15jsonArray.put("Bob");
16jsonArray.put("John");
17jsonObject.put("notification_user_id", jsonArray);
18
19//通过toString的方法获得JSON格式的字符串
20Log.d("JsonDemo", jsonObject.toString());
另外，一个JSON的单元也可以是数组即JSONArray。
下面是从字符串读取JSON对象以及使用JSON对象的例子：
1 String s = "{\"temp\":{\"min\":11.34,\"max\":19.01},\"success\":true,\"notification_user_id\":[\"Adam\",\"Bob\",\"John\"]}";
2 try {
3 JSONObject jsonObject = new JSONObject(s);
4 // 获取JSON对象的一个键对应的值
5 JSONArray notificationUserId = jsonObject.getJSONArray("notification_user_id");
6 /* optBoolean和getBoolean的区别是：
7 * optBoolean方法在没有找到这个键时可以返回默认值（即第二个参数）
8 * getBoolean方法如果没有找到键，将抛出异常
9 * 同理，getString和optString等也是这个区别
10 */
11 boolean success = jsonObject.optBoolean("unexist",true);
12 boolean unexist = jsonObject.getBoolean("unexist");
13 } catch (JSONException e) {
14 Log.d("JsonDemo", "crash:"+e.getMessage());
15 e.printStackTrace();
16 }
GSON
Google开发的更加好用的JSON套件，需要引入implementation 'com.google.code.gson:gson:2.8.6’依赖来使用。
GSON在使用之前可以事先创建好POJO简单对象，然后直接用GSON将一个对象解析成JSON格式的字符串或者从一个JSON格式的字符串创建对象，非常方便。
定义便于GSON使用的简单对象类：
1package com.byted.chapter5;
2
3import com.google.gson.annotations.SerializedName;
4
5import java.util.List;
6
7public class People {
8 // 这里的注解便是对应JSON的键
9 @SerializedName("age")
10 public int age;
11 @SerializedName("name")
12 public String firstName;
13 @SerializedName("friends")
14 public List<String> friends;
15}
将对象或数组转化为JSON字符串：
1public static void generateGsonString() {
2 Gson gson = new Gson();
3 People people = new People();
4 people.age = 10;
5 people.firstName = "sander";
6 ArrayList<String> friends = new ArrayList<>();
7 friends.add("sss");
8 friends.add("ddd");
9 friends.add("nnn");
10 people.friends=friends;
11 // 直接使用toJson方法即可，非常方便，一步到位
12 String s = gson.toJson(people);
13
14 People[] p=new People[1];
15 p[0]=people;
16 String str=gson.toJson(p);
17}
将JSON字符串读取转化为数据对象：
1public static void parseGsonString(){
2 Gson gson = new Gson();
3
4 String sp= " {\n" +
5 " \"name\": \"sander\",\n" +
6 " \"age\": 11\n" +
7 " }" ;
8 // 直接传入JSON字符串和目标的类即可生成对象
9 People people = gson.fromJson(sp, People.class);
10
11 String s="[\n" +
12 " {\n" +
13 " \"name\": \"sander\",\n" +
14 " \"age\": 11\n" +
15 " },\n" +
16 " {\n" +
17 " \"name\": \"sander\",\n" +
18 " \"age\": 12\n" +
19 " },\n" +
20 " {\n" +
21 " \"name\": \"sander\",\n" +
22 " \"age\": 13\n" +
23 " },\n" +
24 " {\n" +
25 " \"name\": \"sander\",\n" +
26 " \"age\": 14\n" +
27 " },\n" +
28 " {\n" +
29 " \"name\": \"sander\",\n" +
30 " \"age\": 15\n" +
31 " }\n" +
32 "]";
33 // 对于泛型的List要用getType这种方式获得类的信息
34 List<People> peoples = gson.fromJson(s, new TypeToken<List<People>>(){}.getType());
35 // 普通的数组类型可以直接读
36 People[] peoples2 = gson.fromJson(s, People[].class);
37}
Retrofit
Retrofit是一个对HTTP请求框架的封装，使用之前首先添加依赖：implementation "com.squareup.retrofit2:retrofit:2.8.1"
然后需要在src/main/AndroidManifest.xml中添加网络权限：
1<uses-permission android:name="android.permission.INTERNET" />
2<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
在使用的时候，首先需要创建一个描述网络请求的接口，采用注解的方式指明URL等信息，使用注解+参数传递的方式在POST请求的请求体中加入信息。注意这里的URL是不完整的，省略了Base部分。举例如下：
1import retrofit2.Call;
2import retrofit2.http.Field;
3import retrofit2.http.FormUrlEncoded;
4import retrofit2.http.GET;
5import retrofit2.http.POST;
6import retrofit2.http.Part;
7
8public interface ApiService {
9 // 方法：GET
10 // https://wanandroid.com/wxarticle/chapters/json
11 @GET("wxarticle/chapters/json")
12 Call<ArticleResponse> getArticles();
13
14
15 // https://www.wanandroid.com/user/register
16 //方法：POST
17 // username,password,repassword
18 // @FormUrlEncoded表示将参数中会通过@Field的方式指明键和值
19 @FormUrlEncoded
20 @POST("user/register")
21 Call<UserResponse> register(@Field("username") String username,
22 @Field("password") String password,
23 @Field("repassword") String repassword);
24}
在需要进行网络请求的地方，需要实例化Retrofit对象，在这里指明URL的base部分，然后创建API实例。之后，一般建议使用异步请求的方式完成网络连接。注意返回值是泛型的Response类型，具体类型可以自定义，可以使用.body()方法获得内部真正需要的数据对象。使用例如：
1private void getData() {
2 Retrofit retrofit = new Retrofit.Builder()
3 .baseUrl("https://wanandroid.com/")
4 .addConverterFactory(GsonConverterFactory.create())
5 .build();
6
7 // 用刚才创建的接口进行配置，创建ApiService实例
8 ApiService apiService = retrofit.create(ApiService.class);
9 // 采用异步请求的方式，完成后回调方法
10 apiService.getArticles().enqueue(new Callback<ArticleResponse>() {
11 //请求成功时调用。这里的ArticleResponse是自定义的
12 @Override
13 public void onResponse(Call<ArticleResponse> call, Response<ArticleResponse> response) {
14 if (response.body() != null) {
15 List<ArticleResponse.Article> articles = response.body().articles;
16 Log.d("retrofit", articles.toString());
17 if (articles.size() != 0) {
18 mAdapter.setData(response.body().articles);
19 mAdapter.notifyDataSetChanged();
20 }
21 }
22 }
23
24 //请求失败时调用
25 @Override
26 public void onFailure(Call<ArticleResponse> call, Throwable t) {
27 Log.d("retrofit", t.getMessage());
28 }
29 });
30
31}
当然，也可以采用同步的方式，不过可能会造成卡顿等问题。
1Response<ArticleResponse> = apiService.getArticles().execute();
2AriticleResponse article = response == null ? null : response.body();