From 1ee447563d208b39e962537a47f14aea741777b0 Mon Sep 17 00:00:00 2001 From: Gordon Sim Date: Mon, 23 Nov 2009 18:10:08 +0000 Subject: QPID-664: Added a little bit of doc on connection options. git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk/qpid@883439 13f79535-47bb-0310-9956-ffa450edef68 --- cpp/include/qpid/messaging/Connection.h | 34 +++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) (limited to 'cpp/include/qpid/messaging/Connection.h') diff --git a/cpp/include/qpid/messaging/Connection.h b/cpp/include/qpid/messaging/Connection.h index f7c5ecfae9..5c5246ff82 100644 --- a/cpp/include/qpid/messaging/Connection.h +++ b/cpp/include/qpid/messaging/Connection.h @@ -41,6 +41,35 @@ class Session; class Connection : public qpid::client::Handle { public: + /** + * Current implementation supports the following options: + * + * username + * password + * heartbeat + * tcp-nodelay + * sasl-mechanism + * sasl-min-ssf + * sasl-max-ssf + * + * (note also bounds, locale, max-channels and max-framesize, but not sure whether those should be docuemented here) + * + * Retry behaviour can be controlled through the following options: + * + * reconnection-timeout - determines how long it will try to + * reconnect for -1 means forever, 0 + * means don't try to reconnect + * min-retry-interval + * max-retry-interval + * + * The retry-interval is the time that the client waits for + * after a failed attempt to reconnect before retrying. It + * starts at the value of the min-retry-interval and is + * doubled every failure until the value of max-retry-interval + * is reached. + * + * + */ static QPID_CLIENT_EXTERN Connection open(const std::string& url, const Variant::Map& options = Variant::Map()); QPID_CLIENT_EXTERN Connection(ConnectionImpl* impl = 0); @@ -63,6 +92,11 @@ struct InvalidOptionString : public qpid::Exception InvalidOptionString(const std::string& msg); }; +/** + * TODO: need to change format of connection option string (currently + * name1=value1&name2=value2 etc, should probably use map syntax as + * per address options. + */ QPID_CLIENT_EXTERN void parseOptionString(const std::string&, Variant::Map&); QPID_CLIENT_EXTERN Variant::Map parseOptionString(const std::string&); -- cgit v1.2.1