Overview of Wink-based Feed Samples
Feeds are a mechanism to deliver content in a standardized
specification format. Atom Syndication Format and RSS are two such
specifications. Apache Wink is an open-source project providing
feed support (in addition to being an implementation of JAX-RS)
within WebSphere Application Server. Wink has both read and write
support for Atom syndication format, Atom Publishing Protocol and RSS.
Feed samples, and what they demonstrate
The Feed samples have been built to demonstrate the Atom and RSS
support in Wink. In addition, it also demonstrates Atom Publishing
Protocol support. See the following specific scenarios that the samples support.
Also refer to the
Installation section
for details on how to test these scenarios.
- Generate an Atom feed - a simple example to create an Atom
feed
- Read an Atom feed - an example to read Atom content.
For example, read an Atom feed from the O'reilly site:
http://www.oreillynet.com/pub/feed/1
- Generate an RSS feed - a simple example to create an RSS
feed
- Read an RSS feed - an example to read RSS content. For
example, read an RSS feed from
http://rss.cnn.com/rss/cnn_topstories.rss
- Atom Publishing Protocol support - demonstrates the ability to
create, update, delete, and retrieve entries in a feed. Also provides
options to retrieve the service document, and the associated feed.
Package structure
The Feed sample application is distributed as IBM® WebSphere
Application Server Feature Pack for Web 2.0, a stand-alone package, and
as an Eclipse plug-in.
- Stand-alone package content is organized as follows:
- /documentation/index.html - Root page for the provided
documentation
- /feed_samples - Contains the SampleFeedApp_Wink.war file,
and the wink-shared-library.zip file
- /feed_samples/wink-shared-library.zip -
Contains the following JAR files that need to be added into IBM WebSphere Application
Server 6.1.x and 7.x, and IBM WebSphere Application Server
Community Edition 2.x as a shared library.
- JAX-RS JAR files: ibm-wink-jaxrs-*.jar and jsr311-api-*.jar
- JAXB support for WebSphere Application Server Version 6.1.x and
WebSphere Application Server Community Edition 2.x: ibm-jaxb-*.jar
- JSON4J JAR file: JSON4J.jar
- Logging JAR files: slf4j-api-*.jar, slf4j-jdk14-*.jar
and jcl-over-slf4j-*.jar
- Support for the Wink client calls: httpclient-*.jar,
httpcore-*.jar and commons-codec-*.jar
- Other Wink dependencies: commons-lang-*.jar
- IBM WebSphere Application Server Feature Pack for Web
2.0 content is organized as follows
- {app_server_root}/web2fep/samples/Feed - Contains
the SampleFeedApp_Wink.war file
-
{app_server_root}/web2fep/documentation/Feed_Samples/index.html
- Root page for the provided samples documentation.
- {app_server_root}/web2fep/site/eclipse-update-site.zip - An
archived Eclipse site for use with Eclipse-based development tooling
that contains "Feed Samples" as one of the Eclipse plug-ins.
- {app_server_root}/web2fep/optionalLibraries/jaxrs_1.X - Contains
the Wink JAR files, and its dependencies: ibm-wink-jaxrs-*.jar,
jsr311-api-*.jar, slf4j-api-*.jar, slf4j-jdk14-*.jar,
jcl-over-slf4j-*.jar, httpclient-*.jar, httpcore-*.jar,
commons-codec-*.jar and commons-lang-*.jar
- {app_server_root}/web2fep/optionalLibraries/jaxrs_1.X/jaxb -
Contains ibm-jaxb-*.jar file, which is another Wink dependency.
- {app_server_root}/web2fep/optionalLibraries/JSON4J -
Contains JSON4J.jar file, yet another Wink dependency.
- Eclipse plug-in content is organized as follows:
- /features - Contains feature information
- /plugins - Contains the plug-in JAR file. The pattern of this JAR
file is com.ibm.ajax.feed.samples_*.jar. This directory also contains
JAR files of the pattern,
com.ibm.ajax.feed.samples.help_*1.0.1.1.jar, which include the
documentation files.
- /plugins/com.ibm.ajax.feed.samples_1.0.1.1.jar/ -
Contains the SampleFeedApp_Wink.war sample application file