110204b2efe2f484859cab32b4c454f718b49291
[WebKit-https.git] / WebCore / platform / FileSystem.h
1 /*
2  * Copyright (C) 2007, 2008 Apple Inc. All rights reserved.
3  * Copyright (C) 2008 Collabora, Ltd. All rights reserved.
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  *
9  * 1.  Redistributions of source code must retain the above copyright
10  *     notice, this list of conditions and the following disclaimer. 
11  * 2.  Redistributions in binary form must reproduce the above copyright
12  *     notice, this list of conditions and the following disclaimer in the
13  *     documentation and/or other materials provided with the distribution. 
14  * 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of
15  *     its contributors may be used to endorse or promote products derived
16  *     from this software without specific prior written permission. 
17  *
18  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
19  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
21  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
22  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
23  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
24  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
25  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29  
30 #ifndef FileSystem_h
31 #define FileSystem_h
32
33 #if PLATFORM(GTK)
34 #include <gmodule.h>
35 #endif
36 #if PLATFORM(QT)
37 #include <QFile>
38 #include <QLibrary>
39 #if defined(Q_OS_WIN32)
40 #include <windows.h>
41 #endif
42 #if defined(Q_WS_MAC)
43 #include <CoreFoundation/CFBundle.h>
44 #endif
45 #endif
46
47 #include <time.h>
48
49 #include <wtf/Platform.h>
50 #include <wtf/Vector.h>
51
52 #include "KURL.h"
53 #include "PlatformString.h"
54
55 typedef const struct __CFData* CFDataRef;
56
57 #if PLATFORM(WIN_OS)
58 // These are to avoid including <winbase.h> in a header for Chromium
59 typedef void *HANDLE;
60 // Assuming STRICT
61 typedef struct HINSTANCE__* HINSTANCE;
62 typedef HINSTANCE HMODULE;
63 #endif
64
65 namespace WebCore {
66
67 class CString;
68
69 #if PLATFORM(QT)
70
71 typedef QFile* PlatformFileHandle;
72 const PlatformFileHandle invalidPlatformFileHandle = 0;
73 #if defined(Q_WS_MAC)
74 typedef CFBundleRef PlatformModule;
75 typedef unsigned PlatformModuleVersion;
76 #elif defined(Q_OS_WIN)
77 typedef HMODULE PlatformModule;
78 struct PlatformModuleVersion {
79     unsigned leastSig;
80     unsigned mostSig;
81
82     PlatformModuleVersion(unsigned)
83         : leastSig(0)
84         , mostSig(0)
85     {
86     }
87
88     PlatformModuleVersion(unsigned lsb, unsigned msb)
89         : leastSig(lsb)
90         , mostSig(msb)
91     {
92     }
93
94 };
95 #else
96 typedef QLibrary* PlatformModule;
97 typedef unsigned PlatformModuleVersion;
98 #endif
99
100 #elif PLATFORM(WIN_OS)
101 typedef HANDLE PlatformFileHandle;
102 typedef HMODULE PlatformModule;
103 // FIXME: -1 is INVALID_HANDLE_VALUE, defined in <winbase.h>. Chromium tries to
104 // avoid using Windows headers in headers.  We'd rather move this into the .cpp.
105 const PlatformFileHandle invalidPlatformFileHandle = reinterpret_cast<HANDLE>(-1);
106
107 struct PlatformModuleVersion {
108     unsigned leastSig;
109     unsigned mostSig;
110
111     PlatformModuleVersion(unsigned)
112         : leastSig(0)
113         , mostSig(0)
114     {
115     }
116
117     PlatformModuleVersion(unsigned lsb, unsigned msb)
118         : leastSig(lsb)
119         , mostSig(msb)
120     {
121     }
122
123 };
124 #else
125 typedef int PlatformFileHandle;
126 #if PLATFORM(GTK)
127 typedef GModule* PlatformModule;
128 #else
129 typedef void* PlatformModule;
130 #endif
131 const PlatformFileHandle invalidPlatformFileHandle = -1;
132
133 typedef unsigned PlatformModuleVersion;
134 #endif
135
136 bool fileExists(const String&);
137 bool deleteFile(const String&);
138 bool deleteEmptyDirectory(const String&);
139 bool getFileSize(const String&, long long& result);
140 bool getFileModificationTime(const String&, time_t& result);
141 String pathByAppendingComponent(const String& path, const String& component);
142 bool makeAllDirectories(const String& path);
143 String homeDirectoryPath();
144 String pathGetFileName(const String&);
145 String directoryName(const String&);
146
147 Vector<String> listDirectory(const String& path, const String& filter = String());
148
149 CString fileSystemRepresentation(const String&);
150
151 inline bool isHandleValid(const PlatformFileHandle& handle) { return handle != invalidPlatformFileHandle; }
152
153 // Prefix is what the filename should be prefixed with, not the full path.
154 CString openTemporaryFile(const char* prefix, PlatformFileHandle&);
155 void closeFile(PlatformFileHandle&);
156 int writeToFile(PlatformFileHandle, const char* data, int length);
157
158 // Methods for dealing with loadable modules
159 bool unloadModule(PlatformModule);
160
161 #if PLATFORM(WIN)
162 String localUserSpecificStorageDirectory();
163 String roamingUserSpecificStorageDirectory();
164
165 bool safeCreateFile(const String&, CFDataRef);
166 #endif
167
168 #if PLATFORM(GTK)
169 String filenameToString(const char*);
170 char* filenameFromString(const String&);
171 String filenameForDisplay(const String&);
172 #endif
173
174 #if PLATFORM(CHROMIUM)
175 String pathGetDisplayFileName(const String&);
176 String getAbsolutePath(const String&);
177 bool isDirectory(const String&);
178 KURL filePathToURL(const String&);
179 #endif
180
181 } // namespace WebCore
182
183 #endif // FileSystem_h