/*

* Copyright (c) 2006 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:    SIMPLE Engine XML utils factory

*

*/

#ifndef simplexmlfactory_H

#define simplexmlfactory_H

#include <e32std.h>

#include <e32base.h>

// FORWARD DECLARATION

class MSimpleDocument;

class MSimpleWinfo;

class MSimpleElement;

class MSimpleNamespace;

class MSimpleFilterDocument;

class MSimplePresenceList;

class MSimpleContent;

/**

 * SIMPLE Engine XML utils factory

 *

 * @lib simplexmlutils 

 * @since S60 3.2

 */ 

class TSimpleXmlFactory

    {

public:

    /**

     * Create new simple Element entity.

     * @since S60 3.2

     * @return MSimpleElement, ownership is transferred.

     */

    IMPORT_C static MSimpleElement* NewElementL(

        const TDesC8& aNsUri,

        const TDesC8& aLocalName );

    /**

     * Create new simple NameSpace entity.

     * @since S60 3.2

     * @param aPrefix prefix to be used

     * @param aUri URI

     * @return MSimpleNameSpace, ownership is transferred.

     */

    IMPORT_C static MSimpleNamespace* NewNamespaceL(

        const TDesC8& aPrefix,

        const TDesC8& aUri );

    /**

     * Create new simple Document entity from scratch.

     * @since S60 3.2

     * @return MSimpleDocument, ownership is transferred.

     */

    IMPORT_C static MSimpleDocument* NewDocumentL( );

    /**

     * Create new simple Document entity from xml-document.

     * @since S60 3.2

     * @param aXml a valid XML document in PIDF format.

     * @return MSimpleDocument, ownership is transferred.

     */

    IMPORT_C static MSimpleDocument* NewDocumentL( const TDesC8& aXml );

    /**

     * Create new simple Document entity from MIME multipart

     * @since S60 3.2

     * @param aData MIME multipart data

     * @param aBoundary MIME multipart boundary

     * @param aStart MIME multipart start content-id

     * @return MSimpleDocument, ownership is transferred.

     */

    IMPORT_C static MSimpleDocument* NewDocumentInMultiPartL(

        const TDesC8& aData, const TDesC8& aBoundary, const TDesC8& aStart );        

    /**

     * Create new simple FilterDocument entity.

     * @since S60 3.2

     * @return MSimpleFilterDocument, ownership is transferred.

     */

    IMPORT_C static MSimpleFilterDocument* NewFilterDocumentL();

    /**

     * Create new simple FilterDocument entity.

     * @since S60 3.2

     * @param aXml a valid XML document in PIDF format.     

     * @return MSimpleFilterDocument, ownership is transferred.

     */

    IMPORT_C static MSimpleFilterDocument* NewFilterDocumentL( const TDesC8& aXml );    

    /**

     * Create new presence list (resource list)

     * @since S60 3.2

     * @param aData MIME multipart data

     * @param aBoundary MIME multipart boundary

     * @param aStart MIME multipart start content-id

     * @return MSimplePresenceList, ownership is transferred.

     */

    IMPORT_C static MSimplePresenceList* NewPresenceListL(

        const TDesC8& aData, const TDesC8& aBoundary, const TDesC8& aStart );

    /**

     * Create new winfo document

     * @since S60 3.2

     * @return MSimpleWinfo, ownership is transferred.

     */

    IMPORT_C static MSimpleWinfo* NewWinfoL();

    /**

     * Create new winfo document

     * @since S60 3.2

     * @param aXml XML document

     * @return MSimpleWinfo, ownership is transferred.

     */

    IMPORT_C static MSimpleWinfo* NewWinfoL( const TDesC8& aXml );

    IMPORT_C static MSimpleContent* NewContentL( 

        const TDesC8& aContentID, const TDesC8& aContentType );    

    };

#endif      // simplexmlfactory_H

// End of File