Application - Petstore Java EE 7
- Author : Antonio Goncalves
- Level : Intermediate
- Technologies : Java EE 7 (JPA 2.1, CDI 1.1, Bean Validation 1.1, EJB Lite 3.2, JSF 2.2, JAX-RS 2.0), Twitter Bootstrap (Bootstrap 3.x, JQuery 2.x, PrimeFaces 5.x)
- Application Servers : GlassFish 4.x, WildFly 8
- Summary : A Petstore-like application using Java EE 7
Purpose of this application
Do you remember the good old Java Petstore ? It was a sample application created by Sun for its Java BluePrints program. The Java Petstore was designed to illustrate how J2EE (and then Java EE) could be used to develop an eCommerce web application. Yes, the point of the Petstore is to sell pets online. The Petstore had a huge momentum and we started to see plenty of Petstore-like applications flourish. The idea was to build an application with a certain technology. Let's face it, the J2EE version was far too complex using plenty of (today outdated) design patterns. When I wrote my Java EE 5 book back in 2006, I decided to write a Petstore-like application but much simpler. But again, it's out-dated today.
What you have here is another Petstore-like application but using Java EE 7 and all its goodies (CDI, EJB Lite, REST interface). It is based on the Petstore I developed for my Java EE 5 book (sorry, it's written in French). I've updated it based on my Java EE 6 book, and now I'm updating it again so it uses some new features of Java EE 7 described on my Java EE 7 book. The goals of this sample is to :
- use Java EE 7 and just Java EE 7 : no external framework or dependency (except web frameworks or logging APIs)
- make it simple : no complex business algorithm, the point is to bring Java EE 7 technologies together to create an eCommerce website
If you want to use a different web interface, external frameworks, add some sexy alternative JVM language… feel free to fork the code. But the goal of this EE 7 Petstore is to remain simple and to stick to Java EE 7.
The only external framework used are Arquillian, Twitter Bootstrap and PrimeFaces. Arquillian is used for integration testing. Using Maven profile, you can test services, injection, persistence... against different application servers. Twitter Bootstrap and PrimeFaces bring a bit of beauty to the web interface.
Compile and package
Being Maven centric, you can compile and package it without tests using
mvn clean compile -Dmaven.test.skip=true,
mvn clean package -Dmaven.test.skip=true or
mvn clean install -Dmaven.test.skip=true. Once you have your war file, you can deploy it.
Test with Arquillian
Launching tests under WildFly is straight forward. You only have to launch WidlFly and execute the tests using the Maven profile :
mvn clean test -Parquillian-wildfly-remote
Deploy in Glassfish
This sample has been tested with GlassFish 4.x in several modes :
- GlassFish runtime : download GlassFish, install it, start GlassFish (typing
asadmin start-domain) and once the application is packaged deploy it (using the admin console or the command line
asadmin deploy target/applicationPetstore.war)
- GlassFish embedded : use the GlassFish Maven Plugin by running
mvn clean package embedded-glassfish:run(you might have to increase Perm Gen space with
Execute the sample
Once deployed go to the following URL and start buying some pets: http://localhost:8080/applicationPetstore.
curl -X GET http://localhost:8080/applicationPetstore/rs/catalog/categories
curl -X GET http://localhost:8080/applicationPetstore/rs/catalog/products
curl -X GET http://localhost:8080/applicationPetstore/rs/catalog/items
You can also get a JSON representation as follow :
curl -X GET -H "accept: application/json" http://localhost:8080/applicationPetstore/rs/catalog/items
Test this application on CloudBees
Third Party Tools & Frameworks
When, like me, you have no web designer skills at all and your web pages look ugly, you use Twitter Bootstrap ;o)
I use Silk Icons which are in Creative Commons
Arquillian for the integration tests.
Sonar provides services for continuous inspection of code quality. I use it to have some metrics on the Yaps Petstore (and produce, hopefully, not too ugly code with good code coverage). You can also use it to get some metrics. Download, install and run Sonar with
mvn -Pjacoco,glassfish3 install sonar:sonar (or
mvn -Pjacoco,jboss7 install sonar:sonar to run on JBoss 7). For integration testing we need to use JaCoCo. To view the code coverage of integartion tests, make sure you add the "Integration test coverage" widget to your Sonar dashboard (you need admin privileges).
Some people who worked on this project :
Bugs & Workaround
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.