blob: b086da948312377a0ac6ed865055697a1a94d8a7 [file] [log] [blame]
= Topic Configuration
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published
A Topic 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]
----
<Resource id="myTopic" type="javax.jms.Topic">
destination =
</Resource>
----
Alternatively, a Topic 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 `javax.ejb.embeddable.EJBContainer` API or `InitialContext`
[source,properties]
----
myTopic = new://Resource?type=javax.jms.Topic
myTopic.destination =
----
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 Topic a warning will
be logged. If a Topic is needed by the application and one is not
declared, TomEE will create one dynamically using default settings.
Multiple Topic declarations are allowed. # Supported Properties
Property
Type
Default
Description
destination
String
Specifies the name of the topic