This a sample REST application written in Java. It's purpose is to create a generic project that can be used as a starting point for a new project, but also for learning efforts (I am building an open game database at www.oregami.org).
- built on Dropwizard version 0.7.0
- dependency injection with Google Guice
- Hibernate / JPA 2.1 as database access framework
- HSQLDB as database
- "Session-per-HTTP-request" with Guice PersistentFilter
- suport for cross-origin resource sharing
- JPA entities with UUIDs as primary keys
- a pattern for accessing and manipulation entities with HTTP REST calls (Resource => Service => DAO => entity)
- a pattern for ServiceResult objects which contain ServiceErrorMessages (which can later be bound to web form fields in the client)
Feel free to suggest corrections, optimizations or extensions via pull requests!
Start the application with the class "ToDoApplication" with the parameters "server todo.yml".
List all tasks with: GET => http://localhost:8080/task
Add a new task with: POST => http://localhost:8080/task Header: Content-Type:application/json JSON-Body e.g. : {"name" : "task 1", "description" : "This is a description"}
Modify a task: PUT => http://localhost:8080/task/[id] Header: Content-Type:application/json Accept:application/json JSON-Body e.g.: { "id": "402880944687600101468760d9ea0000", "version": "0", "name": "task 1 with new name", "description": "This is an updated description", "finished": "false" }
I recommend you use the great chrome extension Postman to make such HTTP calls!