// Copyright (c) 2004-2009 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 CActiveBackupClient class.

// 

//

/**

 @file

 @released

*/

#include "abclient.h"

#include "abclientsession.h"

#include "abachandler.h"

namespace conn

	{

	CActiveBackupClient::CActiveBackupClient() : iClientSession(NULL), iABCallbackHandler(NULL)

	/** 

	Class constructor.

	*/

		{

		}

	EXPORT_C CActiveBackupClient* CActiveBackupClient::NewL()

	/**

    This method creates a CActiveBackupClient, connects to the Secure Backup Server

	and does not wish to be called back so does not supply an implementation of

	MActiveBackupDataClient.

    If this is called when the Secure Backup Server is not active then it will leave

    with KErrNotSupported.

	@return Pointer to a created CActiveBackupClient object

	*/

		{

		CActiveBackupClient* self = new (ELeave) CActiveBackupClient();

		CleanupStack::PushL(self);

		self->ConstructL();

		CleanupStack::Pop(self);

		return self;

		}

	EXPORT_C CActiveBackupClient* CActiveBackupClient::NewL(MActiveBackupDataClient* aClient)

	/**

    This method creates a CActiveBackupClient, connects to the Secure Backup Server

    and supplies a pointer to a MActiveBackupDataClient implementation.

    If this is called when the Secure Backup Server is not active then it will leave

    with KErrNotSupported.

    @param aClient pointer to an object that implements the MActiveBackupDataClient

				   mixin.  If this is NULL then the data owner does not take part in

				   active backup or restore.

	@panic KErrNotFound Debug only - If an ActiveScheduler is not installed

	@leave Release only - If an ActiveScheduler is not installed

	@return Pointer to a created CActiveBackupClient object

	*/

		{

		CActiveBackupClient* self = new (ELeave) CActiveBackupClient();

		CleanupStack::PushL(self);

		self->ConstructL(aClient);

		CleanupStack::Pop(self);

		return self;

		}

	void CActiveBackupClient::ConstructL()

	/**

	Construct this instance of CActiveBackupClient

	*/

		{

		iClientSession = new (ELeave) RABClientSession;

		User::LeaveIfError(iClientSession->Connect());

		}

	void CActiveBackupClient::ConstructL(MActiveBackupDataClient* aClient)

	/**

	Construct this instance of CActiveBackupClient

	@param aClient  Pointer to a concrete instance of MActiveBackupDataClient

	*/

		{

		ConstructL();

		iABCallbackHandler = CActiveBackupCallbackHandler::NewL(aClient, *iClientSession);

		iABCallbackHandler->StartListeningForServerMessagesL();

		}

	EXPORT_C CActiveBackupClient::~CActiveBackupClient()

	/**

	Standard destructor.

	*/

		{

		delete iABCallbackHandler;

		if (iClientSession)

			{

			iClientSession->Close();

			}

		delete iClientSession;

		iClientSession = NULL;

		}

    EXPORT_C void CActiveBackupClient::BURModeInfoL(TDriveList& aDriveList, TBURPartType& aBackupType, TBackupIncType& aIncBackupType)

    /**

    This method returns the type(s) of backup / restore operation currently active

    @param aDriveList list of drives involved in backup and restore

    @param aBackupType enumerated type indicating whether a backup or restore

    is in progress and whether full or partial.

    @param aIncBackupType enumerated type indicating whetherr a backup is base

    or incremental.

    */

		{

		iClientSession->BURModeInfoL(aDriveList, aBackupType, aIncBackupType);

		}

    EXPORT_C TBool CActiveBackupClient::DoesPartialBURAffectMeL()

    /**

    This method can be called when a partial backup or restore is active and will indicate

    whether the calling process is expected to take part.  If a full backup or restore is 

    active then this method will return ETrue for all data owners.  If no backup or restore

    is active then this method will return EFalse for all data owners.

    @return ETrue if the calling data owner is involved in the current backup or restore

    operation.

    */

		{

		return iClientSession->DoesPartialBURAffectMeL();

		}

    EXPORT_C void CActiveBackupClient::ConfirmReadyForBURL(TInt aErrorCode)

    /**

    This method is called to indicate to the Secure Backup Server that the data owner is ready

    to participate in backup or restore.  The data owner must call this method to indicate

    readiness or the Secure Backup Server will not request or supply backup data.

    N.B. The Secure Backup Server will supply snapshot data (if relevant) before a data 

    owner indicates readiness as it assumes that the data owner requires snapshot data in

    order to prepare for a backp or restore.

    @param aErrorCode this should be set to KErrNone when the client is ready for

    backup or restore. If it is set to any other value then it indicates that the client

    cannot continue with the backup or restore and the error code will be supplied to

    the remote backup client.

    */

		{

		iClientSession->ConfirmReadyForBURL(aErrorCode);

		}

	} // end of conn namespace