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 installThen 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.RouteACreate a keystore (default password being james72laBalle):
keytool -genkey -alias james -keyalg RSA -keystore keystoreThen 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 \
   -v $PWD/keystore:/root/conf/keystore \
   -p 25:25 \
   apache/james:memory-latestYou can play with curl utility with the resulting server:
$ curl -XGET http://172.17.0.2:8000/hello/a
RouteA