/*
* 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 "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:  CCA client's connecting class.
*
*/


#ifndef C_CCACONNECTION_H
#define C_CCACONNECTION_H

#include <e32base.h>
#include <mccaconnection.h>
#include <mccaconnectionext.h>

/**
 *  CCCAConnection
 *  CCA client's core connection class.
 *
 *  @code
 *
 *  @endcode
 *
 *  @lib ccaclient
 *  @since S60 v5.0
 */
class CCCAConnection : 	public CActive,
                        public MCCAConnectionExt, 
                        private MAknServerAppExitObserver
    {
#ifdef __CCACLIENTUNITTESTMODE
    friend class ut_CCAConnection;
#endif// __CCACLIENTUNITTESTMODE

public:

    /**
     * Two-phased constructor.
     */
    static CCCAConnection* NewL( );

    /**
    * Destructor.
    */
    virtual ~CCCAConnection();


public:

// from base class CActive

    /**
     * From CActive.
     * (see baseclass for details)
     *
     * @since S60 v5.0
     */
    void RunL();

    /**
     * From CActive.
     * (see baseclass for details)
     *
     * @since S60 v5.0
     */
    void DoCancel();

// from base class MCCAConnection

    /**
     * From MCCAConnection
     * (see details from header)
     *
     * @since S60 v5.0
     */
    void Close();

    /**
     * From MCCAConnection
     * (see details from header)
     *
     * @since S60 v5.0
     */
    void LaunchApplicationL( MCCAParameter& aParameter );

    /**
     * From MCCAConnection
     * (see details from header)
     *
     * @since S60 v5.0
     */
    void LaunchAppL(
            MCCAParameter& aParameter,
            MCCAObserver* aObserver = NULL );

    /**
     * From MCCAConnectionExt
     * (see details from header)
     *
     * @since S60 v5.0
     */	
    void CloseAppL();

private:

// from base class MAknServerAppExitObserver

    /**
     * From MAknServerAppExitObserver.
     * (see baseclass for details)
     *
     * @since S60 v5.0
     */
    void HandleServerAppExit( TInt aReason );

private:

    CCCAConnection();
    void ConstructL();

    /**
     * Makes connection to service class.
     */
    void ConnectL();

    /**
     * Close down service connection.
     */
    void DisconnectServerApplication();

    /**
    * Do service connection
    */
    void ConnectServerApplicationL();

    /**
    * Do launch
    */
    void DoLaunchL(MCCAParameter& aParameter);

    /**
    * Clean iParameter
    */
    void CloseParameter();
	
private: // Data structures
    /// Application launching status
    enum TAppStatus
            {
            EAppClosed,
            EAppLaunching,
            EAppRunning
            };

private: // data

    /**
     * Application server service.
     * Own.
     */
    RCCAClientUIService iAppService;

    /**
     * Exit application server monitor.
     * Own.
     */
    CApaServerAppExitMonitor* iMonitor;

    /**
     * Launch parameter including contact link etc.
     * Own.
     */
    CCCAParameter* iParameter;

    /**
     * Observer to indicate happenings.
     * Not own.
     */
    MCCAObserver* iObserver;

    /**
     * The status of connection.
     * Own.
     */
    TAppStatus iAppStatus;

    /**
     * For making the asyncronic syncronic.
     * Own.
     */
    CActiveSchedulerWait* iSchedulerWait;

    /**
     * Stream buffer for launch.
     * Own.
     */
    HBufC8* iMsgStream;
    
    /**
     * Ptr to the Stream buffer iMsgStream     
     */
    TPtr8 iMsgStreamPtr;

    /**
     * Boolean to protect from attempts to close CCA twice from
	 * external client     
     */
	TBool iClosePending;
    };

#endif // C_CCACONNECTION_H

// End of File