You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by jb...@apache.org on 2017/03/09 19:40:35 UTC

[1/2] activemq-artemis git commit: This closes #1079

Repository: activemq-artemis
Updated Branches:
  refs/heads/master 81a3ec599 -> 101c6e686


This closes #1079


Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo
Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/101c6e68
Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/101c6e68
Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/101c6e68

Branch: refs/heads/master
Commit: 101c6e6860521db71f74fa32b8c1df8159c0fd48
Parents: 81a3ec5 6add6ee
Author: Justin Bertram <jb...@apache.org>
Authored: Thu Mar 9 13:39:58 2017 -0600
Committer: Justin Bertram <jb...@apache.org>
Committed: Thu Mar 9 13:39:58 2017 -0600

----------------------------------------------------------------------
 docs/user-manual/en/SUMMARY.md    |  1 +
 docs/user-manual/en/using-AMQP.md | 50 ++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)
----------------------------------------------------------------------



[2/2] activemq-artemis git commit: doc: small chapter on AMQP

Posted by jb...@apache.org.
doc: small chapter on AMQP


Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo
Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/6add6ee5
Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/6add6ee5
Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/6add6ee5

Branch: refs/heads/master
Commit: 6add6ee59c0405631cec7c615d2f226d92e12689
Parents: 81a3ec5
Author: Clebert Suconic <cl...@apache.org>
Authored: Thu Mar 9 13:24:47 2017 -0500
Committer: Justin Bertram <jb...@apache.org>
Committed: Thu Mar 9 13:39:58 2017 -0600

----------------------------------------------------------------------
 docs/user-manual/en/SUMMARY.md    |  1 +
 docs/user-manual/en/using-AMQP.md | 50 ++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/6add6ee5/docs/user-manual/en/SUMMARY.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md
index 198e1fb..f514ff7 100644
--- a/docs/user-manual/en/SUMMARY.md
+++ b/docs/user-manual/en/SUMMARY.md
@@ -9,6 +9,7 @@
 * [Using the Server](using-server.md)
 * [Using JMS](using-jms.md)
 * [Using Core](using-core.md)
+* [Using AMQP](using-amqp.md)
 * [Mapping JMS Concepts to the Core API](jms-core-mapping.md)
 * [The Client Classpath](client-classpath.md)
 * [Examples](examples.md)

http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/6add6ee5/docs/user-manual/en/using-AMQP.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/using-AMQP.md b/docs/user-manual/en/using-AMQP.md
new file mode 100644
index 0000000..7375d27
--- /dev/null
+++ b/docs/user-manual/en/using-AMQP.md
@@ -0,0 +1,50 @@
+# Using AMQP
+
+Apache ActiveMQ Artemis is also a pure AMQP 1.0 broker, with a high performant and feature complete protocol manager for AMQP.
+
+You can use *any* AMQP 1.0 compatible clients.
+
+A short list includes:
+
+- qpid clients at the [qpid project](http://qpid.apache.org/download.html)
+- [.NET Clients](https://blogs.apache.org/activemq/entry/using-net-libraries-with-activemq)
+- [Javascript NodeJS](https://github.com/noodlefrenzy/node-amqp10)
+- [Java Script RHEA](https://github.com/grs/rhea)
+
+
+... and many others.
+
+
+# Message Conversions
+
+The broker will not perform any message conversion to any other protocols when sending AMQP and receiving AMQP.
+
+However if you intend your message to be received on a AMQP JMS Client, you must follow the JMS Mapping convention:
+
+- [JMS Mapping Conventions](https://www.oasis-open.org/committees/download.php/53086/amqp-bindmap-jms-v1.0-wd05.pdf)
+
+
+If you send a body type that is not recognized by this specification the conversion between AMQP and any other protocol will make it a Binary Message.
+
+So, make sure you follow these conventions if you intend to cross protocols or languages. Especially on the message body.
+
+
+# Example
+
+We have a few examples as part of the Artemis distribution:
+
+
+- .NET: 
+ * ./examples/protocols/amqp/dotnet
+
+- ProtonCPP
+ * ./examples/protocols/amqp/proton-cpp
+ 
+- Ruby
+ * ./examples/protocols/amqp/proton-ruby
+ 
+- Java (Using the qpid JMS Client)
+ * ./examples/protocols/amqp/queue
+
+
+