view artifact-database/src/main/java/de/intevation/artifactdatabase/rest/Standalone.java @ 90:68285f7bc476

More javadoc. artifacts/trunk@846 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author Sascha L. Teichmann <sascha.teichmann@intevation.de>
date Fri, 26 Mar 2010 17:59:50 +0000
parents 69c84cf7c5d7
children e27cf9c84eb8
line wrap: on
line source
package de.intevation.artifactdatabase.rest;

import org.restlet.Component;

import org.restlet.data.Protocol;

import de.intevation.artifacts.ArtifactDatabase;

import de.intevation.artifactdatabase.Config;

import org.apache.log4j.Logger;

/**
 * Starts an HTTP server bound to a RestApp.
 * The server (binding interface and port) is configure via the
 * global configuration.
 *
 * @author <a href="mailto:sascha.teichmann@intevation">Sascha L. Teichmann</a>
 */
public class Standalone
{
    private static Logger logger = Logger.getLogger(Standalone.class);

    /**
     * XPath to figure out the port where to listen from the
     * global configuration.
     */
    public static final String REST_PORT =
        "/artifact-database/rest-server/port/text()";

    /**
     * XPath to figure out from global configuration
     * which network interface to use to bind the HTTP server.
     */
    public static final String LISTEN_INTERFACE =
        "/artifact-database/rest-server/listen/text()";

    /**
     * The default port of the HTTP server: 8181
     */
    public static final int DEFAULT_PORT = 8181;

    /**
     * Builds a RestApp wrapped around the given artifact database,
     * and bind this application to HTTP server. The HTTP server
     * is configured by the global configuration. If no port is
     * given by the configuration the default port is used. If
     * no interface is given the HTTP server is reachable from
     * all interfaces.
     * @param db The artifact database to be exposed via the
     * REST application.
     */
    public static void startAsServer(ArtifactDatabase db) {
        String portString   = Config.getStringXPath(REST_PORT);
        String listenString = Config.getStringXPath(LISTEN_INTERFACE);

        int port = DEFAULT_PORT;

        if (portString != null) {
            try {
                port = Integer.parseInt(portString);
                if (port < 0) {
                    throw new NumberFormatException();
                }
            }
            catch (NumberFormatException nfe) {
                logger.error("rest port is not a positive integer value.", nfe);
                return;
            }
        }

        RestApp app = new RestApp(db);

        Component component = new Component();

        if (listenString != null) {
            component.getServers().add(Protocol.HTTP, listenString, port);
        }
        else {
            component.getServers().add(Protocol.HTTP, port);
        }

        component.getDefaultHost().attach(app);

        logger.info("Starting rest HTTP server on "
            + (listenString != null ? listenString : "*")
            + ":" + port);

        try {
            component.start();
        }
        catch (Exception e) {
            logger.error(e.getLocalizedMessage(), e);
        }
    }
}
// vim:set ts=4 sw=4 si et sta sts=4 fenc=utf8 :

http://dive4elements.wald.intevation.org