Tag Reference

Tags for creation of JOnAS-specific resources

Applies to: all EJB types

The jonas.bean element declares the JOnAS specific information for an enterprise bean.

Applies to: All EJB types, class level

ParameterTypeApplicabilityDescriptionMandatory
ejb-nametextThe enterprise bean's name specified in the standard EJB deployment descriptor.true
jndi-nametextThe JNDI name of the enterprise bean's home. Concerns only the Entity and Session beans. Mandatory if version < 2.5, but optional for Session beans for 2.5 onwards. You can use standart @ejb.bean jndi-name attribut instead of this specific tagfalse
inactivity-timeouttextOptional inactivity timeout valuefalse
prefetchtextOptional prefetch boolean valuefalse
cleanuptextDetermine the jonas-specific behavior for table management at deploy time.false
lock-policytextDetermine the jonas-specific lock policy for database access. Possible value is container-serialized, container-read-committed, container-read-uncommitted, databasefalse
automatic-pk-field-nametextThe jdbc column name for automatic primary key auto generaredfalse

The jonas.ejb-ref element declares the JOnAS specific information for a reference to another enterprise bean's home.

Applies to: All EJB types, class level

ParameterTypeApplicabilityDescriptionMandatory
ejb-ref-nametextThe name of the ejb reference specified in the standard EJB deployment descriptor.true
jndi-nametextThe JNDI name of the ejb.true

The jonas.finder-method-jdbc-mapping element declares the SQL WHERE clause associated to a finder method of a container-managed persistence entity.

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
method-nametextThe method's name.true
method-paramstextIdentifies a single method among multiple methods with an overloaded method name.false
jdbc-where-clausetextThe SQL WHERE clause.true

The jonas.is-modified-method-name element specifies the name of the is-modified method of an entity.

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
is-modified-method-nametextThe name of the is-modified method of an entity.true

The jonas.jdbc-mapping element declares the mapping of an entity with container-managed persistence to the underlying database.

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
jndi-nametextThe JNDI name of the datasource.true
jdbc-table-nametextThe name of the relational table.true

The jonas.max-cache-size element defines the max number of instances (int value) that can be hold in memory. The default value is infinite. This tag has only been present since version 2.4.

Applies to: Entity Beans or SessionBean or MessageDrivenBean class level

The jonas.jonas-message-driven-destination element declares the JOnAS specific information for a the message driven bean destination.

Applies to: Message Driven Bean, class level

ParameterTypeApplicabilityDescriptionMandatory
jndi-nametextThe JNDI name of the message driven destination.true

The jonas.min-pool-size element specify the number of instances that will be created to populate the pool when the bean is loaded for the first time. The default value is 0. This tag has only been present since version 2.4.

Applies to: Entity Beans or SessionBean or MessageDrivenBean class level

The jonas.passivation-timeout element specifies the value of timeout in seconds for passivation of entity instances when no transaction are used.

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
passivation-timeoutintThe value of timeout in seconds for passivation of entity instances when no transaction are used.true

The jonas.resource element declares the JOnAS specific information for an external resource referenced by a bean.

Applies to: All EJB types, class level

ParameterTypeApplicabilityDescriptionMandatory
res-ref-nametextThe name of the resource reference specified in the standard EJB deployment descriptor.true
jndi-nametextThe JNDI name of the resource.true

The jonas.resource-env element declares the JOnAS specific information for an external resource environment referenced by a bean.

Applies to: All EJB types, class level

ParameterTypeApplicabilityDescriptionMandatory
resource-env-ref-nametextThe name of the resource environment reference specified in the standard EJB deployment descriptor.true
jndi-nametextThe JNDI name of the resource environment.true

The jonas.session-timeout element specifies the value of timeout in seconds for expiration of session instances.

Applies to: Session Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
session-timeoutintThe value of timeout in seconds for expiration of session instances.true

The jonas.shared element specifies if the bean state can be accessed outside JOnAS. This tag has only been present since version 2.4.

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
sharedboolTrue if the bean state can be accessed outside JOnAS. The default is False.true

The jonas.cmp-field-jdbc-mapping element declares the mapping of a container-managed field of an entity to a column of a relational table.

Applies to: Entity Beans, method level

ParameterTypeApplicabilityDescriptionMandatory
field-nametextThe field's name.true
jdbc-field-nametextThe column name of the relational table.true
sql-typetextThe sql-type element specifies the SQL type (CMP2 only)false

The jonas.ejb-relation element the name of the joint table for the current relation.

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
jdbc-table-nametextThe optional name of the relation joint table.false

The jonas.field-mapping element represents a mapping from a foreign key column in the database table

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
foreign-key-jdbc-nametextThe column name of the foreign key of this fieldtrue
key-jdbc-nametextThe column name of the primary key composite of this field. Use only if your pk is compositefalse

The jonas.target.field-mapping element represents a mapping from a foreign key column in the database table

Applies to: Entity Beans, class level

ParameterTypeApplicabilityDescriptionMandatory
foreign-key-jdbc-nametextThe jonas.field-mapping element represents a mapping from a foreign key column in the database tabletrue
key-jdbc-nametextThe column name of the foreign key of this fieldfalse