The Apache Software Foundation

# Configure Custom WebAdmin routes

The current project demonstrates how to write custom webadmin routes for Apache James. This enables writing new administrative features exposed over a REST API. This can allow you to write some additional features, make James interact with third party systems, do advance reporting...

Find this example on GitHub.

Start by importing the dependencies:

    <dependency>
        <groupId>org.apache.james</groupId>
        <artifactId>james-server-webadmin-core</artifactId>
    </dependency>

You can then write your first route using the Spark Java framework:

    public class RouteA implements Routes {
        @Override
        public String getBasePath() {
            return "/hello/a";
        }

        @Override
        public void define(Service service) {
            service.get(getBasePath(), (req, res) -> "RouteA\n");
        }
    }

Knowing that:
- entending Routes: will ensure that authentication is requested if configured.
- entending PublicRoutes: will not request authentication.

You can compile this example project:

    mvn clean install

Then embed your route into a James server. First configure your route into `webadmin.properties`:

    enabled=true
    port=8000
    host=localhost

    # List of fully qualified class names that should be exposed over webadmin
    # in addition to your product default routes. Routes needs to be located
    # within the classpath or in the ./extensions-jars folder.
    extensions.routes=org.apache.james.examples.RouteA

Then start a James server with your JAR and the configuration:

    docker run -d \
       -v $PWD/webadmin.properties:/root/conf/webadmin.properties \
       -v $PWD/exts:/root/extensions-jars \
       -p 25:25 \
       apache/james:memory-latest --generate-keystore

You can play with `curl` utility with the resulting server:

    $ curl -XGET http://172.17.0.2:8000/hello/a
    RouteA