RSS Parser

Additional

Language
Kotlin
Version
N/A
Created
Jun 18, 2016
Updated
Jan 25, 2019
Owner
Marco Gomiero (prof18)
Contributors
javmarina
Marco Gomiero (prof18)
2
Activity
Badge
Generate
Download
Source code
APK file

Promotion

RSS Parser

Important Notice

Versions 1.4 and 1.4.1 have been deleted due to a critical dependency error. Please forgive me and update to the latest version available.

About

This is an Android library to parse a RSS Feed. You can retrive the following information about an article:

  • Title
  • Author
  • Description
  • Content
  • Main Image
  • Link
  • Publication Date
  • Categories

Disclaimer: This library has been built starting from RSS feed generated from a Wordpress Site. Of course it's compatible with RSS feed generated from other tipe of sites; Here you can find an example of RSS feed.

How to

Import:

The library is uploaded in jCenter, so you can easily add the dependency:

dependencies {
  compile 'com.prof.rssparser:rssparser:2.0.3'
}

Use:

Starting from the version 2.x, the library has been completely rewritten using Kotlin and the coroutines. However, The compatibility with Java has been maintained and the same code of the versions 1.x can be used.

If you are using Kotlin you need to launch the coroutine that retrieves the articles.

import com.prof.rssparser.Article
import com.prof.rssparser.Parser

//url of RSS feed
private val url = "https://www.androidauthority.com/feed"

coroutineScope.launch(Dispatchers.Main) {
    try {
        val parser = Parser()
        val articleList = parser.getArticles(url)
        // The list contains all article's data. For example you can use it for your adapter.
    } catch (e: Exception) {
        // Handle the exception
    }
}

You can give a look to the full kotlin sample by clicking here

If you are still using Java, the code is very similar to the older versions of the library:

import com.prof.rssparser.Article;
import com.prof.rssparser.OnTaskCompleted;
import com.prof.rssparser.Parser;

Parser parser = new Parser();
parser.onFinish(new OnTaskCompleted() {

    //what to do when the parsing is done
    @Override
    public void onTaskCompleted(List<Article> list) {
        // The list contains all article's data. For example you can use it for your adapter.
    }

    //what to do in case of error
    @Override
    public void onError(Exception e) {
        // Handle the exception
    }
});
parser.execute(urlString);

The full Java sample is available here

Version 1.4.4 and below:
import com.prof.rssparser.Article;
import com.prof.rssparser.Parser;

//url of RSS feed
String urlString = "http://www.androidcentral.com/feed";
Parser parser = new Parser();
parser.onFinish(new Parser.OnTaskCompleted() {
    
    @Override
    public void onTaskCompleted(ArrayList<Article> list) {
      //what to do when the parsing is done
      //the Array List contains all article's data. For example you can use it for your adapter. 
    }

    @Override
    public void onError() {
      //what to do in case of error
    }
});
parser.execute(urlString);

Sample app

I wrote a simple app that shows articles from Android Authority. If in the article's content there isn't an image, a placeholder will be loaded.

The sample is written both in Kotlin and Java. You can browse the Kotlin code here and the Java code here You can also download the apk file to try it!

Please use the issues tracker only to report issues. If you have any kind of question you can ask it on the blog post that I wrote

Changelog

  • 24 January 2019 - Now the date of an article is saved as String, to extend the compatibility with different formats - Version 2.0.3
  • 11 January 2019 - Moved the Java parsing on a background thread - Version 2.0.2
  • 2 January 2019 - Fixed an error on Date parsing - Version 2.0.1
  • 22 December 2018 - Rewrote library with Kotlin - Version 2.0.0
  • 8 December 2018 - Include thrown exception in onError() callback (PR #22) - Version 1.4.5
  • 7 Semptember 2018 - Added more sources for the featured image. Removed unused resources and improved the parsing of the image. Fixed dependency errors. - Version 1.4.4
  • 14 December 2017 - Little fixes on Error Management - Version 1.3.1
  • 13 December 2017 - Improved Error Management - Version 1.3
  • 10 December 2017 - Added support for the categories - Version 1.2
  • 12 August 2017 - Fixed the Library Manifest and updated the dependencies - Version 1.1
  • 18 June 2016 - First release - Version 1.0

License

   Copyright 2016 Marco Gomiero

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.