536ee41f8ded4206a2e79174aacf8abae7ed0590
[WebKit-https.git] / Source / WebCore / Modules / geolocation / Geolocation.h
1 /*
2  * Copyright (C) 2008, 2009, 2010, 2011 Apple Inc. All Rights Reserved.
3  * Copyright 2010, The Android Open Source Project
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
25  */
26
27 #pragma once
28
29 #if ENABLE(GEOLOCATION)
30
31 #include "ActiveDOMObject.h"
32 #include "Document.h"
33 #include "GeolocationPosition.h"
34 #include "GeolocationPositionError.h"
35 #include "PositionCallback.h"
36 #include "PositionErrorCallback.h"
37 #include "PositionOptions.h"
38 #include "ScriptWrappable.h"
39 #include "Timer.h"
40 #include <wtf/HashMap.h>
41 #include <wtf/HashSet.h>
42
43 namespace WebCore {
44
45 class Frame;
46 class GeoNotifier;
47 class GeolocationError;
48 class Navigator;
49 class Page;
50 class ScriptExecutionContext;
51 class SecurityOrigin;
52 struct PositionOptions;
53
54 class Geolocation final : public ScriptWrappable, public RefCounted<Geolocation>, public ActiveDOMObject {
55     WTF_MAKE_ISO_ALLOCATED_EXPORT(Geolocation, WEBCORE_EXPORT);
56     friend class GeoNotifier;
57 public:
58     static Ref<Geolocation> create(Navigator&);
59     WEBCORE_EXPORT ~Geolocation();
60
61     WEBCORE_EXPORT void resetAllGeolocationPermission();
62     Document* document() const { return downcast<Document>(scriptExecutionContext()); }
63
64     void getCurrentPosition(Ref<PositionCallback>&&, RefPtr<PositionErrorCallback>&&, PositionOptions&&);
65     int watchPosition(Ref<PositionCallback>&&, RefPtr<PositionErrorCallback>&&, PositionOptions&&);
66     void clearWatch(int watchID);
67
68     WEBCORE_EXPORT void setIsAllowed(bool);
69     void resetIsAllowed() { m_allowGeolocation = Unknown; }
70     bool isAllowed() const { return m_allowGeolocation == Yes; }
71
72     void positionChanged();
73     void setError(GeolocationError&);
74     bool shouldBlockGeolocationRequests();
75
76     Navigator* navigator();
77     WEBCORE_EXPORT Frame* frame() const;
78
79 private:
80     explicit Geolocation(Navigator&);
81
82     GeolocationPosition* lastPosition();
83
84     // ActiveDOMObject
85     void stop() override;
86     bool canSuspendForDocumentSuspension() const override;
87     void suspend(ReasonForSuspension) override;
88     void resume() override;
89     const char* activeDOMObjectName() const override;
90
91     bool isDenied() const { return m_allowGeolocation == No; }
92
93     Page* page() const;
94     SecurityOrigin* securityOrigin() const;
95
96     typedef Vector<RefPtr<GeoNotifier>> GeoNotifierVector;
97     typedef HashSet<RefPtr<GeoNotifier>> GeoNotifierSet;
98
99     class Watchers {
100     public:
101         bool add(int id, RefPtr<GeoNotifier>&&);
102         GeoNotifier* find(int id);
103         void remove(int id);
104         void remove(GeoNotifier*);
105         bool contains(GeoNotifier*) const;
106         void clear();
107         bool isEmpty() const;
108         void getNotifiersVector(GeoNotifierVector&) const;
109     private:
110         typedef HashMap<int, RefPtr<GeoNotifier>> IdToNotifierMap;
111         typedef HashMap<RefPtr<GeoNotifier>, int> NotifierToIdMap;
112         IdToNotifierMap m_idToNotifierMap;
113         NotifierToIdMap m_notifierToIdMap;
114     };
115
116     bool hasListeners() const { return !m_oneShots.isEmpty() || !m_watchers.isEmpty(); }
117
118     void sendError(GeoNotifierVector&, GeolocationPositionError&);
119     void sendPosition(GeoNotifierVector&, GeolocationPosition&);
120
121     static void extractNotifiersWithCachedPosition(GeoNotifierVector& notifiers, GeoNotifierVector* cached);
122     static void copyToSet(const GeoNotifierVector&, GeoNotifierSet&);
123
124     static void stopTimer(GeoNotifierVector&);
125     void stopTimersForOneShots();
126     void stopTimersForWatchers();
127     void stopTimers();
128
129     void cancelRequests(GeoNotifierVector&);
130     void cancelAllRequests();
131
132     void makeSuccessCallbacks(GeolocationPosition&);
133     void handleError(GeolocationPositionError&);
134
135     void requestPermission();
136
137     bool startUpdating(GeoNotifier*);
138     void stopUpdating();
139
140     void handlePendingPermissionNotifiers();
141
142     void startRequest(GeoNotifier*);
143
144     void fatalErrorOccurred(GeoNotifier*);
145     void requestTimedOut(GeoNotifier*);
146     void requestUsesCachedPosition(GeoNotifier*);
147     bool haveSuitableCachedPosition(const PositionOptions&);
148     void makeCachedPositionCallbacks();
149
150     void resumeTimerFired();
151
152     WeakPtr<Navigator> m_navigator;
153     GeoNotifierSet m_oneShots;
154     Watchers m_watchers;
155     GeoNotifierSet m_pendingForPermissionNotifiers;
156     RefPtr<GeolocationPosition> m_lastPosition;
157
158     enum { Unknown, InProgress, Yes, No } m_allowGeolocation { Unknown };
159     bool m_isSuspended { false };
160     bool m_resetOnResume { false };
161     bool m_hasChangedPosition { false };
162     RefPtr<GeolocationPositionError> m_errorWaitingForResume;
163     Timer m_resumeTimer;
164     GeoNotifierSet m_requestsAwaitingCachedPosition;
165 };
166     
167 } // namespace WebCore
168
169 #endif // ENABLE(GEOLOCATION)