Multi-line svn commit, see body.
[shibboleth/cpp-xmltooling.git] / xmltooling / ElementProxy.h
index 874139b..a10d873 100644 (file)
  */\r
 \r
 /**\r
- * @file ElementProxy.h\r
+ * @file xmltooling/ElementProxy.h\r
  * \r
  * An XMLObject with an open content model \r
  */\r
 \r
-#if !defined(__xmltooling_eleproxy_h__)\r
+#ifndef __xmltooling_eleproxy_h__\r
 #define __xmltooling_eleproxy_h__\r
 \r
 #include <xmltooling/XMLObject.h>\r
@@ -31,7 +31,7 @@ using namespace xercesc;
 namespace xmltooling {\r
 \r
     /**\r
-     * An XMLObject with an open content model.\r
+     * An XMLObject that exposes its children via mutable list.\r
      */\r
     class XMLTOOL_API ElementProxy : public virtual XMLObject\r
     {\r
@@ -40,26 +40,18 @@ namespace xmltooling {
         virtual ~ElementProxy() {}\r
         \r
         /**\r
-         * Gets the text content of the object\r
-         * \r
-         * @return the text content, or NULL\r
-         */\r
-        virtual const XMLCh* getTextContent() const=0;\r
-        \r
-        /**\r
-         * Sets (or clears) the text content of the object \r
+         * Gets a mutable list of child objects\r
          * \r
-         * @param value         value to set, or NULL to clear\r
+         * @return  mutable list of child objects\r
          */\r
-        virtual void setTextContent(const XMLCh* value)=0;\r
-        \r
+        virtual ListOf(XMLObject) getXMLObjects()=0;\r
 \r
         /**\r
-         * Gets a mutable list of child objects\r
+         * Gets an immutable list of child objects\r
          * \r
-         * @return  mutable list of child objects\r
+         * @return  immutable list of child objects\r
          */\r
-        virtual ListOf(XMLObject) getXMLObjects()=0;\r
+        virtual const std::list<XMLObject*>& getXMLObjects() const=0;\r
     };\r
     \r
 };\r