/*
* 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:    Factory class for SIMPLE Engine
*
*/




#ifndef simplefactory_H
#define simplefactory_H

#include <e32std.h>
#include <e32base.h>


// FORWARD DECLARATION
class MSimpleConnection;
class MSimplePublisher;
class MSimpleWatcher;
class MSimpleWinfoWatcher;
class MSimpleDocument;
class MSimpleElement;
class MSimpleNamespace;
class MSimpleFilterDocument;

class MSimpleConnectionObserver;
class MSimplePublishObserver;
class MSimpleWatcherObserver;
class MSimpleWinfoObserver;
class MSimpleContent;
class MSimpleInstantMsgObserver;
class MSimpleInstantMessage;

/**
 * Factory class for SIMPLE Engine
 *
 * @lib simpleengine
 * @since S60 3.2
 */
class TSimpleFactory
    {

public:

    /**
     * Create new simple Element entity.
     * @since S60 3.2
     * @param aNsUri the namespace URI for this element.
     * @param aLocalName the local name for this element.
     * @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 engine Connection entity.
     * @since S60 3.2
     * @param aObserver client callback observer
     * @return MSimpleConnection, ownership is transferred.
     */
    IMPORT_C static MSimpleConnection* NewConnectionL(
        MSimpleConnectionObserver& aObserver );

    /**
     * Create new Publisher entity.
     * @since S60 3.2
     * @paraam aConn simple engine connection
     * @param aObserver client callback observer
     * @return MSimplePublisher, ownership is transferred.
     */
    IMPORT_C static MSimplePublisher* NewPublisherL(
        MSimpleConnection& aConn,
        MSimplePublishObserver& aObserver );

    /**
     * Create new InstantMessage entity.
     * @since S60 5.0
     * @param aConn simple engine connection
     * @param aObserver client callback observer
     * @return MSimpleInstantMessage, ownership is transferred.
     */
    IMPORT_C static MSimpleInstantMessage* NewInstantMessageL(
        MSimpleConnection& aConn,
        MSimpleInstantMsgObserver& aObserver );

    /**
     * Create new Watcher entity.
     * @since S60 3.2
     * @paraam aConn simple engine connection
     * @param aObserver client callback observer
     * @return MSimpleWatcher, ownership is transferred.
     */
    IMPORT_C static MSimpleWatcher* NewWatcherL(
        MSimpleConnection& aConn,
        MSimpleWatcherObserver& aObserver );

    /**
     * Create new WinfoWatcher entity.
     * @since S60 3.2
     * @paraam aConn simple engine connection
     * @param aObserver client callback observer
     * @return MSimpleWinfoWatcher, ownership is transferred.
     */
    IMPORT_C static MSimpleWinfoWatcher* NewWinfoWatcherL(
        MSimpleConnection& aConn,
        MSimpleWinfoObserver& aObserver );

    /**
     * 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 containing in PIDF format.
     * @return MSimpleDocument, ownership is transferred.
     */
    IMPORT_C static MSimpleDocument* NewDocumentL( const TDesC8& aXml );

    /**
     * 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 containing in PIDF format.
     * @return MSimpleFilterDocument, ownership is transferred.
     */
    IMPORT_C static MSimpleFilterDocument* NewFilterDocumentL( const TDesC8& aXml );
    
    IMPORT_C static MSimpleContent* NewContentL( 
        const TDesC8& aContentID, const TDesC8& aContentType );    

    /**
     * Create new simple engine Connection entity.
     * @since S60 3.2
     * @param aObserver client callback observer
     * @param aServiceId serviceId of current service
     * @return MSimpleConnection, ownership is transferred.
     */
    IMPORT_C static MSimpleConnection* NewConnectionL(
        MSimpleConnectionObserver& aObserver, TInt32 aServiceId );
    };

#endif

// End of File