/*
* Copyright (c) 2005 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:  Client-side service implementations
*
*/


#ifndef SYNCSERVICE_H
#define SYNCSERVICE_H

#include <AknServerApp.h>
#include <SyncServiceConst.h>

#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
#include <apaidpartner.h>
#else
#include <apaid.h>
#endif


struct  TSyncServiceParam
 	{
 	TUint   iJobId;
 	TUint   iProfileId;
 	TUint   iServiceId;
 	TUint   iSilent;
 	};
 	
/**
*  RSyncService  
*
*  Lower level client side service class
*
*  @lib syncservice.lib
*  @since Series 60 3.0
*/
class RSyncService : public RAknAppServiceBase
	{
	public: 
		/**
		* Sends the synchronisation start command to the
		* server side with parameters aParams
		*/
		void StartSyncL( TSyncServiceParam aParam );
		
		/**
		* Sends command that enables or disables the SyncML session
		* progress notes to the server side.
		* @param aEnabled Should the progress note be enabled or disabled.
		*/
		void EnableProgressNoteL( TBool aEnabled );

	private: // From RApaAppServiceBase
		/**
		* Returns the uid of the service
		*/
		TUid ServiceUid() const;
	};

/**
*  CSyncService  
*
*  Higher level client side service class
*
*  @lib syncservice.lib
*  @since Series 60 3.0
*/
class CSyncService : public CBase
	{
	public:

        /**
        * Two-phased constructor.
        */
		IMPORT_C static CSyncService* NewL( MAknServerAppExitObserver* aObserver,
		                                    TUint aServiceId );
		
        /**
        * Destructor.
        */
        virtual ~CSyncService();
		
    public:

		/**
		* StartSyncL
		*
		* @param aParam Parameters for the service so that it
		*               knows which service command to issue
        * @return None
		*/
    	IMPORT_C TUid StartSyncL( TSyncServiceParam aParam );

		/**
		* Sends a command to the sync or devman application to
		* indicate that the progress note should be enabled
		* or disabled.
		* @param aEnabled Should the progress not be shown.
        * @return None
		*/
        IMPORT_C void EnableProgressNoteL( TBool aEnabled );
        
	private:
	
        /**
        * C++ default constructor.
        */
		CSyncService();
	
		/**
		* 2nd phase constructor
		* First calls Discover to find the right application with aParams.
		* Then calls iService to connect to right application.
		* Creates an instance of CApaServerAppExitMonitor		
		* Creates an instance of CSyncService.
		* Sets itself as observer for the service.
		*
		* @param aObserver  pointer of MAknServerAppExitObserver to be passed to iMonitor
		* @param aServiceId parameters for the service so that it
		*                   knows which application to start	
        * @return None
		*/
		void ConstructL(  MAknServerAppExitObserver* aObserver,
		                  TUint aServiceId );

		/**
		* DiscoverL
		* Finds the right application id to be started and returns it.
		* Connects RApaLsSession and initializes
		* it with GetServerApps command. Then gets all the services that
		* implement the service by using GetServiceImplementationsLC. 
		* Calls TryMatchL for each service and if there's a match,
		* the appId is returned. If no implementation is found, 0 is returned.
		*
		* @param aServiceId parameters for the service so that it
		*                   knows which application to start	
        * @return None
		*/
    	TUid DiscoverL( TUint aServiceId );

		/**
		* TryMatchL
		* Reads the service type information from OpaqueData.
		* Sets aAppUi as the application id.
		*
		* @param aInfo      Application service information.
        * @param aAppUid    Application Uid
		* @param aServiceId Parameters for the service so that it
		*                   knows which application to start
        * @return Boolean   ETrue if not found, returns EFalse.
		*/
    	TBool TryMatchL( const TApaAppServiceInfo aInfo,
    	                 TUid& aAppUid,
    	                 TUint aServiceId );

	private:
		// Lower level client-side service implementation
		RSyncService 		        iService;
		// Monitor for checking events from the server side
		CApaServerAppExitMonitor* 	iMonitor;
		TSyncServiceParam           iParameters;
		TUid                        iUid;
		TUint                       iServiceId;
	};

#endif  // SYNCSERVICE_H

// End of File