آشنایی با RSS Reader - خبرخوان در برنامه نویسی اندروید

RSS مخفف Really Simple Syndication ( به معنای متحد سازی واقعا آسان) می باشد.
RSS راهی ساده برای به اشتراک گذاشتن آپدیت ها و محتوای وب سایت شما با کاربر های شما می باشد، به طوری که کاربر ها مجبور نباشند برای مشاهده و دسترسی به هر آپدیتی ، روزانه سایت شما را مشاهده کنند.

مثالی از RSS:

RSS داکیومنتی می باشد که توسط وب سایت با توسعه ی xml ایجاد می شود.
می توانید به راحتی این داکیومنت را تجزیه کرده و آن را در اپلیکیشن خود به کاربر نمایش دهید.
یک داکیومنت RSS مانند زیر می باشد :

<rss version="2.0">
   <channel>
      <title>Sample RSS</title>
      <link>http://www.google.com</link>
      <description>World's best search engine</description>
   </channel>
</rss>

اِلمان های یک RSS  :

یک داکیومنت RSS مانند آنچه در بالا دیدید، دارای المان های زیر می باشد :

1. channel:
   این عنصر برای توصیف منبع تغذیه ی RSS استفاده می شود.
2. title :
   عنوان کانال را تعریف می کند.
3. link :
   یک هایپرلینک برای کانال تعریف می کند.
4. description :
   کانال را توصیف می کند.

تجزیه ی RSS :

تجزیه ی داکیومنت RSS بیشتر شبیه به تجزیه xml می باشد. پس ، از اول  اجازه دهید نگاهی به چگونگی تجزیه ی داکیومنت XML داشته باشیم.

برای انجام این کار ، یک آبجکت XMLPullParser ایجاد خواهیم کرد، اما برای ایجاد آن نیز ابتدا آبجکت XmlPullParserFactory را ایجاد می کنیم و سپس متد ()newPullParser را برای ایجاد XMLPullParser فرا می خوانیم.
سینتکس آن مانند زیر می باشد :

private XmlPullParserFactory xmlFactoryObject = XmlPullParserFactory.newInstance();
private XmlPullParser myparser = xmlFactoryObject.newPullParser();

گام بعدی شامل مشخص کردن فایل دارای XML برای XmlPullParser می باشد، که می تواند شامل یک فایل یا یک stream باشد. در این مورد یک stream است و سینتکس آن نیز در زیر ارائه شده است :

myparser.setInput(stream, null);

و آخرین گام تجزیه ی XML می باشد.
یک فایل xml شامل :

• رویداد ها (event)
• نام (Name )
• متن (Text)
• AttributesValue

و غیره می باشد.

بنابراین XMLPullParser دارای یک تابع مجزا برای تجزیه ی هر کدام از کامپوننت های فایل xml است.
سینتکس  آن مانند زیر می باشد :

int event = myParser.getEventType();
while (event != XmlPullParser.END_DOCUMENT)  {
   String name=myParser.getName();
   
   switch (event){
      case XmlPullParser.START_TAG:
      break;
      
      case XmlPullParser.END_TAG:
      if(name.equals("temperature")){
         temperature = myParser.getAttributeValue(null,"value");
      }
      break;
   }		 
   event = myParser.next(); 					
}

متد getEventType نوع event  ای  که اتفاق می افتد را گزارش می دهد. به عنوان مثال ، آغاز Document، آغاز tag و غیره.
متد getName نام تگ را گزارش می دهد و از آنجایی که ما فقط علاقمند به دما هستیم، بنابراین فقط در وضعیت مشروط چک می کنیم که اگر تگ دما را گرفتیم، متد getAttributeValue را فرا بخوانیم تا مقدار مربوط به تگ دما را به ما گزارش دهد.

علاوه بر این متد ها، متد های دیگری توسط این کلاس برای تجزیه ی بهتر فایل های xml ارائه می شوند. این متد ها در جدول زیر ارائه شده اند :

• ()getAttributeCount :
  این متد تعداد اتریبیوت های تگ آغازین را بر میگرداند.
• (getAttributeName(int index :
  این متد نام اتریبیوت مشخص شده توسط index  را بر می گرداند.
• ()getColumnNumber :
  این متد مقدار بازگشتی ستون فعلی را باز می گرداند و این مقدار از 0 شروع می شود.
• ()getLineNumber :
  این متد شماره خط فعلی را باز می گرداند و از 1 شروع می شود .
• ()getNamespace :
  این متد نام URL فعلی را باز می گرداند.
• ()getPrefix : 
  این متد پیشوند فعلی المان ها را باز می گرداند.
• ()getName :
  این متد نام تگ ها را باز می گرداند.
• ()getText :
  این متد متن را برای المان مورد نظر بر می گرداند.

مثال :

این مثال استفاده از کلاس XMLPullParser را توضیح می دهد. این مثال یک اپلیکیشن تجزیه ی پایه (basic Parsing application) ایجاد می کند که به شما اجازه می دهد تا یک داکیومنت RSS را  تجزیه کنید و پس از آن نتایج را نشان می دهد.

برای آزمایش این مثال می توانید آن را روی یک دستگاه حقیقی یا یک امولاتور اجرا کنید.

• برای ایجاد یک اپلیکیشن اندروید از اندروید استودیو تحت پکیج com.example.sairamkrishna.myapplication استفاده می کنیم .
• فایل src/MainActivity.java را برای افزودن کد لازم تغییر دهید.
• res/layout/activity_main را برای افزودن مولفه های XML مربوطه تغییر دهید.
• یک فایل جاوای جدید تحت src/HandleXML.java برای تجزیه ی داده ی XML، ایجاد کنید.
• برنامه را اجرا کنید و یک دستگاه اجرایی اندروید انتخاب کرده و اپلیکیشن را روی آن نصب کنید و نتایج را بررسی کنید.

محتوای تغییر یافته ی src/MainActivity.java :

package com.example.sairamkrishna.myapplication;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;

import android.widget.Button;
import android.widget.EditText;


public class MainActivity extends Activity {
   EditText title,link,description;
   Button b1,b2;
   private String finalUrl="http://tutorialspoint.com/android/sampleXML.xml";
   private HandleXML obj;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      title = (EditText) findViewById(R.id.editText);
      link = (EditText) findViewById(R.id.editText2);
      description = (EditText) findViewById(R.id.editText3);

      b1=(Button)findViewById(R.id.button);
      b2=(Button)findViewById(R.id.button2);
      b1.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            obj = new HandleXML(finalUrl);
            obj.fetchXML();

            while(obj.parsingComplete);
            title.setText(obj.getTitle());
            link.setText(obj.getLink());
            description.setText(obj.getDescription());
         }
      });

      b2.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            Intent in=new Intent(MainActivity.this,second.class);
            startActivity(in);
         }
      });
   }

}

محتوای تغییر یافته ی فایل جاوای src/HandleXML.java:

package com.example.rssreader;

import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;

import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserFactory;

import android.util.Log;

public class HandleXML {
   private String title = "title";
   private String link = "link";
   private String description = "description";
   private String urlString = null;
   private XmlPullParserFactory xmlFactoryObject;
   public volatile boolean parsingComplete = true;
   
   public HandleXML(String url){
      this.urlString = url;
   }
   
   public String getTitle(){
      return title;
   }
   
   public String getLink(){
      return link;
   }
   
   public String getDescription(){
      return description;
   }
   
   public void parseXMLAndStoreIt(XmlPullParser myParser) {
      int event;
      String text=null;
      
      try {
         event = myParser.getEventType();
         
         while (event != XmlPullParser.END_DOCUMENT) {
         String name=myParser.getName();
         
         switch (event){
            case XmlPullParser.START_TAG:
            break;
            
            case XmlPullParser.TEXT:
            text = myParser.getText();
            break;
            
            case XmlPullParser.END_TAG:
            
            if(name.equals("title")){
               title = text;
            }
            
            else if(name.equals("link")){
               link = text;
            }
            
            else if(name.equals("description")){
               description = text;
            }
            
            else{
            }
            
            break;
            }
            
            event = myParser.next(); 
            }
            
            parsingComplete = false;
            }
            
            catch (Exception e) {
               e.printStackTrace();
            }
         }
         
         public void fetchXML(){
            Thread thread = new Thread(new Runnable(){
               @Override
               public void run() {
               
               try {
               URL url = new URL(urlString);
               HttpURLConnection conn = (HttpURLConnection) url.openConnection();
               
               conn.setReadTimeout(10000 /* milliseconds */);
               conn.setConnectTimeout(15000 /* milliseconds */);
               conn.setRequestMethod("GET");
               conn.setDoInput(true);
               
               // Starts the query
               conn.connect();
               InputStream stream = conn.getInputStream();
               
               xmlFactoryObject = XmlPullParserFactory.newInstance();
               XmlPullParser myparser = xmlFactoryObject.newPullParser();
               
               myparser.setFeature(XmlPullParser.FEATURE_PROCESS_NAMESPACES, false);
               myparser.setInput(stream, null);
               
               parseXMLAndStoreIt(myparser);
               stream.close();
            }
            
            catch (Exception e) {
            }
         }
      });
      thread.start(); 
   }
}

فایل second.java را تحت دایرکتوری java/second.java بسازید :

package com.example.sairamkrishna.myapplication;

import android.app.Activity;
import android.os.Bundle;
import android.webkit.WebView;

public class second extends Activity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.second_activity);
      WebView w1=(WebView)findViewById(R.id.webView);
      w1.loadUrl("http://tutorialspoint.com/android/sampleXML.xml");
   }
}

محتوای فایل res/layout/second_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:orientation="vertical" android:layout_width="match_parent"
   android:layout_height="match_parent">
   
   <WebView
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:id="@+id/webView"
      android:layout_gravity="center_horizontal" />
</LinearLayout>

محتوای تغییر یافته ی res/layout/activity_main.xml :

<?xml version="1.0" encoding="utf-8"?>
<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:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin"
   tools:context=".MainActivity"
   android:transitionGroup="true">
   
   <TextView android:text="RSS example" android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textview"
      android:textSize="35dp"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials point"
      android:id="@+id/textView"
      android:layout_below="@+id/textview"
      android:layout_centerHorizontal="true"
      android:textColor="#ff7aff24"
      android:textSize="35dp" />
      
   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/abc"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true"
      android:theme="@style/Base.TextAppearance.AppCompat" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText"
      android:layout_below="@+id/imageView"
      android:hint="Tittle"
      android:textColorHint="#ff69ff0e"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText2"
      android:layout_below="@+id/editText"
      android:layout_alignLeft="@+id/editText"
      android:layout_alignStart="@+id/editText"
      android:textColorHint="#ff21ff11"
      android:hint="Link"
      android:layout_alignRight="@+id/editText"
      android:layout_alignEnd="@+id/editText" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText3"
      android:layout_below="@+id/editText2"
      android:layout_alignLeft="@+id/editText2"
      android:layout_alignStart="@+id/editText2"
      android:hint="Description"
      android:textColorHint="#ff33ff20"
      android:layout_alignRight="@+id/editText2"
      android:layout_alignEnd="@+id/editText2" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Fetch"
      android:id="@+id/button"
      android:layout_below="@+id/editText3"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true"
      android:layout_toLeftOf="@+id/imageView"
      android:layout_toStartOf="@+id/imageView" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Result"
      android:id="@+id/button2"
      android:layout_alignTop="@+id/button"
      android:layout_alignRight="@+id/editText3"
      android:layout_alignEnd="@+id/editText3" />

</RelativeLayout>

محتوای تغییر یافته res/values/string.xml :

<resources>
   <string name="app_name">My Application</string>
</resources>

محتوای پیش فرض AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.sairamkrishna.myapplication" >
   <uses-permission android:name="android.permission.INTERNET"/>
   
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      
      <activity
         android:name=".MainActivity"
         android:label="@string/app_name" >
      
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
         
      </activity>
      
      <activity android:name=".second"></activity>
   </application>
</manifest>

می خواهیم اپلیکیشن را اجرا کنیم ؛
فرض می کنیم که شما در هنگام انجام تنظیمات ، محیط AVD خود را ایجاد کرده اید. برای اجرای اپلیکیشن از اندروید استودیو ، یکی از فایل های اکتیویتی اپلیکیشن را باز کرده و روی آیکون Run  در نوار ابزار کلیک کنید. اندروید استودیو اپلیکیشن را روی AVD نصب کرده و آن را اجرا می کند. اگر همه چیز در مورد برنامه و تنظیمات آن درست باشد، پنجره ی امولاتور زیر نمایش داده خواهد شد :

اکنون روی دکمه ی Fetch Feed بزنید تا RSS feed را بیاورید، پس از آن صفحه ی زیر نمایش داده خواهد شد که داده ی RSS را نمایش می دهد.