Enterprise Java Development@TOPIC@
In this section of the lab we will be getting the environment ready and getting you familiar with the modules you will be working with.
Start the application server either at the command line or within IDE
Figure 60.1. Start the Application Server (command line)
$ ./bin/standalone.sh ... 22:48:07,175 INFO [org.jboss.as] (Controller Boot Thread) JBAS015874: WildFly 8.1.0.Final "Kenny" started in 56096ms - Started 630 of 694 services (131 services are lazy, passive or on-demand)
Start off by building the solution to verify the environment os setup correctly.
Change directory to the jpatickets-labsol directory
Build, deploy, and test the solution
Figure 60.2. Build, Deploy, and Test Solution
$ mvn clean install ... [INFO] Reactor Summary: [INFO] [INFO] EJB::JPA Tickets Lab::Solution ..................... SUCCESS [ 0.556 s] [INFO] EJB::JPA Tickets Lab::Solution::Impl ............... SUCCESS [ 11.543 s] [INFO] EJB::JPA Tickets Lab::Solution::EJB ................ SUCCESS [ 0.948 s] [INFO] EJB::JPA Tickets Lab::Solution::EAR ................ SUCCESS [ 0.730 s] [INFO] EJB::JPA Tickets Lab::Solution::WAR ................ SUCCESS [ 1.280 s] [INFO] EJB::JPA Tickets Lab::Solution::IT Test ............ SUCCESS [ 16.556 s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS
Now build the starting point for the exercise. Many things have been turned off but it should build successfully.
Change directory to the jpatickets-labex directory
Build initial state of exercise. Notice all the tests have been skipped
Figure 60.3. Build Initial Exercise State
$ mvn clean install ... Tests run: 10, Failures: 0, Errors: 0, Skipped: 10 ... [INFO] ------------------------------------------------------------------------ [INFO] Reactor Summary: [INFO] [INFO] EJB::JPA Tickets Lab::Exercise ..................... SUCCESS [ 0.690 s] [INFO] EJB::JPA Tickets Lab::Exercise::Impl ............... SUCCESS [ 11.621 s] [INFO] EJB::JPA Tickets Lab::Exercise::EJB ................ SUCCESS [ 1.021 s] [INFO] EJB::JPA Tickets Lab::Exercise::EAR ................ SUCCESS [ 0.747 s] [INFO] EJB::JPA Tickets Lab::Exercise::WAR ................ SUCCESS [ 0.846 s] [INFO] EJB::JPA Tickets Lab::Exercise::IT Test ............ SUCCESS [ 7.229 s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS
Import the jpatickets-labex module and its children into your
IDE to begin the changes to the exercise. The following shows the source
trees for the modules you will be working with.
The overall project is a six (6) module project with one(1) parent and five (5) child modules; impl, ejb, ear, war, and test.
Figure 60.4. Exercise Modules
jpatickets-labex
|-- jpatickets-labex-impl
| |-- pom.xml
| `-- src
| |-- main
| | `-- java
| `-- test
| |-- java
| `-- resources
|-- jpatickets-labex-ejb
| |-- pom.xml
| `-- src
| `-- main
| |-- java
| `-- resources
|-- jpatickets-labex-ear
| `-- pom.xml
|-- jpatickets-labex-war
| |-- pom.xml
| `-- src
| `-- main
| |-- java
| |-- resources
| `-- webapp-filtered
|-- jpatickets-labex-test
| |-- pom.xml
| `-- src
| `-- test
| |-- java
| `-- resources
`-- pom.xmlThe Impl module provides the business objects (BOs), data access objects (DAOs), and business logic for the application. The BOs are mapped to the database using JPA, the DAOs implement the details of accessing the BOs in the database. The business logic handles any logic issues above the data tier (minimal in this case). The impl module contains a JPA persistence unit and test infrastructure that we will want to use for reference when deploying one to the server-side. There are two main interfaces to the business logic; VenueMgmt and EventMgmt. The EJB tier simply needs to instantiate this logic, inject the objects with required resource dependencies (i.e., a persistence context/EntityManager), provide remote and local access, and define transaction semantics to the container. You will not need to modify this module during the exercise but may be asked to look through it.
Figure 60.5. Impl Module Source Tree
jpatickets-labex/jpatickets-labex-impl/
|-- pom.xml
`-- src
|-- main
| `-- java
| `-- org
| `-- myorg
| `-- jpatickets
| |-- bl
| | |-- EventMgmtImpl.java
| | |-- EventMgmt.java
| | |-- UnavailableException.java
| | |-- VenueMgmtImpl.java
| | `-- VenueMgmt.java
| |-- bo
| | |-- Address.java
| | |-- Event.java
| | |-- Seat.java
| | |-- SeatPK.java
| | |-- Ticket.java
| | |-- TicketPK.java
| | `-- Venue.java
| `-- dao
| |-- EventMgmtDAOImpl.java
| |-- EventMgmtDAO.java
| |-- VenueDAOImpl.java
| `-- VenueDAO.java
`-- test
|-- java
| `-- org
| `-- myorg
| `-- jpatickets
| `-- bl
| |-- TicketsFactory.java
| `-- TicketsTest.java
`-- resources
|-- log4j.properties
`-- META-INF
`-- persistence.xmlThe EJB contains two primary EJBs for the exercise (VenueMgmtEJB and EventMgmtEJB) and a third/fourth EJB we will not address (TicketsInitEJB and TicketsInitTxEJB). I refer to it as a third/fourth EJB because logically "TickitInit" is one logical EJB that has been split into two physical EJBs. TicketInitEJB is the remote facade for IT clients to initiate a DB reset. TicketInitTxEJB is an EJB that wraps drop() and create() schema into separate transactions. It happens to use BEAN managed transactions for those actions. You will primarily be working with the VenueMgmt and EventMgmt EJBs and the persistence unit that will be defined in META-INF/persistence.xml
Figure 60.6. EJB Module Source Tree
jpatickets-labex/jpatickets-labex-ejb/
|-- pom.xml
`-- src
`-- main
|-- java
| `-- org
| `-- myorg
| `-- jpatickets
| |-- dto
| | `-- EventDTO.java
| `-- ejb
| |-- EventMgmtEJB.java
| |-- EventMgmtRemote.java
| |-- TicketsInitEJB.java
| |-- TicketsInitRemote.java
| |-- TicketsInitTxEJB.java
| |-- VenueMgmtEJB.java
| `-- VenueMgmtRemote.java
`-- resources
`-- META-INF
`-- persistence.xmlThe EAR module contains no source other than a pom.xml. It is exclusively used to deploy the EJB to the server with its Impl module dependency. When identifying the entity classes in the EAR-deployed EJB persistence.xml as a "jar-file", it will be important to know the path of the Impl module within the EAR.
Figure 60.7. EAR Module Source and Deployable Artifact Tree
jpatickets-labex/jpatickets-labex-ear/ `-- pom.xml
jpatickets-labex/jpatickets-labex-ear/target/jpatickets-labex-ear-4.0.0-SNAPSHOT
|-- jpatickets-labex-ejb.jar
|-- lib
| `-- jpatickets-labex-impl-4.0.0-SNAPSHOT.jar
`-- META-INF
`-- application.xmlThe WAR module is provide to demonstrate persistent unit deployment through an imported EJB and an embedded persistence.xml. It is strictly being used as a deployment platform and does not container a user interface.
Figure 60.8. WAR Module Source Tree
jpatickets-labex-war/src/
`-- main
|-- java
| `-- org
| `-- myorg
| `-- jpatickets
| `-- webejb
| `-- WebVenueMgmtEJB.java
|-- resources
| `-- META-INF
| `-- persistence.xml
`-- webapp-filtered
`-- WEB-INF
`-- jboss-web.xmlThe RMI IT Test module is used to deploy the EAR and WAR and initiate tests within the exercise. When you start the exercise most/all of the @Tests have been deactivated with an @Ignore. You will turn them on to expose issues with the implementation and then implement a fix. At the end of the exercise all @Tests should be enabled and passing.
Figure 60.9. RMI IT Test Module Source Tree
jpatickets-labex-test/src/
`-- test
|-- java
| `-- org
| `-- myorg
| `-- jpatickets
| `-- ejbclient
| |-- EventMgmtIT.java
| |-- TicketsITFactory.java
| `-- VenueMgmtIT.java
`-- resources
|-- jboss-ejb-client.properties
|-- jndi.properties
`-- log4j.xmlDuring this setup you started you
Started you application server so applications could be deployed to it
Built, deployed, and tested the solution to verify your environment is correct
Built the starting state of the exercise to verify it could build in its initial state
Imported the exercise into your IDE to begin making changes to the exercise copy