/*

* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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:    Singleton to hold server session*

*/

#ifndef CCRSERVERHADLESINGLETON_H

#define CCRSERVERHADLESINGLETON_H

// INCLUDES

#include "RCRService.h"

#include "RCRClient.h"

#include <e32base.h>

// CONSTANTS

// None

// MACROS

// None

// DATA TYPES

// None

// FORWARD DECLARATIONS

class CCRAPIBase;

// CLASS DECLARATION

/**

*  Singleton class to store client handles. Instance of this class is kept

*  in TLS and a reference count is maintained. This is to ensure that if a

*  process creates multiple CCRDvrApi instances, they will all share the

*  same session to CommonRecordingEngine.

*

*  @lib CommonRecordingEngineClient.lib

*  @since Series 60 3.0

*/

NONSHARABLE_CLASS( CCRServerHandleSingleton ) : public CBase

    {

    /**

    * CCRApiBase and CCRDvrApi are the only classes 

    * that should have access to this class.

    */

    friend class CCRApiBase;

    friend class CCRDvrApi;

private: // Constructors and destructors

    /**

    * Private constructor to prevent direct instantiation. InstanceL must be used.

    */

    CCRServerHandleSingleton();

    /**

    * Second phase of 2-phased construction

    */

    void ConstructL();

    /**

    * Private destructor to prevent direct deletion. Release must be used.

    */

    ~CCRServerHandleSingleton();

private: // New methods

    /**

    * Returns the singleton instance. If it does not yet exist, it is created. 

    * If it does, a reference count is incremented

    * @since Series 60 3.0

    * @param none.

    * @return Instance to singleton class.

    */

    static CCRServerHandleSingleton* InstanceL();

    /**

    * Releases the singleton instance. If reference count reaches zero, the

    * instance is destroyed and client connection closed.

    */

    static void Release();  

    /**

    * Returns a reference to the service handle

    * @since Series 60 3.0

    * @param none.

    * @return Reference to RCRService

    */

    inline RCRService& Service() { return iService; }

private: // Data

    /**

    * Amount of references to this instance.

    * Instance will be deleted when this reaches zero.

    */

    TInt iReferenceCount;

    /**

    * Handle to Recording Engine client.

    */

    RCRClient iClient;

    /**

    * Handle to Recording Engine services.

    */

    RCRService iService;

    };

#endif // CCRSERVERHADLESINGLETON_H

//  End of File