A Yeoman generator for Aurelia and Dropwizard.
Install Git, node.js, JDK 7, and Maven 3.
Install Gulp and jspm:
npm install -g gulp
npm install -g jspm
Install Yeoman:
npm install -g yo
Install the Aurelia-Dropwizard generator:
npm install -g generator-aurelia-dropwizard
In a new directory, generate the service:
yo aurelia-dropwizard
Compile the service:
mvn compile && gulp build
Run the service:
mvn exec:exec -pl [myapp]-service
Your service will run at http://localhost:8080. It's time to create some resources.
Generate the resource:
yo aurelia-dropwizard:resource [myresource]
You will be asked to specify methods for the resource, where each method has the following:
- a name
- a type (GET, POST, PUT, DELETE, HEAD)
- a URI path template, such as
/users/{userId}/orders/{orderId} - for a POST method, an optional list of form parameters
Files that are regenerated will appear as conflicts. Allow the generator to overwrite these files as long as no custom changes have been made.
Compile and rerun the service:
mvn compile && gulp build
mvn exec:exec -pl [myapp]-service
You can now invoke HTTP requests against your service, such as
curl -X POST localhost:8080/myapp/myresource/users/1/orders/2 \
-d "formParam1=hello&formParam2=world"
Generate the entity:
yo aurelia-dropwizard:entity [myentity]
You will be asked to specify attributes for the entity, where each attribute has the following:
- a name
- a type (String, Integer, Long, Float, Double, Boolean, Date, Enum)
- for a String attribute, an optional minimum and maximum length
- for a numeric attribute, an optional minimum and maximum value
- for a Date attribute, an optional constraint to either past values or future values
- for an Enum attribute, a list of enumerated values
- whether the attribute is required
Compile and rerun the service:
mvn compile && gulp build
mvn exec:exec -pl [myapp]-service
A client-side Aurelia application will now be available by running
gulp watch
The Gulp server will run at http://localhost:9000. It will proxy REST requests to the Dropwizard service running at http://localhost:8080.
At this point you should be able to navigate to a page to manage your persistent entities.
The Gulp server supports hot reloading of client-side HTML/CSS/Javascript file changes, while the Dropwizard service supports hot reloading of Java class file changes.