Home | History | Annotate | Download | only in webdatabase
      1 /*
      2  * Copyright (C) 2012 Apple 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  * 1. Redistributions of source code must retain the above copyright
      8  *    notice, this list of conditions and the following disclaimer.
      9  * 2. Redistributions in binary form must reproduce the above copyright
     10  *    notice, this list of conditions and the following disclaimer in the
     11  *    documentation and/or other materials provided with the distribution.
     12  *
     13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
     14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
     17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
     18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
     19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
     20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
     21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     24  */
     25 
     26 #ifndef DatabaseManager_h
     27 #define DatabaseManager_h
     28 
     29 #include "modules/webdatabase/DatabaseContext.h"
     30 #include "modules/webdatabase/DatabaseError.h"
     31 #include "platform/heap/Handle.h"
     32 #include "wtf/Assertions.h"
     33 #include "wtf/Forward.h"
     34 #include "wtf/HashMap.h"
     35 #include "wtf/PassRefPtr.h"
     36 
     37 namespace blink {
     38 
     39 class Database;
     40 class DatabaseCallback;
     41 class DatabaseContext;
     42 class ExceptionState;
     43 class SecurityOrigin;
     44 class ExecutionContext;
     45 
     46 class DatabaseManager {
     47     WTF_MAKE_NONCOPYABLE(DatabaseManager); WTF_MAKE_FAST_ALLOCATED;
     48 public:
     49     static DatabaseManager& manager();
     50 
     51     // These 2 methods are for DatabaseContext (un)registration, and should only
     52     // be called by the DatabaseContext constructor and destructor.
     53     void registerDatabaseContext(DatabaseContext*);
     54     void unregisterDatabaseContext(DatabaseContext*);
     55 
     56 #if ENABLE(ASSERT)
     57     void didConstructDatabaseContext();
     58     void didDestructDatabaseContext();
     59 #else
     60     void didConstructDatabaseContext() { }
     61     void didDestructDatabaseContext() { }
     62 #endif
     63 
     64     static void throwExceptionForDatabaseError(DatabaseError, const String& errorMessage, ExceptionState&);
     65 
     66     PassRefPtrWillBeRawPtr<Database> openDatabase(ExecutionContext*, const String& name, const String& expectedVersion, const String& displayName, unsigned long estimatedSize, DatabaseCallback*, DatabaseError&, String& errorMessage);
     67 
     68     String fullPathForDatabase(SecurityOrigin*, const String& name, bool createIfDoesNotExist = true);
     69 
     70 private:
     71     DatabaseManager();
     72     ~DatabaseManager();
     73 
     74     // This gets a DatabaseContext for the specified ExecutionContext.
     75     // If one doesn't already exist, it will create a new one.
     76     DatabaseContext* databaseContextFor(ExecutionContext*);
     77     // This gets a DatabaseContext for the specified ExecutionContext if
     78     // it already exist previously. Otherwise, it returns 0.
     79     DatabaseContext* existingDatabaseContextFor(ExecutionContext*);
     80 
     81     PassRefPtrWillBeRawPtr<Database> openDatabaseInternal(ExecutionContext*,
     82         const String& name, const String& expectedVersion, const String& displayName,
     83         unsigned long estimatedSize, bool setVersionInNewDatabase, DatabaseError&, String& errorMessage);
     84 
     85     static void logErrorMessage(ExecutionContext*, const String& message);
     86 
     87     typedef WillBePersistentHeapHashMap<ExecutionContext*, RefPtrWillBeMember<DatabaseContext> > ContextMap;
     88     ContextMap m_contextMap;
     89 #if ENABLE(ASSERT)
     90     int m_databaseContextRegisteredCount;
     91     int m_databaseContextInstanceCount;
     92 #endif
     93 };
     94 
     95 } // namespace blink
     96 
     97 #endif // DatabaseManager_h
     98