Creates HPAS-specific deployment descriptors (hp-ejb-jar.xml) for EJB beans.
Attribute | Description | Required |
xmlencoding | The encoding of the hp-ejb-jar.xml file. | No, default is "UTF-8" |
destdir | Destination directory for output Bluestone-specific deployment descriptor files. | No, default is destdir parameter of ejbdoclet task |
mergedir | Merge directory where ejbdoclet looks for files to be merged with generated files. | No, required, if the merge feature used |
validateXml | Validates the generated xml file according to the DTD file contained inside xdoclet.jar. | No, default is false |
sfsbPassivationRoot | This attribute is the path to a local directory indicating where the container should passivate Stateful Session Bean instances. | No, only if @bluestone:bean passivation="true" used on a stateful session bean. Default is "" |
persistenceProduct | Only applies when using CMP. This attribute specifies the name of a third party persistence manager product. | No, default is "VXML" |
persistenceVersion | Only applies when using CMP. This attribute specifies the version of the third party product. | No, default is "" |
persistenceClass | Only applies when using CMP. This attribute specifies the class that implements the persistence manager interface. | No, default is com.hp.mwlabs.j2ee.containers.ejb.persistence.vxml.CMPPersistenceManager |
persistenceSuffix | Only applies when using CMP. This attribute specifies a suffix to be appended to the abstract bean class name to obtain the generated bean class name. | No, default is "" |
Merge File Name | Description | Required |
None at present (TODO). |
Most of the class-level Bluestone options are specified in parameters of this tag.
Parameter | Usage |
[read-only]: Boolean | Optional. Specifies whether the bean is marked as read only. Applicable only to entity beans. |
[passivation]: Boolean | Determines whether the container can manage the passivation behaviour of beans; indicates whether passivation is enabled for the bean. Applicable to stateful session beans and entity beans. For stateful session beans, if this parameter is used then the passivate-threshold parameter must also be present. |
[passivate-threshold]: Integer | Specifies the number of beans for a deployed EJB above which the container will attempt to passivate instances. Applicable to stateful session beans only, when the passivation parameter has been used. |
[session-timeout]: duration | Indicates the timeout for the session. |
[concurrent-message-processing]: Boolean | Specifies whether concurrent message processing is enabled. Applicable to message driven beans only. |
[max-messages]: Integer | Specifies the maximum number of messages assigned to a single session. This value is passed to the JMS server. Applicable to message driven beans only. |
[max-message-threads]: Integer | Specifies the maximum number of separate server sessions (threads) that will be created to handle messages. Applicable to message driven beans only. |
[message-thread-timeout]: duration | Specifies the amount of time after which an idle server session will be available to be removed from the pool. Applicable to message driven beans only. |
[connection-retry]: Boolean | Specifies whether an exception listener is registered for the connection. If no exception listener is established, there will be no connection failover. Applicable to message driven beans only. |
[jndi-factory]: String | Specifies the lookup string used to obtain the factory that will be used to create the connection used by the MDB. Applicable to message driven beans. |
[jndi-destination]: String | Specifies the lookup string for the destination topic or queue for which the bean is registered as a listener. Applicable to message driven beans. |
Contains the information required to setup an object pool.
Parameter | Usage |
initial-size: Integer | Specifies the initial size of the pool. |
cache-limit: Integer or "unlimited" | Specifies the maximum size of the pool. When the cache-limit is reached, pooled entries that are returned to the pool will be discarded; if the cache-limit is reached, new objects may still be created. |
idle-timeout: duration | Specifies the idle timeout for the pool. | use-reaper: Boolean | Specifies whether the pool should enforce the cache-limit. The reaper can be disabled to optimize pool performance. |
reap-asynch: Boolean | Specifies whether pool reaping should occur asynchronously with respect to inserting or removing objects from the pool. Setting this to true makes pool accesses faster but consumes more system resources. |
A mapping of EJB references to deployed beans.
NB This is likely to be refactored in the future, to use extra parameters on the @ejb:ejb-ref and @ejb:ejb-external-ref tags instead of the @bluestone:ejb-ref tag.
Parameter | Usage |
type: "co-located" or "distributed" | Use "co-located" for references to EJBs in the same application, and "distributed" for references to EJBs in other applications. |
ref-name: String | Specifies the mapping into the ejb-ref entry in the standard deployment descriptor. |
jndi-name: String | Specifies the actual name under which the bean is registered in the name service. |
[application]: String | Specifies the name of the application in which the EJB component is deployed. Only applies when type="distributed". |
[host]: String | Specifies the host name for the name server. Only applies when type="distributed". |
[port]: String | Specifies the port number for the name server. Only applies when type="distributed". |