fuhouyin/spring-boot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document JMS auto configuration

Browse Source 
Fixes gh-1445
This commit is contained in:
Stephane Nicoll 2014-08-28 09:52:34 +02:00
parent 538cd90657
commit aa0f90ec2e
1 changed files with 29 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
View File

@ -1774,7 +1774,8 @@ The `javax.jms.ConnectionFactory` interface provides a standard method of creati
`ConnectionFactory` to work with JMS, you generally won't need to use it directly yourself `ConnectionFactory` to work with JMS, you generally won't need to use it directly yourself
and you can instead rely on higher level messaging abstractions (see the and you can instead rely on higher level messaging abstractions (see the
{spring-reference}/#jms[relevant section] of the Spring Framework reference {spring-reference}/#jms[relevant section] of the Spring Framework reference
documentation for details). documentation for details). Spring Boot also auto configures the necessary infrastructure
to send and receive messages.
@ -1846,9 +1847,9 @@ resolved against their provided names.
[[boot-features-using-jms-template]] [[boot-features-using-jms-sending]]
==== Using JmsTemplate ==== Sending a message
Spring's `JmsTemplate` is auto-configured and you can `@Autowire` it directly into your Spring's `JmsTemplate` is auto-configured and you can autowire it directly into your
own beans: own beans:
[source,java,indent=0] [source,java,indent=0]
@ -1872,7 +1873,31 @@ own beans:
} }
---- ----
NOTE: {spring-javadoc}/jms/core/JmsMessagingTemplate.{dc-ext}[`JmsMessagingTemplate`]
(new in Spring 4.1) can be injected in a similar manner.
[[boot-features-using-jms-receiving]]
==== Receiving a message
When the JMS infrastructure is present, any bean can be annotated with `@JmsListener` to
create a listener endpoint. If no `JmsListenerContainerFactory` has been defined, a default
one is configured automatically.
The following component creates a listener endpoint on the `someQueue` destination:
[source,java,indent=0]
----
@Component
public class MyBean {
@JmsListener(destination = "someQueue")
public void processMessage(String content) { ... }
}
----
Check {spring-javadoc}/jms/annotation/EnableJms.{dc-ext}[the javadoc of `@EnableJms`]
for more details.
[[boot-features-jta]] [[boot-features-jta]]
== Distributed Transactions with JTA == Distributed Transactions with JTA