blob: ff3217cd6a5e1036f5a05edd9b18b29ff36db175 (
plain)
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
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
// This file describes a central switchboard for notifications that might
// happen in various parts of the application, and allows users to register
// observers for various classes of events that they're interested in.
#ifndef CONTENT_PUBLIC_BROWSER_NOTIFICATION_SERVICE_H_
#define CONTENT_PUBLIC_BROWSER_NOTIFICATION_SERVICE_H_
#include "content/common/content_export.h"
#include "content/public/browser/notification_details.h"
#include "content/public/browser/notification_source.h"
namespace content {
class CONTENT_EXPORT NotificationService {
public:
// Returns the NotificationService object for the current thread, or NULL if
// none.
static NotificationService* current();
static NotificationService* Create();
virtual ~NotificationService() {}
// Synchronously posts a notification to all interested observers.
// Source is a reference to a NotificationSource object representing
// the object originating the notification (can be
// NotificationService::AllSources(), in which case
// only observers interested in all sources will be notified).
// Details is a reference to an object containing additional data about
// the notification. If no additional data is needed, NoDetails() is used.
// There is no particular order in which the observers will be notified.
virtual void Notify(int type,
const NotificationSource& source,
const NotificationDetails& details) = 0;
// Returns a NotificationSource that represents all notification sources
// (for the purpose of registering an observer for events from all sources).
static Source<void> AllSources() { return Source<void>(NULL); }
// Returns the same value as AllSources(). This function has semantic
// differences to the programmer: We have checked that this AllSources()
// usage is safe in the face of multiple profiles. Objects that were
// singletons now will always have multiple instances, one per browser
// context.
//
// Some usage is safe, where the Source is checked to see if it's a member of
// a container before use. But, we want the number of AllSources() calls to
// drop to almost nothing, because most usages are not multiprofile safe and
// were done because it was easier to listen to everything.
static Source<void> AllBrowserContextsAndSources() {
return Source<void>(NULL);
}
// Returns a NotificationDetails object that represents a lack of details
// associated with a notification. (This is effectively a null pointer.)
static Details<void> NoDetails() { return Details<void>(NULL); }
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_NOTIFICATION_SERVICE_H_
|
