@Target(TYPE) @Retention(RUNTIME) public @interface Entity { String name() default ""; EntityType entityType() default EntityType.CMP; AccessType access() default AccessType.PROPERTY; int version() default 3; }

Defines the transaction boundary for session business methods. The default value is REQUIRED. If @TransactionAttribute annotates the class, it defines the default value.

@Target({TYPE,METHOD}) @Retention(RUNTIME) public @interface TransactionAttribute { TransactionAttributeType value() default REQUIRED; }

Configures an EJB values for a field or method.

@EJB is essentially a @Resource where it's known that the result is an EJB interface.

In the following exaple, Resin will call setFoo method with the bean in "java:comp/env/ejb/foo" before the session is started.

@EJB void setFoo(example.Test test) { _test = test; } @Target({TYPE, METHOD, FIELD, PARAMETER}) @Retention(RUNTIME) public @interface EJB { String name() default ""; String businessInterface() default ""; String jndiName() default ""; }

Configures a JNDI values for a field or method.

Inject relies heavily on defaults from the field or method name and type. If more information is required, use @Resource, @EJB, or @EJBHome.

In the following exaple, Resin will call setDataSource method with the data source in "java:comp/env/jdbc/test" before the session is started.

@Inject(jndi-name="java:comp/env/jdbc/test") void setDataSource(javax.sql.DataSource dataSource) { _dataSource = dataSource; } @Target({METHOD, FIELD}) @Retention(RUNTIME) public @interface Inject { String jndiName() default ""; }

Configures a JNDI values for a field or method. @Resource is essentially the same as @Inject but provides more configurable options. @Resource can also be used at the Class level to declare a dependency in cases where the session bean loads the JNDI value by itself.

In the following exaple, Resin will call setDataSource method with the data source in "java:comp/env/jdbc/test" before the session is started. The "java:comp/env/jdbc" full name is inferred from the DataSource type.

@Resource(name="test") void setDataSource(javax.sql.DataSource dataSource) { _dataSource = dataSource; } @Target({TYPE, METHOD, FIELD, PARAMETER}) @Retention(RetentionPolicy.RUNTIME) public @interface Resource { String name() default ""; String resourceType() default ""; AuthenticationType authenticationType() CONTAINER; boolean shareable() default true; String jndiName() default ""; }
Copyright (c) 1998-2009 Caucho Technology, Inc. All rights reserved.
caucho® , resin® and quercus® are registered trademarks of Caucho Technology, Inc.
resin-ee Resin 3.0

Session beans may be configured using dependency injection annotation.
These annotations will likely change package names to something other than javax.ejb as J2EE 1.5 drafts progress.

Marks the class as an entity bean. Each entity bean corresponds to a database row. Entity bean persistence is configured with the CMP annotations.

In EJB 3.0, the application uses entity bean instances directly. Unlike EJB 2.1, there is no pooling, local stub, or home interface for an entity.

nameThe bean's nameThe bean's class name
entityTypecontainer-managed (CMP) or bean-managed (BMP)CMP
accessfield-based (FIELD) or method-getter based (PROPERTY)PROPERTY
versionEJB version3
TransactionAttributemeaning
REQUIREDStart a new transaction if necessary
SUPPORTSDon't start a new transaction, but use one if it exists
MANDATORYRequire the caller to have started a transaction
NEVERForbid the caller to have started a transaction
REQUIRESNEWAlways start a new transaction, suspending the old one
NOTSUPPORTEDSuspend any active transaction
jndiNameThe jndi name of the resourceThe field name
jndiNameThe jndi name of the resourceThe field name
nameThe name of the resourceThe field name
resourceTypeThe resource typedThe field type
authenticationTypeWhether the container or the application is responsible for authenticationCONTAINER
shareableTrue if the bean follows JCA shareability requirements.true
jndiNameThe jndi name of the resourceThe field name
javax.sql.DataSourcejava:comp/env/jdbc
javax.mail.*java:comp/env/mail
javax.ejb.EntityManagerjava:comp/EntityManager
javax.transaction.UserTransactionjava:comp/UserTransaction
javax.ejb.EJBHomejava:comp/env/ejb
javax.jms.*java:comp/env/jms