dropwizard-example/README.md
The Dropwizard example application was developed to, as its name implies, provide examples of some of the features present in Dropwizard.
Included with this application is an example of the optional DB API module. The examples provided illustrate a few of the features available in Hibernate, along with demonstrating how these are used from within Dropwizard.
This database example comprises the following classes:
The PersonDAO illustrates using the Data Access Object pattern with assisting of Hibernate.
The Person illustrates mapping of Java classes to database tables with assisting of JPA annotations.
All the JPQL statements for use in the PersonDAO are located in the Person class.
migrations.xml illustrates the usage of dropwizard-migrations which can create your database prior to running
your application for the first time.
The PersonResource and PeopleResource are the REST resource which use the PersonDAO to retrieve data from the database, note the injection
of the PersonDAO in their constructors.
As with all the modules the db example is wired up in the initialize function of the HelloWorldApplication.
To test the example application run the following commands.
To create the example, package the application using Apache Maven from the root dropwizard directory.
cd dropwizard
./mvnw package
cd dropwizard-example
To set up the h2 database run.
java -jar target/dropwizard-example-$DW_VERSION.jar db migrate example.yml
To run the server run.
java -jar target/dropwizard-example-$DW_VERSION.jar server example.yml
To hit the Hello World example (hit refresh a few times).
To post data into the application.
curl -H "Content-Type: application/json" -X POST -d '{"fullName":"Other Person","jobTitle":"Other Title"}' http://localhost:8080/people