tree: 1820280fdd173d3dcea089e34e66292ddf196b31 [path history] [tgz]
  1. src/
  2. pom.xml
  3. README.MD
examples/bookmark-em/README.MD

Bookmark EM Example

This example demonstrates how to use JPA in the backend. The example is based on bookmark example from the RESTful Web Services book, which was inspired by the http://del.icio.us/ web service.

A bookmark web application is presented that is capable of maintaining users and their bookmarks.

Contents

The mapping of the URI path space is presented in the following table:

URI pathResource classHTTP methodsNotes
/usersUsersResourceGETReturns a list of users.
/users/{userid}UserResourceGET, PUT (used also for creating new users), DELETEReturns user details
/users/{userid}/bookmarksBookmarksResourceGET, POSTReturns a list of bookmarks for actual user resource.
/users/{userid}/bookmarks/{bmid}BookmarkResourceGET, PUT, DELETEReturns bookmark uri and a long and short description.

Running the Example

Bookmark example runs on Glassfish 3.1 application server (https://javaee.github.io/glassfish/) and needs a running JavaDB (http://www.oracle.com/technetwork/java/javadb/overview/index.html) instance for underlying data (it comes along with GlassFish 3.1).

Presuming, you have installed Glassfish 3.1. AS_HOME variable should point to your glassfish installation directory.

Building And Starting The Bookmark Service

You then build and run the example by

mvn package
$AS_HOME/bin/asadmin start-domain
$AS_HOME/bin/asadmin start-database
$AS_HOME/bin/asadmin deploy target/bookmark-em.war

Test Client Running

mvn test -Djersey.config.test.container.factory=org.glassfish.jersey.test.external.ExternalTestContainerFactory -Djersey.config.test.logging.enable=true -Djersey.config.test.logging.dumpEntity=true -Djersey.config.test.container.port=8080 -Ptest

Links

http://java.net/projects/bpcatalog/sources/svn/content/trunk/ee5/docs/persistence/webonlyapp.html?raw=true