You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2013/12/19 15:31:22 UTC
[07/19] git commit: Continue the JMS documentation
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é <jb...@apache.org>
Authored: Wed Dec 18 15:57:34 2013 +0100
Committer: Jean-Baptiste Onofré <jb...@apache.org>
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