2. EJB 3 Sample Project Installation

 Documentation Summary

 Page Summary

The EJB 3 sample application shows a basic address book with a list of persons in the left panel and, for each selected person, a list of contacts in the right panel. You may search existing persons by first or last name, and create, edit, and delete persons or contacts based on the login you choose. Note that admins have the right to make modifications, users have not.

The two panels are packed in HDividedBox container and the current position of this divider is saved in an EJB 3 stateful bean. This position will be restored if you reload the application via the Reload button of your browser.

More specifically, this sample illustrates:

• EJB 3 entity beans externalization, via the HibernateExternalizer class, with Gas3 generated ActionScript3 classes.
  

• EJB 3 stateless session beans. The PersonServiceBean class uses an EntityManager for persistence operations.
  

• EJB 3 stateful session beans. The PositionServiceBean stores the current divider position and, even if you reload the Flex application, this position is restored from this stateful context. However, if you click the "][" button at the top right corner of the Flex application, the remove() method is called on the EJB and the initial value is restored. This appends because the previous stateful bean instance is destroyed and the new one returns a default initial value of 300.
  

• Automatic configuration. Entity bean externalization and remote destinations are automatically configured. See the scan="true" attribute in ear/addressbook.war/WEB-INF/granite/granite-config.xml, the ejb3/META-INF/services-config.properties file and the @RemoteDestination annotation in session bean classes.
  

• Security settings, via the TomcatSecurityService class (see granite-config.xml), at two levels; a web-tier security that forbids unauthenticated accesses (@RemoteDestination annotation in PersonServiceBean), and a EJB-tier security that forbids modification method calls for a simple user (@SecurityDomain and @RolesAllowed annotations in PersonServiceBean).
   

Follow general requirements here, then:

• Download JBoss 4.2+.
• Download graniteds-ejb3-1.2.0.zip.
• Download org.granite.gas3_1.2.0.zip.
   

Follow these steps:

• Unzip the JBoss binary distribution somewhere on your computer; for example /jboss-4.2.2.GA.
• Unzip the org.granite.gas3_1.2.0.zip archive in your Eclipse plugin directory.
• (Re)start Eclipse, right-click in the Package Explorer view, choose Import, then General / Existing Projects into Workspace, choose Select Archive File, browse to graniteds-ejb3-1.2.0.zip, and click on Finish.
• Edit the env.properties file in the root directory of the graniteds_ejb3 project, and adjust the following variables:
   

  # Set 'FLEX_HOME' property to your flex2 sdk installation directory and
  # 'FLEX_TASKS_JAR' to your flexTasks.jar location.
  # WARNING: This property must have this exact name ('FLEX_HOME').
  FLEX_HOME=/flex_sdk_2
  FLEX_TASKS_JAR=${FLEX_HOME}/lib/flexTasks.jar
  
  # Set 'JBOSS_HOME' property to your JBoss installation directory and
  # 'JBOSS_HOME_DEPLOY' to your deploy directory.
  JBOSS_HOME=/jboss-4.2.2.GA
  JBOSS_HOME_DEPLOY=${JBOSS_HOME}/server/default/deploy
  

  The JBOSS_HOME_DEPLOY variable should be ok without modification.

• Copy users.properties and roles.properties found in the root directory of the graniteds_ejb3 project into the /jboss-4.2.2.GA/server/default/conf/props directory. Make sure to backup existing files first.
• Edit the /jboss-4.2.2.GA/server/default/conf/login-config.xml and replace at the end of the file:
   

    <application-policy name="other">
      <authentication>
        <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"
          flag="required" />
      </authentication>
    </application-policy>
  

  by:

  <application-policy name="other">
      <authentication>
        <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"
          flag="required">
          <module-option name="usersProperties">props/users.properties</module-option>
          <module-option name="rolesProperties">props/roles.properties</module-option>
        </login-module>
      </authentication>
    </application-policy>
  

   

• Open an Eclipse Ant view (Window / Show View / Ant), drag and drop the build.xml file, found in the root directory of the graniteds_ejb3 project, on it, and double-click the Deploy target. This should compile, package, and deploy the EJB 3 sample application in JBoss.
• Start JBoss (run.bat or run.sh in /jboss-4.2.2.GA/bin).
• Point your browser to http://localhost:8080/graniteds-ejb3/.

You should now see the EJB 3 sample application running.