xmp_toolkit_ruby 0.0.2

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCore/Interfaces/ICoreObjectFactory.h

@@ -0,0 +1,279 @@
+#ifndef ICoreObjectFactory_h__
+#define ICoreObjectFactory_h__ 1
+
+// =================================================================================================
+// Copyright 2014 Adobe
+// All Rights Reserved.
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+
+#include "XMPCore/XMPCoreFwdDeclarations.h"
+#include "XMPCommon/Interfaces/IObjectFactory.h"
+
+namespace AdobeXMPCore {
+
+	//!
+	//! @brief Version1 of a interface that represents a factory to create various artifacts of XMP DOM like array,
+	//! structure, path etc.
+	//!
+	//! @details Provides all the functions to create instances of various artifacts of XMP DOM and return them as shared pointers
+	//! to the clients. This is the interface through which clients of the library actually get access to all other interfaces.
+	//!
+
+	class XMP_PUBLIC ICoreObjectFactory_v1
+		: public virtual IObjectFactory_v1
+	{
+	public:
+
+		//!
+		//! @brief Creates an empty name space prefix map.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to an empty \#INameSpacePrefixMap_v1 object.
+		//!
+		virtual pINameSpacePrefixMap_base APICALL CreateNameSpacePrefixMap( pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Provides the default mapping of prefix string and nameSpace strings used by XMPCore.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to const \#INameSpacePrefixMap_v1 object containing all the mappings used as default by the XMPCore.
+		//!
+		virtual pcINameSpacePrefixMap_base APICALL GetDefaultNameSpacePrefixMap( pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates a normal property path segment.These are essentially all properties (simple, struct and arrays).
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the property.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the property.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to const \#IPathSegment_v1.
+		//!
+		virtual pcIPathSegment_base APICALL CreatePropertyPathSegment( const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates an array index path segment that denotes a specific element of an array.
+		//! @details Such segments do not have an own name and inherits the namespace from the Array property itself.
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the property.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] index An object of type \#AdobeXMP::sizet containting the index of the array element.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to const \#IPathSegment_v1.
+		//! \attention Throws \#AdobeXMP::pcIError in case
+		//!		- pointers to const char buffers are NULL,
+		//!		- their content is empty.
+		//!
+		virtual pcIPathSegment_base APICALL CreateArrayIndexPathSegment( const char * nameSpace, sizet nameSpaceLength, sizet index, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates a Qualifier path segment, which behaves like a normal property
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the property.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the property.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to const \#IPathSegment_v1.
+		//!
+		virtual pcIPathSegment_base APICALL CreateQualifierPathSegment( const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates a path segment that selects a specific qualifier by its value.
+		//! For example a specific language in a alternative array of languages.
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the property.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the property.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] value Pointer to a constant char buffer containing value of the language (xml:lang)
+		//! \param[in] valueLength Number of characters in value. In case value is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to const \#IPathSegment_v1.
+		//!
+		virtual pcIPathSegment_base APICALL CreateQualifierSelectorPathSegment( const char * nameSpace, sizet nameSpaceLength, const char * name,
+			sizet nameLength, const char * value, sizet valueLength, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates an empty IPath object.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to an empty \#IPath_v1 object
+		//!
+		virtual pIPath_base APICALL CreatePath( pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates a path from a char buffer which contains the serialized path.
+		//! \param[in] path Pointer to a const char buffer containing serialized form of the path.
+		//! \param[in] pathLength Number of characters in the path. In case path in null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] map A pointer to a const \#IXMPNameSpacePrefixMap_v1 object which will contain the mapping for nameSpaces to prefixes.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to a \#IPath_v1 object.
+		//!
+		virtual pIPath_base APICALL ParsePath( const char * path, sizet pathLength, pcINameSpacePrefixMap_base map, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates a simple property node which is not part of any metadata document.
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the simple node.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the simple node.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] value Pointer to a constant char buffer containing value of the simple node.
+		//! \param[in] valueLength Number of characters in value. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to a \#ISimpleNode_v1 object.
+		//!
+		virtual pISimpleNode_base APICALL CreateSimpleNode( const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength,
+			const char * value, sizet valueLength, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates an array node which is not part of any metadata document.
+		//! \param[in] arrayForm A value indicating the array type
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the array node.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the array node.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to a \#IArrayNode_v1 object.
+		//!
+		virtual pIArrayNode_base APICALL CreateArrayNode( uint32 arrayForm, const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates a structure node which is not part of any metadata document.
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the structure node.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the structure node.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to a \#IStructureNode_v1 object.
+		virtual pIStructureNode_base APICALL CreateStructureNode( const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength, pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Creates an empty IMetadata object.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return a pointer to an empty \#IMetadata_v1 object.
+		//!
+		virtual pIMetadata_base APICALL CreateMetadata( pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Provides the reference to the database of Serializers and Parsers available with the library.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return a pointer to \#IDOMImplementationRegistry_base object containing all the entries for serailizers and parsers.
+		//!
+		virtual pIDOMImplementationRegistry_base APICALL GetDOMImplementationRegistry( pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+		//! @brief Provides access to the configuration manager of the library.
+		//! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+		//! \return A pointer to \#ICoreConfigurationManager_base object.
+		//!
+		virtual pICoreConfigurationManager_base APICALL GetCoreConfigurationManager( pcIError_base & error ) __NOTHROW__ = 0;
+
+		//!
+        //! @brief Converts old xmp object to new xmp object.
+        //! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+        //! \return A pointer to \#IMetadata_base object.
+        //!
+        virtual pIMetadata_base APICALL ConvertXMPMetatoIMetadata( XMPMetaRef xmpref, pcIError_base & error ) __NOTHROW__ = 0;
+        
+        //!
+        //! @brief Converts new xmp object to old xmp object.
+        //! \param[out] error A reference to a pointer to const IError object which will be filled with the error object in case of any error.
+        //! \return XMPMetaRef.
+        //!
+        virtual XMPMetaRef APICALL ConvertIMetadatatoXMPMeta( pIMetadata iMeta, pcIError_base & error ) __NOTHROW__ = 0;
+        
+
+		//!
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		
+		//!
+		//! @{
+		//! @brief Returns the actual raw pointer from the shared pointer, which can be a shared pointer of a proxy class.
+		//! \return Either a const or non const pointer to ICoreObjectFactory interface.
+		//!
+		virtual pICoreObjectFactory APICALL GetActualICoreObjectFactory() __NOTHROW__ = 0;
+		XMP_PRIVATE pcICoreObjectFactory GetActualICoreObjectFactory() const __NOTHROW__ {
+			return const_cast< ICoreObjectFactory_v1 * >( this )->GetActualICoreObjectFactory();
+		}
+		//!
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Returns the pointer to internal interfaces.
+		//! \return Either a const or non const pointer to ICoreObjectFactory_I interface.
+		//!
+		virtual AdobeXMPCore_Int::pICoreObjectFactory_I APICALL GetICoreObjectFactory_I() __NOTHROW__ = 0;
+
+		XMP_PRIVATE AdobeXMPCore_Int::pcICoreObjectFactory_I GetICoreObjectFactory_I() const __NOTHROW__ {
+			return const_cast< ICoreObjectFactory_v1 * >( this )->GetICoreObjectFactory_I();
+		}
+		//!
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Converts raw pointer to base version to pointer to client interested version.
+		//! @details The raw pointer is of version 1 interface where as the returned pointer depends on the version client is interested in.
+		//! \return Pointer to const or non constant interface.
+		//!
+		XMP_PRIVATE static pICoreObjectFactory MakeCoreObjectFactory( pICoreObjectFactory_base ptr );
+		XMP_PRIVATE static pcICoreObjectFactory MakeCoreObjectFactory( pcICoreObjectFactory_base ptr ) {
+			return MakeCoreObjectFactory( const_cast< pICoreObjectFactory_base >( ptr ) );
+		}
+		//!
+		//! @}
+
+		//!
+		//! @brief Returns the unique ID assigned to the interface.
+		//! \return 64 bit unsigned integer representing the unique ID assigned to the interface.
+		//!
+		XMP_PRIVATE static uint64 GetInterfaceID() { return kICoreObjectFactoryID; }
+
+		//!
+		//! @brief returns the version of the interface.
+		//! \return 32 bit unsigned integer representing the version of the interface.
+		//!
+		XMP_PRIVATE static uint32 GetInterfaceVersion() { return 1; }
+		//! \endcond
+
+		//!
+		//! @brief Gets an object of ICoreObjectFactory.
+		//! \return A pointer to an ICoreObjectFactory object.
+		//!
+		XMP_PRIVATE static pICoreObjectFactory GetCoreObjectFactory();
+
+		//!
+		//! @{
+		//! @brief Sets up the core object factory.
+		//! \param[in] coreObjectFactory A pointer to an \#ICoreObjectFactory_v1 object.
+		//! \note coreObjectFactory is an optional parameter and only required for clients who don't directly link with the library
+		//!       but want to use its functionality.
+		//!
+	#if LINKING_XMPCORE_LIB
+		XMP_PRIVATE static void SetupCoreObjectFactory();
+	#else
+		XMP_PRIVATE static void SetupCoreObjectFactory( pICoreObjectFactory_base coreObjectFactory );
+	#endif
+		//! @}
+
+		//!
+		//! @brief Destroy everything related to core object factory.
+		//!
+		XMP_PRIVATE static void DestroyCoreObjectFactory();
+
+	protected:
+		//!
+		//! Destructor
+		//! 
+		virtual ~ICoreObjectFactory_v1() __NOTHROW__ {}
+
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+
+		#ifdef FRIEND_CLASS_DECLARATION
+			FRIEND_CLASS_DECLARATION();
+		#endif
+		REQ_FRIEND_CLASS_DECLARATION();
+		//! \endcond
+
+	};
+}
+#endif // ICoreObjectFactory_h__

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCore/Interfaces/IDOMImplementationRegistry.h

@@ -0,0 +1,150 @@
+#ifndef IDOMImplementationRegistry_h__
+#define IDOMImplementationRegistry_h__ 1
+
+// =================================================================================================
+// Copyright Adobe
+// Copyright 2014 Adobe
+// All Rights Reserved
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+
+#include "XMPCore/XMPCoreFwdDeclarations.h"
+#include "XMPCommon/Interfaces/BaseInterfaces/ISharedObject.h"
+#include "XMPCommon/Interfaces/BaseInterfaces/IVersionable.h"
+
+namespace AdobeXMPCore {
+
+	//!
+	//! \brief Version1 of the interface that serves as a database/registry of all the parsers and
+	//!  serializers available with the XMPCore library.
+	//! \details Provides all the functions to
+	//!		-# get registered serializers and parsers from the database.
+	//!		-# add client defined serializers and parsers to the database.
+	//! \attention Support multi threading if library is configured to support multi-threading by default.
+	//! \note By default following keys are registered by default with the database by the library:
+	//!		-# rdf
+	//!
+	class XMP_PUBLIC IDOMImplementationRegistry_v1
+		: public virtual ISharedObject
+		, public virtual IVersionable
+	{
+	public:
+
+		//!
+		//! @brief Gets a parser corresponding to the key and returns to the client for usage.
+		//! \param[in] key Pointer to a const NULL terminated char buffer containing key of the parser in the database.
+		//! \return A shared pointer to a \#IDOMParser object.
+		//! \note In case the key is not present in the database an invalid shared pointer will be returned.
+		//! \note key is case sensitive.
+		//!
+		virtual spIDOMParser APICALL GetParser( const char * key ) const = 0;
+
+		//!
+		//! @brief Gets a serializer corresponding to the key and returns to the client for usage.
+		//! \param[in] key Pointer to a const NULL terminated char buffer containing key of the serializer in the database.
+		//! \return A shared pointer to a \#IDOMSerializer object.
+		//! \note In case the key is not present in the database an invalid shared pointer will be returned.
+		//! \note key is case sensitive.
+		//!
+		virtual spIDOMSerializer APICALL GetSerializer( const char * key ) const = 0;
+
+		//!
+		//! @brief Registers a parser with the database along with the key.
+		//! \param[in] key Pointer to a const NULL terminated char buffer containing key of the parser to be used while registering.
+		//! \param[in] parser A pointer to \#IClientDOMParser object to be registered with the database
+		//! \return True in case parser is successfully registered, false otherwise like in case key is already registered.
+		//!
+		virtual bool APICALL RegisterParser( const char * key, pIClientDOMParser_base parser ) = 0;
+
+		//!
+		//! @brief Registers a serializer with the database along with the key.
+		//! \param[in] key Pointer to a const NULL terminated char buffer containing key of the serializer to be used while registering.
+		//! \param[in] serializer A pointer to \#IClientDOMSerializer object to be registered with the database.
+		//! \return True in case serializer is successfully registered, false otherwise like in case key is already registered.
+		//!
+		virtual bool APICALL RegisterSerializer( const char * key, pIClientDOMSerializer_base serializer ) = 0;
+
+		//!
+		//! @brief Provides the reference to the database of Serializers and Parsers available with the library.
+		//! \return A shared pointer to \#IDOMImplementationRegistry object containing all the entries for serailizers and parsers.
+		//!
+		XMP_PRIVATE static spIDOMImplementationRegistry GetDOMImplementationRegistry();
+
+		//!
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		
+		//!
+		//! @{
+		//! @brief Returns the actual raw pointer from the shared pointer, which can be a shared pointer of a proxy class.
+		//! \return Either a const or non const pointer to IDOMImplementationRegistry interface.
+		//!
+		virtual pIDOMImplementationRegistry APICALL GetActualIDOMImplementationRegistry() __NOTHROW__ = 0;
+		XMP_PRIVATE pcIDOMImplementationRegistry GetActualIDOMImplementationRegistry() const __NOTHROW__ {
+			return const_cast< IDOMImplementationRegistry_v1 * >( this )->GetActualIDOMImplementationRegistry();
+		}
+		//!
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Returns the pointer to internal interfaces.
+		//! \return Either a const or non const pointer to IDOMImplementationRegistry_I interface.
+		//!
+		virtual AdobeXMPCore_Int::pIDOMImplementationRegistry_I APICALL GetIDOMImplementationRegistry_I() __NOTHROW__ = 0;
+
+		XMP_PRIVATE AdobeXMPCore_Int::pcIDOMImplementationRegistry_I GetIDOMImplementationRegistry_I() const __NOTHROW__ {
+			return const_cast< IDOMImplementationRegistry_v1 * >( this )->GetIDOMImplementationRegistry_I();
+		}
+		//!
+		//! @}
+		
+		//!
+		//! @{
+		//! @brief Converts raw pointer to shared pointer. The raw pointer is of version 1 interface
+		//!        where as the returned shared pointer depends on the version client is interested in.
+		//! \return Shared pointer to const or non constant interface.
+		//!
+		XMP_PRIVATE static spIDOMImplementationRegistry MakeShared( pIDOMImplementationRegistry_base ptr );
+		XMP_PRIVATE static spcIDOMImplementationRegistry MakeShared( pcIDOMImplementationRegistry_base ptr ) {
+			return MakeShared( const_cast< pIDOMImplementationRegistry_base >( ptr ) );
+		}
+		//!
+		//! @}
+
+		//!
+		//! @brief Returns the unique ID assigned to the interface.
+		//! \return 64 bit unsigned integer representing the unique ID assigned to the interface.
+		//!
+		XMP_PRIVATE static uint64 GetInterfaceID() { return kIDOMImplementationRegistryID; }
+
+		//!
+		//! @brief Returns the version of the interface.
+		//! \return 32 bit unsigned integer representing the version of the interface.
+		//!
+		XMP_PRIVATE static uint32 GetInterfaceVersion() { return 1; }
+		//! \endcond
+
+	protected:
+		//!
+		//! Destructor
+		//! 
+		virtual ~IDOMImplementationRegistry_v1() __NOTHROW__ {}
+
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		virtual pIDOMParser_base APICALL getParser( const char * key, pcIError_base & error ) const __NOTHROW__ = 0;
+		virtual pIDOMSerializer_base APICALL getSerializer( const char * key, pcIError_base & error ) const __NOTHROW__ = 0;
+		virtual uint32 APICALL registerParser( const char * key, pIClientDOMParser_base parser, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual uint32 APICALL registerSerializer( const char * key, pIClientDOMSerializer_base serializer, pcIError_base & error ) __NOTHROW__= 0;
+
+		#ifdef FRIEND_CLASS_DECLARATION
+			FRIEND_CLASS_DECLARATION();
+		#endif
+		REQ_FRIEND_CLASS_DECLARATION();
+		//! \endcond
+
+	};
+}
+
+#endif // IDOMImplementationRegistry_h__

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCore/Interfaces/IDOMParser.h

@@ -0,0 +1,181 @@
+#ifndef IDOMParser_h__
+#define IDOMParser_h__ 1
+
+// =================================================================================================
+// Copyright Adobe
+// Copyright 2014 Adobe
+// All Rights Reserved
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+
+#include "XMPCore/XMPCoreFwdDeclarations.h"
+#include "XMPCommon/Interfaces/BaseInterfaces/ISharedObject.h"
+#include "XMPCommon/Interfaces/BaseInterfaces/IVersionable.h"
+#include "XMPCommon/Interfaces/BaseInterfaces/IConfigurable.h"
+
+namespace AdobeXMPCore {
+
+	//!
+	//! @brief Version 1 of the interface that supports parsing of the XMP Data Model.
+	//! @details Provides all functions to parse the buffer as well as to configure the parser.
+	//!
+	class XMP_PUBLIC IDOMParser_v1
+		: public virtual IConfigurable
+		, public virtual ISharedObject
+		, public virtual IVersionable
+	{
+	public:
+
+		//!
+		//! @brief Indicates various types of operations possible while parsing with some node as the context.
+		//!
+		typedef enum {
+			//! @brief Append all the nodes parsed from the buffer as the child of the context node.
+			//! \attention Error is thrown in case
+			//!		- Context Node is invalid.
+			//!		- Context Node is not array or structure node.
+			//!		- Context Node is a structure node but a child node with the same qualified name is already present.
+			//!		- Context Node is an array node but the type of any parsed node is not same as that of other existing nodes in the array.
+			//!
+			kATAppendAsChildren				= 0,
+
+			//! @brief Replaces the children of the context node with nodes parsed from the buffer.
+			//! \attention Error is thrown in case
+			//!		- Context Node is invalid.
+			//!		- Context Node is not array or structure node.
+			//!		- Context Node is a structure node but a child node with the same qualified name is not already present.
+			//!		- Context Node is an array node but the type of all parsed nodes are not same.
+			//!
+			kATReplaceChildren				= 1,
+
+			//! @brief Either append all the nodes parsed from the buffer as the child/children of the context node.
+			//! \attention Error is thrown in case
+			//!		- Context Node is invalid.
+			//!		- Context Node is not array or structure node.
+			//!		- Context Node is an array node but the type of all parsed nodes are not same.
+			//!     - If a structure node is the parsed node, it is appended if it already not present, otherwise it is replaced.
+			//!     - If an array node is the parsed node, it is appended if it already not present, otherwise it is removed.
+			kATAppendOrReplaceChildren		= 2,
+
+			//! @brief Treats all the parsed nodes as the siblings of the context node and place them before the context node, if possible.
+			//! \attention Error is thrown in case
+			//!		- Context Node is invalid.
+			//!		- parent of the Context Node is not an array node.
+			//!		- The type of any parsed nodes is not same as that of other existing nodes in the array.
+			kATInsertBefore					= 3,
+
+			//! @brief Treats all the parsed nodes as the siblings of the context node and place them after the context node, if possible.
+			//! \attention Error is thrown in case
+			//!		- Context Node is invalid.
+			//!		- parent of the Context Node is not an array node.
+			//!		- The type of any parsed nodes is not same as that of other existing nodes in the array.
+			kATInsertAfter					= 4,
+
+			//! @brief Replaces the context node and insert the node parsed from the buffer in its place.
+			//! \attention Error is thrown in case
+			//!		- type of node returned after parsing in not of type which is compatible with the Context Node.
+			kATReplace						= 5,
+		} eActionType;
+
+		//!
+		//! @brief Parses the buffer contents and creates an XMP DOM node.
+		//! \param[in] buffer Pointer to a constant char buffer containing serialized XMP Data Model.
+		//! \param[in] bufferLength Number of characters in buffer. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \return A shared pointer to an object of \#IMetadata containing all the information parsed from the buffer.
+		//!
+		virtual spIMetadata APICALL Parse( const char * buffer, sizet bufferLength ) = 0;
+
+		//!
+		//! @brief Parse the buffer contents and populate the provided node .
+		//! \param[in] buffer Pointer to a constant char buffer containing serialized XMP Data Model.
+		//! \param[in] bufferLength Number of characters in buffer. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] actionType Value indicating how the parsed content and context node should be used.
+		//! \param[in,out] node The context node to be used base on the actionType.
+		//!
+		virtual void APICALL ParseWithSpecificAction( const char * buffer, sizet bufferLength, eActionType actionType, spINode & node ) = 0;
+
+		//!
+		//! @brief Virtual copy constructor.
+		//! @details Creates an exact replica of the object.
+		//! \return A shared pointer to an object of \#IDOMParser which is the exact replica of the current serializer.
+		//!
+		virtual spIDOMParser APICALL Clone() const = 0;
+
+		//!
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		
+		//!
+		//! @{
+		//! @brief Returns the actual raw pointer from the shared pointer, which can be a shared pointer of a proxy class.
+		//! \return Either a const or non const pointer to IDOMParser interface.
+		//!
+		virtual pIDOMParser APICALL GetActualIDOMParser() __NOTHROW__ = 0;
+		XMP_PRIVATE pcIDOMParser GetActualIDOMParser() const __NOTHROW__ {
+			return const_cast< IDOMParser_v1 * >( this )->GetActualIDOMParser();
+		}
+		//!
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Returns the pointer to internal interfaces.
+		//! \return Either a const or non const pointer to IDOMParser_I interface.
+		//!
+		virtual AdobeXMPCore_Int::pIDOMParser_I APICALL GetIDOMParser_I() __NOTHROW__ = 0;
+
+		XMP_PRIVATE AdobeXMPCore_Int::pcIDOMParser_I GetIDOMParser_I() const __NOTHROW__ {
+			return const_cast< IDOMParser_v1 * >( this )->GetIDOMParser_I();
+		}
+		//!
+		//! @}
+		
+		//!
+		//! @{
+		//! @brief Converts raw pointer to shared pointer. 
+		//!	@details The raw pointer is of version 1 interface where as the returned shared pointer depends on the version client is interested in.
+		//!          
+		//! \return Shared pointer to const or non constant interface.
+		//!
+		XMP_PRIVATE static spIDOMParser MakeShared( pIDOMParser_base ptr );
+		XMP_PRIVATE static spcIDOMParser MakeShared( pcIDOMParser_base ptr ) {
+			return MakeShared( const_cast< pIDOMParser_base >( ptr ) );
+		}
+		//!
+		//! @}
+
+		//!
+		//! return The unique ID assigned to the interface.
+		//! \return 64 bit unsigned integer representing the unique ID assigned to the interface.
+		//!
+		XMP_PRIVATE static uint64 GetInterfaceID() { return kIDOMParserID; }
+
+		//!
+		//! return The version of the interface.
+		//! \return 32 bit unsigned integer representing the version of the interface.
+		//!
+		XMP_PRIVATE static uint32 GetInterfaceVersion() { return 1; }
+		//! \endcond
+
+	protected:
+		//!
+		//! Destructor
+		//! 
+		virtual ~IDOMParser_v1() __NOTHROW__ {}
+
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		virtual pIMetadata_base APICALL parse( const char * buffer, sizet bufferLength, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual void APICALL parseWithSpecificAction( const char * buffer, sizet bufferLength, uint32 actionType, pINode_base node, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual pIDOMParser_base APICALL clone( pcIError_base & error ) const __NOTHROW__ = 0;
+
+		#ifdef FRIEND_CLASS_DECLARATION
+			FRIEND_CLASS_DECLARATION();
+		#endif
+		REQ_FRIEND_CLASS_DECLARATION();
+		//! \endcond
+
+	};
+}
+
+#endif // IDOMParser_h__