IndexedDB: Implement spec updates to IDBTransaction.error
[WebKit-https.git] / Source / WebCore / Modules / indexeddb / IDBTransaction.h
1 /*
2  * Copyright (C) 2010 Google Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
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 AND ITS CONTRIBUTORS "AS IS" AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
16  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
17  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
18  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
19  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
20  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
21  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #ifndef IDBTransaction_h
27 #define IDBTransaction_h
28
29 #if ENABLE(INDEXED_DATABASE)
30
31 #include "ActiveDOMObject.h"
32 #include "DOMError.h"
33 #include "DOMStringList.h"
34 #include "Event.h"
35 #include "EventListener.h"
36 #include "EventNames.h"
37 #include "EventTarget.h"
38 #include "IDBMetadata.h"
39 #include "IDBTransactionBackendInterface.h"
40 #include "IDBTransactionCallbacks.h"
41 #include <wtf/HashSet.h>
42 #include <wtf/RefCounted.h>
43
44 namespace WebCore {
45
46 class IDBCursor;
47 class IDBDatabase;
48 class IDBObjectStore;
49
50 class IDBTransaction : public IDBTransactionCallbacks, public EventTarget, public ActiveDOMObject {
51 public:
52     enum Mode {
53         READ_ONLY = 0,
54         READ_WRITE = 1,
55         VERSION_CHANGE = 2
56     };
57
58     static PassRefPtr<IDBTransaction> create(ScriptExecutionContext*, PassRefPtr<IDBTransactionBackendInterface>, Mode, IDBDatabase*);
59     virtual ~IDBTransaction();
60
61     static const AtomicString& modeReadOnly();
62     static const AtomicString& modeReadWrite();
63     static const AtomicString& modeVersionChange();
64     static const AtomicString& modeReadOnlyLegacy();
65     static const AtomicString& modeReadWriteLegacy();
66
67     static Mode stringToMode(const String&, ExceptionCode&);
68     static const AtomicString& modeToString(Mode, ExceptionCode&);
69
70     IDBTransactionBackendInterface* backend() const;
71     bool isActive() const { return m_active; }
72     bool isFinished() const { return m_state == Finished; }
73     bool isReadOnly() const { return m_mode == READ_ONLY; }
74     bool isVersionChange() const { return m_mode == VERSION_CHANGE; }
75
76     // Implement the IDBTransaction IDL
77     const String& mode() const;
78     IDBDatabase* db() const { return m_database.get(); }
79     PassRefPtr<DOMError> error() const { return m_error; }
80     PassRefPtr<IDBObjectStore> objectStore(const String& name, ExceptionCode&);
81     void abort();
82
83     class OpenCursorNotifier {
84     public:
85         OpenCursorNotifier(PassRefPtr<IDBTransaction>, IDBCursor*);
86         ~OpenCursorNotifier();
87     private:
88         RefPtr<IDBTransaction> m_transaction;
89         IDBCursor* m_cursor;
90     };
91
92     void registerRequest(IDBRequest*);
93     void unregisterRequest(IDBRequest*);
94     void objectStoreCreated(const String&, PassRefPtr<IDBObjectStore>);
95     void objectStoreDeleted(const String&);
96     void setActive(bool);
97     void setError(PassRefPtr<DOMError>);
98
99     DEFINE_ATTRIBUTE_EVENT_LISTENER(abort);
100     DEFINE_ATTRIBUTE_EVENT_LISTENER(complete);
101     DEFINE_ATTRIBUTE_EVENT_LISTENER(error);
102
103     // IDBTransactionCallbacks
104     virtual void onAbort();
105     virtual void onComplete();
106
107     // EventTarget
108     virtual const AtomicString& interfaceName() const;
109     virtual ScriptExecutionContext* scriptExecutionContext() const;
110     virtual bool dispatchEvent(PassRefPtr<Event>);
111     bool dispatchEvent(PassRefPtr<Event> event, ExceptionCode& ec) { return EventTarget::dispatchEvent(event, ec); }
112
113     // ActiveDOMObject
114     virtual bool hasPendingActivity() const OVERRIDE;
115     virtual bool canSuspend() const OVERRIDE;
116     virtual void stop() OVERRIDE;
117
118     using RefCounted<IDBTransactionCallbacks>::ref;
119     using RefCounted<IDBTransactionCallbacks>::deref;
120
121 private:
122     IDBTransaction(ScriptExecutionContext*, PassRefPtr<IDBTransactionBackendInterface>, Mode, IDBDatabase*);
123
124     void enqueueEvent(PassRefPtr<Event>);
125     void closeOpenCursors();
126
127     void registerOpenCursor(IDBCursor*);
128     void unregisterOpenCursor(IDBCursor*);
129
130     // EventTarget
131     virtual void refEventTarget() { ref(); }
132     virtual void derefEventTarget() { deref(); }
133     virtual EventTargetData* eventTargetData();
134     virtual EventTargetData* ensureEventTargetData();
135
136     enum State {
137         Unused, // No requests have been made.
138         Used, // At least one request has been made.
139         Finishing, // In the process of aborting or completing.
140         Finished, // No more events will fire and no new requests may be filed.
141     };
142
143     RefPtr<IDBTransactionBackendInterface> m_backend;
144     RefPtr<IDBDatabase> m_database;
145     const Mode m_mode;
146     bool m_active;
147     State m_state;
148     bool m_contextStopped;
149     RefPtr<DOMError> m_error;
150
151     ListHashSet<IDBRequest*> m_requestList;
152
153     typedef HashMap<String, RefPtr<IDBObjectStore> > IDBObjectStoreMap;
154     IDBObjectStoreMap m_objectStoreMap;
155
156     typedef HashMap<RefPtr<IDBObjectStore>, IDBObjectStoreMetadata> IDBObjectStoreMetadataMap;
157     IDBObjectStoreMetadataMap m_objectStoreCleanupMap;
158
159     HashSet<IDBCursor*> m_openCursors;
160
161     EventTargetData m_eventTargetData;
162 };
163
164 } // namespace WebCore
165
166 #endif // ENABLE(INDEXED_DATABASE)
167
168 #endif // IDBTransaction_h