sl@0: // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // Implementation of CActiveBackupClient class.
sl@0: // 
sl@0: //
sl@0: 
sl@0: /**
sl@0:  @file
sl@0:  @released
sl@0: */
sl@0: 
sl@0: #include "abclient.h"
sl@0: #include "abclientsession.h"
sl@0: #include "abachandler.h"
sl@0: 
sl@0: namespace conn
sl@0: 	{
sl@0: 
sl@0: 	CActiveBackupClient::CActiveBackupClient() : iClientSession(NULL), iABCallbackHandler(NULL)
sl@0: 	/** 
sl@0: 	Class constructor.
sl@0: 	*/
sl@0: 		{
sl@0: 		}
sl@0: 
sl@0: 
sl@0: 	EXPORT_C CActiveBackupClient* CActiveBackupClient::NewL()
sl@0: 	/**
sl@0:     This method creates a CActiveBackupClient, connects to the Secure Backup Server
sl@0: 	and does not wish to be called back so does not supply an implementation of
sl@0: 	MActiveBackupDataClient.
sl@0: 
sl@0:     If this is called when the Secure Backup Server is not active then it will leave
sl@0:     with KErrNotSupported.
sl@0:     
sl@0: 	@return Pointer to a created CActiveBackupClient object
sl@0: 	*/
sl@0: 		{
sl@0: 		CActiveBackupClient* self = new (ELeave) CActiveBackupClient();
sl@0: 		CleanupStack::PushL(self);
sl@0: 		self->ConstructL();
sl@0: 		CleanupStack::Pop(self);
sl@0: 		return self;
sl@0: 		}
sl@0: 
sl@0: 	EXPORT_C CActiveBackupClient* CActiveBackupClient::NewL(MActiveBackupDataClient* aClient)
sl@0: 	/**
sl@0:     This method creates a CActiveBackupClient, connects to the Secure Backup Server
sl@0:     and supplies a pointer to a MActiveBackupDataClient implementation.
sl@0: 
sl@0:     If this is called when the Secure Backup Server is not active then it will leave
sl@0:     with KErrNotSupported.
sl@0: 
sl@0:     @param aClient pointer to an object that implements the MActiveBackupDataClient
sl@0: 				   mixin.  If this is NULL then the data owner does not take part in
sl@0: 				   active backup or restore.
sl@0: 
sl@0: 	@panic KErrNotFound Debug only - If an ActiveScheduler is not installed
sl@0: 	@leave Release only - If an ActiveScheduler is not installed
sl@0: 	@return Pointer to a created CActiveBackupClient object
sl@0: 	*/
sl@0: 		{
sl@0: 		CActiveBackupClient* self = new (ELeave) CActiveBackupClient();
sl@0: 		CleanupStack::PushL(self);
sl@0: 		self->ConstructL(aClient);
sl@0: 		CleanupStack::Pop(self);
sl@0: 		return self;
sl@0: 		}
sl@0: 
sl@0: 	void CActiveBackupClient::ConstructL()
sl@0: 	/**
sl@0: 	Construct this instance of CActiveBackupClient
sl@0: 	*/
sl@0: 		{
sl@0: 		iClientSession = new (ELeave) RABClientSession;
sl@0: 		
sl@0: 		User::LeaveIfError(iClientSession->Connect());
sl@0: 		}
sl@0: 
sl@0: 	void CActiveBackupClient::ConstructL(MActiveBackupDataClient* aClient)
sl@0: 	/**
sl@0: 	Construct this instance of CActiveBackupClient
sl@0: 
sl@0: 	@param aClient  Pointer to a concrete instance of MActiveBackupDataClient
sl@0: 	*/
sl@0: 		{
sl@0: 		ConstructL();
sl@0: 		
sl@0: 		iABCallbackHandler = CActiveBackupCallbackHandler::NewL(aClient, *iClientSession);
sl@0: 		iABCallbackHandler->StartListeningForServerMessagesL();
sl@0: 		}
sl@0: 
sl@0: 
sl@0: 	EXPORT_C CActiveBackupClient::~CActiveBackupClient()
sl@0: 	/**
sl@0: 	Standard destructor.
sl@0: 	*/
sl@0: 		{
sl@0: 		delete iABCallbackHandler;
sl@0: 		if (iClientSession)
sl@0: 			{
sl@0: 			iClientSession->Close();
sl@0: 			}
sl@0: 		delete iClientSession;
sl@0: 		iClientSession = NULL;
sl@0: 		}
sl@0: 
sl@0:     EXPORT_C void CActiveBackupClient::BURModeInfoL(TDriveList& aDriveList, TBURPartType& aBackupType, TBackupIncType& aIncBackupType)
sl@0:     /**
sl@0:     This method returns the type(s) of backup / restore operation currently active
sl@0: 
sl@0:     @param aDriveList list of drives involved in backup and restore
sl@0:     @param aBackupType enumerated type indicating whether a backup or restore
sl@0:     is in progress and whether full or partial.
sl@0:     @param aIncBackupType enumerated type indicating whetherr a backup is base
sl@0:     or incremental.
sl@0:     */
sl@0: 		{
sl@0: 		iClientSession->BURModeInfoL(aDriveList, aBackupType, aIncBackupType);
sl@0: 		}
sl@0: 
sl@0: 
sl@0:     EXPORT_C TBool CActiveBackupClient::DoesPartialBURAffectMeL()
sl@0:     /**
sl@0:     This method can be called when a partial backup or restore is active and will indicate
sl@0:     whether the calling process is expected to take part.  If a full backup or restore is 
sl@0:     active then this method will return ETrue for all data owners.  If no backup or restore
sl@0:     is active then this method will return EFalse for all data owners.
sl@0: 
sl@0:     @return ETrue if the calling data owner is involved in the current backup or restore
sl@0:     operation.
sl@0:     */
sl@0: 		{
sl@0: 		return iClientSession->DoesPartialBURAffectMeL();
sl@0: 		}
sl@0: 
sl@0: 
sl@0:     EXPORT_C void CActiveBackupClient::ConfirmReadyForBURL(TInt aErrorCode)
sl@0:     /**
sl@0:     This method is called to indicate to the Secure Backup Server that the data owner is ready
sl@0:     to participate in backup or restore.  The data owner must call this method to indicate
sl@0:     readiness or the Secure Backup Server will not request or supply backup data.
sl@0: 
sl@0:     N.B. The Secure Backup Server will supply snapshot data (if relevant) before a data 
sl@0:     owner indicates readiness as it assumes that the data owner requires snapshot data in
sl@0:     order to prepare for a backp or restore.
sl@0: 
sl@0:     @param aErrorCode this should be set to KErrNone when the client is ready for
sl@0:     backup or restore. If it is set to any other value then it indicates that the client
sl@0:     cannot continue with the backup or restore and the error code will be supplied to
sl@0:     the remote backup client.
sl@0:     */
sl@0: 		{
sl@0: 		iClientSession->ConfirmReadyForBURL(aErrorCode);
sl@0: 		}
sl@0: 
sl@0: 	} // end of conn namespace
sl@0: 
sl@0: