Android编程权威指南（第二版）学习笔记（二十三）—— 第23章 HTTP 与后台任务

本章主要讲了如何使用 android 系统的网络连接，并介绍了格式化 JSON 和多线程编程 AsyncTask 的使用。另外，挑战练习里还结合了 Gson 库的使用。

GitHub 地址：
完成23章但未完成挑战
完成23章挑战1：使用 Gson
完成23章挑战2：添加分页
完成23章挑战3：动态调整网格列

1. 网络连接基本

首先要在 Manifest 文件中请求网络权限

<uses-permission android:name="android.permission.INTERNET" />

然后我们建立一个网络请求的函数：

// FlickrFetchr.java
// 参数是 url 字符串，并且需要抛出 IO 错误
public byte[] getUrlBytes(String urlSpec) throws IOException {
    URL url = new URL(urlSpec);
    // 打开连接
    HttpURLConnection connection = (HttpURLConnection) url.openConnection();

    try {
    	// 建立两个流对象
        ByteArrayOutputStream out = new ByteArrayOutputStream();
        // 使用 getInputStream() 方法时才会真正发送 GET 请求
        // 如果要使用 POST 请求，需要调用 getOutputStream()
        InputStream in = connection.getInputStream();
		// 如果连接失败就抛出错误
        if (connection.getResponseCode() != HttpURLConnection.HTTP_OK) {
            throw new IOException(connection.getResponseMessage() +
                    ": with" +
                    urlSpec);
        }
        
        // 建立一个计数器
        int bytesRead = 0;
        // 建立一个缓存 buffer
        byte[] buffer = new byte[1024];
        // 用 InputStream.read 将数据读取到 buffer 中，
        // 然后写到 OutputStream 中
        while ((bytesRead = in.read(buffer)) > 0) {
            out.write(buffer, 0, bytesRead);
        }
        // 之后一定要关闭 OutputStream
        out.close();
        return out.toByteArray();
    } finally {
    	// 最后要关闭连接
        connection.disconnect();
    }
}

public String getUrlString(String urlSpec) throws IOException {
	// 将结果转换成 String
    return new String(getUrlBytes(urlSpec));
}

2. 线程与主线程

网络连接需要时间，Web 服务器可能需要1~2秒的时间来响应访问请求，文件下载则耗时更久。考虑到这个因素，Android 禁止任何主线程网络连接行为。即使强行在主线程中进行网络连接，Android 也会抛出 NetworkOnMainThreadException 异常。

这是为什么呢?要想知道，首先要了解什么是线程，什么是主线程以及主线程的用途是什么。
线程是个单一执行序列。单个线程中的代码会逐步执行。所有 Android 应用的运行都是从主线程开始的。然而，主线程不是线程那样的预定执行序列。相反，它处于一个无限循环的运行状态，等待着用户或系统触发事件的发生。事件触发后，主线程便负责执行代码，以响应这些事件。

主线程运行着所有更新 UI 的代码，其中包括响应 activity 的启动、按钮的点击等不同 UI 相关事件的代码。(由于响应的事件基本都与用户界面相关，主线程有时也叫作 UI 线程。)
事件处理循环让 UI 代码得以按顺序执行。这可以保证任何事件处理都不会发生冲突，同时代码也能够快速响应执行。

而网络连接相比其他任务更耗时。等待响应期间，用户界面毫无反应，这可能会导致应用无响应(Application Not Responding,ANR)现象发生，也就是一个弹框，要求你关闭应用。
怎样使用后台线程最容易呢？答案就是使用 AsyncTask 类

3. AsyncTask

3.1 AsyncTask 的生命

AsyncTask 类可以重写的方法和一个进程的生命过程对应：

• onPreExecute() 执行之前
• onProgressUpdate() 更新进展
• doInBackground() 在线程中真正要完成的事
• onPostExecute() 完成之后要做的事（在 UI 线程中执行）
• onCancelled() 退出之后

3.2 AsyncTask 的三个参数

其中模板的三个类类型参数（不能是基础类型）分别是：输入、进度、结果。

3.2.1 第一个参数：输入

第一个类型参数可指定输入参数的类型。可参考以下示例使用该参数:

AsyncTask<String,Void,Void> task = new AsyncTask<String,Void,Void>() {
	public Void doInBackground(String... params) { 
		for (String parameter : params) {
			Log.i(TAG, "Received parameter: " + parameter);
		}
		return null;
	}
};

输入参数传入 execute(…)方法(可接受一个或多个参数): task.execute(“第一个参数”, “第二个参数”, “……”);
然后，再把这些变量参数传递给 doInBackground(…)方法。

3.2.2 第二个参数：进度

第二个类型参数可指定发送进度更新需要的类型。以下为示例代码:

final ProgressBar gestationProgressBar = /* 一个特定的进度条 */;
gestationProgressBar.setMax(42); /* 最大的进度 */
AsyncTask<Void,Integer,Void> haveABaby = new AsyncTask<Void,Integer,Void>() {
	public Void doInBackground(Void... params) {
		while (!babyIsBorn()) {
			Integer weeksPassed = getNumberOfWeeksPassed();
          publishProgress(weeksPassed); // 关键，将参数发送到 onProgressUpdate
          patientlyWaitForBaby();
		} 
	}
	
	public void onProgressUpdate(Integer... params) {
		int progress = params[0];
		gestationProgressBar.setProgress(progress);
	} 
};
/* call when you want to execute the AsyncTask */
haveABaby.execute();

进度更新通常发生在执行的后台进程中。问题是，在后台进程中无法完成必要的 UI 更新。因此 AsyncTask 提供了 publishProgress(…)和 onProgressUpdate(…)方法。
其工作方式是这样的 : 在后台线程中 , 从 doInBackground(…) 方法中调用 publishProgress(…)方法。这样 onProgressUpdate(…)方法便能够在 UI 线程上调用。因此，在 onProgressUpdate(…)方法中执行 UI 更新就可行了，但必须在 doInBackground(…) 方法中使用 publishProgress(…)方法对它们进行管控。

3.2.3 第三个参数：结果

第三个类型参数是处理结果返回的类型参数。下面是本章的示例代码

// PhotoGalleryFragment.java

private class FetchItemsTask extends AsyncTask<Integer, Void, List<GalleryItem>> {
    @Override
    protected List<GalleryItem> doInBackground(Integer... params) {
        return new FlickrFetchr().fetchItems(params[0]);
    }

    @Override
    protected void onPostExecute(List<GalleryItem> galleryItems) {
        mItems = galleryItems;
        setAdapter();
    }
}

第三个参数就是在 doInBackground 中返回的结果，我们需要从后台请求 API 返回的 JSON 数据，然后将其格式化，返回的就是我们需要的数据。

4. JSON 数据解析

什么是 JSON 数据呢？JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于 JavaScript 的一个子集。JSON 采用完全独立于语言的文本格式，但是也使用了类似于C语言家族的习惯（包括C, C++, C#, Java, JavaScript, Perl, Python 等）。这些特性使 JSON 成为理想的数据交换语言。

JSON 对象是一系列包含在{ }中的名值对。JSON 数组是包含在[ ]中用逗号隔开的 JSON 对象列表。对象彼此嵌套形成层级关系。详细的语法可以查看JSON 官网。

JSON 这种数据格式在同样基于这些结构的编程语言之间交换十分方便，所以网络服务器端越来越多地开始用 JSON 来交换数据，我们在这章使用的 API 同样如此。

一个例子

// 为节省版面，去掉了无关的属性
{
  "photos": {
    "page": 1,
    "pages": 10,
    "photo": [
      {
        "id": "31987348504",
        "title": "Penny",
        "url_s": "https://farm3.staticflickr.com/2915/31987348504_9a949c482d_m.jpg",
      },
      {
        "id": "31987352214",
        "title": "",
        "url_s": "https://farm1.staticflickr.com/455/31987352214_58428f3a9d_m.jpg",
      }
    ]
  },
  "stat": "ok"
}

对应的解析代码：

// 解析时用 try…catch，要抛出 JSONException 防止程序崩溃
// JSONObject 构造方法解析传入的 JSON 数据后
// 会生成与原始 JSON 数据对应的对象树
JSONObject jsonBody = new JSONObject(jsonString);

// 顶层 JSONObject 对应着原始数据最外层的{ }。它包含了一个叫作 photos 的嵌套 JSONObject
JSONObject photosJsonObject = jsonBody.getJSONObject("photos");

// 这个嵌套对象又包含了一个叫作 photo 的 JSONArray
JSONArray photoJsonArray = photosJsonObject.getJSONArray("photo");

// 这个嵌套数组中又包含了一组 JSONObject
// 这些 JSONObeject 就是要获取的一张张图片的元数据
for (int i = 0; i < photoJsonArray.length(); i++) {
    JSONObject photoJsonObject = photoJsonArray.getJSONObject(i);
    GalleryItem item = new GalleryItem();
    item.setId(photoJsonObject.getString("id"));
    item.setCaption(photoJsonObject.getString("title"));
    if (!photoJsonObject.has("url_s")) {
        continue;
    }
    item.setUrl(photoJsonObject.getString("url_s"));
    items.add(item);
}

解析完成后就可以在 AsyncTask 的 onPostExecute 中对 UI 进行更新了。

5. 挑战练习

本章的挑战练习难度依次递增，考验了我们很多知识。

5.1 使用 Gson 库解析 JSON 数据

Gson 是 Google 官方推荐的 JSON 解析库，使用 Gson 不用写任何解析代码，它能自动将 JSON 数据映射为 Java 对象。

5.1.1 添加 Gson 依赖

在 File -> Project Structure -> Dependencies 中添加 gson 依赖

5.1.2 构建对应的 POJO 类

由于不想更改原本的 GalleryItem 类，并且想让成员变量的命名符合 java 的命名规范，我使用了 @SerializedName() 注解，这个注解注明了 Gson 在转换时对应的键名。并且构建了一个新的类，用于匹配对应的 API 结构：

// PhotoBean.java

public class PhotoBean {

    public static final String STATUS_OK = "ok"
            , STATUS_FAILED = "fail";

    @SerializedName("photos")
    private PhotosInfo mPhotoInfo;
    @SerializedName("stat")
    private String mStatus;
    @SerializedName("message")
    private String mMessage;

    public class PhotosInfo {
        @SerializedName("photo")
        List<GalleryItem> mPhoto;

        public List<GalleryItem> getPhoto() {
            return mPhoto;
        }
    }
    // 省略 getter 和 setter
}

5.1.3 使用 Gson

Gson 的使用再简单不过了，与上面的代码相比有云泥之别：

PhotoBean photoBean = (PhotoBean) new Gson()
        .fromJson(jsonString, PhotoBean.class);

不过记得要抛出 JsonSyntaxException。

5.2 分页显示

这个挑战的需求是：如果我们下滑最底部，就在后面添加下一页的内容。
所以在 url 的生成中我们还要加入 page 这个参数。我加入了一个成员变量 mNextPage 用于记录下次要请求的页面， 然后添加了一个常量 MAX_PAGES 用于控制最大请求页数。

5.2.1 RecyclerView.onScrollListener

onScrollListener 有两个可以重写的方法，一个是 onScrollStateChanged()，还有一个是 onScrolled，对我们这个需求来说，显然 onScrollStateChanged 比较合适，ScrollState 也有三种：

• SCROLL_STATE_IDLE: 视图没有被拖动，处于静止
• SCROLL_STATE_DRAGGING： 视图正在拖动中
• SCROLL_STATE_SETTLING： 视图在惯性滚动

这个挑战最关键的就是如何判断滑到最底端。首先滑动到最底端时前两个状态其实都可以，但是滑动到最底这个信息只有 LayoutManager 知道，我们可以直接看代码分析：

private RecyclerView.OnScrollListener onButtomListener = 
		new RecyclerView.OnScrollListener() {
    @Override
    public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        // 首先获取 LayoutManager
        GridLayoutManager layoutManager = (GridLayoutManager) recyclerView.getLayoutManager();
        // 然后可以找到最后显示的位置，一旦滚动就会获取该位置
        mLastPosition = layoutManager.findLastCompletelyVisibleItemPosition();
        // 如果静止的时候最后的位置大于等于数据个数
        // 而且前一个任务完成时（防止多次重复）
        if (newState == RecyclerView.SCROLL_STATE_IDLE
                && mLastPosition >= mPhotoAdapter.getItemCount() - 1) {
            if (mFetchItemsTask.getStatus() == AsyncTask.Status.FINISHED) {
            	// 下一页加一，在小于最大页数时
            	// 弹出 Toast 表示正在加载
            	// 然后打开一个新任务，加载下一页
                mNextPage++;
                if (mNextPage <= MAX_PAGES) {
                    Toast.makeText(getActivity(), "waiting to load ……", Toast.LENGTH_SHORT).show();
                    // AsyncTask 只能执行一次，所以需要新建
                    mFetchItemsTask = new FetchItemsTask();
                    mFetchItemsTask.execute(mNextPage);
                } else {
                	// 滑到最底提示已经到头了
                    Toast.makeText(getActivity(), "This is the end!", Toast.LENGTH_SHORT).show();
                }
            }
        }
    }
};

5.2.2 添加数据并展示

我在 Adapter 中加入了一个 addData 方法，将新的数据加入到数据集中，然后使用 notifyDataSetChanged 方法更新视图。

然后修改了 setAdapter 方法：

private void setAdapter() {
    if (isAdded()) {
        if (mPhotoAdapter == null) {
            mPhotoAdapter = new PhotoAdapter(mItems);
            mPhotoRecyclerView.setAdapter(mPhotoAdapter);
            mPhotoRecyclerView.addOnScrollListener(onButtomListener);
        } else {
            mPhotoAdapter.addData(mItems);
        }
    }
}

5.3 动态调整网格列

使用 OnGlobalLayoutListener 即可：

mPhotoRecyclerView.getViewTreeObserver()
.addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
    @Override
    public void onGlobalLayout() {
		// 计算列数，以 1080p 屏幕显示3列为基准
        int columns = mPhotoRecyclerView.getWidth() / 350;
        // 重新设置 LayoutManager、Adapter 和 Listener
        mPhotoRecyclerView.setLayoutManager(new GridLayoutManager(getActivity(), columns));
        mPhotoRecyclerView.setAdapter(mPhotoAdapter);
        mPhotoRecyclerView.addOnScrollListener(onButtomListener);
        // 滚动到之前看到的位置
        mPhotoRecyclerView.getLayoutManager().scrollToPosition(mLastPosition);
        //将 GlobalLayoutListener 去掉以避免多次触发
        mPhotoRecyclerView.getViewTreeObserver().removeOnGlobalLayoutListener(this);
    }
});

---

GitHub Page: kniost.github.io
简书：http://www.jianshu.com/u/723da691aa42