android開發學習之路——天氣預報之遍歷省市縣數據（二）

    我們已經知道省市縣的數據都是從服務器端獲取到的，因此與服務器的交互是必不可少的，我們再util包下增加一個HttpUtil類，代碼如下所示：

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

    由於Okhttp的出色封裝，這里和服務器進行交互的代碼非常簡單，僅僅3行就完成了。現在我們發起一條HTTP請求只需要調用sendOkHttpRequest（）方法，傳入請求地址，並注冊一個回調來處理服務器響應就可以了。

    由於服務器返回的省市縣數據都是JSON格式的，所以我們再提供一個工具類來解析和處理這種數據。在util包下新建一個Utility類，代碼如下：

public class Utility {

    /**
     * 解析和處理服務器返回的省級數據
     */
    public static boolean handleProvinceResponse(String response) {
        if (!TextUtils.isEmpty(response)) {
            try {
                JSONArray allProvinces = new JSONArray(response);
                for (int i = 0; i < allProvinces.length(); i++) {
                    JSONObject provinceObject = allProvinces.getJSONObject(i);
                    Province province = new Province();
                    province.setProvinceName(provinceObject.getString("name"));
                    province.setProvinceCode(provinceObject.getInt("id"));
                    province.save();
                }
                return true;
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
        return false;
    }

    /**
     * 解析和處理服務器返回的市級數據
     */
    public static boolean handleCityResponse(String response, int provinceId) {
        if (!TextUtils.isEmpty(response)) {
            try {
                JSONArray allCities = new JSONArray(response);
                for (int i = 0; i < allCities.length(); i++) {
                    JSONObject cityObject = allCities.getJSONObject(i);
                    City city = new City();
                    city.setCityName(cityObject.getString("name"));
                    city.setCityCode(cityObject.getInt("id"));
                    city.setProvinceId(provinceId);
                    city.save();
                }
                return true;
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
        return false;
    }

    /**
     * 解析和處理服務器返回的縣級數據
     */
    public static boolean handleCountyResponse(String response, int cityId) {
        if (!TextUtils.isEmpty(response)) {
            try {
                JSONArray allCounties = new JSONArray(response);
                for (int i = 0; i < allCounties.length(); i++) {
                    JSONObject countyObject = allCounties.getJSONObject(i);
                    County county = new County();
                    county.setCountyName(countyObject.getString("name"));
                    county.setWeatherId(countyObject.getString("weather_id"));
                    county.setCityId(cityId);
                    county.save();
                }
                return true;
            } catch (JSONException e) {
                e.printStackTrace();
            }
        }
        return false;
    }

｝

    可以看到，我們提供了handleProvincesResponse()、handleCitiesResponse()、handleCountiesResponse()這3個方法，分別用於解析和處理服務器返回的省級、市級和縣級數據。處理的方法是類似的，先使用JSONArray和JSONObject將數據解析出來，然后組裝成實體類對象，再調用save()方法將數據存儲到數據庫當中。

    工具類准備好了，現在開始寫界面。由於遍歷全國省市縣的功能我們后面還會復用，因此寫在碎片里，這樣復用的時候，直接在布局里引用碎片就可以了。

    在res/layout目錄中新建choose_area.xml布局，代碼如下所示：

<LinearLayout
  xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_height="match_parent"    
    android:layout_width="match_parent"
    android:background="#fff "  >
    <RelativeLayout  
        android:layout_height="?attr/actionBarSize"
        android:layout_width="match_parent
        android:background="?attr/colorPrimary""> 
        <TextView 
           android:id="@+id/title_text"
           android:layout_height="wrap_content"
           android:layout_width="wrap_content"
           android:textSize="20sp" 
           android:textColor="#fff"
           android:layout_centerInParent="true" /> 
        <Button 
           android:id="@+id/back_button" 
           android:layout_height="25dp" 
           android:layout_width="25dp"
           android:layout_centerVertical="true"
           android:layout_alignParentLeft="true"
           android:layout_marginLeft="10dp"
           android:background="@drawable/ic_back"/> 
    </RelativeLayout> 
    <ListView 
        android:id="@+id/list_view"
        android:layout_height="match_parent"
        android:layout_width="match_parent"/> 
</LinearLayout>

    布局文件中的內容並不復雜，我們先定義了一個頭布局作為標題欄，將布局高度設置為actionBar的高度，背景色設置為colorPrimary。然后在頭布局中放置一個TextView用於顯示標題內容，放置了一個Button用於執行返回操作，注意我已經提前准備好了一張ic_back.png圖片作為按鈕的背景圖。這里之所以要自己定義標題欄，是因為碎片中最好不要直接使用ActionBar或Toolbar，不然在復用的時候可能出現一些你不想看到的效果。

    接下來在頭布局的下面定義了一個ListView，省市縣的數據就將顯示在這里。之所以這次使用ListView，是因為它會自動給每個子項之間添加一條分割線，而如果使用RecyclerView想實現同樣的功能則會比較麻煩，這里我們總是選擇最優的實現方案。

    接下來我們需要編寫用於遍歷省市縣數據的碎片了。新建ChooseAreaFragment繼承自Fragment，代碼如下：

public class ChooseAreaFragment extends Fragment {

    private static final String TAG = "ChooseAreaFragment";

    public static final int LEVEL_PROVINCE = 0;

    public static final int LEVEL_CITY = 1;

    public static final int LEVEL_COUNTY = 2;

    private ProgressDialog progressDialog;

    private TextView titleText;

    private Button backButton;

    private ListView listView;

    private ArrayAdapter<String> adapter;

    private List<String> dataList = new ArrayList<>();

    /**
     * 省列表
     */
    private List<Province> provinceList;

    /**
     * 市列表
     */
    private List<City> cityList;

    /**
     * 縣列表
     */
    private List<County> countyList;

    /**
     * 選中的省份
     */
    private Province selectedProvince;

    /**
     * 選中的城市
     */
    private City selectedCity;

    /**
     * 當前選中的級別
     */
    private int currentLevel;


    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.choose_area, container, false);
        titleText = (TextView) view.findViewById(R.id.title_text);
        backButton = (Button) view.findViewById(R.id.back_button);
        listView = (ListView) view.findViewById(R.id.list_view);
        adapter = new ArrayAdapter<>(getContext(), android.R.layout.simple_list_item_1, dataList);
        listView.setAdapter(adapter);
        return view;
    }

    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
                if (currentLevel == LEVEL_PROVINCE) {
                    selectedProvince = provinceList.get(position);
                    queryCities();
                } else if (currentLevel == LEVEL_CITY) {
                    selectedCity = cityList.get(position);
                    queryCounties();
                } else if (currentLevel == LEVEL_COUNTY) {
                    String weatherId = countyList.get(position).getWeatherId();
                    if (getActivity() instanceof MainActivity) {
                        Intent intent = new Intent(getActivity(), WeatherActivity.class);
                        intent.putExtra("weather_id", weatherId);
                        startActivity(intent);
                        getActivity().finish();
                    } else if (getActivity() instanceof WeatherActivity) {
                        WeatherActivity activity = (WeatherActivity) getActivity();
                        activity.drawerLayout.closeDrawers();
                        activity.swipeRefresh.setRefreshing(true);
                        activity.requestWeather(weatherId);
                    }
                }
            }
        });
        backButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (currentLevel == LEVEL_COUNTY) {
                    queryCities();
                } else if (currentLevel == LEVEL_CITY) {
                    queryProvinces();
                }
            }
        });
        queryProvinces();
    }

    /**
     * 查詢全國所有的省，優先從數據庫查詢，如果沒有查詢到再去服務器上查詢。
     */
    private void queryProvinces() {
        titleText.setText("中國");
        backButton.setVisibility(View.GONE);
        provinceList = DataSupport.findAll(Province.class);
        if (provinceList.size() > 0) {
            dataList.clear();
            for (Province province : provinceList) {
                dataList.add(province.getProvinceName());
            }
            adapter.notifyDataSetChanged();
            listView.setSelection(0);
            currentLevel = LEVEL_PROVINCE;
        } else {
            String address = "http://guolin.tech/api/china";
            queryFromServer(address, "province");
        }
    }

    /**
     * 查詢選中省內所有的市，優先從數據庫查詢，如果沒有查詢到再去服務器上查詢。
     */
    private void queryCities() {
        titleText.setText(selectedProvince.getProvinceName());
        backButton.setVisibility(View.VISIBLE);
        cityList = DataSupport.where("provinceid = ?", String.valueOf(selectedProvince.getId())).find(City.class);
        if (cityList.size() > 0) {
            dataList.clear();
            for (City city : cityList) {
                dataList.add(city.getCityName());
            }
            adapter.notifyDataSetChanged();
            listView.setSelection(0);
            currentLevel = LEVEL_CITY;
        } else {
            int provinceCode = selectedProvince.getProvinceCode();
            String address = "http://guolin.tech/api/china/" + provinceCode;
            queryFromServer(address, "city");
        }
    }

    /**
     * 查詢選中市內所有的縣，優先從數據庫查詢，如果沒有查詢到再去服務器上查詢。
     */
    private void queryCounties() {
        titleText.setText(selectedCity.getCityName());
        backButton.setVisibility(View.VISIBLE);
        countyList = DataSupport.where("cityid = ?", String.valueOf(selectedCity.getId())).find(County.class);
        if (countyList.size() > 0) {
            dataList.clear();
            for (County county : countyList) {
                dataList.add(county.getCountyName());
            }
            adapter.notifyDataSetChanged();
            listView.setSelection(0);
            currentLevel = LEVEL_COUNTY;
        } else {
            int provinceCode = selectedProvince.getProvinceCode();
            int cityCode = selectedCity.getCityCode();
            String address = "http://guolin.tech/api/china/" + provinceCode + "/" + cityCode;
            queryFromServer(address, "county");
        }
    }

    /**
     * 根據傳入的地址和類型從服務器上查詢省市縣數據。
     */
    private void queryFromServer(String address, final String type) {
        showProgressDialog();
        HttpUtil.sendOkHttpRequest(address, new Callback() {
            @Override
            public void onResponse(Call call, Response response) throws IOException {
                String responseText = response.body().string();
                    boolean result = false;
                if ("province".equals(type)) {
                    result = Utility.handleProvinceResponse(responseText);
                } else if ("city".equals(type)) {
                    result = Utility.handleCityResponse(responseText, selectedProvince.getId());
                } else if ("county".equals(type)) {
                    result = Utility.handleCountyResponse(responseText, selectedCity.getId());
                }
                if (result) {
                    getActivity().runOnUiThread(new Runnable() {
                        @Override
                        public void run() {
                            closeProgressDialog();
                            if ("province".equals(type)) {
                                queryProvinces();
                            } else if ("city".equals(type)) {
                                queryCities();
                            } else if ("county".equals(type)) {
                                queryCounties();
                            }
                        }
                    });
                }
            }

            @Override
            public void onFailure(Call call, IOException e) {
                // 通過runOnUiThread()方法回到主線程處理邏輯
                getActivity().runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        closeProgressDialog();
                        Toast.makeText(getContext(), "加載失敗", Toast.LENGTH_SHORT).show();
                    }
                });
            }
        });
    }

    /**
     * 顯示進度對話框
     */
    private void showProgressDialog() {
        if (progressDialog == null) {
            progressDialog = new ProgressDialog(getActivity());
            progressDialog.setMessage("正在加載...");
            progressDialog.setCanceledOnTouchOutside(false);
        }
        progressDialog.show();
    }

    /**
     * 關閉進度對話框
     */
    private void closeProgressDialog() {
        if (progressDialog != null) {
            progressDialog.dismiss();
        }
    }

}

   這個類里的代碼非常多，但邏輯並不復雜。在onCreateView（）方法中先是獲取到了一些控件的實例，然后去初始化ArrayAdapter，並將它設置為ListView的適配器。接着在onActivityCreated（）方法中給ListView和Button設置了點擊事件，到這初始工作算是完成。

    在onAcivityCreated（）方法的最后，調用了queryProvinces（）方法，也就是從這里開始加載省級數據的。queryProvinces（）方法中首先會將頭布局的標題設置成中國，將返回按鈕隱藏起來，因為省級列表已經不能再返回了。然后調用LitePal的查詢接口來從數據庫中讀取省級數據，如果讀取到了就直接將數據顯示到界面上，如果沒有，就組裝出一個請求地址，然后調用queryFromServer（）方法來從服務器上查詢數據。

    queryFromServer（）方法會調用HttpUtil的sendOkHttpRequest（）方法來向服務器發送請求，響應的數據會回調到onResponse()方法中，然后我們在這里去調用Utility的handleProvincesResponse（）方法來解析和處理服務器返回的數據，並存儲到數據庫中。在解析和處理完數據之后，我們再次調用了queryProvinces（）方法來重新加載省級數據，由於queryProvinces（）方法牽扯到了UI操作，因此必須要在主線程中調用，，這里借助了runOnUiThread（）方法來實現從子線程切換到主線程。現在數據庫中已經存在了數據，因此調用queryProvinces（）就會直接將數據顯示到界面上了。

    當你點擊了某個省的時候會進入到ListView的onItemClick（）方法中，這個時候會根據當前的級別來判斷是去調用queryCities（）方法還是queryCounties（）方法，queryCities（）方法是去查詢市級數據，而queryCounties（）方法是去查詢縣級數據。

    另外，在返回按鈕的點擊事件里，會對當前ListView的列表級別進行判斷。如果當前是縣級列表，那么就返回到市級列表，如果當前是市級列表，那么就返回到省級列表。當返回到省級列表時，返回按鈕會自動隱藏。

    這樣我們就把遍歷省市縣的功能完成了，但碎片不能直接顯示在界面上的，因為我們需要將它添加到活動當中。修改activity_main.xml中的代碼，如下所示：

<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_height="match_parent"
    android:layout_width="match_parent" > 
    <fragment 
        android:id="@+id/choose_area_fragment"
        android:name="com.coolweather.android.ChooseAreaFragment"
        android:layout_height="match_parent"
        android:layout_width="match_parent"  />
 </FrameLayout>

    定義了一個FrameLayout，然后將ChooseAreaFragment添加進來，並讓它充滿整個布局。

    另外，我們剛才在碎片的布局里面已經自定義了一個標題欄，因此就不再需要原生的AcitonBar了，修改res/values/styles.xml中的代碼，如下所示：

<resources> 
    <!-- Base application theme. -->
    <style parent="Theme.AppCompat.Light.NoActionBar">
         .... 
     </style>
</resources>

     接下來聲明程序所需要的權限。修改AndroidManifest.xml中的代碼，如下所示：

<manifest 
    package="com.coolweather.android"
    xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.INTERNET"/>
    .... 
</manifest>

    由於我們是通過網絡接口來獲取全國省市縣數據的，因此必須要添加訪問網絡的權限才行。

    下一章節設計並編寫顯示天氣信息的布局和功能。

 

具體實現步驟連接：

android開發學習之路——天氣預報之技術分析與數據庫（一）

android開發學習之路——天氣預報之遍歷省市縣數據（二）

android開發學習之路——天氣預報之顯示天氣信息（三）

android開發學習之路——天氣預報之手動更新天氣和切換城市（四）

android開發學習之路——天氣預報之后台自動更新天氣（五）