Chapter 5.

Creating a BMP Entity Bean

This chapter describes how to create a Bean Managed Persistence (BMP) EJB component. We will create two BMP beans, Customer and Manager, as shown below. The Customer bean will be responsible for storing the details of customers of MyStore. The Manager bean stores details of the manager of MyStore. Both beans communicate with their respective tables in the database using Data Access Objects (DAOs) named CustomerDAO and ManagerDAO respectively.

All customers have been assigned a unique customerID for housekeeping purposes in MyStore in addition to their username for accessing the services of MyStore. Similarly the Manager of MyStore has been assigned a unique ManagerID.

Note : It is the usual practice to access business methods of BMP beans via a session bean, which encapsulates business logic and acts as an interface to further EJB components. In this case Customer and Manager are accessible via by StoreAccess.

This approach comes from a pattern called a Session Facade, whereby entERPrise beans encapsulate business logic and business data and expose their interfaces. The session bean acts as a facade to encapsulate the complexity of interactions with the lower-level beans. The session facade is responsible for managing business objects and provides a uniform business service abstraction to presentation layer clients, thereby hiding the business object implementation in the lower-level beans.

This tutorial uses that pattern for business tier implementation.

Tasks :

1. Create a BMP bean named Customer under package au.com.tusc.bmp.

2. Create a DAO class named CustomerDAOImpl under package au.com.tusc.dao.

3. Add all attributes/properties to the CustomerBean, with getter and setter methods for each of the attributes.

4. Add a finder method named ejbFindByPrimaryKey with the signature

   public CustomerPK ejbFindByPrimaryKey (CustomerPK pk) throws FinderException

5. Add a finder method named ejbFindByUserID with the signature

   public CustomerPK ejbFindByUserID (String userID) throws FinderException

6. Add a business method named getCustomerData with the signature

   public CustomerData getCustomerData()

7. Implement required methods in the CustomerDAOImpl class.

8. Deploy the Customer Bean.

9. Add a create method to the StoreAccess Bean.

   public void ejbCreate() throws Javax.ejb.CreateException

10. Add a business method to the StoreAccess Bean.

    public CustomerData getCustomerData(String userID)

11. Create a test client named SessionBMPClient under package au.com.tusc.client.

12. Run your client and test the bean.

Create the Customer BMP Entity Bean :

Go To Package Explorer > Expand Mystore (project) node > select src, right click and a menu will pop up.

On the pop up menu > New > Lomboz EJB Creation Wizard.

Enter package name au.com.tusc.bmp, bean name Customer and select bean type as Bean Manged Entity > Finish.

This will create a package named au.com.tusc.bmp under src and CustomerBean under that package as shown below.

Note: It will generate the bean name, jndi-name and type of bean in file. Also, the word 'Bean' is appended to the name of the file.

As we can see from the figure above it has created a class level tag @ejb.bean, which has assigned the bean type, its name and its JNDI name which will be generated in the Home interface. This tag will also generate deployment descriptors in ejb-jar.XML and jboss.xml file once you generate your EJB classes.

Now we are going to generate all the interfaces including Home, Remote, DAO and other helper classes. We don't need to specify any tags in ejbGenerate.xml as we have already set up that for the MyStoreMgr EJB module in chapter 3.

文章整理：西部数码--专业提供域名注册、虚拟主机服务
http://www.west263.com
以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!