Preloader image

MessageDrivenContainer Configuration

A MessageDrivenContainer can be declared via xml in the <tomee-home>/conf/tomee.xml file or in a WEB-INF/resources.xml file using a declaration like the following. All properties in the element body are optional.

<Container id="myMessageDrivenContainer" type="MESSAGE">
    activationSpecClass = org.apache.activemq.ra.ActiveMQActivationSpec
    instanceLimit = 10
    messageListenerInterface = jakarta.jms.MessageListener
    resourceAdapter = Default JMS Resource Adapter
</Container>

Alternatively, a MessageDrivenContainer can be declared via properties in the <tomee-home>/conf/system.properties file or via Java VirtualMachine -D properties. The properties can also be used when embedding TomEE via the jakarta.ejb.embeddable.EJBContainer API or InitialContext

myMessageDrivenContainer = new://Container?type=MESSAGE
myMessageDrivenContainer.activationSpecClass = org.apache.activemq.ra.ActiveMQActivationSpec
myMessageDrivenContainer.instanceLimit = 10
myMessageDrivenContainer.messageListenerInterface = jakarta.jms.MessageListener
myMessageDrivenContainer.resourceAdapter = Default JMS Resource Adapter

Properties and xml can be mixed. Properties will override the xml allowing for easy configuration change without the need for $\{} style variable substitution. Properties are not case sensitive. If a property is specified that is not supported by the declared MessageDrivenContainer a warning will be logged. If a MessageDrivenContainer is needed by the application and one is not declared, TomEE will create one dynamically using default settings. Multiple MessageDrivenContainer declarations are allowed. # Supported Properties

Property

Type

Default

Description

activationSpecClass

String

org.apache.activemq.ra.ActiveMQActivationSpec

Specifies the activation spec class

instanceLimit

int

10

Specifies the maximum number of bean instances that are allowed to exist for each MDB deployment.

messageListenerInterface

String

jakarta.jms.MessageListener

Specifies the message listener interface handled by this container

resourceAdapter

String

Default JMS Resource Adapter

The resource adapter delivers messages to the container