--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/persistentstorage/dbms/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();
+ }