AeroGear Controller is a very lean model view controller written in Java. It focuses on the routing of HTTP request to plain Java object endpoint and the handling of the returned result. The result of an invocation is either forwarded to a view, or returned in the format requested by the caller.
-
Add the following maven dependency
<dependency> <groupId>org.jboss.aerogear</groupId> <artifactId>aerogear-controller</artifactId> <version>1.0.0</version> <scope>compile</scope> </dependency> -
Since AeroGear Controller uses CDI it is required that a
beans.xmlfile exists in theWEB-INFfolder<beans xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/beans_1_0.xsd"> </beans>
-
Create a pojo controller
public class Home { public void index() { } } -
Create a Java class containing the routes (must extend
AbstractRoutingModule)public class Routes extends AbstractRoutingModule { @Override public void configuration() { route() .from("/") .on(RequestMethod.GET) .to(Home.class).index(); } } -
Create a jsp page at
/WEB-INF/pages/<Controller Class Name>/<method>.jsp<!-- /WEB-INF/pages/Home/index.jsp --> <html> <body> <p>hello from index!</p> </body> </html>
For information about creating RESTful routes, please refer to the user guide.
You can use immutable beans straight away as controller parameters:
public class Store {
public Car save(Car car) {
return car;
}
}
This can be populated by configuring a route to handle POST requests:
route()
.from("/cars")
.on(RequestMethod.POST)
.to(Store.class).save(param(Car.class));
And you can use a simple html form for it, by just following the convention:
<input type="text" name="car.color"/>
<input type="text" name="car.brand"/>
The car object will be automatically populated with the provided values - note that it supports deep linking, so this would work fine too:
<input type="text" name="car.brand.owner"/>
All the intermediate objects are created automatically.
This was only a small portion of the features that are available in AeroGear Controller, please refer to the user guide for more information.