/*

 * Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).

 * All rights reserved.

 * This component and the accompanying materials are made available

 * under the terms of the License "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: 

 * RUpsManagement implementation.	 See class and function definitions

 * for more detail.

 *

 */

 /**

  @file

 */

 #include <ups/upsclient.h>

 #include <s32mem.h>

 #include "upscommon.h"

 #include <scs/nullstream.h>

 namespace UserPromptService

 	{

 EXPORT_C RUpsManagement::RUpsManagement()

 /**

 	This constructor provides a single point of definition from

 	which the superclass constructor is called.

  */

 :	RScsClientBase(), iCreateViewFilterBuf(), iMatchLengthBuf()

 	{

 	iMatchLengthBuf() = 0;

 	}

 EXPORT_C TInt RUpsManagement::Connect()

 /**

 	Connect to the UPS server.

 	@return					Symbian OS error code where KErrNone indicates

 							success and any other value indicates failure.

  */

 	{

 	TVersion v = UserPromptService::Version();

 	TUidType serverFullUid = UserPromptService::ServerImageFullUid();

 	TInt r = RScsClientBase::Connect(

 		UserPromptService::KUpsServerName, v, UserPromptService::KServerImageName, serverFullUid);

 	return r;

 	}

 EXPORT_C void RUpsManagement::Close()

 /**

 Cleanup and call RScsClientBase::Close

 */

 	{

 	RScsClientBase::Close();

 	}

 EXPORT_C void RUpsManagement::DeleteDatabaseL()

 /**

 	Deletes all stored UPS decisions.

 	@capability WriteDeviceData 

 */

 	{

 	User::LeaveIfError(CallSessionFunction(EDeleteDatabase));

 	}

 EXPORT_C void RUpsManagement::CreateView(const CDecisionFilter& aFilter, TRequestStatus &aStatus)

 /**

 	Creates a view for records which match the supplied CDecisionFilter.

 	If the CDecisionFilter is created using the constructor which specifies all fields (or all fields are set), then an exact match will be

 	searched for.

 	If the CDecisionFilter is created without parameters, then any fields which are not set will match any record.

 	Only one view can be active in a single RUpsManagement session at any one time.

 	Simultaneous database updates, either from this management session, another session or the main UPS 

 	operation may cause the query to be aborted with KErrAbort.

 	When you are finished with the view you should call CancelAndCloseView (otherwise you

 	will not be able to create a new view).

 	@param aFilter	Specifies the filter to be matched.

 	@capability ReadDeviceData 

 */

 {

 	aStatus = KRequestPending;

 	TRAPD(err,

 		RNullWriteStream nullstream;

 		nullstream << aFilter;

 		nullstream.CommitL();

 		TInt bytesWritten = nullstream.BytesWritten();

 		iCreateViewFilterBuf.Close();

 		iCreateViewFilterBuf.CreateL(bytesWritten);

 		// Arg 0 - The CDecisionFilter

 		// Externalize to iCreateViewFilterBuf

 		RDesWriteStream desstream(iCreateViewFilterBuf);

 		CleanupClosePushL(desstream);

 		desstream << aFilter;

 		desstream.CommitL();

 		CleanupStack::PopAndDestroy(&desstream);

 		// Arg 1 - TUint32 length of first match returned by server

 		// Server writes into iMatchLengthBuf

 		CallSessionFunction(ECreateView, TIpcArgs(&iCreateViewFilterBuf, &iMatchLengthBuf), aStatus);

 		);

 	if(err != KErrNone)

 		{

 		TRequestStatus *rs = &aStatus;

 		User::RequestComplete(rs, err);

 		}

 }

 EXPORT_C CDecisionRecord *RUpsManagement::NextMatchL()

 /**

 	Returns the next matching record in the view created with CreateViewL.

 	Simultaneous database updates, either from this management session, another session or the main UPS 

 	operation may cause the query to be aborted with KErrAbort.

 	When you are finished with the view you should call CancelAndCloseView.

 	@return record ptr, or 0 if there are no more matching records. Leaves for other errors.

 	@capability ReadDeviceData 

 */

 {

 	if(iMatchLengthBuf() == 0)

 		{

 		return 0; // No more matches

 		}

 	CDecisionRecord *record = CDecisionRecord::NewLC();

 	// Arg 0 - The CDecisionRecord buffer

 	RBuf8 buf;

 	CleanupClosePushL(buf);

 	buf.CreateL(iMatchLengthBuf());

 	// Arg 1 - TUint32 length of next match

 	User::LeaveIfError(CallSessionFunction(ENextMatch, TIpcArgs(&buf, &iMatchLengthBuf)));

 	RDesReadStream readStream(buf);

 	CleanupClosePushL(readStream);

 	readStream >> *record;

 	CleanupStack::PopAndDestroy(&readStream);

 	CleanupStack::PopAndDestroy(&buf);

 	CleanupStack::Pop(record);

 	return record;

 }

 EXPORT_C void RUpsManagement::CancelAndCloseView()

 	/**

 	Close down a view. This can also be used to cancel an outstanding CreateView request.

 	@capability ReadDeviceData 

 	*/

 {

 	CancelSessionFunction(ECreateView);

 	(void) CallSessionFunction(ECloseView);

 	iCreateViewFilterBuf.Close();

 	iMatchLengthBuf() = 0;

 }

 EXPORT_C void RUpsManagement::RemoveDecisionsL(const CDecisionFilter& aFilter)

 /**

 	Removes all records which match the supplied CDecisionFilter.

 	The filter can match/delete multiple records in one operation.

 	@param aFilter	Specifies the records to be deleted.

 	@capability WriteDeviceData 

 */

 	{

 	// Calculate the buffer length required to represent the filter object

 	RNullWriteStream nullstream;

 	nullstream << aFilter;

 	nullstream.CommitL();

 	TInt bytesWritten = nullstream.BytesWritten();

 	// Create buffer for filter

 	RBuf8 filterBuf;

 	CleanupClosePushL(filterBuf);

 	filterBuf.CreateL(bytesWritten);

 	// Arg 0 - The CDecisionFilter

 	// Externalize to iCreateViewFilterBuf

 	RDesWriteStream desstream(filterBuf);

 	CleanupClosePushL(desstream);

 	desstream << aFilter;

 	desstream.CommitL();

 	CleanupStack::PopAndDestroy(&desstream);

 	User::LeaveIfError(CallSessionFunction(ERemoveDecisions, TIpcArgs(&filterBuf)));

 	CleanupStack::PopAndDestroy(&filterBuf);

 	}

 EXPORT_C void RUpsManagement::UpdateDecision(TUint32 aRecordId, TBool aAllow, TRequestStatus &aStatus)

 /**

 	Updates the single record which matches the unique record ID.

 	This API ONLY updates the CDecisionRecord result field. The only legal values are ETrue (always) or EFalse (never)

 	@param aRecordId	Specifies the single record to update.

 	@param aAllow		Allow or reject the request.

 	@capability AllFiles 

 */

 	{

 	TIpcArgs args(aRecordId, aAllow);

 	CallSessionFunction(EUpdateDecision, args, aStatus);

 	}

 EXPORT_C void RUpsManagement::CancelUpdateDecision()

 /**

 	Cancel an outstanding UpdateDecision request.

 	Normally this will not be used because an UpdateDecision call will complete very quickly, but

 	internally the request is asynchronous and exposing the cancel API allows the cancel code path

 	to be tested.

 	@capability AllFiles 

 */

 	{

 	CancelSessionFunction(EUpdateDecision);

 	}

 EXPORT_C void RUpsManagement::DeleteDecisionsForExeL(const TSecureId& aExeSid)

 /**

 	Delete all decisions in the database for the specified executable.

 	@param aExeSid	The SID of the executable which has been deleted.

 	@capability SWI observer plugin SID only

 */

 	{

 	User::LeaveIfError(CallSessionFunction(EDeleteDecisionsForExe, TIpcArgs(aExeSid.iId)));

 	}

 EXPORT_C void RUpsManagement::NotifyPluginsMayHaveChangedL()

 /**

 	Notify the UPS that an ECOM plugin has been installed somewhere, which may be an evaluator.

 	The UPS will reload all ECOM plugins ASAP.

 	@capability SWI observer plugin SID only

 */

 	{

 	User::LeaveIfError(CallSessionFunction(ENotifyPluginsMayHaveChanged));

 	}

 EXPORT_C void RUpsManagement::NotifyPolicyFilesChanged(TRequestStatus &aStatus)

 /**

 	Policy files have been added, changed or deleted.

 	The UPS server will rebuild its policy file cache and delete decisions which relate to policy files

 	which are no longer active (ie. have been deleted, or eclipsed by a policy file with a different

 	major version number).

 	@capability SWI observer plugin SID only

 */

 	{

 	TIpcArgs args;

 	CallSessionFunction(ENotifyPolicyFilesChanged, args, aStatus);

 	}

 EXPORT_C void RUpsManagement::CancelNotifyPolicyFilesChanged()

 	/**

 	Cancel a previous call to NotifyPolicyFilesChanged.

 	Normally this functions should not be used, it is only present for testing the handling

 	of abnormal events.

 	@capability SWI observer plugin SID only

 	*/

 	{

 	CancelSessionFunction(ENotifyPolicyFilesChanged);

 	}

 } // End of namespace UserPromptService

 // End of file