xdmprotocols/XcapProtocol/inc/XcapDocumentNode.h
branchRCL_3
changeset 35 fbd2e7cec7ef
parent 0 c8caa15ef882
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xdmprotocols/XcapProtocol/inc/XcapDocumentNode.h	Wed Sep 01 12:23:14 2010 +0100
@@ -0,0 +1,219 @@
+/*
+* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: CXcapDocumentNode
+*
+*/
+
+
+
+
+#ifndef __XCAPDOCUMENTNODE__
+#define __XCAPDOCUMENTNODE__
+
+#include "XdmNodeFactory.h"
+#include "XdmDocumentNode.h"
+
+class CXdmEngine;
+class CXcapProtocol;
+class CXcapProtocol;
+class CXdmNodeAttribute;
+
+//CLASS DECLARATION
+NONSHARABLE_CLASS( CXcapDocumentNode ) : public CXdmDocumentNode, public MXdmNodeFactory
+    {
+    public:  // Constructors and destructor
+        
+        /**
+        * Destructor.
+        */
+        virtual ~CXcapDocumentNode();
+
+    public: // New functions
+        
+        /**
+        * Two-phased constructor.
+        *
+        * @param TDesC8& Name of the new element 
+		* @return CXdmDocumentNode* 
+        */
+        static CXcapDocumentNode* NewL( CXdmEngine& aXdmEngine,
+                                        CXcapProtocol& aXcapProtocol );
+        
+        /**
+        * Two-phased constructor.
+        *
+        * @param TDesC8& Name of the new element 
+		* @return CXdmDocumentNode* 
+        */
+        static CXcapDocumentNode* NewL( CXdmEngine& aXdmEngine,
+                                        const TDesC& aNodeName,
+                                        CXcapProtocol& aXcapProtocol );
+        
+        /**
+        * Two-phased constructor.
+        *
+        * @param TDesC8& Name of the new element 
+		* @return CXdmDocumentNode* 
+        */
+        static CXcapDocumentNode* NewL( CXdmEngine& aXdmEngine,
+                                        CXcapProtocol& aXcapProtocol,
+                                        const CXdmDocumentNode& aAnotherNode,
+                                        const CXdmDocumentNode& aParentNode );
+        
+        /**
+        * Two-phased constructor.
+		*
+        * @param TDesC8& Name of the new element
+        * @param CXdmDocumentNode* The parent of the new node
+		* @return CXdmDocumentNode* 
+        */
+        static CXcapDocumentNode* NewL( CXdmEngine& aXdmEngine,
+                                        const TDesC& aNodeName,
+                                        CXcapProtocol& aXcapProtocol,
+                                        CXdmDocumentNode* aParentNode );
+
+        /**
+        * Two-phased constructor.
+		*
+        * @param TBool Leaf node indicator
+        * @param TDesC8& Name of the new element
+        * @param CXdmDocumentNode* The parent of the new node
+		* @return CXdmDocumentNode* 
+        */
+        static CXcapDocumentNode* NewL( CXdmEngine& aXdmEngine, TBool aLeafNode,
+                                        const TDesC& aNodeName, CXcapProtocol& aXcapProtocol,
+                                        CXdmDocumentNode* aParentNode );
+                                       
+        /**
+        * Two-phased constructor.
+		*
+        * @param TBool Leaf node indicator
+        * @param TDesC8& Name of the new element
+        * @param CXdmDocumentNode* The parent of the new node
+		* @return CXdmDocumentNode* 
+        */
+        static CXcapDocumentNode* NewL( CXdmEngine& aXdmEngine,
+                                        const TBool aLeafNode,
+                                        CXcapProtocol& aXcapProtocol,
+                                        CXdmDocumentNode* aParentNode );
+        
+        /**
+        * Set the next node in the list
+        * @param The next node in the list
+		* @return void 
+        */
+        void RemoveNode( CXcapDocumentNode* aChileNode );
+                                               
+    private:
+
+         /**
+        * C++ constructor, private version.
+        */
+        CXcapDocumentNode( CXdmEngine& aXdmEngine,
+                           CXcapProtocol& aXcapProtocol );
+
+        /**
+        * C++ constructor, protected version.
+        *
+        * @param CXdmDocumentNode* The parent node of this element
+        */
+		CXcapDocumentNode( CXdmEngine& aXdmEngine,
+		                   CXcapProtocol& aXcapProtocol,
+		                   CXdmDocumentNode* aParentNode );
+		      
+        /**
+        * C++ constructor, another private version.
+        */
+		CXcapDocumentNode( const TBool aLeafNode,
+		                   CXdmEngine& aXdmEngine,
+		                   CXcapProtocol& aXcapProtocol,
+                           CXdmDocumentNode* aParentNode );
+		
+		/**
+        * By default Symbian OS constructor is private.
+        *
+        * @param TDesC8& Name of this node
+        * @return void
+        */
+		void CopyConstructL( const CXdmDocumentNode& aAnotherNode,
+		                     const CXdmDocumentNode& aParentNode );
+         
+    private:  //From MXdmNodeFactory
+                     
+        /**
+        * Create a new child element
+        *
+        * @param TDesC8& Name of the new element
+		* @return CXdmDocumentNode* 
+        */
+        CXdmDocumentNode* ChileNodeL();
+        
+        /**
+        * Create a new child element
+        *
+        * @param TDesC8& Name of the new element
+		* @return CXdmDocumentNode* 
+        */
+        CXdmDocumentNode* ChileNodeL( const TDesC& aChildName );
+        
+        /**
+        * Create a new child element
+        *
+        * @param TDesC8& Name of the new element
+		* @return CXdmDocumentNode* 
+        */
+        CXdmDocumentNode* ChileNodeL( const CXdmDocumentNode* aAnotherNode  );
+        
+        /**
+        * Create a new attribute
+        *
+        * @param TDesC8& Name of the new attribute
+		* @return CXdmNodeAttribute* 
+        */
+        CXdmNodeAttribute* AttributeL();
+        
+        /**
+        * Create a new attribute
+        *
+        * @param TDesC8& Name of the new attribute
+		* @return CXdmNodeAttribute* 
+        */
+        CXdmNodeAttribute* AttributeL( const TDesC& aAttributeName );
+        
+    private:  //From MXdmNodeInterface                          
+
+        /**
+        * Two-phased constructor.
+		*
+        * @param TDesC& Namespace prefix string
+		* @return void 
+        */
+        void SetPrefixL( const TDesC8& aNamespace );
+        
+        /**
+        * Returns the namespace string for this element
+		*
+		* @return TPtrC Namespace string of this element 
+        */
+        TPtrC8 Prefix() const;
+    
+    private:
+        
+        HBufC8*                                     iPrefix;
+        CXcapProtocol&                              iXcapProtocol;
+    };
+
+#endif      //__XCAPDOCUMENTNODE__
+            
+// End of File