Rules Implemented by the Verify EJB Tool

This document lists the rules imposed on EJB deployment descriptors and code as per the EJB 2.0 specification.

Note: The EJB Verifier verifies modules and beans developed to the EJB 2.0 specification (including CMP 1.x beans in accordance with the EJB .20 specification). It does not support modules and beans developed to the EJB 1.1 specification.

The EJB Verifier in JDeveloper 9.0.4 implements many of these rules; the remainder should be implemented by 9.0.5. The implemented rules are identified by a filled bullet character, the unimplemented ones by an unfilled bullet character. For example:

• This rule is checked by the Verify tool
• This rule is not

There is a fair amount of duplication between rules for session, entity CMP, and entity BMP beans and rules for remote and local homes, etc. Thus, many rules appear multiple times differing only by the specification reference.

Messages are worded to describe the scope of an issue properly. For example, CMP 2.x entity beans must be abstract, but BMP and CMP 1.x entity beans must not. So the message refers to "CMP 2.x entity bean", "BMP entity bean", or "CMP 1.x entity bean", as appropriate. On the other hand, all entity beans must extend javax.ejb.EntityBean, so the message refers only to "entity bean".

Some rules have [warning] appended. These typically flag things that are specifically discouraged by the spec, but not absolutely prohibited. Usually in these cases, the message text contains "should" rather than "must".

Deployment Descriptor Rules

Rules are grouped by enclosing DTD element. The paths in parentheses at the end of each rule designate the specific DTD element to which the rule applies, relative to the enclosing DTD element ("." indicates the "enclosing" element itself).

Bean Descriptions

<entity>, <message-driven>, <session>

• EJB name <class-name> already declared (ejb-name)
• Bean class <class-name> not found in project (ejb-class)
• Environment entry name <name> already declared (env-entry/env-entry-name)
• Environment entry type <class-name> must be primitive wrapper type or String (env-entry/env-entry-type)
• Environment entry value must be convertible to <class-name> (env-entry/env-entry-value)
• EJB reference <name> already declared (ejb-ref/ejb-ref-name, ejb-local-ref/ejb-ref-name)
• EJB reference name <name> should be prefixed with "ejb/" (ejb-ref/ejb-ref-name, ejb-local-ref/ejb-ref-name) [warning]
• EJB reference expected type must be Entity or Session (ejb-ref/ejb-ref-type, ejb-local-ref/ejb-ref-type)
• EJB reference <interface> interface <class-name> not found in project (ejb-ref/remote, ejb-ref/home, ejb-ref/local, ejb-ref/local-home)
• EJB reference <interface> interface must extend <class-name> (ejb-ref/remote, ejb-ref/home, ejb-ref/local, ejb-ref/local-home)
• EJB <name> assumed to be externally defined (ejb-ref/ejb-link, ejb-local-ref/ejb-link) [warning]
• Resource factory <name> already referenced (resource-ref/res-ref-name)
• Resource factory type <class-name> not found in project (resource-ref/res-type)
• Resource factory authentication type must be Application or Container (resource-ref/res-auth)
• Resource factory shareability must be Shareable or Unshareable (resource-ref/res-sharing-scope)
• Resource environment <name> already referenced (resource-env-ref/resource-env-ref-name)
• Resource environment type <class-name> not found in project (resource-env-ref/resource-env-ref-type)
• Security role name <name> not valid XML name (NMTOKEN) (security-identity/run-as/role-name)
• Security role <name> not declared in assembly descriptor (security-identity/run-as/role-name)

<entity>, <session>

• <interface> interface <class-name> not found in project (remote, home, local, local-home)
• Remote or local interface must be declared (.)
• Home interface must be declared when remote interface declared (remote)
• Remote interface must be declared when home interface declared (home)
• Local home interface must be declared when local interface declared (local)
• Local interface must be declared when local home interface declared (local-home)
• Security role reference <name> not linked to security role (security-role-ref/role-name)
• Security role name <name> not valid XML name (NMTOKEN) (security-role-ref/role-link)
• Security role <name> not declared in assembly descriptor (security-role-ref/role-link)

<session>

• Session type must be either Stateful or Stateless (session-type)
• Transaction type must be either Bean or Container (transaction-type)

<message-driven>

• <interface> interface not applicable to message-driven bean (remote, home, local, local-home)
• Acknowledgment mode not applicable with Container transaction type (acknowledge-mode)
• Acknowledgment mode must be either Auto-acknowledge or Dups-ok-acknowledge (acknowledge-mode)
• Destination type must be either javax.jms.Queue or javax.jms.Topic (message-driven-destination/destination-type)
• Subscription durability not applicable for Queue destination type (message-driven-destination/subscription-durability)
• Subscription durability must be either Durable or NonDurable (message-driven-destination/subscription-durability)
• Transaction type must be either Bean or Container (transaction-type)

<entity>

• Entity bean name <name> must be valid Java identifier (ejb-name, 10.3.13)
• Entity bean name <name> must not be reserved EJB QL identifier (ejb-name, 11.2.6.1)
• Persistence type must be either Bean or Container (persistence-type)
• Reentrant must be either True or False (reentrant)
• Primary key class <class-name> not found in project (prim-key-class)

<entity> CMP

• CMP version must be either 1.x or 2.x (cmp-version)
• CMP field <name> must be defined to correspond to primary key field <name> (prim-key-class)
• Primary key field <name> must be public (prim-key-class)
• Primary key field <name> must be a CMP field (primkey-field)
• Primary key field must be of primary key class <class-name> (primkey-field)

<entity> CMP 2.x

• Name <name> of CMP 2.x bean not valid XML name (NMTOKEN) (ejb-name)
• Name <name> of CMP 2.x bean should not be EJB QL reserved word (ejb-name, 10.6.14)
• Abstract schema name required for CMP 2.x bean (abstract-schema-name)
• Abstract schema name <name> must be valid Java identifier (abstract-schema-name, 10.3.13)
• Abstract schema name <name> should not be reserved EJB QL identifier (ejb-name, 10.6.14)
• Query declaration missing for query method <signature> (.)
• Find method <signature> not found in entity bean class (query/query-method)
• Select method <signature> not found in entity bean class (query/query-method)
• CMP 2.x field name <name> must start with lowercase letter (cmp-field/field-name)
• CMP 2.x field name <name> must be a valid Java identifier (cmp-field/field-name, 10.3.1)
• Result type mapping not applicable to finder method (query/result-type-mapping)
• Result type mapping must be Local or Remote (query/result-type-mapping)

<entity> CMP 1.x

• Home interface required for CMP 1.x bean (.)
• Remote interface required for CMP 1.x bean (.)
• Query declaration not applicable to CMP 1.x bean (query)
• CMP field required for CMP 1.x bean (cmp-field/field-name)
• CMP 1.x bean field <name> must be defined in <class-name> (cmp-field/field-name)

<entity> BMP

• Primary key field not applicable for BMP bean (primkey-field)
• CMP version not applicable for BMP bean (cmp-version)
• Query declaration not applicable to BMP bean (query)
• CMP field not applicable to BMP bean (cmp-field)

Relationships

<ejb-relation>

• Relation name <name> already used (ejb-relation-name)
• Relationship role name <name> already used (ejb-relationship-role/ejb-relationship-role-name)
• Role source entity bean <name> not defined (ejb-relationship-role/relationship-role-source/ejb-name)
• Bean <name> cannot participate in a relationship because it is not a CMP 2.x entity bean (ejb-relationship-role/relationship-role-source/ejb-name)
• Multiplicity must be One or Many (ejb-relationship-role/multiplicity)
• Cascading deletion not applicable when other role has multiplicity of Many (ejb-relationship-role/cascade-delete)
• CMR field name must begin with lowercase letter (ejb-relationship-role/cmr-field/cmr-field-name)
• CMP 2.x field name <name> must be a valid Java identifier (cmp-field/field-name, 10.3.1)
• CMR field type must be java.util.Collection or java.util.Set (ejb-relationship-role/cmr-field/cmr-field-type)
• Accessor method <signature> for CMR field <name> not found in <class-name> (ejb-relationship-role/cmr-field/cmr-field-name)

Assembly Descriptor

<assembly-descriptor>

• Security role name <name> not valid XML name (NMTOKEN) (security-role/role-name)
• Security role <name> already declared (security-role/role-name)
• Method permission security role name not valid XML name (NMTOKEN) (method-permission/role-name)
• Method permission security role <name> not declared (method-permission/role-name)
• EJB <name> not known (method-permission/method/ejb-name, container-transaction/method/ejb-name, exclude-list/method/ejb-name)
• EJB interface selector not one of: Home, Remote, LocalHome, or Local (method-permission/method/method-intf, container-transaction/method/method-intf, exclude-list/method/method-intf)
• Method <signature> must be defined in <interface-list> (method-permission/method, container-transaction/method, exclude-list/method)
• Transaction attribute must be one of: NotSupported, Supports, Required, RequiresNew, Mandatory, Never (container-transaction/trans-attribute)
• Transaction attribute for message-driven bean onMessage method must be one of: NotSupported, Required (container-transaction/trans-attribute, 15.4.7)
• Method <signature> already assigned transaction attribute (container-transaction/method)
• <unchecked> overrides security role assignments for method <signature> (method-permission/method) [warning] (.)
• <exclude-list> overrides security role assignments for method <signature> (exclude-list/method) [warning]
• Method <signature> has no security role assignment (assembly-descriptor) [warning]

Miscellaneous

<large-icon>, <small-icon> (in <ejb-jar>, <entity>, <message-driven> , <session>)

• Icon <file> not found in project (.)
• Icon <file> not a valid GIF or JPEG image (.)

<ejb-client-jar>

• Client JAR <file> not found in workspace (.) [warning]

Interface and Class Rules

Session Bean

session bean class

• Session bean class must implement javax.ejb.SessionBean (7.10.2)
• Session bean class must not implement javax.jms.MessageListener (15.4.2)
• Session bean class must be public (7.10.2)
• Session bean class must not be abstract (7.10.2)
• Session bean class must not be final (7.10.2)
• Session bean class must have public no-argument constructor (7.10.2)
• Session bean class must not define finalize()(7.10.2)
• Session bean should not implement remote interface (7.10.2) [warning]
• Session bean should not implement local interface (7.10.2) [warning]
• Support method name <name> must not start with "ejb" (7.10.4)
• Remote business method <signature> must be implemented (7.10.5)
• Local business method <signature> must be implemented (7.10.7)
• Remote ejbCreate method <signature> must be implemented (7.10.6)
• Local ejbCreate method <signature> must be implemented (7.10.8)
• ejbCreate method should not throw RemoteException (7.10.3) [warning]
• ejbCreate method must be public (7.10.3)
• ejbCreate method must not be final (7.10.3)
• ejbCreate method must not be static (7.10.3)
• ejbCreate method return type must be void (7.10.3)
• ejbCreate method <signature> must correspond to a create method (7.10.4, 7.10.6)
• Business method should not throw RemoteException (7.10.4) [warning]
• Business method must be public (7.10.4)
• Business method must not be final (7.10.4)
• Business method must not be static (7.10.4)
• Business method return type must be <class-name> (7.10.5)
• Business method return type must be <class-name> (7.10.7)
• Session bean field should not be transient (7.4.1)
• Session bean with bean managed transaction demarcation must not implement javax.ejb.SessionSynchronization (7.5.3)
• Stateless session bean must not implement javax.ejb.SessionSynchronization (7.10.2)
• ejbPostCreate method not applicable to session bean (7.10.2) [warning]

session bean class method bodies

• Method <name> method must not use SessionContext method <name> (7.6.1)
• Method <name> method must not use UserTransaction method <name> (7.6.1)
• Method <name> method must not use enterprise bean method <name> (7.6.1)
• Method <name> method must not use resource manager method <name> (7.6.1)
• Session bean must not invoke getPrimaryKey() (6.9.3)

session remote interface

• Session bean remote interface must extend javax.ejb.EJBObject (7.10.5)
• Method name must not start with "ejb" (7.10.4)
• Method <signature> must throw <class-name> thrown by implementing method (7.10.5)
• Local interface <class-name> must not be exposed (7.10.5)
• Local home interface <class-name> must not be exposed (7.10.5)
• Method <signature> must throw RemoteException (7.10.5)
• Method <signature> must not derive from both <class-name> and <class-name> (7.10.5)
• Constant <name> must be primitive type or String (7.10.5)
• Methods <signature> and <signature> map to the same IDL name (7.10.5)
• <class-name> assumed to be serializable or otherwise RMI/IIOP compatible (7.10.5) [warning]

session home interface

• Session bean remote interface must extend javax.ejb.EJBHome (7.10.6)
• Local interface <class-name> must not be exposed (6.7.2)
• Local home interface <class-name> must not be exposed (6.7.2)
• Session bean local home interface must not define methods other than create methods (7.10.6)
• Method <signature> must return remote interface <class-name> (7.10.6)
• Method <signature> must throw RemoteException (7.10.6)
• Method <signature> must throw CreateException (7.10.6)
• Method <signature> must throw <class-name> thrown by implementing ejbCreate method (7.10.6)
• Method <signature> must not derive from both <class-name> and <class-name> (RMI/IIOP rule) (7.10.6)
• Constant <name> must be primitive type or String (7.10.6)
• Methods <signature> and <signature> map to the same IDL name (7.10.6)
• <class-name> assumed to be serializable or otherwise RMI/IIOP compatible (7.10.6) [warning]

stateful session home interface

• Session bean must define at least one create method (7.10.6)

stateless session home interface

• Stateless session bean must define create method with no arguments (7.10.6)
• Stateless session bean must not define create method other than create with no arguments (7.10.6)

session local interface

• Session bean local interface must extend javax.ejb.EJBLocalObject (7.10.7)
• Method name must not start with "ejb" (7.10.4)
• Method <signature> must not throw RemoteException (7.10.7)
• Method <signature> must throw <class-name> thrown by implementing method (7.10.7)

session local home interface

• Session bean local home interface must extend javax.ejb.EJBLocalHome (7.10.8)
• Session bean local home interface must not define methods other than create methods (7.10.8)
• Method <signature> must not throw RemoteException (7.10.8)
• Method <signature> must throw CreateException (7.10.8)
• Method <signature> must return local interface <class-name> (7.10.8)
• Method <signature> must throw <class-name> thrown by implementing ejbCreate method (7.10.8)

stateful session local home interface

• Session bean must define at least one create method

stateless session local home interface

• Stateless session bean must define create method with no arguments (7.10.8)
• Stateless session bean must not define create method other than create with no arguments (7.10.8)

CMP 2.x Entity Bean

CMP 2.x entity bean class

• Entity bean class must implement javax.ejb.EntityBean (10.6.2)
• Entity bean class must not implement javax.jms.MessageListener (15.4.2)
• Entity bean class must be public (10.6.2)
• CMP 2.x entity bean class must be abstract (10.6.2)
• Entity bean class must have public no-argument constructor (10.6.2)
• Entity bean class must not define finalize() (10.6.2)
• Entity bean should not implement remote interface (10.6.2) [warning]
• Entity bean should not implement local interface (10.6.2) [warning]
• Entity bean class must implement remote interface method <signature> (or else not implement remote interface) (10.6.2)
• Entity bean class must implement local interface method <signature> (or else not implement local interface) (10.6.2)
• Remote create method <signature> must be implemented (10.6.10)
• Local create method <signature> must be implemented (10.6.12)
• ejbCreate method must be public (10.6.4)
• ejbCreate method must not be final (10.6.4)
• ejbCreate method must not be static (10.6.4)
• ejbCreate method return type must be primary key class <class-name> (10.6.4)
• ejbCreate method must throw CreateException (10.6.4)
• ejbCreate method <signature> must correspond to a local or remote home interface create method (10.6.10, 10.6.12)
• CMP 2.x ejbCreate method must not throw RemoteException (10.6.4)
• ejbPostCreate method <signature> must be implemented (10.6.5)
• ejbPostCreate method must be public (10.6.5)
• ejbPostCreate method must not be final (10.6.5)
• ejbPostCreate method must not be static (10.6.5)
• ejbPostCreate method return type must be void (10.6.5)
• ejbPostCreate method <signature> must correspond to an ejbCreate method (10.6.5)
• ejbPostCreate method must be defined for ejbCreate(<signature> ) method (10.6.5)
• CMP 2.x ejbPostCreate method must not throw RemoteException (10.6.5)
• ejbHome method must not throw RemoteException (10.6.6)
• ejbHome method must be public (10.6.6)
• ejbHome method must not be static (10.6.6-)
• ejbHome method <signature> must correspond to a local or remote home interface business method (10.6.10, 10.6.12)
• Finder method <signature> must not be implemented (10.6.2)
• ejbSelect method must throw FinderException (10.6.7)
• ejbSelect method must be public (10.6.6)
• ejbSelect method must be abstract (10.6.7)
• ejbSelect method <signature> must correspond to query element in deployment descriptor (10.5.7)
• Remote business method <signature> must be implemented (10.6.9)
• Local business method <signature> must be implemented (10.6.11)
• Business method <signature> must be public (10.6.8)
• Business method <signature> must not be final (10.6.8)
• Business method <signature> must not be static (10.6.8)
• Business method <signature> return type must be <class-name> (10.6.10, 10.6.12)
• Business method <signature> must correspond to a local or remote interface business method (10.6.10, 10.6.12)
• CMP 2.x business method <signature> must not throw RemoteException (10.6.8)
• Support method name <name> must not start with "ejb" (10.6.8)
• CMP 2.x CMP field accessor <signature> must be public (10.3.1)
• CMP 2.x CMP field accessor <signature> must be abstract (10.3.1)
  
• Entity bean must define CMP field <name> accessor <signature> (cmp-field/field-name, 10.3.1)
• Entity bean must define CMR field <name> accessor <signature> (cmr-field/field-name, 10.3.1)
• Entity bean must not define field <name> corresponding to CMP field <name> (cmp-field/field-name, 10.3.1)
• Entity bean must not define field <name> corresponding to CMR field <name> (10.3.1)

CMP 2.x entity bean class method bodies

• Method <name> must not access CMP field (10.5.2)
• Method <name> must not access CMR field (10.5.2)
• Method <name> method must not use EntityContext method <name> (10.5.5)
• Method <name> method must not use enterprise bean method <name> (10.5.5)
• Method <name> method must not use resource manager method <name> (10.5.5)
• Method ejbCreate must not set CMR field (use ejbPostCreate) (10.5.2)
• Method <name> must not set primary key CMP field (10.3.1)

CMP 2.x entity remote interface

• Entity bean remote interface must extend javax.ejb.EJBObject (10.6.9)
• Method name must not start with "ejb" (10.6.8)
• Method <signature> must throw <class-name> thrown by implementing method (7.10.5)
• Local interface <class-name> must not be exposed (10.3.1)
• Local home interface <class-name> must not be exposed (10.3.1)
• Method <signature> must throw RemoteException (10.6.9)
• Method <signature> must not derive from both <class-name> and <class-name> (10.6.9)
• Constant <name> must be primitive type or String (10.6.9)
• Methods <signature> and <signature> map to the same IDL name (10.6.9)
• <class-name> assumed to be serializable or otherwise RMI/IIOP compatible (10.6.9) [warning]
• Entity bean remote interface should not expose setter for CMP field <name> (10.3.1)
• Entity bean remote interface must not expose CMR field accessor <signature> (10.3.1)

CMP 2.x entity remote home interface

• Entity bean remote home interface must extend javax.ejb.EJBHome (10.6.10)
• Entity bean remote home interface must define finder method findByPrimaryKey (10.6.10)
• Entity bean remote home interface must not overload required finder method findByPrimaryKey (9.5.2)
• Finder method <signature> must correspond to query element in deployment descriptor (10.6.14)
• Local interface <class-name> must not be exposed (10.6.10)
• Local home interface <class-name> must not be exposed (10.6.10)
• Create method <signature> must return remote interface <class-name> (10.6.10)
• Create method <signature> must throw CreateException (10.6.10)
• Create method <signature> must throw <class-name> thrown by implementing ejbCreate method (10.6.10)
• Create method <signature> must throw <class-name> thrown by implementing ejbPostCreate method (10.6.10)
• Finder method <signature> must return remote interface <class-name> or collection thereof (10.6.10)
• Finder method <signature> must throw FinderException (10.6.10)
• Home method name <name> must not start with "remove" (10.6.10)
• Home method name <name> must not start with "ejb" (10.6.8)
• Method <signature> must throw RemoteException (10.6.10)
• Method <signature> must not derive from both <class-name> and <class-name> (RMI/IIOP rule) (10.6.10)
• Constant <name> must be primitive type or String (10.6.10)
• Methods <signature> and <signature> map to the same IDL name (10.6.10)
• <class-name> assumed to be serializable or otherwise RMI/IIOP compatible (10.6.10) [warning]

CMP 2.x entity local interface

• Entity bean local interface must extend javax.ejb.EJBLocalObject (10.6.11)
• Method name must not start with "ejb" (10.6.8)
• Method <signature> must not throw RemoteException (10.6.11)
• Method <signature> must throw <class-name> thrown by implementing method (10.6.11)
• Entity bean local interface should not expose setter for CMP field <name> (10.3.1) [warning]

CMP 2.x entity local home interface

• Entity bean local interface must extend javax.ejb.EJBLocalHome (10.6.12)
• Entity bean local interface must define finder method findByPrimaryKey( <class-name>) (10.6.12)
• Entity bean local interface must not overload finder method findByPrimaryKey (9.5.2)
• Finder method <signature> must correspond to query element in deployment descriptor (10.6.14)
• Create method <signature> must return local interface <class-name> (10.6.12)
• Create method <signature> must throw CreateException (10.6.12)
• Create method <signature> must throw <class-name> thrown by implementing ejbCreate method (10.6.12)
• Create method <signature> must throw <class-name> thrown by implementing ejbPostCreate method (10.6.12)
• Finder method <signature> must return local interface <class-name> or collection thereof (10.6.12)
• Finder method <signature> must throw FinderException (10.6.12)
• Home method name <name> must not start with "remove" (10.6.12)
• Home method name <name> must not start with "ejb" (10.6.8)
• Method <signature> must not throw RemoteException (10.6.12)

CMP 2.x entity dependent value

• Dependent value class <class-name> assumed to be serializable (10.6.3)
• Dependent value class <class-name> must be public (10.6.3)
• Dependent value class <class-name> must not be abstract (10.6.3)

CMP 2.x entity primary key class

• Primary key class must be legal RMI/IIOP value type (10.6.13)
• Compound primary key class must be public (10.8.2)
• Compound primary key class must have public no-argument constructor (10.8.2)
• Compound primary key field must be public (10.8.2)
• Compound primary key field must not be static (10.8.2)
• Compound primary key field must correspond to a CMP field (10.8.2)
• Primary key class must override hashCode() and equals(Object) (10.6.13)

BMP and CMP 1.x Entity Bean

BMP and CMP 1.x entity bean class

• Entity bean class must implement javax.ejb.EntityBean (12.2.2)
• Entity bean class must not implement javax.jms.MessageListener (15.4.2)
• Entity bean class must be public (12.2.2)
• Entity bean class must not be final (12.2.2)
• Entity bean class must have public no-argument constructor (12.2.2)
• Entity bean class must not define finalize() (12.2.2)
• Entity bean should not implement remote interface (12.2.2) [warning]
• Entity bean class must implement remote interface method <signature> (or else not implement remote interface) (12.2.2)
• Remote create method <signature> must be implemented (12.2.9)
• ejbCreate method must be public (12.2.3)
• ejbCreate method must not be final (12.2.3)
• ejbCreate method must not be static (12.2.3)
• ejbCreate method return type must be primary key class <class-name> (12.2.3)
• ejbCreate method should not throw RemoteException (12.2.3) [warning]
• ejbPostCreate method <signature> must be implemented (12.2.4)
• ejbPostCreate method must be public (12.2.4)
• ejbPostCreate method must not be final (12.2.4)
• ejbPostCreate method must not be static (12.2.4)
• ejbPostCreate method return type must be void (12.2.4)
• ejbPostCreate method <signature> must correspond to an ejbCreate method (12.2.4)
• ejbPostCreate method should not throw RemoteException (12.2.4 [warning]
• Remote business method <signature> must be implemented (12.2.9)
• Business method <signature> must be public (12.2.7)
• Business method <signature> must not be final (12.2.7)
• Business method <signature> must not be static (12.2.7)
• Business method <signature> return type must be <class-name> (12.2.8, 12.2.10)
• Business method <signature> should not throw RemoteException (12.2.7) [warning]
• Support method name <name> must not start with "ejb" (12.2.7)

BMP entity bean class

• BMP entity bean class must not be abstract (12.2.2)
• BMP entity bean with ill-defined transaction boundaries should not rely on ejbLoad and ejbStore (12.1.6.1) [warning]
• Entity bean should not implement local interface (12.2.2) [warning]
• Entity bean class must implement local interface method <signature> (or else not implement local interface) (12.2.2)
• Local create method <signature> must be implemented (12.2.11)
• ejbCreate method <signature> must correspond to a local or remote home interface create method (12.2.9, 12.2.11)
• ejbSelect method not applicable to BMP entity bean (12.2.7) [warning]
• Remote find method <signature> must be implemented (12.2.9)
• Local find method <signature> must be implemented (12.2.11)
• ejbFindByPrimaryKey method must be implemented (12.2.5)
• ejbFind method must be public (12.2.5)
• ejbFind method must not be final (12.2.5)
• ejbFind method must not be static (12.2.5)
• ejbFind return type must be <class-name> (12.2.5, 12.1.7)
• ejbFind method should not throw RemoteException (12.2.5) [warning]
• ejbFind method <signature> must correspond to a local or remote home interface finder method (12.2.9, 12.2.11)
• Remote home method <signature> must be implemented (12.2.9)
• Local home method <signature> must be implemented (12.2.11)
• ejbHome method <signature> must correspond to a local or remote home interface business method (12.2.9, 12.2.11)
• ejbHome method must be public (12.2.6)
• ejbHome method must not be static (12.2.6
• ejbHome method must not throw RemoteException (12.2.6)
• Business method <signature> must correspond to a local or remote interface business method (12.2.8, 12.2.10)
• Remote business method <signature> must be implemented (12.2.9)
• Local business method <signature> must be implemented (12.2.11)

CMP 1.x entity bean class

• CMP 1.x entity bean class must not be abstract (14.1, 12.2.2)
• CMP 1.x entity bean field <name> must be public (14.1.1)
• CMP 1.x entity bean field <name> must not be transient (14.1.1)
• CMP 1.x entity bean field <name> assumed to be serializable (14.1.1)
• ejbCreate method <signature> must correspond to a remote home interface create method (12.2.9, 12.2.11)
• ejbSelect method not applicable to CMP 1.x entity bean (14.1, 12.2.7) [warning]
• ejbFind method not applicable to CMP 1.x entity bean (14.1, 12.2.7) [warning]
• ejbHome method not applicable to CMP 1.x entity bean (14.1.7, 12.2.7) [warning]
• Business method <signature> must correspond to a remote interface business method (12.2.8, 12.2.10)

BMP and CMP 1.x entity bean class method bodies

• Method <name> method must not use EntityContext method <name> (10.5.5)
• Method <name> method must not use enterprise bean method <name> (10.5.5)
• Method <name> method must not use resource manager method <name> (10.5.5)

BMP and CMP 1.x entity remote interface

• Entity bean remote interface must extend javax.ejb.EJBObject (12.2.8)
• Method name must not start with "ejb" (12.2.7)
• Method <signature> must throw <class-name> thrown by implementing method (12.2.8)
• Local interface <class-name> must not be exposed (12.2.8)
• Local home interface <class-name> must not be exposed (12.2.8)
• Method <signature> must throw RemoteException (12.2.8)
• Method <signature> must not derive from both <class-name> and <class-name> (12.2.8)
• Constant <name> must be primitive type or String (12.2.8)
• Methods <signature> and <signature> map to the same IDL name (12.2.8)
• <class-name> assumed to be serializable or otherwise RMI/IIOP compatible (12.2.8) [warning]

BMP and CMP 1.x entity remote home interface

• Entity bean remote home interface must extend javax.ejb.EJBHome (12.2.9)
• Create method <signature> must return remote interface <class-name> (12.2.9)
• Create method <signature> must throw CreateException (12.2.9)
• Create method <signature> must throw <class-name> thrown by implementing ejbCreate method (12.2.9)
• Create method <signature> must throw <class-name> thrown by implementing ejbPostCreate method (12.2.9)
• Finder method <signature> must return remote interface <class-name> or collection thereof (12.2.9)
• Entity bean remote home interface must define finder method findByPrimaryKey (12.2.9)
• Finder method <signature> must throw FinderException (10.6.10)
• Finder method <signature> must throw <class-name> thrown by implementing ejbFind method (12.2.9)
• Method <signature> must throw RemoteException (12.2.9)
• Method <signature> must not derive from both <class-name> and <class-name> (12.2.9)
• Constant <name> must be primitive type or String (12.2.9)
• Methods <signature> and <signature> map to the same IDL name (12.2.9)
• <class-name> assumed to be serializable or otherwise RMI/IIOP compatible (12.2.9) [warning]

CMP 1.x entity remote home interface

• CMP 1.x entity bean home interface must not define methods other than "create" (14.1.7)
• CMP 1.x entity bean create method must be named "create" (14.1.8)
  

BMP entity remote home interface

• Home method name <name> must not start with "remove" (12.2.9)
• Home method name <name> must not start with "ejb" (12.2.7)
  
• Local interface <class-name> must not be exposed (12.2.9)
• Local home interface <class-name> must not be exposed (12.2.9)

CMP 1.x entity remote home interface

• CMP 1.x create method <name> must be named "create" (14.1.8)

BMP entity local interface

• Entity bean local interface must extend javax.ejb.EJBLocalObject (12.2.10)
• Method name must not start with "ejb" (12.2.7)
• Method <signature> must not throw RemoteException (12.2.10)
• Method <signature> must throw <class-name> thrown by implementing method (12.2.10)

BMP entity local home interface

• Entity bean local home interface must extend javax.ejb.EJBLocalHome (12.2.11)
• Create method <signature> must return local interface <class-name> (12.2.11)
• Create method <signature> must throw CreateException (12.2.11)
• Create method <signature> must throw <class-name> thrown by implementing ejbCreate method (12.2.11)
• Create method <signature> must throw <class-name> thrown by implementing ejbPostCreate method (12.2.11)
• Entity bean local interface must define finder method findByPrimaryKey( <class-name>) (12.2.10)
• Finder method <signature> must return local interface <class-name> or collection thereof (12.2.11)
• Finder method <signature> must throw FinderException (12.2.11)
• Finder method <signature> must throw <class-name> thrown by implementing ejbFind method (12.2.11)
• Home method name <name> must not start with "ejb" (12.2.7)
• Home method name <name> must not start with "remove" (12.2.11)
• Home method <signature> must throw <class-name> thrown by implementing home method (12.2.11)
• Method <signature> must not throw RemoteException (12.2.11)

BMP and CMP 1.x entity primary key class

• Primary key class must be legal RMI/IIOP value type (12.2.12)
• Primary key class must override hashCode() and equals(Object) (12.2.12)

CMP 1.x entity primary key class

• Compound primary key class <class-name> must be public (14.1.9)
• Compound primary key class <class-name> must have public no-argument constructor (14.1.9)
• Compound primary key field <name> must be public (14.1.9)
• Compound primary key field <name> must not be static (14.1.9)
• Compound primary key field <name> must correspond to a CMP field (14.1.9)

Message-Driven Bean

message-driven bean class

• Message-driven bean class must implement javax.ejb.MessageDrivenBean (15.7.2)
• Message-driven bean class must implement javax.jms.MessageListener (15.7.2)
• Message-driven bean class must be public (15.7.2)
• Message-driven bean class must not be abstract (15.7.2)
• Message-driven bean class must not be final (15.7.2)
• Message-driven bean class must have public no-argument constructor (15.7.2)
• Message-driven bean class must not define finalize (15.7.2)
• Message-driven bean must define create method with no arguments (15.7.3)
• Message-driven bean must not define create method other than create with no arguments (15.7.3)
• ejbCreate method must be public (15.7.3)
• ejbCreate method must not be final (15.7.3)
• ejbCreate method must not be static (15.7.3)
• ejbCreate method return type must be void (15.7.3)
• ejbCreate method must not throw <class-name> (15.7.3)
• Message-driven bean must define onMessage(javax.jms.Message) method (15.7.4)
• onMessage method must be public (15.7.4)
• onMessage method must not be final (15.7.4)
• onMessage method must not be static (15.7.4)
• onMessage method return type must be void (15.7.4)
• onMessage method must not throw <class-name> (15.7.4)
• ejbRemove method must be public (15.7.5)
• ejbRemove method must not be final (15.7.5)
• ejbRemove method must not be static (15.7.5)
• ejbRemove method return type must be void (15.7.5)
• ejbRemove method must not throw <class-name> (15.7.5)

message-driven bean class method bodies

• Method <name> method must not use MessageDrivenContext method <name> (15.4.3)
• Method <name> method must not use UserTransaction method <name> (15.5.1)
• Method <name> method must not use enterprise bean method <name> (15.5.1)
• Method <name> method must not use resource manager method <name> (15.5.1)

EJB Clients

EJB client method bodies

• Remote object must be narrowed with PortableRemoteObject.narrow(Object) before casting (6.10, 9.13)
• equals(Object) should not be used to compare EJB objects; use isIdentical(Object) instead (6.9.1, 6.9.2)

Copyright © 1997, 2004, Oracle. All rights reserved.