/*

* Copyright (c) 2000 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: Implementation of applicationmanagement components

*

*/

#ifndef __APPLICATIONMANAGEMENTCLIENT_H__

#define __APPLICATIONMANAGEMENTCLIENT_H__

// INCLUDES

#include <e32std.h>

#include "ApplicationManagementCommon.h"

#include "ApplicationManagementClientServer.h"

#include "ApplicationManagementConst.h"

#include <ssl.h>

#include <f32file.h>

#include <AknServerApp.h>

#include <uikon.hrh>

typedef RArray<TUint32> RElementIdArray;

namespace NApplicationManagement

	{

// CLASS DECLARATION

/**

*  RApplicationManagement class to establish ApplicationManagement server connection

*/

class RAMTC : public RSessionBase

	{

		public:

    /**

	* Connect Connects client side to application management server

    * @return KErrNone Symbian error code

    */

	IMPORT_C TInt Connect();

    /**

	* Close Close server connection

    */

	IMPORT_C void Close();

	/**

	* GetApplicationUidL finds uid for given deployment component.

	* @param aInternalId Id of the deployment component, whose uid is wished

	* @param aUid	After successful call, will hold the uid

	*/	

	IMPORT_C void GetApplicationUidL( TInt aInternalId, TUid &aUid );

	};

class RApplicationManagement : public RAknAppServiceBase

	{

	public:

	       public: // Constructors 

	IMPORT_C RApplicationManagement();

	    /**

		* Connect Connects client side to application management server

	    * @return KErrNone Symbian error code

        */

		IMPORT_C TInt Connect( const TCertInfo &aCertInfo );

		IMPORT_C TInt Connect( );

	    /**

		* Close Close server connection

        */

		IMPORT_C void Close();

//Session management		

	    /**

		* DeliverL Add deployment component to the system. At least some parameter

		* (in the aInfo or aData) must not be empty.

		*

		* @param aInfo  TDeploymentComponentInfo containing the essentials of component

		* @param aData The Delivery deployment component Data

		* @param aInstallOpts Optional install options

		* @param aMetaData Optional meta data for install operation

	    * @return Created Internal Id for the deployment component

        */

		/**

		* DownloadL Adds deployment component with EDCSDownload to the system. 

		* @param aUserId The user id of the component

	    * @return Created Internal Id for the deployment component

        */

		IMPORT_C TUint32 DownloadL( const TDCUserId &aUserId ) const;

		IMPORT_C TUint32 DeliverL( const TDCUserId &aUserId ) const;

		/**

		* DeploymentComponent Returns the deployment component having the given Id.

		* If there's no such deployment component, method returns

		* KErrNotFound. 

		* @param aId Id of the component to be found

	    * @return KErrNone  Symbian error code (KErrNotFound if not found)

		*/

		IMPORT_C TInt DeploymentComponent( 

			TUint32 aInternalId, TDeploymentComponent &aReturnValue ) const;

		/**

		* DeploymentComponentUserId Returns the user id of deployment component 

		* having the given internal Id.

		* @param aId Id of the component to be found

		* @param aResponse The buffer in which the user id will be placed

	    * @return KErrNone  Symbian error code (KErrNotFound if not found)

		*/

		IMPORT_C void DeploymentComponentUserIdL( 

			TUint32 aInternalId, TDCUserId &aResponse ) const;

		/**

		* DeploymentComponentDataL Fetches data for component that's in EDCSDelivered state.

		* @param aInternalId Id of the component to be found

		* @param aDataType Type of the data to be found. Must be one of EDCInstallOptions

		*		EDCMetaData, EDCData, 

		* @param aBuffer The buffer that will be filled with the data

	    * @return 

		*/

		IMPORT_C void DeploymentComponentDataL( 

			TUint32 aInternalId, TDeplCompAttrType aDataType, CBufBase &aBuffer ) const;

		/**

		* UpdateDeploymentComponentL Updates deployment component.

		* @param aInternalId Id of the component to be updated

		* @param aItem Type of the data to be updated.

		* @param aItemData The data

	    * @leave The deployment component, or NULL if there's not one

		*/

		IMPORT_C void UpdateDeploymentComponentL( TUint32 aInternalId,

			TDeplCompAttrType aItem, const TDesC8 &aItemData ) const;

		/**

		* UpdateDeploymentComponentL Updates deployment component with mime type too.

		* @param aInternalId Id of the component to be updated

		* @param aItem Type of the data to be updated. This must be 

		*	EDCMetaData or EDCData for call to be successful

		* @param aItemData The data

		* @param aDataMime The data mime type

	    * @leave The deployment component, or NULL if there's not one

		*/	

		IMPORT_C void UpdateDeploymentComponentDataL( 

			TUint32 aInternalId, TDeplCompAttrType aItem, 

			const TDesC8 &aItemData, const TDesC8 &aDataMime ) const; 

		/**

		* UpdateDeploymentComponentStreamedDataL Updates deployment component with mime type too.

		* @param aInternalId Id of the component to be updated

		* @param aItem Type of the data to be updated. This must be 

		*	EDCMetaData or EDCData for call to be successful

		* @param aDataMime The data mime type

	    * @leave The deployment component, or NULL if there's not one

		*/	

		IMPORT_C void UpdateDeploymentComponentStreamedDataL( 

			TUint32 aInternalId, TDeplCompAttrType aItem, const TDesC8 &aDataMime ) const; 

		/**

		* DeploymentComponentIds Returns array of the deployment component Ids, that exist in the

		* system. Optionally one can give a TDeploymentComponentState flag to restrict

		* resulted ids to those components that has the given state.

		* @param aArray Will hold the response

		* @param aState Optional state of the wished deployment components

	    * @return KErrNone Symbian error code

		*/

		IMPORT_C TInt DeploymentComponentIdsL(

			RElementIdArray &aArray, 

			const TDeploymentComponentState aState = EDCSNone  ) const;

		/**

		* InstallL Installs given deployment component.

		* @param aInternalId The id of deployment component to be installed

	    * @param aTargetState Will the installed component be actibve or inactive (default active)

		* @return KErrNone Symbian error code

		*/

		IMPORT_C void InstallL( TUint32 aInternalId , 

			TDeploymentComponentState aTargetState = EDCSActive) const;

		/**

		* RemoveL Removes given deployment component.

		* @param aInternalId The id of the component to be removed

	    * @return 

		*/

		IMPORT_C void RemoveL( TUint32 aInternalId ) const;

		/**

		* UpdateL Updates the given deployment

		* @param aSourceInternalId The id of the component that is source of update

		* @param aTargetInternalId The id of the component that is target of update

	    * @leave 

		*/

		IMPORT_C void UpdateL( TUint32 aSourceInternalId, TUint32 aTargetInternalId ) const;

		/**

		* StartDownloadL Starts download of deployment component.

		* @param aInternalId The id of the component to be downloaded

		* @param aTargetState The target state of download (

	    * @return 

		*/

		IMPORT_C void StartDownloadL( TUint32 aInternalId, 

			const TDownloadTarget aTarget= EDeliver  ) const;

	 	/**

		* StateChangingDCIds Returns array of the deployment component Ids, that are

		* in the state changing list. Currently they are those that are being downloaded.

		* @param aArray Will hold the response

	    * @return KErrNone Symbian error code

		*/

		IMPORT_C TInt StateChangingDCIdsL( RElementIdArray &aArray ) const;

		/**

		* StateChangeComplete Informs server that the state of component is updated in the

		*	adapter, and that it thus can be removed from the list of state changing objects.

		* @param aInternalId The id of the component to be removed from list

		*

	    * @return KErrNone Symbian error code

		*/

		IMPORT_C TInt StateChangeComplete( TUint32 aInternalId ) const;

		/**

		* ActivateL Tries to activate given deployment component

		*	

		* @param aInternalId The id of the component to be activated

		*/

		IMPORT_C void ActivateL( TUint32 aInternalId ) const;

		/**

		* DeactivateL Tries to deactivate given deployment component

		*	

		* @param aInternalId The id of the component to be deactivated

		*/

		IMPORT_C void DeactivateL( TUint32 aInternalId ) const;

		/**

		* DeploymentComponentDataSizeL Get deployment component attribute size

		*	

		* @param aInternalId The id of the component 

		* @param aItem The type of attribute whose size is to be got

		* @return The size

		*/

		IMPORT_C TInt DeploymentComponentDataSizeL( TUint32 aInternalId, 

			const TDeplCompAttrType &aItem ) const;

		/**

		* DeploymentComponentTempInstFile ask file handle from server to be used

		*	

		* @param aTempFile temporary file handle 

		* @param aItem The type of attribute whose type of temporary file to get

	    * @return KErrNone Symbian error code

		*/

		IMPORT_C void DeploymentComponentTempInstFileL( TUint32 aInternalId, RFile& aTempFile, const TDeplCompAttrType &aItem ) const;

		/**

		 * GetFinalResultsForGAL ask results from AM Server. In response AM 

         * server returns final result and target URI of node

         *	

         * @param aInternalId The id of the component 

         * @param aFinalResult Final result of deployment component

         * @param aTargetURI Target URI of deployment component

         * @return void

         */

		IMPORT_C void GetFinalResultsForGAL(TUint32 aInternalId, TInt& aFinalResult,  TDes8& aTargetURI) const;

		IMPORT_C void GenericAlertSentL(TUint32 aInternalId) const;

		/**

		* Implementation of Service UID() from base class. Returns AM service UID 

		* to framework

		*	

		* @return uid of AM service UID

		*/	

		TUid ServiceUid() const;  

        /**

         * CheckStatusNodes Checks all deployed,delivered and download component's status node values

         * and set the state accordingly. For ex, on first SCOMO session if status node = Download progress

         * which means that download operation is failed in previous sessiona and hence we need to set the

         * value of status node to Download failed.

         *   

         */

        IMPORT_C void CheckStatusNodesL( ) const;

	private:	

	};

	}

#endif //__APPLICATIONMANAGEMENTCLIENT_H__

//  End of File