intl/icu/source/common/servnotf.h@129ffea94266
intl/icu/source/common/servnotf.h
Sat, 03 Jan 2015 20:18:00 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Sat, 03 Jan 2015 20:18:00 +0100
- branch
- TOR_BUG_3246
- changeset 7
- 129ffea94266
- permissions
- -rw-r--r--
Conditionally enable double key logic according to:
private browsing mode or privacy.thirdparty.isolate preference and
implement in GetCookieStringCommon and FindCookie where it counts...
With some reservations of how to convince FindCookie users to test
condition and pass a nullptr when disabling double key logic.
1 /**
2 *******************************************************************************
3 * Copyright (C) 2001-2011, International Business Machines Corporation and *
4 * others. All Rights Reserved. *
5 *******************************************************************************
6 */
7 #ifndef ICUNOTIF_H
8 #define ICUNOTIF_H
10 #include "unicode/utypes.h"
12 #if UCONFIG_NO_SERVICE
14 U_NAMESPACE_BEGIN
16 /*
17 * Allow the declaration of APIs with pointers to BreakIterator
18 * even when break iteration is removed from the build.
19 */
20 class ICUNotifier;
22 U_NAMESPACE_END
24 #else
26 #include "unicode/uobject.h"
27 #include "unicode/unistr.h"
29 #include "mutex.h"
30 #include "uvector.h"
32 U_NAMESPACE_BEGIN
34 class U_COMMON_API EventListener : public UObject {
35 public:
36 virtual ~EventListener();
38 public:
39 static UClassID U_EXPORT2 getStaticClassID();
41 virtual UClassID getDynamicClassID() const;
43 public:
44 #ifdef SERVICE_DEBUG
45 virtual UnicodeString& debug(UnicodeString& result) const {
46 return debugClass(result);
47 }
49 virtual UnicodeString& debugClass(UnicodeString& result) const {
50 return result.append("Key");
51 }
52 #endif
53 };
55 /**
56 * <p>Abstract implementation of a notification facility. Clients add
57 * EventListeners with addListener and remove them with removeListener.
58 * Notifiers call notifyChanged when they wish to notify listeners.
59 * This queues the listener list on the notification thread, which
60 * eventually dequeues the list and calls notifyListener on each
61 * listener in the list.</p>
62 *
63 * <p>Subclasses override acceptsListener and notifyListener
64 * to add type-safe notification. AcceptsListener should return
65 * true if the listener is of the appropriate type; ICUNotifier
66 * itself will ensure the listener is non-null and that the
67 * identical listener is not already registered with the Notifier.
68 * NotifyListener should cast the listener to the appropriate
69 * type and call the appropriate method on the listener.
70 */
72 class U_COMMON_API ICUNotifier : public UMemory {
73 private: UVector* listeners;
75 public:
76 ICUNotifier(void);
78 virtual ~ICUNotifier(void);
80 /**
81 * Add a listener to be notified when notifyChanged is called.
82 * The listener must not be null. AcceptsListener must return
83 * true for the listener. Attempts to concurrently
84 * register the identical listener more than once will be
85 * silently ignored.
86 */
87 virtual void addListener(const EventListener* l, UErrorCode& status);
89 /**
90 * Stop notifying this listener. The listener must
91 * not be null. Attemps to remove a listener that is
92 * not registered will be silently ignored.
93 */
94 virtual void removeListener(const EventListener* l, UErrorCode& status);
96 /**
97 * ICU doesn't spawn its own threads. All listeners are notified in
98 * the thread of the caller. Misbehaved listeners can therefore
99 * indefinitely block the calling thread. Callers should beware of
100 * deadlock situations.
101 */
102 virtual void notifyChanged(void);
104 protected:
105 /**
106 * Subclasses implement this to return TRUE if the listener is
107 * of the appropriate type.
108 */
109 virtual UBool acceptsListener(const EventListener& l) const = 0;
111 /**
112 * Subclasses implement this to notify the listener.
113 */
114 virtual void notifyListener(EventListener& l) const = 0;
115 };
117 U_NAMESPACE_END
119 /* UCONFIG_NO_SERVICE */
120 #endif
122 /* ICUNOTIF_H */
123 #endif
