<bluestone/> subtask

Bluestone

Creates HPAS-specific deployment descriptors (hp-ejb-jar.xml) for EJB beans.

Parameters

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 Points

Merge File Name Description Required
None at present (TODO).

Class level Tags

@bluestone:bean

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.

@bluestone:pool

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.

@bluestone:ejb-ref

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

Method level Tags

None at present.