/*

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

*

*/

#ifndef CFCONTEXTSERVICE_H

#define CFCONTEXTSERVICE_H

// SYSTEM INCLUDE FILES

#include <cfcontextobject.h>

#include <cfcontextquery.h>

#include <cfcontextsubscription.h>

// USER INCLUDE FILES

#include "cfservicebase.h"

// FORWARD DECLARATIONS

// DATA TYPES

// CLASS DECLARATION

class CCFContextSubscriptionListener;

class CCFServerMessageListener;

class CCFContextDataObject;

/**

 * Context service class.

 *

 * @lib cfclient.lib

 * @since S60 5.0

 */

NONSHARABLE_CLASS( CCFContextService ): public CCFServiceBase

    {

public:

    /**

     * Symbian two phased constructors.

     *

     * @since S60 5.0

     * @param None.

     * @return CCFContextService

     */

    static CCFContextService* NewL( RCFClientSession& aSession,

        MCFListener& aListener );

    static CCFContextService* NewLC( RCFClientSession& aSession,

        MCFListener& aListener );

    /**

     * C++ destructor.

     */

    virtual ~CCFContextService( );

public:

    // @see CCFClient

    void PublishContextL( CCFContextObject& aContext );

    // @see CCFClient

    void PublishContextL( CCFContextObject& aContext,

        CCFContextDataObject& aData );

    // @see CCFClient

    void SubscribeContextL( CCFContextSubscription& aSubscription );

    // @see CCFClient

    void UnsubscribeContextL( 

        CCFContextSubscription& aSubscription);

    // @see CCFClient

    void RequestContextL( CCFContextQuery& aContextQuery,

        RContextObjectArray& aRequestResults);

    // @see CCFClient

    void RequestContextSetL( RContextQueryArray& aContextQuerySet,

        RContextObjectArray& aRequestResults);

    // @see CCFClient

    TInt DefineContext( const TDesC& aContextSource,

        const TDesC& aContextType,

        const TSecurityPolicy& aReadSecurityPolicy,

        const TSecurityPolicy& aWriteSecurityPolicy );

    // @see CCFClient

    TInt InstallContextSourceSetting( const TDesC& aSettingFilename,

        const TUid& aContextSourceUid );

    // @see CCFClient

    TInt UninstallContextSourceSetting( const TDesC& aSettingFilename,

        const TUid& aContextSourceUid );

    // @see CCFClient

    TInt UninstallContextSourceSettings( const TUid& aContextSourceUid );

private:

    // Checks is context is legal

    TBool IsContextLegalForAdd( const CCFContextObject& aContext );

    // Checks is context data is legal

    TInt IsContextDataLegalForAdd( const CCFContextDataObject& aContextData );

    // Read context objects from request stream

    void ReadStreamContextObjectL( const TDesC8& aData,

        RContextObjectArray& aArray );

    // Stream context subscription

    HBufC8* WriteStreamContextSubscriptionLC(

        CCFContextSubscription& aSubscription );

    // Stream context object

    HBufC8* WriteStreamContextObjectLC( CCFContextObject& aContext );

    // Stream context query array

    HBufC8* WriteStreamContextQueryLC( RContextQueryArray& aQueryArray );

    // Stream context query array

    HBufC8* WriteStreamContextQueryLC( CCFContextQuery& aQuery );

    // Stream context data object

    HBufC8* WriteStreamContextDataObjectLC(

        CCFContextDataObject& aContextData );

private:

    CCFContextService( RCFClientSession& aSession, MCFListener& aListener );

    void ConstructL( );

private: // Data

    /** Request buffer dynamic size */

    TInt iRequestBufferSize;

    /** Context data object maximum size **/

    TInt iContextDataMaxSize;

    /** Context subscription listener */

    CCFContextSubscriptionListener* iContextSubscriptionListener;

    /** Server message listener */

    CCFServerMessageListener* iServerMessageListener;

    };

#endif // CFCONTEXTSERVICE_H