activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From tab...@apache.org
Subject svn commit: r1566734 - /activemq/activemq-dotnet/Apache.NMS.AMQP/trunk/RELEASE.txt
Date Mon, 10 Feb 2014 20:37:00 GMT
Author: tabish
Date: Mon Feb 10 20:36:59 2014
New Revision: 1566734

URL: http://svn.apache.org/r1566734
Log:
https://issues.apache.org/jira/browse/AMQNET-454

Add RELEASE.txt file to root.

Added:
    activemq/activemq-dotnet/Apache.NMS.AMQP/trunk/RELEASE.txt   (with props)

Added: activemq/activemq-dotnet/Apache.NMS.AMQP/trunk/RELEASE.txt
URL: http://svn.apache.org/viewvc/activemq/activemq-dotnet/Apache.NMS.AMQP/trunk/RELEASE.txt?rev=1566734&view=auto
==============================================================================
--- activemq/activemq-dotnet/Apache.NMS.AMQP/trunk/RELEASE.txt (added)
+++ activemq/activemq-dotnet/Apache.NMS.AMQP/trunk/RELEASE.txt Mon Feb 10 20:36:59 2014
@@ -0,0 +1,136 @@
+=======================================================================
+ * Apache.NMS.AMQP : Apache NMS for AMQP Client Library
+ * Initial Release Notes
+=======================================================================
+
+1.0 Welcome
+
+Welcome to Apache NMS AMQP! This NMS Provider will connect to the AMQP
+messaging protocol. Versions Amqp1.0 and Amqp0.10 are supported. NMS
+applications using this provider may communicate with Amqp Brokers 
+such as Apache ActiveMQ and Apache Qpid qpidd, and messaging 
+infrastructure such as Apache Qpid Dispatch Router.
+
+2.0 Implementation Overview
+
+The AMQP Provider leverages the interop binding "Apache Qpid 
+.NET Binding for C++ Messaging". The .NET Binding is an interop layer
+that connects .NET programs to the Qpid native C++ protocol engine 
+libraries.
+
+The general architecture is:
+
+                      +----------------------------+
+                      | NMS Application            |
+                      |                            |
+                      +--------------+-------------+
+                                     |
+                                     V
+                      +----------------------------+
+                      | NMS AMQP Provider          |
+                      | Apache.NMS.AMQP.dll        |
+                      +--------------+-------------+
+                                     |
+managed                              V
+(.NET)                +-------------------------------+
+::::::::::::::::::::::| Qpid Interop Binding          |::::::::::::
+unmanaged             | org.apache.qpid.messaging.dll |
+(Native Win32/64)     +-------------+-----------------+
+                                     |
+                                     V
+          +----------------------------------+
+          |  Qpid C++ Messaging Libraries    |
+          |  qpid*.dll                       |
+          +--------+--------------+----------+
+                   |              |
+                   V              |
+          +-----------------+     |
+          | Boost Libraries |     |
+          +--------+--------+     |
+                   |              |
+                   V              V
+          +---------------------------------+
+          | MSVC Runtime Libraries          |
+          +---------------------------------+
+
+
+3.0 Getting Started
+
+3.1 Installing Apache Qpid vendor files
+
+In order to use the AMQP Provider your application must have the
+Apache Qpid native and supporting libraries available on the path. 
+These files are installed automatically during the nant 
+installation of the Apache.Qpid vendor kit.
+
+3.2 Selecting the correct Apache Qpid vendor files
+
+The Apache Qpid vendor files are shipped in two versions:
+ * .NET 2.0 Compiled with Visual Studio 2008
+ * .NET 4.0 Compiled with Visual Studio 2010
+ 
+Each of these kits is built for the 32-bit x86 platform in both Debug
+and Release configurations. A typical kit holds:
+ * The Apache Qpid interop library
+     org.apache.qpid.messaging.dll
+ * Apache Qpid/Proton library files
+     qpid-protond.dll
+     qpidclientd.dll
+     qpidcommond.dll
+     qpidmessagingd.dll
+     qpidtypesd.dll 
+ * Boost library files
+     boost_chrono-vc100-mt-gd-1_47.dll
+     boost_date_time-vc100-mt-gd-1_47.dll
+     boost_program_options-vc100-mt-gd-1_47.dll
+     boost_system-vc100-mt-gd-1_47.dll
+     boost_thread-vc100-mt-gd-1_47.dll
+
+3.3 Building your Application
+
+A HelloWorld application is included in the Apache.NMS.AMQP 
+development tree to get users off to a quick start.
+
+This project selects:
+    Visual Studio  : 2010
+	Configuration  : Debug
+	.NET Framework : 4.0
+	Platform       : AnyCPU
+
+HelloWorld builds and runs on both 32-bit x86 and 64-bit x64 systems
+as long as the base project is built with the AnyCPU or the x64 
+Platform. The Apache Qpid subsystem will not load under .NET projects
+that specify the x64 Platform.
+	
+4.0 Using the Apache.NMS.AMQP Provider
+
+4.1 Creating AMQP Connections
+
+Connections to AMQP brokers and endpoints are controlled by arguments
+to the ConnectionFactory constructor. By default connections use
+protocol "amqp1.0".
+
+  Uri connecturi = new Uri("amqp:tcp:localhost:5672");
+  string clientID = "abc";
+  Hashtable options = new Hashtable();
+  options["username"] = "guest";
+  options["password"] = "secret";
+  options["protocol"] = "amqp1.0"; // or "amqp0-10"
+  
+  IConnectionFactory factory = new
+    NMSConnectionFactory(connecturi, clientID, options);
+	  
+In this release connection options are passed through an option table
+and not through the connect URI/URL. More information about connection
+options is available at:
+
+http://qpid.apache.org/components/programming/book/connection-options.html 
+  
+5.0 Future Considerations
+
+ * 64-bit x64 Apache Qpid vendor kit
+ * Support for more robust object message formats
+ * Transactions and message durability
+ * Unit test/system tests
+ 
+

Propchange: activemq/activemq-dotnet/Apache.NMS.AMQP/trunk/RELEASE.txt
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message