/*
* 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 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:  This Class provides the functionality to launch the application
*
*/



#ifndef __LAUNCHER_H
#define __LAUNCHER_H

class TOptions;
class RApaLsSession;
class CLauncherObserver;
class TDocument;
class CDocumentHandler;

/**
* This Class provides the core functionality of launching 
* the application
*
* @since  Series60 v3.2
*/
class CLauncher : public CBase
    {

    public:

    	 /**
        * Returns the instance of CLauncher.
        * @since  Series60 v3.2
        * @param  aSession AppArch server session.
        * @return CLauncher* return the instance of CLauncher class
        */
        static CLauncher* NewL( RApaLsSession& aSession );

            
     	/**
        * This function Launch the Given Application
        * succeed.
        * @since  Series60 v3.2
        * @param  aAppId   UID of the application to be launch
        * @param  aCmdLine Commandline Argument
        * @param  aOptions mode for laucnhing the appilcation(standalone/chained)
        * @param  aObserver observer for informing when the launched application dies
        */
       	
        TThreadId LaunchApplicationL( const TDesC& aAppId, 
                                       const TDesC8& aCmdLine, 
                                       const TOptions& aOptions );
       	
       	/**
        * This function Launch the Given Document
        * succeed.
        * @since  Series60 v3.2
        * @param  aCriteria Document to be launch 
        * @param  aMimeType MimeType of application to be launch 
        * @param  aProperties postion and mode for laucnhing the appilcation(standalone/chained)
        * @param  aObserver observer for informing when the launched application dies
        */
       	TThreadId LaunchDocumentL( TDocument& aCriteria, 
       	                            const TDesC8& aMimeType, 
       	                            const TOptions& aProperties , 
       	                            TDesC& aFileName );
       	
        /**
        * This function Launch the Given Document. This function is written to support the requirement of webtv widget .
        * This is applicable only to synchronous chained mode version of launchdocument.
        * succeed.
        * @since  Series60 v3.2
        * @param  aCriteria Document to be launch 
        * 
        */
       	
       	void LaunchDocumentL( TDocument& aCriteria );
        
        /**
        * Destructor
        * @since  Series60 v3.2
        * @param void
        * @return void
        */
        ~CLauncher(); 
        
   	private:

        /**
        * This function parse the application id string  and convert into TUid 
        * @since  Series60 v3.2
        * @param  aSource String to Parse
        * @param  aUid Returns the Uid from the given string
        */
        void ParseAppIdL( const TDesC& aSource ,TUid& aUid );
        
         /**
        * This function parse the application id string  and covert into TUid 
        * @since  Series60 v3.2
        * @param  aHexString String conating UID in HEX format
        * @param  aUid Returns the Uid from the given string 
        */
        TInt ConvertHexStringToInt32(const TDesC& aHexString,TInt32& aInt32 );
       	
       	 /**
        * This function will set the application to launch in chained mode 
        * @since  Series60 v3.2
        * @param  aCmdLine underlying structure in which chained mode has to set
        * @param  aAppUid Uid of the applications
        */
       	      	
       	void SetChainedModeL( CApaCommandLine* aCmdLine  , const TUid& aAppUid );
   	
   		/**
        * Constructor
        * @since  Series60 v3.2
        * @param void
        * @return void
        */
        CLauncher( RApaLsSession& aSession);
        
     


    private:
    
       /**
     	* Session of application architecture server
     	*/
      
        RApaLsSession& iApaLsSession;
        CDocumentHandler* iDocHandler; // this handler wiil be created only in the chained mode and destroyed in dtor.
        
      };

#endif __LAUNCHER_H