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". |