/*
* Copyright (c) 2008 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:  CCFPublishContextCmd class declaration.
*
*/


#ifndef C_CFPUBLISHCONTEXTCMD_H
#define C_CFPUBLISHCONTEXTCMD_H


// SYSTEM INCLUDE FILES
#include <e32base.h>

// USER INCLUDE FILES
#include "cfcmd.h"

// FORWARD DECLARATIONS
class CCFContextManager;
class CCFContextObject;
class CCFContextDataObject;
class CCFContextDataProxy;

// DATA TYPES

// CLASS DECLARATION

/**
 * Publish context command.
 *
 * @lib CFServer
 * @since S60 5.0
 */
NONSHARABLE_CLASS( CCFPublishContextCmd ) : public CCFCmd
    {
public:

    /**
     * Symbian two phased constructors.
     *
     * @since S60 5.0
     * @param aContextManager is the manager handling context subscriptions.
     * @param aContext is the context to be published.
     * @return CCFPublishContextCmd
     */
    static CCFPublishContextCmd* NewL( CCFContextManager& aContextManager,
            const CCFContextObject& aContext );
    static CCFPublishContextCmd* NewLC( CCFContextManager& aContextManager,
            const CCFContextObject& aContext );

    /**
     * Symbian two phased constructors.
     *
     * @since S60 5.0
     * @param aContextManager is the manager handling context subscriptions.
     * @param aContext is the context to be published.
     * @param aData is the context data to be published.
     * @return CCFPublishContextCmd
     */
    static CCFPublishContextCmd* NewL( CCFContextManager& aContextManager,
            const CCFContextObject& aContext,
            CCFContextDataObject& aData );
    static CCFPublishContextCmd* NewLC( CCFContextManager& aContextManager,
            const CCFContextObject& aContext,
            CCFContextDataObject& aData );

    /**
     * C++ destructor.
     */
    virtual ~CCFPublishContextCmd();

public: // From CCFCmd

    /**
     * Executes the publish context command.
     *
     * @since S60 5.0
     * @param None.
     * @return None.
     */
    virtual void ExecuteL();

    /**
     * Logs the error using error trace macros.
     *
     * @since S60 5.0
     * @param aError is the leave code from a call to ExecuteL.
     * @return None.
     */
    virtual void LogError( TInt aError );

private:

    CCFPublishContextCmd( CCFContextManager& aContextManager );
    void ConstructL( const CCFContextObject& aContext );
    void ConstructL( const CCFContextObject& aContext,
            CCFContextDataObject& aData );

private: // Data

    // Context manager handling context publications.
    CCFContextManager& iContextManager;

    // Context published by this command; owned.
    CCFContextObject* iContextObject;

    // Context data; owned, optional: NULL = no data.
    CCFContextDataProxy* iData;
    };

#endif // C_CFPUBLISHCONTEXTCMD_H