= MessageDrivenContainer Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published


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.

[source,xml]
----
<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`

[source,properties]
----
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
