Continue the JMS documentation
Project: http://git-wip-us.apache.org/repos/asf/karaf/repo Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/46e14032 Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/46e14032 Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/46e14032 Branch: refs/heads/master Commit: 46e14032e99ac79ce2d9f6c6ed96646230835b49 Parents: 69ce894 Author: Jean-Baptiste Onofré <[email protected]> Authored: Wed Dec 18 15:57:34 2013 +0100 Committer: Jean-Baptiste Onofré <[email protected]> Committed: Wed Dec 18 15:57:34 2013 +0100 ---------------------------------------------------------------------- manual/src/main/webapp/users-guide/jms.conf | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/karaf/blob/46e14032/manual/src/main/webapp/users-guide/jms.conf ---------------------------------------------------------------------- diff --git a/manual/src/main/webapp/users-guide/jms.conf b/manual/src/main/webapp/users-guide/jms.conf index f06db63..50898ba 100644 --- a/manual/src/main/webapp/users-guide/jms.conf +++ b/manual/src/main/webapp/users-guide/jms.conf @@ -16,7 +16,9 @@ It means that you have to install a JMS broker itself. This JMS broker can be available: * outside of Apache Karaf, as a standalone broker. In that case, Apache Karaf JMS will remotely connect to the JMS broker. -* embedded in Apache Karaf. + For instance, you can use this topology with Apache ActiveMQ or IBM WebsphereMQ. +* embedded in Apache Karaf. With this topology, Apache Karaf itself provides a JMS broker service. Apache ActiveMQ provides + a native support in Apache Karaf. For instance, you can install Apache ActiveMQ directly in Apache Karaf: @@ -24,4 +26,23 @@ For instance, you can install Apache ActiveMQ directly in Apache Karaf: karaf@root()> feature:repo-add activemq Adding feature url mvn:org.apache.activemq/activemq-karaf/LATEST/xml/features karaf@root()> feature:install activemq-broker +{code} + +The Apache Karaf {{jms}} feature provides an OSGi service to create/delete JMS connection factories in the container +and perform JMS operations (send or consume messages, get information about a JMS broker, list the destinations, ...). + +This JMS OSGi service can be manipulated programmatically (see the developer guide for details), using the {{jms:*}} commands, or using the JMS MBean. + +h2. Commands + +h3. {{jms:create}} + +The {{jms:create}} command creates a JMS connection factory in the Apache Karaf container. It automatically creates a +blueprint XML file in the {{deploy}} folder containing the JMS connection factory definition corresponding +to the type that you mentioned. + +The {{jms:create}} command accepts different arguments and options: + +{code} + {code} \ No newline at end of file
