Exercises

The exercise starts where today's example left of. The agency case study already provides a number of beans:

• There is a stateless Agency bean that returns lists of all applications, customers, locations and skills in the database.

• There is a stateful Advertise bean that allows advertisers (of jobs) to update their name, email, and address, and to manage the jobs they have posted to the job agency.

• There is a stateful AdvertiseJob bean that represents an advertised job. This allows the description, location, and required skills to be maintained.

However, it does not define any bean for the potential job applicants at this point. What is required is a Register bean that allows applicants to register themselves with the job agency. The exercise is to implement the RegisterBean, define this new bean within the supplied agency.ear enterprise application, configure the bean, deploy your bean to the J2EE RI, and finally test with either RegisterClient or AllClients (supplied).

Under the Day 5 exercise directory, you will find the usual subdirectories, including the following:

• src The source code for the EJBs and clients

• classes Directory to hold the compiled classes; empty

• build Working directory for the asant build files to use

• j2ee-ri Working directory for using deploytool to build and deploy the agency.ear application

The Register and RegisterHome interfaces have been provided for you, under the src directory. For example, the Register interface is as follows:

package agency;

import java.rmi.*;
import javax.ejb.*;

public interface Register extends EJBObject
{
    void updateDetails (
        String name, String email, 
        String location, String summary, String[] skills
    ) throws RemoteException;
    String getLogin() throws RemoteException;
    String getName() throws RemoteException;
    String getEmail() throws RemoteException;
    String getLocation() throws RemoteException;
    String getSummary() throws RemoteException;
    String[] getSkills() throws RemoteException;
}

Today's exercise is to implement the RegisterBean, configure an appropriate deployment descriptor, deploy your bean to the J2EE RI, and then test with the RegisterClient. The bean will need to be stateful.

If you need some pointers as to how to go about this, read on.

asant run-j2ee-ri

<ejb-jar>
...
  <assembly-descriptor>
...
    <container-transaction>
      <method>
        <ejb-name>RegisterBean</ejb-name>
        <method-intf>Remote</method-intf>
        <method-name>*</method-name>
      </method>
      <trans-attribute>Required</trans-attribute>
    </container-transaction>
  </assembly-descriptor>
</ejb-jar>

A solution to the exercise is provided in Day05/agency.