TechFAQ

The class MUST implement, directly or indirectly, the javax.ejb.EntityBean interface.

public interface EntityBean extends EnterpriseBean {
	void ejbActivate() throws EJBException, RemoteException;
	void ejbLoad() throws EJBException, RemoteException;
	void ejbPassivate() throws EJBException, RemoteException;
	void ejbRemove() throws RemoveException, EJBException, RemoteException;
	void ejbStore() throws EJBException, RemoteException;
	void setEntityContext(EntityContext ctx) throws EJBException, RemoteException;
	void unsetEntityContext() throws EJBException, RemoteException;
}

public interface EnterpriseBean extends Serializable {
}
							

The class MUST be defined as public and MUST be abstract.

The class MUST define a public constructor that takes no arguments.

The class MUST NOT define the finalize() method.

The entity bean class MUST implement the BUSINESS methods, and the ejbCreate<METHOD> and ejbPostCreate<METHOD> methods.

The entity bean class MUST implement the ejbHome<METHOD> methods that correspond to the home business methods specified in the bean’s home interface. These methods are executed on an instance in the POOLED state; hence they MUST NOT access state that is particular to a specific bean instance (e.g., the accessor methods for the bean’s abstract persistence schema MUST NOT be used by these methods).

The entity bean class MUST implement the get and set accessor methods of the bean’s abstract persistence schema as abstract methods.

The entity bean class may have superclasses and/or superinterfaces. If the entity bean has superclasses, the business methods, the ejbCreate<METHOD> and ejbPostCreate<METHOD> methods, and the methods of the EntityBean interface may be implemented in the enterprise bean class or in any of its superclasses.

The entity bean class is allowed to implement other methods (for example helper methods invoked internally by the business methods) in addition to the methods required by the EJB specification.

The entity bean class DOES NOT implement the finder methods. The implementations of the finder methods are provided by the container.

The entity bean class MUST implement any ejbSelect<METHOD> methods as abstract methods.

The class MUST be defined as public and MUST NOT be abstract.

The class MUST be SERIALIZABLE.

The method name MUST have ejbCreate as its prefix.

The method MUST be declared as public.

The method MUST NOT be declared as final or static.

The return type must be the entity bean’s PRIMARY KEY type (NOTE, the return type of HOME's create(...) method is COMPONENT INTERFACE type).

If the ejbCreate<METHOD>(...) method corresponds to a create<METHOD>(...) on the entity bean’s remote home interface, the method arguments and return value types must be legal types for RMI-IIOP.

The throws clause MUST define the javax.ejb.CreateException. The throws clause may define arbitrary application specific exceptions.

The method name MUST have ejbPostCreate as its prefix.

The method MUST be declared as public.

The method MUST NOT be declared as final or static.

The return type MUST be void.

The method arguments MUST be the same as the arguments of the matching ejbCreate<METHOD>(...)method.

The throws clause may define arbitrary application specific exceptions (the javax.ejb.CreateException MAY be thrown, but it is NOT a MANDATORY).

An ejbHome<METHOD>(...) method MUST exist for EVERY home <METHOD>(...) method on the entity bean’s remote home or local home interface. The method name MUST have ejbHome as its prefix followed by the name of the <METHOD> method in which the first character has been uppercased.

The method MUST be declared as public.

The method MUST NOT be declared as static.

If the ejbHome<METHOD>(...) method corresponds to a home <METHOD>(...) on the entity bean’s REMOTE home interface, the method argument and return value types MUST be legal types for RMI-IIOP.

The throws clause may define arbitrary application specific exceptions. The throws clause MUST NOT throw the java.rmi.RemoteException.

The method name MUST have ejbSelect as its prefix.

The method MUST be declared as public.

The method MUST be declared as abstract.

The throws clause MUST define the javax.ejb.FinderException. The throws clause may define arbitrary application specific exceptions.

The method names can be arbitrary, but they must not start with 'ejb' to avoid conflicts with the callback methods used by the EJB architecture.

The method MUST be declared as public.

The method MUST NOT be declared as final or static.

If the business method corresponds to a method of the entity bean’s REMOTE interface, the method argument and return value types MUST be legal types for RMI-IIOP.

The throws clause may define arbitrary application specific exceptions. The business methods of an entity bean with cmp-version 2.x MUST NOT throw the java.rmi.RemoteException.