--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/persistentstorage/dbms/pcdbms/udbms/UD_OBSVR.CPP Fri Jan 22 11:06:30 2010 +0200
@@ -0,0 +1,109 @@
+// Copyright (c) 1998-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:
+// Client observer class
+//
+//
+
+#include "UD_STD.H"
+
+// Class RDbNotifier
+
+EXPORT_C TInt RDbNotifier::Open(RDbDatabase& aDatabase)
+/** Opens a DBMS change notifier on a database.
+
+Note that a notifier cannot be opened on a client side database.
+
+@param aDatabase The database to be observed.
+@return KErrNone if successful, otherwise another of the system-wide error
+codes. */
+ {
+ TRAPD(r,iNotifier=aDatabase.iDatabase->NotifierL());
+ return r;
+ }
+
+EXPORT_C void RDbNotifier::Close()
+/** Closes a DBMS change notifier. Any outstanding notification request is automatically
+cancelled.
+
+Note that this function can be called on a DBMS change notifier that has already
+been closed. */
+ {
+ iNotifier.Close();
+ }
+
+//LOCAL_C void Notify(RDbHandle<CDbNotifier>& aNotifier,TRequestStatus& aStatus,CDbNotifier::TType aType)
+// {
+// aNotifier->Notify(aType,aStatus);
+// }
+
+//EXPORT_C void RDbNotifier::NotifyUnlock(TRequestStatus& aStatus)
+///** Makes an asynchronous request for notification of a database event. All events,
+//including the release of all read locks, are reported.
+//
+//When a database event occurs, the request completes and the TRequestStatus
+//objectcontains one of the enumerators defined by the TEvent enumeration member.
+//
+//Alternatively, if an outstanding request is cancelled by a call to the Cancel()
+//member function of this class, then the request completes with KErrCancel.
+//
+//Only one notification request can be outstanding on this notifier at any one
+//time.
+//
+//Note that if further database events occur while a client is handling a request
+//completion, the notifier records the most significant database event and this
+//is signalled as soon as the client issues the next NotifyUnlock() or NotifyChange()
+//request.
+//
+//@param aStatus The request status object. If the request is cancelled, this
+//is set to KErrCancel. If the request completes normally, this is set to one
+//of the enumerator values defined by the TEvent enumeration member. */
+// {
+// ::Notify(iNotifier,aStatus,CDbNotifier::EUnlock);
+// }
+
+//EXPORT_C void RDbNotifier::NotifyChange(TRequestStatus& aStatus)
+///** Makes an asynchronous request for notification of changes to the database.
+//
+//All events which indicate a change to the database are reported; in practice,
+//this means all database events except RDbNotifier::EUnlock.
+//
+//When a change event occurs, the request completes and the TRequestStatus object
+//contains one of the appropriate enumerators defined by the TEvent enumeration
+//member.
+//
+//Alternatively, if an outstanding request is cancelled by a call to the Cancel()
+//member function of this class, then the request completes with KErrCancel.
+//
+//Only one notification request can be outstanding on this notifier at any one
+//time.
+//
+//Note that if further database events occur while a client is handling a request
+//completion, the notifier records the most significant database event and this
+//is signalled as soon as the client issues the next NotifyUnlock() or NotifyChange()
+//request.
+//
+//@param aStatus The request status object. If the request is cancelled, this
+//is set to KErrCancel. If the request completes normally, this is set to one
+//of the enumerator values defined by the TEvent enumeration member. */
+// {
+// ::Notify(iNotifier,aStatus,CDbNotifier::EChange);
+// }
+
+//EXPORT_C void RDbNotifier::Cancel()
+///** Cancels any outstanding notification request to this DBMS notifier.
+//
+//The outstanding request completes with a KErrCancel. */
+// {
+// iNotifier->Cancel();
+// }