Update Solaris packaging files.

[shibboleth/xmltooling.git] / xmltooling / exceptions.h

diff --git a/xmltooling/exceptions.h b/xmltooling/exceptions.h
index a58c24f..43b17fb 100644 (file)
--- a/xmltooling/exceptions.h
+++ b/xmltooling/exceptions.h
@@ -1,5 +1,5 @@
 /*
- *  Copyright 2001-2006 Internet2
+ *  Copyright 2001-2007 Internet2
  * 
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,7 +15,7 @@
  */
 
 /**
- * @file exceptions.h
+ * @file xmltooling/exceptions.h
  * 
  * Exception classes
  */
@@ -50,7 +50,7 @@
         name(const std::string& msg, const xmltooling::params& p=xmltooling::params()) : base(msg,p) {} \
         XMLTOOLING_DOXYGEN(Constructor) \
         name(const std::string& msg, const xmltooling::namedparams& p) : base(msg,p) {} \
-        virtual ~name() {} \
+        virtual ~name() throw () {} \
         virtual const char* getClassName() const { return #ns"::"#name; } \
         void raise() const {throw *this;} \
     }
@@ -131,20 +131,15 @@ namespace xmltooling {
         namedparams(int count,...);
     };
 
-    class XMLTOOL_EXCEPTIONAPI(XMLTOOL_API) XMLToolingException;
-    
-    /** A factory function that returns an empty exception object of a given type. */
-    typedef XMLToolingException* ExceptionFactory();
-    
     /**
      * Base exception class, supports parametrized messages and XML serialization.
      * Parameters are prefixed with a dollar sign ($) and can be positional ($1)
      * or named ($info).
      */
-    class XMLTOOL_EXCEPTIONAPI(XMLTOOL_API) XMLToolingException
+    class XMLTOOL_EXCEPTIONAPI(XMLTOOL_API) XMLToolingException : public std::exception
     {
     public:
-        virtual ~XMLToolingException() {}
+        virtual ~XMLToolingException() throw () {}
 
         /**
          * Constructs an exception using a message and positional parameters.
@@ -190,7 +185,7 @@ namespace xmltooling {
          * 
          * @return  the processed message
          */
-        const char* what() const {return getMessage();}
+        const char* what() const throw () {return getMessage();}
 
         /**
          * Sets the error message.
@@ -281,6 +276,14 @@ namespace xmltooling {
          */
         std::string toString() const;
 
+        /**
+         * Returns a set of query string name/value pairs, URL-encoded, representing the
+         * exception's type, message, and parameters.
+         *
+         * @return  the query string representation
+         */
+        std::string toQueryString() const;
+
     private:
         std::string m_msg;
         mutable std::string m_processedmsg;
@@ -311,6 +314,9 @@ namespace xmltooling {
          */
         static XMLToolingException* fromString(const char* s);
                 
+        /** A factory function that returns an empty exception object of a given type. */
+        typedef XMLToolingException* ExceptionFactory();
+        
         /**
          * Registers a factory to create exceptions of a given class name.
          *