Android（java）学习笔记205：网易新闻RSS客户端应用编写逻辑过程

1.我们的项目需求是编写一个新闻RSS浏览器，RSS(Really Simple Syndication)是一种描述和同步网站内容的格式，是使用最广泛的XML应用。RSS目前广泛用于网上新闻频道，blog和wiki，主要的版本有0.91, 1.0, 2.0。使用RSS订阅能更快地获取信息，网站提供RSS输出，有利于让用户获取网站内容的最新更新。网络用户可以在客户端借助于支持RSS的聚合工具软件，在不打开网站内容页面的情况下阅读支持RSS输出的网站内容。

例如如下的网易RSS订阅：

2.由于我们这里是模拟Android手机APP访问获取服务器里面的数据的工作场景，所以我们这里在电脑上模拟一个服务器环境，这里我们安装Apache（web服务器软件）：

       Apache HTTP Server（简称Apache）是Apache软件基金会的一个开放源码的网页服务器，可以在大多数计算机操作系统中运行，由于其多平台和安全性被广泛使用，是最流行的Web服务器端软件之一。它快速、可靠并且可通过简单的API扩展，将Perl/Python等解释器编译到服务器中。[2]

Apache HTTP服务器是一个模块化的服务器，源于NCSAhttpd服务器，经过多次修改，成为世界使用排名第一的Web服务器软件。

它可以运行在几乎所有广泛使用的计算机平台上。

 

3.安装配置好了Apache之后；我们这里编写一个news.xml文件，放在了Apache安装目录下htdocs文件下，图片资源放在img文件夹内部，如下：

 

 

 

打开news.xml文件内容如下：

 

 

打开img文件夹如下：

我们开启Apache服务：

 

 

 

打开360浏览器，输入网址http://localhost/news.xml，结果如下：

 

 

上面页面出现，说明我们通过电脑浏览器访问PC模拟的Apache服务器数据是可以的，Apache服务器是配置成功的.

 

 

4.接下来，我们开始真正开始编写手机Android 网易RSS新闻阅读器如下：

（1）使用Eclipse新建一个Android工程，命名为" 网易新闻客户端 "，MainActivity.java在com.himi.news包下，如下：

 

 

（2）我们不着急编写布局文件activity_main.xml文件，我们这里需要使用网络，在相应的网络路径下，获取新闻文件信息。

       • 我们有必要编写一个业务逻辑类去实现获取新闻信息；      （这里就是com.himi.news.net包下的：NewsUtils）

       • 获取到新闻信息需要在本地存放起来（写入内存），方便读取新闻信息。所以这里我们也需要编写一个信息数据类存放数据用的；（这里就是com.himi.news.domain包下的：NewsItem）

 

->1:首先我们编写一个业务工具类去获取新闻信息：

 package com.himi.news.net;
 import java.io.InputStream;
 import java.net.HttpURLConnection;
 import java.net.URL;
 import java.util.List;
 import org.apache.http.HttpConnection;
 import android.content.Context;
 import com.himi.news.R;
 import com.himi.news.domain.NewsItem;
 import com.himi.news.service.NewsInfoParser;
 /**
  * 新闻的业务类：工具类
  * @author Administrator
  *
  */
 public class NewsUtils {
     //设置静态方法，方便外界调用
     //获取服务器端网页新闻的信息，这里需要写一个新闻信息数据类，新建包com.himi.news.info,新建类NewsItem存储信息
     /**
      * 得到服务器最新的所有的新闻信息,我们这里路径放在res/values/config.xml中
      * res资源我们必须使用上下文才能访问，所有getAllNews的参数是Context context
      * @param context上下文
      * @return
      */
     public static List<NewsItem> getAllNews(Context context) throws Exception {
         String path = context.getResources().getString(R.string.serverip);
         URL url = new URL(path);
         HttpURLConnection httpConnection = (HttpURLConnection) url.openConnection();
         httpConnection.setRequestMethod("GET");//请求方法为GET方法
         httpConnection.setConnectTimeout(5000);//设置连接超时时间
         httpConnection.setReadTimeout(5000);//前面是连接，这里读取超时时间
         int code = httpConnection.getResponseCode();
         if(code == 200) {
             InputStream is = httpConnection.getInputStream();//得到一个服务器端的输入流，代表RSS数据源，也就是获取了news.xml文件
             return NewsInfoParser.parseNews(is);
         }else  {
             return null;
         }
     }
 }

       上面代码中String path = context.getResources().getString(R.string.serverip);

其中R.string.serverip对应于res/values/config.xml（通常命名为config.xml，便于理解和维护），config.xml内容如下：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="serverip">http://49.123.72.40/news.xml</string>
</resources>

这里我们编写的是网易新闻客户端测试程序，访问的是PC模拟出来的Apache服务器，所以这里的网址是我个人电脑的IP地址: 49.123.72.40 ，以后我们开发真正的项目则是改为公网IP。这里这个config.xml则是方面我们配置网址的，这里修改网址很方便，而且不容易出错，不这样设置可能在程序中多处修改网址才行，很影响效率。

->2:上面代码中，我们通过Http协议获得是一个服务器端new.xml文件的输入流：

InputStream is = httpConnection.getInputStream();很明显这个输入流不是我们想要的，我们通过这个输入流解析这个news.xml文件，这里必然需要编写一个业务类去实现这个解析xml文件：

这里我们新建一个包com.himi.news.service，包中新建一个类NewsInfoParser，如下：

 package com.itheima.news.service;
 import java.io.InputStream;
 import java.util.ArrayList;
 import java.util.List;
 import org.xmlpull.v1.XmlPullParser;
 import android.util.Xml;
 import com.itheima.news.domain.NewsItem;
 /**
  * 新闻信息的解析器 用来解析xml文件
  *
  */
 public class NewsInfoParser {
     /**
      * 解析xml数据流返回 新闻数据
      *
      * @param is
      * @return
      */
     public static List<NewsItem> parseNews(InputStream is) throws Exception {
         //定义一个新闻的集合,用来存放所有的新闻
         List<NewsItem> newsItems = new ArrayList<NewsItem>();
         //代表一条新闻
         NewsItem newsItem = null;
         XmlPullParser parser = Xml.newPullParser();
         // 设置参数
         parser.setInput(is, "utf-8");
         // 开始解析
         int type = parser.getEventType();
         while (type != XmlPullParser.END_DOCUMENT) {
             switch (type) {
             case XmlPullParser.START_TAG://标签开始
                 if("item".equals(parser.getName())){
                     //一个新闻数据要开始了。
                     newsItem = new NewsItem();
                 }else if("title".equals(parser.getName())){
                     String title = parser.nextText();
                     newsItem.setTitle(title);
                 }else if("description".equals(parser.getName())){
                     String description = parser.nextText();
                     newsItem.setDesc(description);
                 }else if("image".equals(parser.getName())){
                     String image = parser.nextText();
                     newsItem.setImage(image);
                 }else if("type".equals(parser.getName())){
                     String newtype = parser.nextText();
                     newsItem.setType(Integer.parseInt(newtype));
                 }else if("comment".equals(parser.getName())){
                     String comment = parser.nextText();
                     newsItem.setComment(Integer.parseInt(comment));
                 }
                 break;
             case XmlPullParser.END_TAG://标签结束
                 if("item".equals(parser.getName())){
                     newsItems.add(newsItem);
                 }
                 break;
             }
             type = parser.next();// 解析下一个事件
         }
         return newsItems;
     }
 }

下面定义一个方便外界调用的static方法： public static List<NewsItem> parseNews(InputStream is) ；接收参数为之前http协议获得的输入流，返回是，这里需要另外定义一个信息数据类NewsItem用来存放每条新闻。

 

->3:我们需要编写一个信息数据类NewsItem存放数据（存放每条新闻信息），如下：

我们新建一个包com.himi.news.domain，这个包下我们新建一个类为NewsItem：

 package com.himi.news.domain;
 public class NewsItem {
     private String title;
     private String desc;
     private String image;
     private int type;
     private int comment;
     public String getTitle() {
         return title;
     }
     public void setTitle(String title) {
         this.title = title;
     }
     /**
      * 它通常只是为了方便输出，比如System.out.println(xx)，
      * 括号里面的“xx”如果不是String类型的话，就自动调用xx的toString()方法
      * 还有其他所有需要显示字符串的地方全部都需要调用tostring（）
      */
     @Override
     public String toString() {
         return "NewsItem [title=" + title + ", desc=" + desc + ", image="
                 + image + ", type=" + type + ", comment=" + comment + "]";
     }
     public String getDesc() {
         return desc;
     }
     public void setDesc(String desc) {
         this.desc = desc;
     }
     public String getImage() {
         return image;
     }
     public void setImage(String image) {
         this.image = image;
     }
     public int getType() {
         return type;
     }
     public void setType(int type) {
         this.type = type;
     }
     public int getComment() {
         return comment;
     }
     public void setComment(int comment) {
         this.comment = comment;
     }
 }

上面我们已经获得news.xml新闻文件的数据信息，并且单条新闻信息临时存放在NewsItem中，多条新闻信息组合成List集合存放的。返回List<NewsItem>。

（3）上面我们写了一个复杂的xml解析的业务逻辑类，但是我们不能确定这个业务逻辑类一定是对的，所以我们要编程测试代码测试这个逻辑单元：

新建一个com.himi.news.test，编写一个TestNewsInfoParser测试上面我们编写的NewsInfoParser，这里同时也需要配置AndroidManifest.xml文件，

这里我们把news.xml文件复制到Android工程目录下的assets文件夹下，在测试代码中调用这个news.xml文件进行解析：代码如下： 

 package com.himi.news.test;
 import java.util.List;
 import android.test.AndroidTestCase;
 import com.himi.news.domain.NewsItem;
 import com.himi.news.service.NewsInfoParser;
 public class TestNewsInfoParser extends AndroidTestCase {
     public void testparseNews() throws Exception {
         // 这里是测试parseNews方法解析xml文件的效果,复制news.xml文件到工程assets目录下测试(测试时期：不从服务器获取)
         List<NewsItem> items = NewsInfoParser.parseNews(getContext()
                 .getAssets().open("news.xml"));// 获取assets文件夹资源需要上下文，这里API提供一个getContext()获取一个虚拟上下文
         for (NewsItem item : items) {
             System.out.println(item);
         }
     }
 }

测试结果说明业务逻辑是正确的；至于具体测试流程 详见  Android（java）学习笔记165：Android的Junit调试

（4）接下来，我们去完成布局UI设计：

 由于我们希望同时显示多条新闻数据，所以这里我们主布局文件activity_main.xml中是使用ListView,如下：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.himi.news.MainActivity" >
    <ListView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:id="@+id/lv" />
</RelativeLayout>

这里我们需要使用Android（java）学习笔记204自定义SmartImageView：（这里的SmartImageView是我们自己定义的，真实项目开发的时候我们可以利用开源项目）

 package com.himi.news.ui;
 import java.io.InputStream;
 import java.net.HttpURLConnection;
 import java.net.URL;
 import com.himi.news.R;
 import android.content.Context;
 import android.graphics.Bitmap;
 import android.graphics.BitmapFactory;
 import android.os.Handler;
 import android.os.Message;
 import android.util.AttributeSet;
 import android.widget.ImageView;
 /**
  * 实现一个子类，扩展系统的ImageView
  * @author Administrator
  *
  */
 public class SmartImageView extends ImageView {
     private static final int SUCCESS = 1;
     private Handler handler = new Handler() {
         public void handleMessage(android.os.Message msg) {
             switch (msg.what) {
             case SUCCESS:
                 Bitmap bitmap = (Bitmap) msg.obj;
                 setImageBitmap(bitmap);
                 break;
             default:
                 //其他消息，都是获取图片失败，加载默认失败图片
                 setImageResource(R.drawable.error);
                 break;
             }
         };
     };
     public SmartImageView(Context context, AttributeSet attrs, int defStyle) {
         super(context, attrs, defStyle);
         // TODO 自动生成的构造函数存根
     }
     public SmartImageView(Context context, AttributeSet attrs) {
         super(context, attrs);
         // TODO 自动生成的构造函数存根
     }
     public SmartImageView(Context context) {
         super(context);
         // TODO 自动生成的构造函数存根
     }
     /**
      * 设置一个网络的路径给imageview,imageview会自动的把这个路径对应的图片下载下来
      * @param path 图片的路径
      */
     public void  setImageUrl(final String path) {
         new Thread() {
             public void run() {
                 try {
                     URL url = new URL(path);
                     HttpURLConnection conn = (HttpURLConnection) url.openConnection();
                     conn.setConnectTimeout(5000);
                     conn.setReadTimeout(5000);
                     conn.setRequestMethod("GET");
                     int code = conn.getResponseCode();
                     if(code ==200) {
                         InputStream is = conn.getInputStream();//获得服务器端的图片文件的输入流
                         Bitmap bitmap = BitmapFactory.decodeStream(is);//将服务器端的图片文件的输入流 转化为 Bitmap图片文件
                         //setImageBitmap(bitmap);子线程不能更新UI,这里要使用消息机制
                         Message msg = Message.obtain();
                         msg.obj = bitmap;
                         msg.what = SUCCESS;
                         handler.sendMessage(msg);
                     }else {
                         handler.sendEmptyMessage(0);
                     }
                 } catch (Exception e) {
                     e.printStackTrace();
                     handler.sendEmptyMessage(0);
                 }
             };
         }.start();
     }
 }

如果我们加载新闻数据信息，如果获取的图片路径不对的，现实生活中我们应该是默认显示一个" 加载失败 "的图片如下：

这里我们自己自定义的SmartImageView往往不够成熟，考虑不够周全，幸运的时候我们在网上可以利用开源项目，很方便获取非常成熟的SmartImageView开源代码

每条新闻item的布局，自己定义item.xml，如下：

新建一个包com.himi.news.ui,复制之前Android（java）学习笔记204中自定义的SmartImageView到这个包下：

item.xml文件如下：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" >
    <com.himi.news.ui.SmartImageView
        android:id="@+id/iv_item"
        android:layout_width="100dip"
        android:layout_height="80dip" />
    <TextView
        android:id="@+id/tv_item_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginLeft="5dip"
        android:layout_marginTop="5dip"
        android:layout_toRightOf="@id/iv_item"
        android:singleLine="true"
        android:text="我是标题"
        android:textColor="#000000"
        android:textSize="19sp" />
    <TextView
        android:id="@+id/tv_item_desc"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@id/tv_item_title"
        android:layout_marginLeft="5dip"
        android:layout_marginTop="1dip"
        android:layout_toRightOf="@id/iv_item"
        android:lines="2"
        android:text="我是描述,我们都是好孩子"
        android:textColor="#AA000000"
        android:textSize="14sp" />
    <TextView
        android:id="@+id/tv_item_type"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="2dip"
        android:layout_alignParentRight="true"
        android:layout_below="@id/tv_item_desc"
        android:background="#ff0000"
        android:text="直播" />
</RelativeLayout>

这里自定义的SmartImageView可以自动获取相应网络路径下的图片，更符合我们的需求，所以我们自定义扩展这个ImageView为SmartImageView。

 

 （5）回到MainActivity.java:

 package com.himi.news;
 import java.util.List;
 import android.app.Activity;
 import android.graphics.Color;
 import android.os.Bundle;
 import android.os.Handler;
 import android.os.Message;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.BaseAdapter;
 import android.widget.ImageView;
 import android.widget.ListView;
 import android.widget.TextView;
 import android.widget.Toast;
 import com.himi.news.domain.NewsItem;
 import com.himi.news.net.NewsUtils;
 import com.himi.news.ui.SmartImageView;
 public class MainActivity extends Activity {
     protected static final int SUCCESS = 0;
     protected static final int ERROR = 1;
     private ListView lv;
     private Handler handler = new Handler() {
         public void handleMessage(android.os.Message msg) {
             switch (msg.what) {
             case SUCCESS:
                 lv.setAdapter(new NewsAdapter());
                 break;
             case ERROR:
                 Toast.makeText(MainActivity.this, "请求失败，获取失败", 0).show();
                 break;
             }
         };
     };
     /**
      * 所有的新闻信息
      */
     private List<NewsItem> newsItems;
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         lv = (ListView)findViewById(R.id.lv);
         new Thread() {
             public void run() {
                 try {
                     newsItems = NewsUtils.getAllNews(MainActivity.this);
                     Message msg = Message.obtain();
                     msg.what = SUCCESS;
                     handler.sendMessage(msg);
                 } catch (Exception e) {
                     // TODO 自动生成的 catch 块
                     e.printStackTrace();
                     Message msg = Message.obtain();
                     msg.what = ERROR;
                     handler.sendMessage(msg);
                 }
             };
         }.start();
     }
     private class NewsAdapter extends BaseAdapter {
         public int getCount() {
             return newsItems.size();
         }
         public View getView(int position, View convertView, ViewGroup parent) {
             View view ;
             if(convertView == null) {
                 view = View.inflate(MainActivity.this, R.layout.item, null);
             }else {
                 view = convertView;
             }
             SmartImageView iv = (SmartImageView) view.findViewById(R.id.iv_item);
             TextView tv_title = (TextView) view.findViewById(R.id.tv_item_title);
             TextView tv_desc = (TextView) view.findViewById(R.id.tv_item_desc);
             TextView tv_type = (TextView) view.findViewById(R.id.tv_item_type);
             NewsItem item = newsItems.get(position);
             tv_title.setText(item.getTitle());
             tv_desc.setText(item.getDesc());
             int type = item.getType();
             if(type==1) {
                 tv_type.setText("评论："+item.getComment());
             }else if(type==2) {
                 tv_type.setText("直播");
                 tv_type.setBackgroundColor(Color.RED);
             }else if(type==3) {
                 tv_type.setText("视频");
                 tv_type.setBackgroundColor(Color.BLUE);
             }
             return view;
         }
         public Object getItem(int position) {
             return null;
         }
         public long getItemId(int position) {
             return 0;
         }
     }
 }

 

（6）布署程序到模拟器上，效果如下：

（7）最后我们模拟出一个场景，当我们关闭Apache服务器的时候，我们的手机网易新闻客户端是不能再去获得服务器资源的，如下：

这个时候我们再次进入程序，效果如下：

这里访问请求失败的时候，我们是使用Toast土司提示信息，显示项目开发的时候，会现实开发项目中，我们事先设置好的访问失败的提示网页拿来显示。