Define HPAS-specific deployment descriptors (hp-ejb-jar.xml) for EJB beans.
Applies to: All EJB types
Most of the class-level HPAS options are specified in parameters of this tag.
Applies to: class level of EJB
| Parameter | Type | Applicability | Description | Mandatory |
|---|---|---|---|---|
| read-only | bool | Applicable only to entity beans. | Specifies whether the bean is marked as read only. | false |
| passivation | bool | 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. | Determines whether the container can manage the passivation behaviour of beans; indicates whether passivation is enabled for the bean. | false |
| passivate-threshold | int | 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. | false | |
| session-timeout | int | Indicates the timeout for the session. *** Note, int used because do not know what the f**k is duration | false | |
| concurrent-message-processing | bool | Applicable to message driven beans only | Specifies whether concurrent message processing is enabled. | false |
| max-messages | int | Applicable to message driven beans only | Specifies the maximum number of messages assigned to a single session. This value is passed to the JMS server | false |
| max-message-threads | int | Applicable to message driven beans only | Specifies the maximum number of separate server sessions (threads) that will be created to handle messages | false |
| message-thread-timeout | int | Applicable to message driven beans only | Specifies the amount of time after which an idle server session will be available to be removed from the pool. | false |
| connection-retry | bool | Applicable to message driven beans only | Specifies whether an exception listener is registered for the connection. If no exception listener is established, there will be no connection failover. | false |
| jndi-factory | text | Applicable to message driven beans only | Specifies the lookup string used to obtain the factory that will be used to create the connection used by the MDB. | true |
| jndi-destination | text | Applicable to message driven beans only | Specifies the lookup string for the destination topic or queue for which the bean is registered as a listener. | true |
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 @hpas.ejb-ref tag.
| Parameter | Type | Applicability | Description | Mandatory |
|---|---|---|---|---|
| type | text |
Use "co-located" for references to EJBs in the same application, and
"distributed" for references to EJBs in other applications.
Valid options are: co-located distributed Default value(s): co-located | true | |
| ref-name | text | Specifies the mapping into the ejb-ref entry in the standard deployment descriptor. | true | |
| jndi-name | text | Specifies the actual name under which the bean is registered in the name service. | true | |
| application | text | Only applies when type="distributed". | Specifies the name of the application in which the EJB component is deployed. | false |
| host | text | Only applies when type="distributed". | Specifies the host name for the name server. | false |
| port | text | Only applies when type="distributed". | Specifies the port number for the name server | false |
Contains the information required to setup an object pool.
Applies to: All beans
| Parameter | Type | Applicability | Description | Mandatory |
|---|---|---|---|---|
| initial-size | int | Specifies the initial size of the pool. | false | |
| cache-limit | text |
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.
NB: "integer or unlimited" is bullshit. How do I specify condition for this?
Default value(s): unlimited | false | |
| idle-timeout | int | Specifies the idle timeout for the pool. | false | |
| use-reaper | bool | Specifies whether the pool should enforce the cache-limit. The reaper can be disabled to optimize pool performance. | false | |
| reap-asynch | bool | 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. | false |