EasyBeans Developer's guide Florent BENOIT, OW2 consortium EasyBeans Developer's guide by Florent BENOIT Published $Id: developerguide.xml 216 2006-03-16 19:01:07Z benoitf $ Copyright © 2006-2008 OW2 Consortium Abstract The EasyBeans developer guide is intended for developers wanting to work with the source distribution of EasyBeans. People wanted to contribute to EasyBeans should read this documentation. This work is licensed under the Creative Commons Attribution-ShareAlike License. To view a copy of this license,visit http:// creativecommons.org/licenses/by-sa/2.0/deed.en [http://creativecommons.org/licenses/by/2.0/] or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA. Table of Contents 1. Building EasyBeans From Source. ................................................................................ 1 1.1. Requirements ................................................................................................. 1 1.1.1. JDK ................................................................................................... 1 1.1.2. Maven ................................................................................................ 1 1.1.3. Ant .................................................................................................... 1 1.1.4. TestNG ............................................................................................... 1 1.1.5. Clover ................................................................................................ 1 1.2. Optional Requirements ..................................................................................... 1 1.2.1. Eclipse ............................................................................................... 1 1.2.2. Eclipse Plugins .................................................................................... 1 1.2.2.1. Maven Plugin ............................................................................ 1 1.2.2.2. Checkstyle Plugin ...................................................................... 1 1.2.2.3. AnyEdit Plugin .......................................................................... 2 1.2.2.4. Asm Plugin ............................................................................... 2 1.2.2.5. TestNG Plugin .......................................................................... 2 1.3. Compiling EasyBeans ...................................................................................... 2 1.4. Maven assemblies ........................................................................................... 2 1.4.1. End-User assemblies ............................................................................. 2 1.4.1.1. Jetty ........................................................................................ 2 1.4.1.2. JOnAS ..................................................................................... 2 1.4.1.3. Tomcat ..................................................................................... 3 1.4.1.4. UberJar .................................................................................... 3 1.4.2. Java EE modules assemblies ................................................................... 3 1.4.2.1. War module .............................................................................. 3 1.4.2.2. Rar module ............................................................................... 3 2. Getting EasyBeans From the SVN Repository ................................................................ 4 3. Running EasyBeans server. ......................................................................................... 5 3.1. Requirements ................................................................................................. 5 3.2. Running ........................................................................................................ 5 4. Using the Examples ................................................................................................... 7 4.1. Compiling the Examples .................................................................................. 7 4.1.1. Requirements ....................................................................................... 7 4.1.2. Compile .............................................................................................. 7 4.2. Running Examples ........................................................................................ 10 4.2.1. Stateless Session Bean ......................................................................... 10 4.2.1.1. Description .............................................................................. 10 4.2.1.2. Running the Server ................................................................... 11 4.2.1.3. Deploying the Bean .................................................................. 11 4.2.1.4. Running the Client ................................................................... 11 4.2.2. Stateful Session Bean .......................................................................... 11 4.2.2.1. Description .............................................................................. 11 4.2.2.2. Running the Server ................................................................... 11 4.2.2.3. Deploying the Bean .................................................................. 11 4.2.2.4. Running the Client ................................................................... 12 4.2.3. Entity Bean ....................................................................................... 12 4.2.3.1. Description .............................................................................. 12 4.2.3.2. Running the Server ................................................................... 12 4.2.3.3. Deploying the Bean .................................................................. 12 4.2.3.4. Running the Client ................................................................... 13 4.2.3.5. Properties for the persistence ...................................................... 13 4.2.4. Message Driven Bean .......................................................................... 13 4.2.4.1. Description .............................................................................. 13 4.2.4.2. Running the Server ................................................................... 14 4.2.4.3. Deploying the Bean .................................................................. 14 4.2.4.4. Running the Client ................................................................... 14 iv EasyBeans Developer's guide 4.2.5. Timer example ................................................................................... 14 4.2.5.1. Description .............................................................................. 14 4.2.5.2. Running the server ................................................................... 15 4.2.5.3. Deploying the Bean .................................................................. 15 4.2.5.4. Running the Client ................................................................... 15 4.2.6. Security example ................................................................................ 15 4.2.6.1. Description .............................................................................. 15 4.2.6.2. Running the Server ................................................................... 16 4.2.6.3. Deploying the Bean .................................................................. 16 4.2.6.4. Running the Client ................................................................... 16 4.2.7. Pool example ..................................................................................... 16 4.2.7.1. Description .............................................................................. 16 4.2.7.2. Running the Server ................................................................... 17 4.2.7.3. Deploying the Bean .................................................................. 17 4.2.7.4. Running the Client ................................................................... 17 4.2.8. Migration EJB 2.1/3.0 example ............................................................. 17 4.2.8.1. Description .............................................................................. 18 4.2.8.2. Running the Server ................................................................... 18 4.2.8.3. Deploying the Bean .................................................................. 18 4.2.8.4. Running the Client ................................................................... 18 4.2.9. EAR example ..................................................................................... 18 4.2.9.1. Description .............................................................................. 19 4.2.9.2. Running the Server ................................................................... 19 4.2.9.3. Deploying the EAR .................................................................. 19 4.2.9.4. Using the Client ....................................................................... 19 5. EasyBeans Code Convention ..................................................................................... 21 5.1. File Organization .......................................................................................... 21 5.1.1. Header .............................................................................................. 21 5.1.2. Imports ............................................................................................