/*

* Copyright (c) 2007-2007 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:  Symbian OS server subsession.

*  libraries   : 

*

*/

#ifndef DIAGRESULTSDBTESTRECORDSUBSESSION_H

#define DIAGRESULTSDBTESTRECORDSUBSESSION_H

//System includes

#include <e32cmn.h> //RMessage2

#include <e32base.h> //CObject 

//Forward declarations

class CDiagResultsDbSession;

class CDiagResultsDbTestRecordHandle;

class MRecordCompletionObserver;

/**

* Server Subsession 

*

* @since S60 v5.0

**/

class CDiagResultsDbTestRecordSubsession: public CObject, 

                                          public MRecordCompletionObserver

	{

public:  

    /**

    * NewL.

    * 

    * @param aSession Main Database session.

    * @param aTestRecord The test record that this subsession handles.

    *                    The record is either totally empty or contains data.

    * @param aResumeTestRecord Indicates can opened test record modified.

    *

    * @return Test record subsession.                    

    **/

	static CDiagResultsDbTestRecordSubsession* NewL(

	                                 CDiagResultsDbSession* aSession, 

	                                 CDiagResultsDbTestRecordHandle* aTestRecordHandle,

	                                 TBool aReadonly

	                                 );

    /**

    * Destructor.

    **/

    ~CDiagResultsDbTestRecordSubsession();

    /**

    * Handles the client request. 

    *

    * @param aMessage Details of the client request.

    * @return ETrue if request was asynchronous, EFalse otherwise.

    **/

    TBool DispatchMessageL(const RMessage2& aMessage);

    /**

    * Returns the test record that this subsession represents.

    *

    * @return The test record.

    **/

    CDiagResultsDbTestRecordHandle* CurrentTestRecordHandle();

    /**

    * Returns the value that client send when connecting.

    * ETrue = Readonly subsession.

    * EFalse = Writable subsession.

    **/ 

    TBool ReadonlySubsession() const;

public: //MRecordCompletionObserver

    /**

    * This is called when test record is completed.

    *

    * @param aError Symbian error code or KErrNone.

    **/   

    void CompletedRecordL( TInt aError );    

protected:

    /**

    * C++ Constructor

    *

    * @param aSession Main Database session.

    * @param aTestRecord The test record that this subsession handles.

    *                    The record is either totally empty or contains data.

    **/

    CDiagResultsDbTestRecordSubsession(

                        CDiagResultsDbSession* aSession, 

                        CDiagResultsDbTestRecordHandle* aTestRecord,

                        TBool aReadonly

                        );

    /**

    * ConstructL.

    **/                    

    void ConstructL();                    

private: // Client request handling functions. 

         // Look at DiagResultsDatabaseCommon.h for the client requests.

    void LogTestResultL( const RMessage2& aMessage );

    void GetTestResultL( const RMessage2& aMessage );

    void CompleteTestRecordL( const RMessage2& aMessage );

    void GetTestResultsL( CDiagResultsDbTestRecordHandle* aTestRecord, 

                          const RMessage2& aMessage );

    void GetTestUidsL( const RMessage2& aMessage );

    void GetEngineParamL( const RMessage2& aMessage );

    TBool Completed() const;

    void GetStatusL ( const RMessage2& aMessage );

    void SuspendTestRecordL( const RMessage2& aMessage );

    void CancelLogTestResult( const RMessage2& aMessage );

private: // Data

    // Main DB session

    CDiagResultsDbSession* iSession;

    // Test record that represents this subsession.

    CDiagResultsDbTestRecordHandle* iTestRecordHandle;

    // Details of the client request.

    RMessage2 iMsg;

    // Dynamic flat buffer for transmitting data across IPC.

    CBufFlat* iBuffer;

    // Read or Write-mode 

    TBool iReadonly;

    TBool iCompletedLogTest;

	};

#endif // DIAGRESULTSDBTESTRECORDSUBSESSION_H