/usr/include/sipxtapi/utl/UtlObservable.h is in libsipxtapi-dev 3.3.0~test17-2.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 | //
// Copyright (C) 2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2006 Pingtel Corp. All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
///////////////////////////////////////////////////////////////////////////////
class UtlObservable;
/**
* Generic interface for any object which is an observer
* of an observable.
*/
class UtlObserver
{
public:
virtual ~UtlObserver(){};
/**
* Notification method which the observer must implement. The
* observable's (also, subject) responsibility is to notify
* the observers of state changes. The observable will notify
* the observers by invoking this onNotify method.
*
* @param subject The observable which invoked this method.
* @param code An integer notification value. For example, it
* can be used to indicate the observable's state.
* @param pUserData A reference to any object that the observable may
* pass to the observer.
*/
virtual void onNotify(UtlObservable* subject, int code, void *pUserData) = 0;
};
/**
* Simple interface for any object which is observable,
* meaning that observers can register to be notified
* of the observable's state changes.
*/
class UtlObservable
{
public:
virtual ~UtlObservable(){};
/**
* Registers a listener of this observable.
* Derived classes of UtlObservable should store
* its observers in a collection.
*
* @param observer The observer that wants to "listen to"
* this observable's state changes.
*/
virtual void registerObserver(UtlObserver* observer) = 0;
/**
* Removes a listener of this observable.
* Derived classes of UtlObservable should remove
* this observer from it's collection.
*
* @param observer The observer that no longer wants to "listen to"
* this observable's state changes.
*/
virtual void removeObserver(UtlObserver* observer) = 0;
protected:
/**
* The observable calls this to notify its
* observers of a change.
* Derived classes should iterate through their collection
* of observers and call UtlObserver->onNotify .
*
* @param code An integer notification value. For example, it
* can be used to indicate the observable's state.
* @param pUserData A reference to any object that the observable may
* pass to the observer.
*/
virtual void notify(int code, void *pUserData) = 0;
};
|