JarCastingblog-parser is a Java library to parse blog exports into strongly-typed data object model. This is particularly useful when you want to allow your application to import data from existing blogs.
Usage
Initialize the right parser for your blog export and pass it the file contents of the export, like
File file = new File("blogger-export.xml");
String xml = org.apache.commons.io.FileUtils.readFileToString(file);
BloggerParser parser = new BloggerParser();
Blog blog = parser.parse(xml);
or, you may use the utility class BlogParser as:
File file = new File("wordpress-export.xml");
String xml = org.apache.commons.io.FileUtils.readFileToString(file);
Blog blog = BlogParser.parse(xml, BlogType.Wordpress);
and you are done! The Blog object represents the parsed entities.
Features
1.0.0
- Added support for Wordpress and Movable Type platforms
- Added support for blog description
- Added a static utility class
BlogParser - Added unit tests
0.9.5
- Added support for blog pages
0.9.0
- Support for parsing Blogger XML exports
- Support for parsing blogs, authors, posts and comments
Roadmap
Add support for the following platforms:
- Posterous
- Live Journal
- Tumblr
- Blog.com
- Typepad
Continuous Integration
The library is continuously integrated and unit tested using the *Travis CI system.
Current status of branch MASTER:
The library is tested against
- Oracle JDK 7
- Oracle JDK 6
- Open JDK 7
- Open JDK 6
Downloads
You may download the builds from Maven Central repository using:
<dependency>
<groupId>com.sangupta</groupId>
<artifactId>blog-parser</artifactId>
<version>0.9.0</version>
</dependency>
Dependencies
The library is built using Oracle Java 1.6 and depends on the following open-source third-party libraries:
Versioning
For transparency and insight into our release cycle, and for striving to maintain backward compatibility, the library will be maintained under the Semantic Versioning guidelines as much as possible.
Releases will be numbered with the follow format:
<major>.<minor>.<patch>
And constructed with the following guidelines:
- Breaking backward compatibility bumps the major
- New additions without breaking backward compatibility bumps the minor
- Bug fixes and misc changes bump the patch
For more information on SemVer, please visit http://semver.org/.
License
Copyright 2012, Sandeep Gupta
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or 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.