Simple APP server implementation that stores entries on disk.

This implementation is made up of an {@link com.sun.syndication.propono.atom.server.AtomHandler} named {@link com.sun.syndication.propono.atom.server.impl.FileBasedAtomHandler} and {@link com.sun.syndication.propono.atom.server.impl.FileBasedAtomHandlerFactory}, which sub-classes {@link com.sun.syndication.propono.atom.server.AtomHandlerFactory}.

To use this implementation in your web application, here are the steps:

Now let's go over each of those steps:

1. Add rome-propono-X.Y.jar to your webapp's classpath

Normally this is done by placing the Propono jar in your webapp's WEB-INF/lib directory.

2. Add the Propono {@link com.sun.syndication.propono.atom.server.AtomServlet} to your webapp's web.xml file

For example, you might add something like the following to declare the {@link com.sun.syndication.propono.atom.server.AtomServlet} and then to map it to the path /app

    <servlet>
        <description>Atom Publishing Protocol Servlet</description>
        <servlet-name>AtomServlet</servlet-name>
        <servlet-class>com.sun.syndication.propono.atom.server.AtomServlet</servlet-class>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>AtomServlet</servlet-name>
        <url-pattern>/app/*</url-pattern>
    </servlet-mapping>
        

3. Add a propono.properties file to your webapp's classpath

You'll need to specify the name of the file-based Atom factory in propono.properties. Here's an example:

    com.sun.syndication.propono.atom.server.AtomHandlerFactory=\
       com.sun.syndication.propono.atom.server.impl.FileBasedAtomHandlerFactory
        

4. Specify which collections you'd like to support

If you put nothing else in the properties file, you'll have an Atom server that supports two collections: "entries" for Atom entries and "resources" for any type of file. If you'd like to setup a different set of collections then see the comments in {@link com.sun.syndication.propono.atom.server.impl.FileBasedAtomService} for details on configuring your own collections.

5. Deploy your webapp and accesss your new Atom service

Start your webapp and point your Atom client at /app to start using your new Atom server capability.