重构了XmlDownloader类

用了建造者模式。

在公交车上考虑了两天，在脑子里大概画了个雏形，然后今晚解决了一些细节上的问题。

不废话，发代码：

  1 package com.mlxy.xml;
  2 
  3 import java.io.BufferedReader;
  4 import java.io.BufferedWriter;
  5 import java.io.File;
  6 import java.io.FileOutputStream;
  7 import java.io.InputStream;
  8 import java.io.InputStreamReader;
  9 import java.io.OutputStreamWriter;
 10 import java.net.MalformedURLException;
 11 import java.net.URL;
 12 
 13 import android.content.Context;
 14 import android.os.Environment;
 15 
 16 import com.mlxy.util.CharacterProcesser;
 17 
 18 /**
 19  * Xml文件下载器，重构完成。
 20  * 
 21  * @author mlxy
 22  * @version 1.1
 23  * */
 24 public class XmlDownloader {
 25     private Context parent;
 26     
 27     private String cityName = "南昌";
 28     private String city = CharacterProcesser.encodeByGB2312(cityName);
 29     private String password = "DJOYnieT8234jlsK";
 30     private int day = 0;
 31     private String link = "http://php.weather.sina.com.cn/xml.php?city=" + city
 32             + "&password=" + password + "&day=" + day;
 33     
 34     /** 私有构造方法，避免被外部实例化。*/
 35     private XmlDownloader() {
 36     }
 37     
 38     /** 根据给定的链接下载对应的xml文件。
 39      * 
 40      * @param link API的链接，需要标明网络协议。*/
 41     private void downloadXml(String link) {
 42         // 用链接字符串new出URL对象
 43         URL url = null;
 44         try {
 45             url = new URL(link);
 46         } catch (MalformedURLException e) {
 47             e.printStackTrace();
 48         }
 49 
 50         // 获取外部存储路径并创建文件对象。
 51         File externalDirectory = Environment.getExternalStorageDirectory();
 52         String fileName = "xml_resource.xml";
 53         File file = new File(externalDirectory, fileName);
 54 
 55         // 写文件。
 56         
 57         // 初始化io流。
 58         InputStream in = null;
 59         BufferedReader reader = null;
 60         FileOutputStream out = null;
 61         BufferedWriter writer = null;
 62         
 63         try {
 64             
 65             // 建立连接并给io流赋值。
 66             in = (InputStream) url.getContent();
 67             reader = new BufferedReader(new InputStreamReader(in, "iso-8859-1"));
 68             out = this.parent.openFileOutput(file.getName(), Context.MODE_PRIVATE);
 69             writer = new BufferedWriter(new OutputStreamWriter(out, "iso-8859-1"));
 70             
 71             // 读一行写一行，然后另起一行。
 72             String line = null;
 73             while ((line = reader.readLine()) != null) {
 74                 writer.write(line);
 75                 writer.newLine();
 76             }
 77             
 78         } catch (Exception e) {
 79             e.printStackTrace();
 80         } finally {
 81             try {
 82                 // 释放资源
 83                 writer.flush();
 84                 writer.close();
 85                 out.close();
 86                 reader.close();
 87                 in.close();
 88             } catch (Exception e2) {
 89                 e2.printStackTrace();
 90             }
 91         }
 92     }
 93     
 94     private void setParent(Context parent) {
 95         this.parent = parent;
 96     }
 97     
 98     private void setCity(String cityName) {
 99         this.cityName = cityName;
100     }
101     
102     private void setPassword(String password) {
103         this.password = password;
104     }
105     
106     private void setDay(int day) {
107         this.day = day;
108     }
109     
110     private String getLink() {
111         return this.link;
112     }
113     
114     public static class Builder {
115         /** 储存好的一个实例，留待建造完毕后返回。*/
116         private XmlDownloader instance = new XmlDownloader();
117         
118         /** 构造函数，需要输入启动此构造器的上下文视图作为参数。*/
119         public Builder(Context parent) {
120             instance.setParent(parent);
121         }
122         
123         /** 设置城市名。</br>
124          * 默认值为<b>南昌</b>。
125          * 
126          * @param cityName 城市名
127          * @return 构造器本身
128          */
129         public Builder setCity(String cityName) {
130             instance.setCity(cityName);
131             return this;
132         }
133         
134         /** 设置密码。</br>
135          * 默认值为<b>DJOYnieT8234jlsK</b>。
136          * 
137          * @param password API密码
138          * @return 构造器本身
139          */
140         public Builder setPassword(String password) {
141             instance.setPassword(password);
142             return this;
143         }
144         
145         /** 设置日期。</br>
146          * 默认值为<b>0</b>，也即是<b>今天</b>。</br>
147          * 以此类推。
148          * 
149          * @param day 日子，0为当天，范围在0-4
150          * @return 构造器本身
151          */
152         public Builder setDay(int day) {
153             instance.setDay(day);
154             return this;
155         }
156         
157         /** 用已经设置好的或默认的参数下载XML文件。*/
158         public void download() {
159             String link = instance.getLink();
160             instance.downloadXml(link);
161         }
162     }
163 }

需要结合前面几篇博文看

场景类则这么调用：

 构建Xml下载器并下载Xml文件。
new XmlDownloader.Builder(MainActivity.this)
        .setCity("南昌")
        .setPassword("DJOYnieT8234jlsK")
        .setDay(0)
        .download();

具体实现方式参考了安卓的Toast和Dialog等几个类。

纠结了一天要不要给建造者提供默认值，就是说在用户没有自己设定参数的情况下是直接返回null还是用默认值来处理。

白天一直想着，不能惯用户的毛病。

然后到了晚上，我一想，用户不就是我么，除了我谁还用我写的这个类，就果断用了默认值。

另外，因为XmlDownloader这个类是不需要实例的，所以：

　　1. 把无参构造函数限制成了私有的，这样别人就没法访问构造函数，也就没法实例化它。

　　2. 去掉了几乎所有getter方法，同时把所有方法和属性定为私有的，因为不会存在任何XmlDownloader对象，也就没有必要对外开放任何接口。

　　2.3.3 求不提反射。

　　3. 要记得给Builder类加上static关键字，因为我们需要通过外部类来直接访问它，如果忘了的话，就会出现这样的一个错误：

No enclosing instance of type XmlDownloader is accessible. Must qualify the allocation with an enclosing instance of type XmlDownloader (e.g. x.new A() where x is an instance of XmlDownloader).

总的来说还是挺好用的，而且也不难，最关键的是

优雅！

用了设计模式之后我整个人都升华了你知道吗