Allow more flexibility in overriding CElement::toXml

The toXml method has a default implementation that recursively calls toXml on
the children and set their "Name" attribute.

With this approach, the toplevel element's name isn't set unless its overrided
implementation explicitly does so.

A first approach for fixing that is to set the XmlElement's name and
recursively call toXml on children (without setting their name because it will
be done by their toXml method). However, the "CXmlElement" being created may or
may not be the object on which the toXml method is called, in which case the
name will be set on the wrong XmlElement.

Instead, in CElement::toXml, we set the XmlElement's name and call a new
virtual method, childrenToXml which only recursively call toXml on children.

This gives full flexibility to elements to choose how they want to serialize
themselves and how they want to serialize their children.

CConfigurableDomain::toXml is modified to take that change into account.

Change-Id: Id12a1023e91cb000e55c242c13643b1db7d46871
Signed-off-by: David Wagner <david.wagner@intel.com>

1 files changed, 14 insertions, 0 deletions

diff --git a/parameter/Element.h b/parameter/Element.h
index 8469ab6..4636dbd 100644
--- a/parameter/Element.h
+++ b/parameter/Element.h
@@ -94,6 +94,20 @@ public:
     // From IXmlSource
     virtual void toXml(CXmlElement& xmlElement, CXmlSerializingContext& serializingContext) const;
 
+    /**
+     * Serialize the children to XML
+     *
+     * This method is virtual, to be derived in case a special treatment is
+     * needed before doing so.
+     *
+     * @param[in,out] xmlElement the XML Element below which the children must
+     *                be serialized (which may or may not be the CElement
+     *                object upon which this method is called)
+     * @param[in,out] serializingContext information about the serialization
+     */
+    virtual void childrenToXml(CXmlElement& xmlElement,
+                               CXmlSerializingContext& serializingContext) const;
+
     // Content structure dump
     void dumpContent(std::string& strContent, CErrorContext& errorContext, const uint32_t uiDepth = 0) const;