網(wǎng)絡(luò)世界.jpg

• SAX解析方式
• 解析JSON格式數(shù)據(jù)
• 使用JSONObject
• 使用GSON
• 網(wǎng)絡(luò)編程的最佳實(shí)踐

9.4 SAX解析方式

<apps>
    <app>
        <id>1</id>
        <name>Google Maps</name>
        <version>1.0</version>
    </app>

    <app>
        <id>2</id>
        <name>Chrome</name>
        <version>2.1</version>
    </app>

    <app>
        <id>3</id>
        <name>Google Play</name>
        <version>2.3</version>
    </app>
</apps>

通常情況下我們都會(huì)新建一個(gè)類繼承自DefaultHandler,并重寫父類的5個(gè)方法。

public class ContentHandler extends DefaultHandler {

    private String nodeName;

    private StringBuilder id;

    private StringBuilder name;

    private StringBuilder version;

    private static final String TAG = "ContentHandler";

    // 文檔開始解析時(shí)調(diào)用春宣，該方法只會(huì)調(diào)用一次
    @Override
    public void startDocument() throws SAXException {
        id = new StringBuilder();
        name = new StringBuilder();
        version = new StringBuilder();
    }

    // 當(dāng)讀取到第一個(gè)元素時(shí)開始做什么
    @Override
    public void startElement(String uri, String localName, String qName, Attributes attributes) throws SAXException {
        //記錄當(dāng)前節(jié)點(diǎn)名
        nodeName = localName;
    }

    // 表示讀取字符串時(shí)做什么
    @Override
    public void characters(char[] ch, int start, int length) throws SAXException {
        //根據(jù)當(dāng)前的節(jié)點(diǎn)名判斷將內(nèi)容添加到哪一個(gè)StrignBuilder對(duì)象中
        if ("id".equals(nodeName))
        {
            id.append(ch,start,length);
        }
        else if ("name".equals(nodeName))
        {
            name.append(ch,start,length);
        }
        else if ("version".equals(nodeName))
        {
            version.append(ch, start, length);
        }
    }

    // 表示讀取到元素結(jié)尾
    @Override
    public void endElement(String uri, String localName, String qName) throws SAXException {
        if ("app".equals(localName)) {
            Log.d(TAG, "id is : "+id.toString().trim());
            Log.d(TAG, "name is : "+name.toString().trim());
            Log.d(TAG, "version is : "+version.toString().trim());

            //最后要將StringBuilder清空掉
            id.setLength(0);
            name.setLength(0);
            version.setLength(0);
        }
    }

    // 表示讀取到文檔結(jié)尾
    @Override
    public void endDocument() throws SAXException {
        super.endDocument();
    }
}

startDocument()方法會(huì)在開始XML解析的時(shí)候調(diào)用。

startElement()方法會(huì)在開始解析某個(gè)節(jié)點(diǎn)的時(shí)候調(diào)用。

character()方法會(huì)在獲取節(jié)點(diǎn)中內(nèi)容的時(shí)候調(diào)用。

endElement()方法會(huì)在完成解析某個(gè)節(jié)點(diǎn)的時(shí)候調(diào)用杉辙。

endDocument()方法會(huì)在完成整個(gè)XML解析的時(shí)候調(diào)用墙杯。

其中startElement(),characters()和endElement()這三個(gè)方法是有參數(shù)的，從XML中解析出來的數(shù)據(jù)就會(huì)以參數(shù)的形式傳入到這些方法中光酣。

需要注意的是，在獲取節(jié)點(diǎn)中的內(nèi)容時(shí)脉课，characters()方法可能會(huì)被調(diào)用多次救军，一些換行符也被當(dāng)作內(nèi)容解析出來财异，我們需要針對(duì)這種情況在代碼中做好控制。

我們首先給id,name和version節(jié)點(diǎn)分別定義了一個(gè)StringBuilder對(duì)象唱遭，并在startDocument()方法中對(duì)它們進(jìn)行初始化戳寸。每當(dāng)開始解析某個(gè)節(jié)點(diǎn)的時(shí)候，startElement()方法就會(huì)得到調(diào)用拷泽，其中localName參數(shù)記錄著當(dāng)前節(jié)點(diǎn)的名字疫鹊，這里我們把它記錄下來。

接著在解析節(jié)點(diǎn)中具體內(nèi)容的時(shí)候就會(huì)調(diào)用characters()方法司致，我們會(huì)根據(jù)當(dāng)前的節(jié)點(diǎn)名進(jìn)行判斷拆吆，將解析出的內(nèi)容添加到哪一個(gè)StringBuilder對(duì)象中。

最后在endElement()方法中進(jìn)行判斷蚌吸，如果app節(jié)點(diǎn)已經(jīng)解析完成锈拨，就打印出id,name和version的內(nèi)容。需要注意的是羹唠，目前id,name和version中都可能是包括回車或換行符的奕枢，因此在打印之前我們還需要調(diào)用一下trim()方法，并且打印完成后還要將StringBuilder的內(nèi)容清空掉佩微，不然的話會(huì)影響下一次內(nèi)容的讀取缝彬。

private void parseXMlWithSAX(String xmlData) {
        try {
            SAXParserFactory factory = SAXParserFactory.newInstance();
            XMLReader xmlReader = factory.newSAXParser().getXMLReader();
            ContentHandler handler = new ContentHandler();
            //將ContentHandler的實(shí)例設(shè)置到XMLReader中
            xmlReader.setContentHandler(handler);
            //開始執(zhí)行解析
            xmlReader.parse(new InputSource(new StringReader(xmlData)));
        }catch (Exception e) {
            e.printStackTrace();
        }
    }

parseXMLWithSAX()方法中先是創(chuàng)建了一個(gè)SAXParserFactory的對(duì)象，然后在獲取到XMLReader對(duì)象哺眯，接著將我們編寫的ContentHandler實(shí)例設(shè)置到XMLReader中谷浅，最后調(diào)用parse()方法開始執(zhí)行解析就好了。

9.4 解析JSON格式數(shù)據(jù)

比起XML奶卓，JSON的主要優(yōu)勢(shì)在于它的體積更小一疯，在網(wǎng)絡(luò)上傳輸?shù)臅r(shí)候可以更省流量。但缺點(diǎn)在于它的語意性較差夺姑，看起來不如XML直觀墩邀。

[{"id":"5","version":"5.5","name":"Clash of Clans"},
{"id":"6","version":"7.0","name":"Boom Beach"},
{"id":"7","version":"3.5","name":"Clash Royale"}]

9.4.1 使用JSONObject

解析JSON數(shù)據(jù)也有很多種方法，可以使用官方提供的JSONObject盏浙，也可以使用谷歌的開源庫GSON眉睹。另外，一些第三方的開源庫如Jackson,FastJSON等也非常不錯(cuò)废膘。

由于我們?cè)诜?wù)器中定義的是一個(gè)JSON數(shù)組竹海，因此這里首先是將服務(wù)器返回的數(shù)據(jù)傳入到了一個(gè)JSONArray對(duì)象中。然后循環(huán)遍歷這個(gè)JSONArray丐黄，從中取出的每一個(gè)元素都是一個(gè)JSONObject對(duì)象斋配，每個(gè)JSONObject對(duì)象中又會(huì)包含id,name和version這些數(shù)據(jù)。接下來只需要調(diào)用getString()方法將這些數(shù)據(jù)取出。

9.4.2 使用GSON

不過GSON并沒有被添加到Android官方的API中许起，因此如果想要使用這個(gè)功能的話十偶，就必須要在項(xiàng)目中添加GSON庫的依賴菩鲜。

compile 'com.google.code.gson:gson:2.8.0'

它主要就是可以將一段JSON格式的字符串自動(dòng)映射成一個(gè)對(duì)象园细，從而不需要我們?cè)偈謩?dòng)去編寫代碼進(jìn)行解析了。

比如說一段JSON格式的數(shù)據(jù)如下所示：

{"name":"Tom","age":"20"}

那我們就可以定義一個(gè)Person類接校，并加入name和age這兩個(gè)字段猛频，然后只需簡(jiǎn)單地調(diào)用如下代碼就可以將JSON數(shù)據(jù)自動(dòng)解析成一個(gè)Person對(duì)象了：

Gson gson = new Gson();
Person person = gson.fronJson(jsonData,Person.class);

如果需要解析的是一段JSON數(shù)組會(huì)稍微麻煩一點(diǎn)，我們需要借助TypeToken將期望解析成的數(shù)據(jù)類型傳入到fromJson()方法中蛛勉。

List<Person> people = gson.fromJson(jsonData,new TypeToken<List<Person>>().getType());

//使用GSON解析數(shù)據(jù)
    private void parseJSONWithGSON(String jsonData)
    {
        Gson gson = new Gson();
        List<App> appList = gson.fromJson(jsonData,new TypeToken<List<App>>(){}.getType());
        for(App app : appList)
        {
            Log.d(TAG, "id is : "+app.getId());
            Log.d(TAG, "name is : "+app.getName());
            Log.d(TAG, "version is : "+app.getVersion());
        }
    }

9.5 網(wǎng)絡(luò)編程的最佳實(shí)踐

一個(gè)應(yīng)用程序很可能會(huì)在許多地方都使用到網(wǎng)絡(luò)功能鹿寻，而發(fā)送HTTP請(qǐng)求的代碼基本都是相同的。如果我們每次都去編寫一遍發(fā)送HTTP請(qǐng)求的代碼诽凌，這顯然是非常差勁的做法毡熏。

通常情況下我們都應(yīng)該將這些通用的網(wǎng)絡(luò)操作提取到一個(gè)公共的類里，并提供一個(gè)靜態(tài)方法侣诵，當(dāng)想要發(fā)清網(wǎng)絡(luò)請(qǐng)求的時(shí)候痢法，只需要簡(jiǎn)單地調(diào)用一下這個(gè)方法即可。

但是需要注意杜顺，網(wǎng)絡(luò)請(qǐng)求通常都是屬于耗時(shí)操作财搁，而sendHttpRequest()方法的內(nèi)部并沒有開啟線程，這樣就有可能導(dǎo)致在調(diào)用sendHttpRequest()方法的時(shí)候使得主線程被阻塞住躬络。

如果我們?cè)趕endHttpRequest()方法中開啟了一個(gè)線程來發(fā)起HTTP請(qǐng)求尖奔，那么服務(wù)器響應(yīng)的數(shù)據(jù)是無法進(jìn)行返回的，所有的耗時(shí)邏輯都是在子線程里進(jìn)行的穷当，sendHttpRequest()方法會(huì)在服務(wù)器還沒來得及響應(yīng)的時(shí)候就執(zhí)行結(jié)束了提茁，當(dāng)然也就無法返回響應(yīng)的邏輯了。

其實(shí)解決邏輯并不難馁菜，只需要使用Java的回調(diào)機(jī)制就可以了茴扁。

首先需要定義一個(gè)接口

public interface HttpCallbackListener
{
    void onFinish(String response);
    void onError(Exception e);
}

我們?cè)诮涌谥卸x了兩個(gè)方法，onFinish()方法表示當(dāng)服務(wù)器成功響應(yīng)我們請(qǐng)求的時(shí)候調(diào)用火邓，onError()表示當(dāng)進(jìn)行網(wǎng)絡(luò)操作出現(xiàn)錯(cuò)誤的時(shí)候調(diào)用丹弱。這兩個(gè)方法都帶有參數(shù)，onFinish()方法中的參數(shù)代表著服務(wù)器返回的數(shù)據(jù)铲咨，而onError()方法中的參數(shù)記錄著錯(cuò)誤的詳細(xì)信息躲胳。

public class HttpUtil
{
    public static void sendHttpRequest(final String address,final
            HttpCallbackListener listener)
    {
        new Thread(new Runnable()
        {
            @Override
            public void run()
            {
                HttpURLConnection connection = null;
                try
                {
                    URL url = new URL(address);
                    connection = (HttpURLConnection) url.openConnection();
                    connection.setRequestMethod("GET");
                    connection.setConnectTimeout(8000);
                    connection.setReadTimeout(8000);
                    connection.setDoInput(true);
                    connection.setDoOutput(true);
                    InputStream in = connection.getInputStream();
                    BufferedReader reader = new BufferedReader(new InputStreamReader(in));
                    StringBuilder response = new StringBuilder();
                    String line;
                    while ((line = reader.readLine()) != null)
                    {
                        response.append(line);
                    }
                    if (listener != null)
                    {
                        //回調(diào)onFinish()方法
                        listener.onFinish(response.toString());
                    }
                } catch (Exception e)
                {
                    if (listener != null)
                    {
                        //回調(diào)onError()方法
                        listener.onError(e);
                    }
                } finally
                {
                    if (connection != null)
                    {
                        connection.disconnect();
                    }
                }
            }
        }).start();
    }
}

我們首先給sendHttpRequest()方法添加了一個(gè)HttpCallbackListener參數(shù)，并在方法的內(nèi)部開啟了一個(gè)子線程纤勒，然后在子線程里去執(zhí)行具體的網(wǎng)絡(luò)操作坯苹。注意，子線程中是無法通過return語句來返回?cái)?shù)據(jù)的摇天，因此這里我們將服務(wù)器響應(yīng)的數(shù)據(jù)傳入了HttpCallbackListener的onFinish()方法中粹湃，如果出現(xiàn)了異常就將異常原因傳入到onError()方法中恐仑。

HttpUtil.sendHttpRequest("www.baidu.com", new HttpCallbackListener()
                {
                    @Override
                    public void onFinish(String response)
                    {
                        //在這里根據(jù)返回內(nèi)容執(zhí)行具體的邏輯
                    }

                    @Override
                    public void onError(Exception e)
                    {
                        //在這里對(duì)異常情況進(jìn)行處理
                    }
                });

在HttpUtil中加入一個(gè)sendOkHttpRequest()方法

 public static void sendOkHttpRequest(String address, Callback callback)
    {
        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder()
                .url(address)
                .build();
        client.newCall(request).enqueue(callback);
    }

sendOkHttpRequest()方法中有一個(gè)okhttp3.Callback參數(shù)，這個(gè)是OkHttp庫中自帶的一個(gè)回調(diào)接口为鳄，類似與我們剛才自己編寫的HttpCallbackListener裳仆。然后在client.newCall()之后沒有像之前那樣一直調(diào)用execute()方法，而是調(diào)用了一個(gè)enqueue()方法孤钦，并把okhttp3.Callback參數(shù)傳入歧斟。相信聰明的你已經(jīng)猜到了，OkHttp在enqueue()方法的內(nèi)部已經(jīng)幫我們開好子線程了偏形，然后會(huì)在子線程中去執(zhí)行HTTP請(qǐng)求静袖，并將最終的請(qǐng)求結(jié)果回調(diào)到okhttp3.Callback當(dāng)中。

那么我們?cè)谡{(diào)用sendOkHttpRequest()方法的時(shí)候就可以這樣寫：

HttpUtil.sendOkHttpRequest("www.baidu.com", new Callback()
                {
                    @Override
                    public void onResponse(Call call, Response response) throws IOException
                    {
                        //得到服務(wù)器返回的具體內(nèi)容
                        String responseData = response.body().string();
                    }
                    @Override
                    public void onFailure(Call call, IOException e)
                    {
                        //在這里對(duì)異常情況進(jìn)行處理
                    }


                });

另外需要注意的是俊扭，不管是使用HttpURLConnection還是OkHttp,最終的回調(diào)接口都還是在子線程中運(yùn)行的队橙，因此我們不可以在這里執(zhí)行任何的UI操作，除非借助runOnUiThread()方法來進(jìn)行線程轉(zhuǎn)換萨惑。