activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From tab...@apache.org
Subject svn commit: r775980 [3/4] - in /activemq/activemq-cpp/trunk/activemq-cpp/src: main/ main/activemq/cmsutil/ main/activemq/commands/ main/activemq/core/ main/activemq/transport/mock/ main/activemq/wireformat/openwire/ main/activemq/wireformat/stomp/ main...
Date Mon, 18 May 2009 15:13:33 GMT
Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/DeliveryMode.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/DeliveryMode.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/DeliveryMode.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/DeliveryMode.h Mon May 18 15:13:29 2009
@@ -20,21 +20,21 @@
 
 #include <cms/Config.h>
 
-namespace cms
-{
+namespace cms{
 
     /**
      * This is an Abstract class whose purpose is to provide a container
-     * for the delivery mode enumeration for CMS messages.  
+     * for the delivery mode enumeration for CMS messages.
+     *
+     * @since 1.0
      */
-    class CMS_API DeliveryMode
-    {
+    class CMS_API DeliveryMode {
     public:
-    
+
         virtual ~DeliveryMode() {}
-        
+
         /**
-         * Enumeration values for Message Delivery Mode   
+         * Enumeration values for Message Delivery Mode
          */
         static const int PERSISTENT = 0;
         static const int NON_PERSISTENT = 1;

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Destination.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Destination.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Destination.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Destination.h Mon May 18 15:13:29 2009
@@ -24,31 +24,31 @@
 #include <string>
 
 namespace cms{
-	
+
     /**
-     * A Destination object encapsulates a provider-specific address. 
+     * A Destination object encapsulates a provider-specific address.
+     *
+     * All CMS Destination objects support concurrent use.
+     *
+     * @since 1.0
      */
     class CMS_API Destination{
     public:
-   
-        enum DestinationType
-        {
+
+        enum DestinationType {
             TOPIC,
             QUEUE,
             TEMPORARY_TOPIC,
             TEMPORARY_QUEUE
         };
-		
-	public:
 
-        /**
-         * Destructor
-         */	
+    public:
+
         virtual ~Destination(){}
-      
+
         /**
          * Retrieve the Destination Type for this Destination
-         * 
+         *
          * @return The Destination Type
          */
         virtual DestinationType getDestinationType() const = 0;
@@ -59,23 +59,23 @@
          * uniquely identify a particular destination.  For example, a topic
          * and a queue both named "FOO" must not have equivalent provider
          * strings.
-         * 
+         *
          * @return Provider specific Name
          */
         virtual std::string toProviderString() const = 0;
-        
+
         /**
          * Creates a new instance of this destination type that is a
          * copy of this one, and returns it.
-         * 
+         *
          * @returns cloned copy of this object
          */
         virtual cms::Destination* clone() const = 0;
-      
+
         /**
          * Copies the contents of the given Destinastion object to this one.
-         * 
-         * @param source 
+         *
+         * @param source
          *      The source Destination object.
          */
         virtual void copy( const cms::Destination& source ) = 0;
@@ -84,11 +84,11 @@
          * Retrieve any properties that might be part of the destination
          * that was specified.  This is a deviation from the JMS spec
          * but necessary due to C++ restrictions.
-         * 
+         *
          * @return const reference to a properties object.
          */
         virtual const CMSProperties& getCMSProperties() const = 0;
-        
+
     };
 }
 

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ExceptionListener.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ExceptionListener.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ExceptionListener.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ExceptionListener.h Mon May 18 15:13:29 2009
@@ -27,23 +27,28 @@
      * If a CMS provider detects a serious problem, it notifies the client
      * application through an <code>ExceptionListener</code> that is registered
      * with the <code>Connection</code>.
+     *
+     * An exception listener allows a client to be notified of a problem asynchronously.
+     * Some connections only consume messages, so they would have no other way to learn
+     * that their connection has failed.
+     *
+     * @since 1.0
      */
-    class CMS_API ExceptionListener
-    {
+    class CMS_API ExceptionListener {
     public:
-   
+
         virtual ~ExceptionListener() {}
-   
+
         /**
          * Called when an exception occurs.  Once notified of an exception
          * the caller should no longer use the resource that generated the
          * exception.
-         * 
+         *
          * @param ex
          *      Exception Object that occurred.
          */
         virtual void onException( const cms::CMSException& ex ) = 0;
-      
+
     };
 
 }

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.cpp?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.cpp (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.cpp Mon May 18 15:13:29 2009
@@ -0,0 +1,45 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "IllegalStateException.h"
+
+using namespace cms;
+
+////////////////////////////////////////////////////////////////////////////////
+IllegalStateException::IllegalStateException() throw() : CMSException() {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+IllegalStateException::IllegalStateException( const IllegalStateException& ex )
+    throw() : CMSException( ex ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+IllegalStateException::IllegalStateException( const std::string& message, const std::exception* cause )
+    throw() : CMSException( message, cause ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+IllegalStateException::IllegalStateException( const std::string& message,
+                                              const std::exception* cause,
+                                              const std::vector< std::pair< std::string, int> >& stackTrace )
+    throw() : CMSException( message, cause, stackTrace ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+IllegalStateException::~IllegalStateException() throw() {
+}

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.cpp
------------------------------------------------------------------------------
    svn:eol-style = native

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.h?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.h (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.h Mon May 18 15:13:29 2009
@@ -0,0 +1,54 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef _CMS_ILLEGALSTATEEXCEPTION_H_
+#define _CMS_ILLEGALSTATEEXCEPTION_H_
+
+#include <cms/Config.h>
+#include <cms/CMSException.h>
+
+namespace cms{
+
+    /**
+     * This exception is thrown when a method is invoked at an illegal or inappropriate
+     * time or if the provider is not in an appropriate state for the requested operation.
+     * For example, this exception must be thrown if Session.commit is called on a
+     * non-transacted session.
+     *
+     * @since 1.3
+     */
+    class CMS_API IllegalStateException : public CMSException {
+    public:
+
+        IllegalStateException() throw();
+
+        IllegalStateException( const IllegalStateException& ex ) throw();
+
+        IllegalStateException( const std::string& message,
+                               const std::exception* cause ) throw();
+
+        IllegalStateException( const std::string& message,
+                               const std::exception* cause,
+                               const std::vector< std::pair< std::string, int> >& stackTrace ) throw();
+
+        virtual ~MessageEOFException() throw();
+
+    };
+
+}
+
+#endif /*_CMS_ILLEGALSTATEEXCEPTION_H_*/

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/IllegalStateException.h
------------------------------------------------------------------------------
    svn:eol-style = native

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.cpp?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.cpp (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.cpp Mon May 18 15:13:29 2009
@@ -0,0 +1,45 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "InvalidClientIdException.h"
+
+using namespace cms;
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidClientIdException::InvalidClientIdException() throw() : CMSException() {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidClientIdException::InvalidClientIdException( const InvalidClientIdException& ex )
+    throw() : CMSException( ex ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidClientIdException::InvalidClientIdException( const std::string& message, const std::exception* cause )
+    throw() : CMSException( message, cause ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidClientIdException::InvalidClientIdException( const std::string& message,
+                                                    const std::exception* cause,
+                                                    const std::vector< std::pair< std::string, int> >& stackTrace )
+    throw() : CMSException( message, cause, stackTrace ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidClientIdException::~InvalidClientIdException() throw() {
+}

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.cpp
------------------------------------------------------------------------------
    svn:eol-style = native

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.h?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.h (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.h Mon May 18 15:13:29 2009
@@ -0,0 +1,52 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef _CMS_INVALICLIENTIDEXCEPTION_H_
+#define _CMS_INVALICLIENTIDEXCEPTION_H_
+
+#include <cms/Config.h>
+#include <cms/CMSException.h>
+
+namespace cms{
+
+    /**
+     * This exception must be thrown when a client attempts to set a connection's
+     * client ID to a value that is rejected by a provider.
+     *
+     * @since 1.3
+     */
+    class CMS_API InvalidClientIdException : public CMSException {
+    public:
+
+        InvalidClientIdException() throw();
+
+        InvalidClientIdException( const InvalidClientIdException& ex ) throw();
+
+        InvalidClientIdException( const std::string& message,
+                                  const std::exception* cause ) throw();
+
+        InvalidClientIdException( const std::string& message,
+                                  const std::exception* cause,
+                                  const std::vector< std::pair< std::string, int> >& stackTrace ) throw();
+
+        virtual ~InvalidClientIdException() throw();
+
+    };
+
+}
+
+#endif /*_CMS_INVALICLIENTIDEXCEPTION_H_*/

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidClientIdException.h
------------------------------------------------------------------------------
    svn:eol-style = native

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.cpp?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.cpp (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.cpp Mon May 18 15:13:29 2009
@@ -0,0 +1,45 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "InvalidDestinationException.h"
+
+using namespace cms;
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidDestinationException::InvalidDestinationException() throw() : CMSException() {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidDestinationException::InvalidDestinationException( const InvalidDestinationException& ex )
+    throw() : CMSException( ex ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidDestinationException::InvalidDestinationException( const std::string& message, const std::exception* cause )
+    throw() : CMSException( message, cause ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidDestinationException::InvalidDestinationException( const std::string& message,
+                                                          const std::exception* cause,
+                                                          const std::vector< std::pair< std::string, int> >& stackTrace )
+    throw() : CMSException( message, cause, stackTrace ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidDestinationException::~InvalidDestinationException() throw() {
+}

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.cpp
------------------------------------------------------------------------------
    svn:eol-style = native

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.h?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.h (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.h Mon May 18 15:13:29 2009
@@ -0,0 +1,52 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef _CMS_INVALIDDESTINATIONEXCEPTION_H_
+#define _CMS_INVALIDDESTINATIONEXCEPTION_H_
+
+#include <cms/Config.h>
+#include <cms/CMSException.h>
+
+namespace cms{
+
+    /**
+     * This exception must be thrown when a destination either is not understood by a provider
+     * or is no longer valid.
+     *
+     * @since 1.3
+     */
+    class CMS_API InvalidDestinationException : public CMSException {
+    public:
+
+        InvalidDestinationException() throw();
+
+        InvalidDestinationException( const InvalidDestinationException& ex ) throw();
+
+        InvalidDestinationException( const std::string& message,
+                                     const std::exception* cause ) throw();
+
+        InvalidDestinationException( const std::string& message,
+                                     const std::exception* cause,
+                                     const std::vector< std::pair< std::string, int> >& stackTrace ) throw();
+
+        virtual ~InvalidDestinationException() throw();
+
+    };
+
+}
+
+#endif /*_CMS_INVALIDDESTINATIONEXCEPTION_H_*/

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidDestinationException.h
------------------------------------------------------------------------------
    svn:eol-style = native

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.cpp?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.cpp (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.cpp Mon May 18 15:13:29 2009
@@ -0,0 +1,45 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "InvalidSelectorException.h"
+
+using namespace cms;
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidSelectorException::InvalidSelectorException() throw() : CMSException() {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidSelectorException::InvalidSelectorException( const InvalidSelectorException& ex )
+    throw() : CMSException( ex ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidSelectorException::InvalidSelectorException( const std::string& message, const std::exception* cause )
+    throw() : CMSException( message, cause ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidSelectorException::InvalidSelectorException( const std::string& message,
+                                                    const std::exception* cause,
+                                                    const std::vector< std::pair< std::string, int> >& stackTrace )
+    throw() : CMSException( message, cause, stackTrace ) {
+}
+
+////////////////////////////////////////////////////////////////////////////////
+InvalidSelectorException::~InvalidSelectorException() throw() {
+}

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.cpp
------------------------------------------------------------------------------
    svn:eol-style = native

Added: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.h?rev=775980&view=auto
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.h (added)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.h Mon May 18 15:13:29 2009
@@ -0,0 +1,52 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef _CMS_INVALIDSELECTOREXCEPTION_H_
+#define _CMS_INVALIDSELECTOREXCEPTION_H_
+
+#include <cms/Config.h>
+#include <cms/CMSException.h>
+
+namespace cms{
+
+    /**
+     * This exception must be thrown when a CMS client attempts to give a provider a
+     * message selector with invalid syntax.
+     *
+     * @since 1.3
+     */
+    class CMS_API InvalidSelectorException : public CMSException {
+    public:
+
+        InvalidSelectorException() throw();
+
+        InvalidSelectorException( const InvalidSelectorException& ex ) throw();
+
+        InvalidSelectorException( const std::string& message,
+                                  const std::exception* cause ) throw();
+
+        InvalidSelectorException( const std::string& message,
+                                  const std::exception* cause,
+                                  const std::vector< std::pair< std::string, int> >& stackTrace ) throw();
+
+        virtual ~InvalidSelectorException() throw();
+
+    };
+
+}
+
+#endif /*_CMS_INVALIDSELECTOREXCEPTION_H_*/

Propchange: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/InvalidSelectorException.h
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MapMessage.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MapMessage.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MapMessage.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MapMessage.h Mon May 18 15:13:29 2009
@@ -21,8 +21,7 @@
 #include <cms/Config.h>
 #include <cms/Message.h>
 
-namespace cms
-{
+namespace cms{
 
     /**
      * A MapMessage object is used to send a set of name-value pairs. The
@@ -35,12 +34,14 @@
      *
      * When a client receives a MapMessage, it is in read-only mode. If a
      * client attempts to write to the message at this point, a
-     * CMSException is thrown.
+     * MessageNotWriteableException is thrown.  To place the MapMessage back
+     * into a state where it can be read from and written to, call the
+     * <code>clearBody</code> method.
      *
      * MapMessage objects support the following conversion table. The marked
      * cases must be supported. The unmarked cases must throw a CMSException.
-     * The String-to-primitive conversions may throw a CMSException if the
-     * primitive's valueOf() method does not accept it as a valid String
+     * The String-to-primitive conversions may throw a MessageFormatException if
+     * the primitive's valueOf() method does not accept it as a valid String
      * representation of the primitive.
      *
      * A value written as the row type can be read as the column type.
@@ -59,6 +60,7 @@
      *  |byte[]  |                                                        X
      *  |----------------------------------------------------------------------
      *
+     * @since 1.0
      */
     class CMS_API MapMessage : public Message {
     public:
@@ -71,9 +73,10 @@
          *
          * @return STL Vector of String values, each of which is the
          *         name of an item in the MapMessage
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
          */
-        virtual std::vector< std::string > getMapNames() const = 0;
+        virtual std::vector< std::string > getMapNames() const throw( CMSException ) = 0;
 
         /**
          * Indicates whether an item exists in this MapMessage object.
@@ -81,15 +84,19 @@
          * @param name
          *      String name of the Object in question
          * @return boolean value indicating if the name is in the map
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
          */
-        virtual bool itemExists( const std::string& name ) const = 0;
+        virtual bool itemExists( const std::string& name ) const throw( CMSException ) = 0;
 
         /**
          * Returns the Boolean value of the Specified name
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual bool getBoolean( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -101,17 +108,21 @@
          *      the name of the boolean
          * @param value
          *      the boolean value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
-        virtual void setBoolean( const std::string& name,
-                                 bool value ) throw( CMSException ) = 0;
+        virtual void setBoolean( const std::string& name, bool value )
+            throw( CMSException ) = 0;
 
         /**
          * Returns the Byte value of the Specified name
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual unsigned char getByte( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -123,17 +134,21 @@
          *      the name of the Byte
          * @param value
          *      the Byte value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
-        virtual void setByte( const std::string& name,
-                              unsigned char value ) throw( CMSException ) = 0;
+        virtual void setByte( const std::string& name, unsigned char value )
+            throw( CMSException ) = 0;
 
         /**
          * Returns the Bytes value of the Specified name
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual std::vector<unsigned char> getBytes( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -145,7 +160,9 @@
          *      The name of the Bytes
          * @param value
          *      The Bytes value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
         virtual void setBytes( const std::string& name,
                                const std::vector<unsigned char>& value )
@@ -156,7 +173,9 @@
          *
          * @param name
          *      name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual char getChar( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -168,7 +187,9 @@
          *      the name of the Char
          * @param value
          *      the Char value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
         virtual void setChar( const std::string& name, char value )
             throw( CMSException ) = 0;
@@ -178,7 +199,9 @@
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual double getDouble( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -190,7 +213,9 @@
          *      The name of the Double
          * @param value
          *      The Double value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
         virtual void setDouble( const std::string& name,
                                 double value ) throw( CMSException ) = 0;
@@ -200,7 +225,9 @@
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual float getFloat( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -212,7 +239,9 @@
          *      The name of the Float
          * @param value
          *      The Float value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
         virtual void setFloat( const std::string& name, float value )
             throw( CMSException ) = 0;
@@ -222,7 +251,9 @@
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual int getInt( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -234,7 +265,9 @@
          *      The name of the Int
          * @param value
          *      The Int value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
         virtual void setInt( const std::string& name, int value )
             throw( CMSException ) = 0;
@@ -244,7 +277,9 @@
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual long long getLong( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -256,7 +291,9 @@
          *      The name of the Long
          * @param value
          *      The Long value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
         virtual void setLong( const std::string& name, long long value )
             throw( CMSException ) = 0;
@@ -266,7 +303,9 @@
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual short getShort( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -278,7 +317,9 @@
          *      The name of the Short
          * @param value
          *      The Short value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
         virtual void setShort( const std::string& name, short value )
             throw( CMSException ) = 0;
@@ -288,7 +329,9 @@
          *
          * @param name
          *      Name of the value to fetch from the map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageFormatExceptio - if this type conversion is invalid.
          */
         virtual std::string getString( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -300,11 +343,12 @@
          *      The name of the String
          * @param value
          *      The String value to set in the Map
-         * @throws CMSException
+         *
+         * @throws CMSException - if the operation fails due to an internal error.
+         * @throws MessageNotWritableException - if the Message is in Read-only Mode.
          */
-        virtual void setString( const std::string& name,
-                                const std::string& value )
-                                    throw( CMSException ) = 0;
+        virtual void setString( const std::string& name, const std::string& value )
+            throw( CMSException ) = 0;
 
     };
 

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Message.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Message.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Message.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/Message.h Mon May 18 15:13:29 2009
@@ -82,7 +82,7 @@
          * session that the message was delivered to.
          *
          * Calls to acknowledge are ignored for both transacted sessions and
-         * sessions specified to use implicit acknowledgement modes.
+         * sessions specified to use implicit acknowledgment modes.
          *
          * A client may individually acknowledge each message as it is consumed,
          * or it may choose to acknowledge messages as an application-defined
@@ -92,14 +92,19 @@
          *
          * Messages that have been received but not acknowledged may be
          * redelivered.
+         *
+         * @throws CMSException - if an internal error occurs.
+         * @throws IllegalStateException - if this method is called on a closed session.
          */
         virtual void acknowledge() const throw( CMSException ) = 0;
 
         /**
          * Clears out the body of the message.  This does not clear the
          * headers or properties.
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void clearBody() = 0;
+        virtual void clearBody() throw( CMSException ) = 0;
 
         /**
          * Clears out the message body. Clearing a message's body does not clear
@@ -108,16 +113,20 @@
          * If this message body was read-only, calling this method leaves the
          * message body in the same state as an empty body in a newly created
          * message.
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void clearProperties() = 0;
+        virtual void clearProperties() throw( CMSException ) = 0;
 
         /**
-         * Retrieves the propery names.
+         * Retrieves the property names.
          *
          * @return The complete set of property names currently in this
          * message.
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual std::vector<std::string> getPropertyNames() const = 0;
+        virtual std::vector<std::string> getPropertyNames() const throw( CMSException ) = 0;
 
         /**
          * Indicates whether or not a given property exists.
@@ -125,8 +134,10 @@
          * @param name
          *      The name of the property to look up.
          * @return True if the property exists in this message.
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual bool propertyExists( const std::string& name ) const = 0;
+        virtual bool propertyExists( const std::string& name ) const throw( CMSException ) = 0;
 
         /**
          * Gets a boolean property.
@@ -134,7 +145,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual bool getBooleanProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -145,7 +158,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual unsigned char getByteProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -156,7 +171,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual double getDoubleProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -167,7 +184,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual float getFloatProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -178,7 +197,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual int getIntProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -189,7 +210,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual long long getLongProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -200,7 +223,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual short getShortProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -211,7 +236,9 @@
          * @param name
          *      The name of the property to retrieve.
          * @return The value for the named property.
+         *
          * @throws CMSException if the property does not exist.
+         * @throws MessageFormatException - if this type conversion is invalid.
          */
         virtual std::string getStringProperty( const std::string& name ) const
             throw( CMSException ) = 0;
@@ -223,10 +250,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setBooleanProperty( const std::string& name,
-            bool value ) throw( CMSException ) = 0;
+        virtual void setBooleanProperty( const std::string& name, bool value )
+            throw( CMSException ) = 0;
 
         /**
          * Sets a byte property.
@@ -235,10 +264,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setByteProperty( const std::string& name,
-            unsigned char value ) throw( CMSException ) = 0;
+        virtual void setByteProperty( const std::string& name, unsigned char value )
+            throw( CMSException ) = 0;
 
         /**
          * Sets a double property.
@@ -247,10 +278,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setDoubleProperty( const std::string& name,
-            double value ) throw( CMSException ) = 0;
+        virtual void setDoubleProperty( const std::string& name, double value )
+            throw( CMSException ) = 0;
 
         /**
          * Sets a float property.
@@ -258,10 +291,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setFloatProperty( const std::string& name,
-            float value ) throw( CMSException ) = 0;
+        virtual void setFloatProperty( const std::string& name, float value )
+            throw( CMSException ) = 0;
 
         /**
          * Sets a int property.
@@ -270,10 +305,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setIntProperty( const std::string& name,
-            int value ) throw( CMSException ) = 0;
+        virtual void setIntProperty( const std::string& name, int value )
+            throw( CMSException ) = 0;
 
         /**
          * Sets a long property.
@@ -282,10 +319,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setLongProperty( const std::string& name,
-            long long value ) throw( CMSException ) = 0;
+        virtual void setLongProperty( const std::string& name, long long value )
+            throw( CMSException ) = 0;
 
         /**
          * Sets a short property.
@@ -294,10 +333,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setShortProperty( const std::string& name,
-            short value ) throw( CMSException ) = 0;
+        virtual void setShortProperty( const std::string& name, short value )
+            throw( CMSException ) = 0;
 
         /**
          * Sets a string property.
@@ -306,10 +347,12 @@
          *      The name of the property to retrieve.
          * @param value
          *      The value for the named property.
-         * @throws CMSException
+         *
+         * @throws CMSException - if the name is an empty string.
+         * @throws MessageNotWriteableException - if properties are read-only
          */
-        virtual void setStringProperty( const std::string& name,
-            const std::string& value ) throw( CMSException ) = 0;
+        virtual void setStringProperty( const std::string& name, const std::string& value )
+            throw( CMSException ) = 0;
 
         /**
          * Gets the correlation ID for the message.
@@ -318,8 +361,10 @@
          * provider-specific message IDs or application-specific String values.
          *
          * @return string representation of the correlation Id
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual std::string getCMSCorrelationID() const = 0;
+        virtual std::string getCMSCorrelationID() const throw( CMSException ) = 0;
 
         /**
          * Sets the correlation ID for the message.
@@ -354,15 +399,20 @@
          *
          * @param correlationId
          *      The message ID of a message being referred to.
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSCorrelationID( const std::string& correlationId ) = 0;
+        virtual void setCMSCorrelationID( const std::string& correlationId )
+            throw( CMSException ) = 0;
 
         /**
          * Gets the DeliveryMode for this message
          *
          * @return DeliveryMode enumerated value.
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual int getCMSDeliveryMode() const = 0;
+        virtual int getCMSDeliveryMode() const throw( CMSException ) = 0;
 
         /**
          * Sets the DeliveryMode for this message
@@ -372,8 +422,10 @@
          *
          * @param mode
          *      DeliveryMode enumerated value.
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSDeliveryMode( int mode ) = 0;
+        virtual void setCMSDeliveryMode( int mode ) throw( CMSException ) = 0;
 
         /**
          * Gets the Destination object for this message.
@@ -389,8 +441,10 @@
          * equivalent to the value assigned when it was sent.
          *
          * @return Destination object
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual const Destination* getCMSDestination() const = 0;
+        virtual const Destination* getCMSDestination() const throw( CMSException ) = 0;
 
         /**
          * Sets the Destination object for this message.
@@ -400,8 +454,11 @@
          *
          * @param destination
          *      Destination Object
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSDestination( const Destination* destination ) = 0;
+        virtual void setCMSDestination( const Destination* destination )
+            throw( CMSException ) = 0;
 
         /**
          * Gets the message's expiration value.
@@ -425,8 +482,10 @@
          * @return the time the message expires, which is the sum of the
          * time-to-live value specified by the client and the GMT at the time
          * of the send
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual long long getCMSExpiration() const = 0;
+        virtual long long getCMSExpiration() const throw( CMSException ) = 0;
 
         /**
          * Sets the message's expiration value.
@@ -436,8 +495,11 @@
          *
          * @param expireTime
          *      the message's expiration time
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSExpiration( long long expireTime ) = 0;
+        virtual void setCMSExpiration( long long expireTime )
+            throw( CMSException ) = 0;
 
         /**
          * The CMSMessageID header field contains a value that uniquely
@@ -467,8 +529,10 @@
          * normal unique value.
          *
          * @return provider-assigned message id
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual std::string getCMSMessageID() const = 0;
+        virtual std::string getCMSMessageID() const throw( CMSException ) = 0;
 
         /**
          * Sets the message ID.
@@ -478,8 +542,10 @@
          *
          * @param id
          *      the ID of the message
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSMessageID( const std::string& id ) = 0;
+        virtual void setCMSMessageID( const std::string& id ) throw( CMSException ) = 0;
 
         /**
          * Gets the message priority level.
@@ -494,8 +560,10 @@
          * deliver expedited messages ahead of normal messages.
          *
          * @return priority value
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual int getCMSPriority() const = 0;
+        virtual int getCMSPriority() const throw( CMSException ) = 0;
 
         /**
          * Sets the Priority Value for this message
@@ -505,8 +573,10 @@
          *
          * @param priority
          *      priority value for this message
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSPriority( int priority ) = 0;
+        virtual void setCMSPriority( int priority ) throw( CMSException ) = 0;
 
         /**
          * Gets an indication of whether this message is being redelivered.
@@ -516,8 +586,10 @@
          * earlier but that its receipt was not acknowledged at that time.
          *
          * @return true if this message is being redelivered
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual bool getCMSRedelivered() const = 0;
+        virtual bool getCMSRedelivered() const throw( CMSException ) = 0;
 
         /**
          * Specifies whether this message is being redelivered.
@@ -527,16 +599,20 @@
          *
          * @param redelivered
          *      boolean redelivered value
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSRedelivered( bool redelivered ) = 0;
+        virtual void setCMSRedelivered( bool redelivered ) throw( CMSException ) = 0;
 
         /**
          * Gets the Destination object to which a reply to this message should
          * be sent.
          *
          * @return Destination to which to send a response to this message
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual const cms::Destination* getCMSReplyTo() const = 0;
+        virtual const cms::Destination* getCMSReplyTo() const throw( CMSException ) = 0;
 
         /**
          * Sets the Destination object to which a reply to this message should
@@ -562,8 +638,11 @@
          *
          * @param destination
          *      Destination to which to send a response to this message
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSReplyTo( const cms::Destination* destination ) = 0;
+        virtual void setCMSReplyTo( const cms::Destination* destination )
+            throw( CMSException ) = 0;
 
         /**
          * Gets the message timestamp.
@@ -589,8 +668,10 @@
          * value.
          *
          * @return the message timestamp
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual long long getCMSTimestamp() const = 0;
+        virtual long long getCMSTimestamp() const throw( CMSException ) = 0;
 
         /**
          * Sets the message timestamp.
@@ -600,8 +681,10 @@
          *
          * @param timeStamp
          *      integer time stamp value
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSTimestamp( long long timeStamp ) = 0;
+        virtual void setCMSTimestamp( long long timeStamp ) throw( CMSException ) = 0;
 
         /**
          * Gets the message type identifier supplied by the client when the
@@ -609,8 +692,10 @@
          *
          * @return the message type
          * @see setCMSType
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual std::string getCMSType() const = 0;
+        virtual std::string getCMSType() const throw( CMSException ) = 0;
 
         /**
          * Sets the message type.
@@ -639,8 +724,10 @@
          * @param type
          *      the message type
          * @see getCMSType
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setCMSType( const std::string& type ) = 0;
+        virtual void setCMSType( const std::string& type ) throw( CMSException ) = 0;
 
     };
 }

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageConsumer.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageConsumer.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageConsumer.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageConsumer.h Mon May 18 15:13:29 2009
@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
- 
+
 #ifndef _CMS_MESSAGECONSUMER_H_
 #define _CMS_MESSAGECONSUMER_H_
 
@@ -23,83 +23,99 @@
 #include <cms/Message.h>
 #include <cms/Closeable.h>
 
-namespace cms
-{
+namespace cms{
+
     /**
      * A client uses a <code>MessageConsumer</code> to received messages
      * from a destination.<br>
      * <br>
-     * A client may either synchronously receive a message consumer's messages 
+     * A client may either synchronously receive a message consumer's messages
      * or have the consumer asynchronously deliver them as they arrive. <br>
      * <br>
-     * For synchronous receipt, a client can request the next message from a 
-     * message consumer using one of its <code>receive</code> methods. There are 
-     * several variations of <code>receive</code> that allow a client to poll or 
-     * wait for the next message.<br>  
+     * For synchronous receipt, a client can request the next message from a
+     * message consumer using one of its <code>receive</code> methods. There are
+     * several variations of <code>receive</code> that allow a client to poll or
+     * wait for the next message.<br>
      * <br>
-     * For asynchronous delivery, a client can register a 
-     * <code>MessageListener</code> object with a message consumer. As messages 
-     * arrive at the message consumer, it delivers them by calling the 
+     * For asynchronous delivery, a client can register a
+     * <code>MessageListener</code> object with a message consumer. As messages
+     * arrive at the message consumer, it delivers them by calling the
      * <code>MessageListener</code>'s <code>onMessage</code> method.
-     * 
+     * <br>
+     * When the MessageConsumer's close method is called the method can block while
+     * an asynchronous message delivery is in progress or until a <code>receive</code>
+     * operation completes.  A blocked consumer in a <code>receive</code> call will
+     * return a Null when the close method is called.
+     *
      * @see MessageListener
+     *
+     * @since 1.0
      */
-    class CMS_API MessageConsumer : public Closeable
-    {
+    class CMS_API MessageConsumer : public Closeable {
     public:
 
         virtual ~MessageConsumer() {}
-      
+
         /**
          * Synchronously Receive a Message
-         * 
-         * @return new message
-         * @throws CMSException
+         *
+         * @return new message which the caller owns and must delete.
+         *
+         * @throws CMSException - If an internal error occurs.
          */
         virtual Message* receive() throw ( CMSException ) = 0;
 
         /**
          * Synchronously Receive a Message, time out after defined interval.
          * Returns null if nothing read.
-         * 
-         * @return new message
-         * @throws CMSException
+         *
+         * @return new message which the caller owns and must delete.
+         *
+         * @throws CMSException - If an internal error occurs.
          */
         virtual Message* receive( int millisecs ) throw ( CMSException ) = 0;
 
         /**
          * Receive a Message, does not wait if there isn't a new message
          * to read, returns NULL if nothing read.
-         * 
-         * @return new message
-         * @throws CMSException
+         *
+         * @return new message which the caller owns and must delete.
+         *
+         * @throws CMSException - If an internal error occurs.
          */
         virtual Message* receiveNoWait() throw ( CMSException ) = 0;
 
         /**
          * Sets the MessageListener that this class will send notifs on
-         * 
-         * @param listener 
+         *
+         * @param listener
          *      The listener of messages received by this consumer.
+         *
+         * @throws CMSException - If an internal error occurs.
          */
-        virtual void setMessageListener( MessageListener* listener ) = 0;
-      
+        virtual void setMessageListener( MessageListener* listener )
+            throw ( CMSException ) = 0;
+
         /**
-         * Gets the MessageListener that this class will send notifs on
-         * 
+         * Gets the MessageListener that this class will send mew Message
+         * notification events to.
+         *
          * @return The listener of messages received by this consumer
+         *
+         * @throws CMSException - If an internal error occurs.
          */
-        virtual MessageListener* getMessageListener() const = 0;
-      
+        virtual MessageListener* getMessageListener() const throw ( CMSException ) = 0;
+
         /**
          * Gets this message consumer's message selector expression.
-         * 
+         *
          * @return This Consumer's selector expression or "".
-         * @throws cms::CMSException
+         *
+         * @throws CMSException - If an internal error occurs.
          */
-        virtual std::string getMessageSelector() const 
+        virtual std::string getMessageSelector() const
             throw ( cms::CMSException ) = 0;
-            
+
     };
 
 }

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.cpp?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.cpp (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.cpp Mon May 18 15:13:29 2009
@@ -24,7 +24,7 @@
 }
 
 ////////////////////////////////////////////////////////////////////////////////
-MessageEOFException::MessageEOFException( const MessageEOFException& ex ) throw() : CMSException() {
+MessageEOFException::MessageEOFException( const MessageEOFException& ex ) throw() : CMSException( ex ) {
 }
 
 ////////////////////////////////////////////////////////////////////////////////

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageEOFException.h Mon May 18 15:13:29 2009
@@ -21,13 +21,13 @@
 #include <cms/Config.h>
 #include <cms/CMSException.h>
 
-namespace cms {
+namespace cms{
 
     /**
      * This exception must be thrown when an unexpected end of stream has been
      * reached when a StreamMessage or BytesMessage is being read.
      *
-     * @since 1.2
+     * @since 1.3
      */
     class CMS_API MessageEOFException : public CMSException {
     public:

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.cpp?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.cpp (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.cpp Mon May 18 15:13:29 2009
@@ -35,8 +35,8 @@
 
 ////////////////////////////////////////////////////////////////////////////////
 MessageFormatException::MessageFormatException( const std::string& message,
-                                          const std::exception* cause,
-                                          const std::vector< std::pair< std::string, int> >& stackTrace )
+                                                const std::exception* cause,
+                                                const std::vector< std::pair< std::string, int> >& stackTrace )
     throw() : CMSException( message, cause, stackTrace ) {
 }
 

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageFormatException.h Mon May 18 15:13:29 2009
@@ -21,7 +21,7 @@
 #include <cms/Config.h>
 #include <cms/CMSException.h>
 
-namespace cms {
+namespace cms{
 
     /**
      * This exception must be thrown when a CMS client attempts to use a data type not
@@ -30,7 +30,7 @@
      * For example, this exception must be thrown if StreamMessage.readShort is used to read
      * a boolean value.
      *
-     * @since 1.2
+     * @since 1.3
      */
     class CMS_API MessageFormatException : public CMSException {
     public:

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageListener.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageListener.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageListener.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageListener.h Mon May 18 15:13:29 2009
@@ -21,37 +21,39 @@
 #include <cms/Config.h>
 
 namespace cms{
-    
+
     class Message;
-    
+
     /**
-     * A <code>MessageListener</code> object is used to receive asynchronously 
+     * A <code>MessageListener</code> object is used to receive asynchronously
      * delivered messages.
+     *
+     * @since 1.0
      */
     class CMS_API MessageListener{
     public:
-    
+
         virtual ~MessageListener(){}
-        
+
         /**
          * Called asynchronously when a new message is received, the message
-         * reference can be to any othe Message types. a dynamic cast is used
+         * reference can be to any of the Message types. a dynamic cast is used
          * to find out what type of message this is.  The lifetime of this
          * object is only guaranteed to be for life of the onMessage function
-         * after this returns the message may no longer exists.  User should
-         * copy the data or clone the message if they wish to keep something
-         * around about this message.
-         * 
+         * after this callback returns the message may no longer exists.  Users should
+         * copy the data or clone the message if they wish to retain information that
+         * was contained in this Message.
+         *
          * It is considered a programming error for this method to throw an
          * exception.
-         * 
+         *
          * @param message
          *      Message object const pointer recipient does not own.
          */
         virtual void onMessage( const Message* message ) = 0;
 
     };
-    
+
 }
 
 #endif /*_CMS_MESSAGELISTENER_H_*/

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.cpp?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.cpp (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.cpp Mon May 18 15:13:29 2009
@@ -35,8 +35,8 @@
 
 ////////////////////////////////////////////////////////////////////////////////
 MessageNotReadableException::MessageNotReadableException( const std::string& message,
-                                          const std::exception* cause,
-                                          const std::vector< std::pair< std::string, int> >& stackTrace )
+                                                          const std::exception* cause,
+                                                          const std::vector< std::pair< std::string, int> >& stackTrace )
     throw() : CMSException( message, cause, stackTrace ) {
 }
 

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotReadableException.h Mon May 18 15:13:29 2009
@@ -21,13 +21,12 @@
 #include <cms/Config.h>
 #include <cms/CMSException.h>
 
-namespace cms {
+namespace cms{
 
     /**
-     * This exception must be thrown when an unexpected end of stream has been
-     * reached when a StreamMessage or BytesMessage is being read.
+     * This exception must be thrown when a CMS client attempts to read a write-only message.
      *
-     * @since 1.2
+     * @since 1.3
      */
     class CMS_API MessageNotReadableException : public CMSException {
     public:

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.cpp
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.cpp?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.cpp (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.cpp Mon May 18 15:13:29 2009
@@ -35,8 +35,8 @@
 
 ////////////////////////////////////////////////////////////////////////////////
 MessageNotWriteableException::MessageNotWriteableException( const std::string& message,
-                                          const std::exception* cause,
-                                          const std::vector< std::pair< std::string, int> >& stackTrace )
+                                                            const std::exception* cause,
+                                                            const std::vector< std::pair< std::string, int> >& stackTrace )
     throw() : CMSException( message, cause, stackTrace ) {
 }
 

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageNotWriteableException.h Mon May 18 15:13:29 2009
@@ -21,13 +21,12 @@
 #include <cms/Config.h>
 #include <cms/CMSException.h>
 
-namespace cms {
+namespace cms{
 
     /**
-     * This exception must be thrown when an unexpected end of stream has been
-     * reached when a StreamMessage or BytesMessage is being read.
+     * This exception must be thrown when a CMS client attempts to write to a read-only message.
      *
-     * @since 1.2
+     * @since 1.3
      */
     class CMS_API MessageNotWriteableException : public CMSException {
     public:

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageProducer.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageProducer.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageProducer.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/MessageProducer.h Mon May 18 15:13:29 2009
@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
- 
+
 #ifndef _CMS_MESSAGEPRODUCER_H_
 #define _CMS_MESSAGEPRODUCER_H_
 
@@ -25,173 +25,200 @@
 #include <cms/CMSException.h>
 #include <cms/DeliveryMode.h>
 
-namespace cms
-{
-    /** 
-     * A client uses a <code>MessageProducer</code> object to send messages to 
-     * a destination. A <code>MessageProducer</code> object is created by 
-     * passing a <code>Destination</code> object to a message-producer creation 
+namespace cms{
+
+    /**
+     * A client uses a <code>MessageProducer</code> object to send messages to
+     * a destination. A <code>MessageProducer</code> object is created by
+     * passing a <code>Destination</code> object to a message-producer creation
      * method supplied by a session.<br>
      * <br>
-     * A client also has the option of creating a message producer without 
-     * supplying a destination. In this case, a destination must be provided 
-     * with every send operation. A typical use for this kind of message 
-     * producer is to send replies to requests using the request's CMSReplyTo 
+     * A client also has the option of creating a message producer without
+     * supplying a destination. In this case, a destination must be provided
+     * with every send operation. A typical use for this kind of message
+     * producer is to send replies to requests using the request's CMSReplyTo
      * destination.<br>
      * <br>
-     * A client can specify a default delivery mode, priority, and time to live 
-     * for messages sent by a message producer. It can also specify the 
+     * A client can specify a default delivery mode, priority, and time to live
+     * for messages sent by a message producer. It can also specify the
      * delivery mode, priority, and time to live for an individual message.<br>
      * <br>
-     * A client can specify a time-to-live value in milliseconds for each 
-     * message it sends. This value defines a message expiration time that is 
-     * the sum of the message's time-to-live and the GMT when it is sent (for 
-     * transacted sends, this is the time the client sends the message, not the 
-     * time the transaction is committed). 
+     * A client can specify a time-to-live value in milliseconds for each
+     * message it sends. This value defines a message expiration time that is
+     * the sum of the message's time-to-live and the GMT when it is sent (for
+     * transacted sends, this is the time the client sends the message, not the
+     * time the transaction is committed).
+     *
+     * @since 1.0
      */
-    class CMS_API MessageProducer : public Closeable
-    {
+    class CMS_API MessageProducer : public Closeable {
     public:
 
         virtual ~MessageProducer() {}
-      
+
         /**
          * Sends the message to the default producer destination, but does
          * not take ownership of the message, caller must still destroy it.
          * Uses default values for deliveryMode, priority, and time to live.
-         * 
+         *
          * @param message
          *      The message to be sent.
-         * @throws CMSException
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void send( Message* message ) throw ( CMSException ) = 0;             
+        virtual void send( Message* message ) throw ( CMSException ) = 0;
 
         /**
          * Sends the message to the default producer destination, but does
          * not take ownership of the message, caller must still destroy it.
-         * 
+         *
          * @param message
          *      The message to be sent.
-         * @param deliveryMode 
+         * @param deliveryMode
          *      The delivery mode to be used.
-         * @param priority 
+         * @param priority
          *      The priority for this message.
-         * @param timeToLive 
+         * @param timeToLive
          *      The time to live value for this message in milliseconds.
-         * @throws CMSException
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void send( Message* message, int deliveryMode, int priority, 
+        virtual void send( Message* message, int deliveryMode, int priority,
             long long timeToLive) throw ( CMSException ) = 0;
-            
+
         /**
          * Sends the message to the designated destination, but does
          * not take ownership of the message, caller must still destroy it.
          * Uses default values for deliveryMode, priority, and time to live.
-         * 
+         *
          * @param destination
          *      The destination on which to send the message
          * @param message
          *      the message to be sent.
-         * @throws CMSException
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void send( const Destination* destination,
-                           Message* message ) throw ( CMSException ) = 0;
-                           
+        virtual void send( const Destination* destination, Message* message )
+            throw ( CMSException ) = 0;
+
         /**
          * Sends the message to the designated destination, but does
          * not take ownership of the message, caller must still destroy it.
-         * 
+         *
          * @param destination
          *      The destination on which to send the message
          * @param message
          *      The message to be sent.
          * @param deliveryMode
          *      The delivery mode to be used.
-         * @param priority 
+         * @param priority
          *      The priority for this message.
-         * @param timeToLive 
+         * @param timeToLive
          *      The time to live value for this message in milliseconds.
-         * @throws CMSException
-         */     
+         *
+         * @throws CMSException - if an internal error occurs.
+         */
         virtual void send( const Destination* destination,
-            Message* message, int deliveryMode, int priority, 
+            Message* message, int deliveryMode, int priority,
             long long timeToLive) throw ( CMSException ) = 0;
-            
-        /** 
+
+        /**
          * Sets the delivery mode for this Producer
-         * 
+         *
          * @param mode
          *      The DeliveryMode
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setDeliveryMode( int mode ) = 0;
-      
-        /** 
+        virtual void setDeliveryMode( int mode ) throw ( CMSException ) = 0;
+
+        /**
          * Gets the delivery mode for this Producer
-         * 
+         *
          * @return The DeliveryMode
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual int getDeliveryMode() const = 0;
-      
+        virtual int getDeliveryMode() const throw ( CMSException ) = 0;
+
         /**
-         * Sets if Message Ids are disbled for this Producer
-         * 
+         * Sets if Message Ids are disabled for this Producer
+         *
          * @param value
          *      boolean indicating enable / disable (true / false)
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setDisableMessageID( bool value ) = 0;
-      
+        virtual void setDisableMessageID( bool value ) throw ( CMSException ) = 0;
+
         /**
-         * Gets if Message Ids are disbled for this Producer
-         * 
+         * Gets if Message Ids are disabled for this Producer
+         *
          * @return boolean indicating enable / disable (true / false)
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual bool getDisableMessageID() const = 0;
+        virtual bool getDisableMessageID() const throw ( CMSException ) = 0;
 
         /**
-         * Sets if Message Time Stamps are disbled for this Producer
+         * Sets if Message Time Stamps are disabled for this Producer
          * @param value - boolean indicating enable / disable (true / false)
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setDisableMessageTimeStamp( bool value ) = 0;
-      
+        virtual void setDisableMessageTimeStamp( bool value )
+            throw ( CMSException ) = 0;
+
         /**
-         * Gets if Message Time Stamps are disbled for this Producer
-         * 
+         * Gets if Message Time Stamps are disabled for this Producer
+         *
          * @return boolean indicating enable / disable (true / false)
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual bool getDisableMessageTimeStamp() const = 0;
-      
+        virtual bool getDisableMessageTimeStamp() const
+            throw ( CMSException ) = 0;
+
         /**
          * Sets the Priority that this Producers sends messages at
-         * 
+         *
          * @param priority
          *      int value for Priority level
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setPriority( int priority ) = 0;
-      
+        virtual void setPriority( int priority ) throw ( CMSException ) = 0;
+
         /**
          * Gets the Priority level that this producer sends messages at
-         * 
+         *
          * @return int based priority level
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual int getPriority() const = 0;
-      
+        virtual int getPriority() const throw ( CMSException ) = 0;
+
         /**
          * Sets the Time to Live that this Producers sends messages with.  This
          * value will be used if the time to live is not specified via the
          * send method.
-         * 
+         *
          * @param time
          *      default time to live value in milliseconds
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual void setTimeToLive( long long time ) = 0;
-      
+        virtual void setTimeToLive( long long time ) throw ( CMSException ) = 0;
+
         /**
          * Gets the Time to Live that this producer sends messages with
-         * 
+         *
          * @return Time to live value in milliseconds
+         *
+         * @throws CMSException - if an internal error occurs.
          */
-        virtual long long getTimeToLive() const = 0;
-      
+        virtual long long getTimeToLive() const throw ( CMSException ) = 0;
+
     };
 
 }

Modified: activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ObjectMessage.h
URL: http://svn.apache.org/viewvc/activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ObjectMessage.h?rev=775980&r1=775979&r2=775980&view=diff
==============================================================================
--- activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ObjectMessage.h (original)
+++ activemq/activemq-cpp/trunk/activemq-cpp/src/main/cms/ObjectMessage.h Mon May 18 15:13:29 2009
@@ -24,11 +24,14 @@
 namespace cms{
 
     /**
-     * Place holder for interaction with JMS systems that support Java 
+     * Place holder for interaction with JMS systems that support Java, the C++
+     * client is not responsible for deserializing the contained Object.
+     *
      * serialized <code>ObjectMessage</code>s.
+     *
+     * @since 1.0
      */
-    class CMS_API ObjectMessage : public Message
-    {
+    class CMS_API ObjectMessage : public Message {
     public:
 
         virtual ~ObjectMessage() {}



Mime
View raw message