1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/ossrv/genericservices/activebackupclient/src/abclient.cpp Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,170 @@
1.4 +// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 +// All rights reserved.
1.6 +// This component and the accompanying materials are made available
1.7 +// under the terms of "Eclipse Public License v1.0"
1.8 +// which accompanies this distribution, and is available
1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.10 +//
1.11 +// Initial Contributors:
1.12 +// Nokia Corporation - initial contribution.
1.13 +//
1.14 +// Contributors:
1.15 +//
1.16 +// Description:
1.17 +// Implementation of CActiveBackupClient class.
1.18 +//
1.19 +//
1.20 +
1.21 +/**
1.22 + @file
1.23 + @released
1.24 +*/
1.25 +
1.26 +#include "abclient.h"
1.27 +#include "abclientsession.h"
1.28 +#include "abachandler.h"
1.29 +
1.30 +namespace conn
1.31 + {
1.32 +
1.33 + CActiveBackupClient::CActiveBackupClient() : iClientSession(NULL), iABCallbackHandler(NULL)
1.34 + /**
1.35 + Class constructor.
1.36 + */
1.37 + {
1.38 + }
1.39 +
1.40 +
1.41 + EXPORT_C CActiveBackupClient* CActiveBackupClient::NewL()
1.42 + /**
1.43 + This method creates a CActiveBackupClient, connects to the Secure Backup Server
1.44 + and does not wish to be called back so does not supply an implementation of
1.45 + MActiveBackupDataClient.
1.46 +
1.47 + If this is called when the Secure Backup Server is not active then it will leave
1.48 + with KErrNotSupported.
1.49 +
1.50 + @return Pointer to a created CActiveBackupClient object
1.51 + */
1.52 + {
1.53 + CActiveBackupClient* self = new (ELeave) CActiveBackupClient();
1.54 + CleanupStack::PushL(self);
1.55 + self->ConstructL();
1.56 + CleanupStack::Pop(self);
1.57 + return self;
1.58 + }
1.59 +
1.60 + EXPORT_C CActiveBackupClient* CActiveBackupClient::NewL(MActiveBackupDataClient* aClient)
1.61 + /**
1.62 + This method creates a CActiveBackupClient, connects to the Secure Backup Server
1.63 + and supplies a pointer to a MActiveBackupDataClient implementation.
1.64 +
1.65 + If this is called when the Secure Backup Server is not active then it will leave
1.66 + with KErrNotSupported.
1.67 +
1.68 + @param aClient pointer to an object that implements the MActiveBackupDataClient
1.69 + mixin. If this is NULL then the data owner does not take part in
1.70 + active backup or restore.
1.71 +
1.72 + @panic KErrNotFound Debug only - If an ActiveScheduler is not installed
1.73 + @leave Release only - If an ActiveScheduler is not installed
1.74 + @return Pointer to a created CActiveBackupClient object
1.75 + */
1.76 + {
1.77 + CActiveBackupClient* self = new (ELeave) CActiveBackupClient();
1.78 + CleanupStack::PushL(self);
1.79 + self->ConstructL(aClient);
1.80 + CleanupStack::Pop(self);
1.81 + return self;
1.82 + }
1.83 +
1.84 + void CActiveBackupClient::ConstructL()
1.85 + /**
1.86 + Construct this instance of CActiveBackupClient
1.87 + */
1.88 + {
1.89 + iClientSession = new (ELeave) RABClientSession;
1.90 +
1.91 + User::LeaveIfError(iClientSession->Connect());
1.92 + }
1.93 +
1.94 + void CActiveBackupClient::ConstructL(MActiveBackupDataClient* aClient)
1.95 + /**
1.96 + Construct this instance of CActiveBackupClient
1.97 +
1.98 + @param aClient Pointer to a concrete instance of MActiveBackupDataClient
1.99 + */
1.100 + {
1.101 + ConstructL();
1.102 +
1.103 + iABCallbackHandler = CActiveBackupCallbackHandler::NewL(aClient, *iClientSession);
1.104 + iABCallbackHandler->StartListeningForServerMessagesL();
1.105 + }
1.106 +
1.107 +
1.108 + EXPORT_C CActiveBackupClient::~CActiveBackupClient()
1.109 + /**
1.110 + Standard destructor.
1.111 + */
1.112 + {
1.113 + delete iABCallbackHandler;
1.114 + if (iClientSession)
1.115 + {
1.116 + iClientSession->Close();
1.117 + }
1.118 + delete iClientSession;
1.119 + iClientSession = NULL;
1.120 + }
1.121 +
1.122 + EXPORT_C void CActiveBackupClient::BURModeInfoL(TDriveList& aDriveList, TBURPartType& aBackupType, TBackupIncType& aIncBackupType)
1.123 + /**
1.124 + This method returns the type(s) of backup / restore operation currently active
1.125 +
1.126 + @param aDriveList list of drives involved in backup and restore
1.127 + @param aBackupType enumerated type indicating whether a backup or restore
1.128 + is in progress and whether full or partial.
1.129 + @param aIncBackupType enumerated type indicating whetherr a backup is base
1.130 + or incremental.
1.131 + */
1.132 + {
1.133 + iClientSession->BURModeInfoL(aDriveList, aBackupType, aIncBackupType);
1.134 + }
1.135 +
1.136 +
1.137 + EXPORT_C TBool CActiveBackupClient::DoesPartialBURAffectMeL()
1.138 + /**
1.139 + This method can be called when a partial backup or restore is active and will indicate
1.140 + whether the calling process is expected to take part. If a full backup or restore is
1.141 + active then this method will return ETrue for all data owners. If no backup or restore
1.142 + is active then this method will return EFalse for all data owners.
1.143 +
1.144 + @return ETrue if the calling data owner is involved in the current backup or restore
1.145 + operation.
1.146 + */
1.147 + {
1.148 + return iClientSession->DoesPartialBURAffectMeL();
1.149 + }
1.150 +
1.151 +
1.152 + EXPORT_C void CActiveBackupClient::ConfirmReadyForBURL(TInt aErrorCode)
1.153 + /**
1.154 + This method is called to indicate to the Secure Backup Server that the data owner is ready
1.155 + to participate in backup or restore. The data owner must call this method to indicate
1.156 + readiness or the Secure Backup Server will not request or supply backup data.
1.157 +
1.158 + N.B. The Secure Backup Server will supply snapshot data (if relevant) before a data
1.159 + owner indicates readiness as it assumes that the data owner requires snapshot data in
1.160 + order to prepare for a backp or restore.
1.161 +
1.162 + @param aErrorCode this should be set to KErrNone when the client is ready for
1.163 + backup or restore. If it is set to any other value then it indicates that the client
1.164 + cannot continue with the backup or restore and the error code will be supplied to
1.165 + the remote backup client.
1.166 + */
1.167 + {
1.168 + iClientSession->ConfirmReadyForBURL(aErrorCode);
1.169 + }
1.170 +
1.171 + } // end of conn namespace
1.172 +
1.173 +