Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 /* | 1 /* |
| 2 * Copyright (C) 2008 Apple Inc. All Rights Reserved. | 2 * Copyright (C) 2008 Apple Inc. All Rights Reserved. |
| 3 * | 3 * |
| 4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
| 5 * modification, are permitted provided that the following conditions | 5 * modification, are permitted provided that the following conditions |
| 6 * are met: | 6 * are met: |
| 7 * 1. Redistributions of source code must retain the above copyright | 7 * 1. Redistributions of source code must retain the above copyright |
| 8 * notice, this list of conditions and the following disclaimer. | 8 * notice, this list of conditions and the following disclaimer. |
| 9 * 2. Redistributions in binary form must reproduce the above copyright | 9 * 2. Redistributions in binary form must reproduce the above copyright |
| 10 * notice, this list of conditions and the following disclaimer in the | 10 * notice, this list of conditions and the following disclaimer in the |
| (...skipping 29 matching lines...) Expand all Loading... | |
| 40 | 40 |
| 41 class File FINAL : public Blob { | 41 class File FINAL : public Blob { |
| 42 public: | 42 public: |
| 43 // AllContentTypes should only be used when the full path/name are trusted; otherwise, it could | 43 // AllContentTypes should only be used when the full path/name are trusted; otherwise, it could |
| 44 // allow arbitrary pages to determine what applications an user has installe d. | 44 // allow arbitrary pages to determine what applications an user has installe d. |
| 45 enum ContentTypeLookupPolicy { | 45 enum ContentTypeLookupPolicy { |
| 46 WellKnownContentTypes, | 46 WellKnownContentTypes, |
| 47 AllContentTypes, | 47 AllContentTypes, |
| 48 }; | 48 }; |
| 49 | 49 |
| 50 // The user should not be able to browse to some files, such as the ones gen erated by the Filesystem API. | |
|
tkent
2014/07/23 01:19:58
nit: I recommend to wrap code comments in 80 colu
pwnall-personal
2014/07/23 06:58:21
Done.
| |
| 51 enum UserVisibility { IsUserVisible, IsNotUserVisible }; | |
| 52 | |
| 50 static PassRefPtrWillBeRawPtr<File> create(const String& path, ContentTypeLo okupPolicy policy = WellKnownContentTypes) | 53 static PassRefPtrWillBeRawPtr<File> create(const String& path, ContentTypeLo okupPolicy policy = WellKnownContentTypes) |
| 51 { | 54 { |
| 52 return adoptRefWillBeNoop(new File(path, policy)); | 55 return adoptRefWillBeNoop(new File(path, policy, File::IsUserVisible)); |
| 53 } | 56 } |
| 54 | 57 |
| 55 static PassRefPtrWillBeRawPtr<File> create(const String& name, double modifi cationTime, PassRefPtr<BlobDataHandle> blobDataHandle) | 58 static PassRefPtrWillBeRawPtr<File> create(const String& name, double modifi cationTime, PassRefPtr<BlobDataHandle> blobDataHandle) |
| 56 { | 59 { |
| 57 return adoptRefWillBeNoop(new File(name, modificationTime, blobDataHandl e)); | 60 return adoptRefWillBeNoop(new File(name, modificationTime, blobDataHandl e)); |
| 58 } | 61 } |
| 59 | 62 |
| 60 // For deserialization. | 63 // For deserialization. |
| 61 static PassRefPtrWillBeRawPtr<File> create(const String& path, const String& name, const String& relativePath, bool hasSnaphotData, uint64_t size, double la stModified, PassRefPtr<BlobDataHandle> blobDataHandle) | 64 static PassRefPtrWillBeRawPtr<File> createFromSerialization(const String& pa th, const String& name, const String& relativePath, bool hasSnaphotData, uint64_ t size, double lastModified, PassRefPtr<BlobDataHandle> blobDataHandle) |
| 62 { | 65 { |
| 63 return adoptRefWillBeNoop(new File(path, name, relativePath, hasSnaphotD ata, size, lastModified, blobDataHandle)); | 66 return adoptRefWillBeNoop(new File(path, name, relativePath, hasSnaphotD ata, size, lastModified, blobDataHandle)); |
| 64 } | 67 } |
| 65 static PassRefPtrWillBeRawPtr<File> create(const String& path, const String& name, uint64_t size, double lastModified, PassRefPtr<BlobDataHandle> blobDataHa ndle) | 68 static PassRefPtrWillBeRawPtr<File> createFromIndexedSerialization(const Str ing& path, const String& name, uint64_t size, double lastModified, PassRefPtr<Bl obDataHandle> blobDataHandle) |
| 66 { | 69 { |
| 67 return adoptRefWillBeNoop(new File(path, name, String(), true, size, las tModified, blobDataHandle)); | 70 return adoptRefWillBeNoop(new File(path, name, String(), true, size, las tModified, blobDataHandle)); |
| 68 } | 71 } |
| 69 | 72 |
| 70 static PassRefPtrWillBeRawPtr<File> createWithRelativePath(const String& pat h, const String& relativePath); | 73 static PassRefPtrWillBeRawPtr<File> createWithRelativePath(const String& pat h, const String& relativePath); |
| 71 | 74 |
| 72 // If filesystem files live in the remote filesystem, the port might pass th e valid metadata (whose length field is non-negative) and cache in the File obje ct. | 75 // If filesystem files live in the remote filesystem, the port might pass th e valid metadata (whose length field is non-negative) and cache in the File obje ct. |
| 73 // | 76 // |
| 74 // Otherwise calling size(), lastModifiedTime() and slice() will synchronous ly query the file metadata. | 77 // Otherwise calling size(), lastModifiedTime() and slice() will synchronous ly query the file metadata. |
| 75 static PassRefPtrWillBeRawPtr<File> createForFileSystemFile(const String& na me, const FileMetadata& metadata) | 78 static PassRefPtrWillBeRawPtr<File> createForFileSystemFile(const String& na me, const FileMetadata& metadata) |
| 76 { | 79 { |
| 77 return adoptRefWillBeNoop(new File(name, metadata)); | 80 return adoptRefWillBeNoop(new File(name, metadata)); |
| 78 } | 81 } |
| 79 | 82 |
| 80 static PassRefPtrWillBeRawPtr<File> createForFileSystemFile(const KURL& url, const FileMetadata& metadata) | 83 static PassRefPtrWillBeRawPtr<File> createForFileSystemFile(const KURL& url, const FileMetadata& metadata) |
| 81 { | 84 { |
| 82 return adoptRefWillBeNoop(new File(url, metadata)); | 85 return adoptRefWillBeNoop(new File(url, metadata)); |
| 83 } | 86 } |
| 84 | 87 |
| 85 KURL fileSystemURL() const { ASSERT(hasValidFileSystemURL()); return m_fileS ystemURL; } | 88 KURL fileSystemURL() const { ASSERT(hasValidFileSystemURL()); return m_fileS ystemURL; } |
| 86 | 89 |
| 87 // Create a file with a name exposed to the author (via File.name and associ ated DOM properties) that differs from the one provided in the path. | 90 // Create a file with a name exposed to the author (via File.name and associ ated DOM properties) that differs from the one provided in the path. |
| 88 static PassRefPtrWillBeRawPtr<File> createWithName(const String& path, const String& name, ContentTypeLookupPolicy policy = WellKnownContentTypes) | 91 static PassRefPtrWillBeRawPtr<File> createWithName(const String& path, const String& name, ContentTypeLookupPolicy policy = WellKnownContentTypes) |
| 89 { | 92 { |
| 90 if (name.isEmpty()) | 93 if (name.isEmpty()) |
| 91 return adoptRefWillBeNoop(new File(path, policy)); | 94 return adoptRefWillBeNoop(new File(path, policy, File::IsUserVisible )); |
| 92 return adoptRefWillBeNoop(new File(path, name, policy)); | 95 return adoptRefWillBeNoop(new File(path, name, policy, File::IsUserVisib le)); |
| 96 } | |
| 97 | |
| 98 static PassRefPtrWillBeRawPtr<File> createForFileSystemFile(const String& pa th, const String& name, ContentTypeLookupPolicy policy = WellKnownContentTypes) | |
| 99 { | |
| 100 if (name.isEmpty()) | |
| 101 return adoptRefWillBeNoop(new File(path, policy, File::IsNotUserVisi ble)); | |
| 102 return adoptRefWillBeNoop(new File(path, name, policy, File::IsNotUserVi sible)); | |
| 93 } | 103 } |
| 94 | 104 |
| 95 virtual unsigned long long size() const OVERRIDE; | 105 virtual unsigned long long size() const OVERRIDE; |
| 96 virtual PassRefPtrWillBeRawPtr<Blob> slice(long long start, long long end, c onst String& contentType, ExceptionState&) const OVERRIDE; | 106 virtual PassRefPtrWillBeRawPtr<Blob> slice(long long start, long long end, c onst String& contentType, ExceptionState&) const OVERRIDE; |
| 97 virtual void close(ExecutionContext*, ExceptionState&) OVERRIDE; | 107 virtual void close(ExecutionContext*, ExceptionState&) OVERRIDE; |
| 98 | 108 |
| 99 virtual bool isFile() const OVERRIDE { return true; } | 109 virtual bool isFile() const OVERRIDE { return true; } |
| 100 virtual bool hasBackingFile() const OVERRIDE { return m_hasBackingFile; } | 110 virtual bool hasBackingFile() const OVERRIDE { return m_hasBackingFile; } |
| 101 | 111 |
| 102 virtual void appendTo(BlobData&) const OVERRIDE; | 112 virtual void appendTo(BlobData&) const OVERRIDE; |
| 103 | 113 |
| 104 const String& path() const { ASSERT(hasValidFilePath()); return m_path; } | 114 const String& path() const { ASSERT(hasValidFilePath()); return m_path; } |
| 105 const String name() const { return m_name; } | 115 const String name() const { return m_name; } |
| 106 | 116 |
| 107 // This returns the current date and time if the file's last modification da te is not known (per spec: http://www.w3.org/TR/FileAPI/#dfn-lastModifiedDate). | 117 // This returns the current date and time if the file's last modification da te is not known (per spec: http://www.w3.org/TR/FileAPI/#dfn-lastModifiedDate). |
| 108 double lastModifiedDate() const; | 118 double lastModifiedDate() const; |
| 109 | 119 |
| 120 UserVisibility userVisibility() const { return m_userVisibility; } | |
| 121 | |
| 110 // Returns the relative path of this file in the context of a directory sele ction. | 122 // Returns the relative path of this file in the context of a directory sele ction. |
| 111 const String& webkitRelativePath() const { return m_relativePath; } | 123 const String& webkitRelativePath() const { return m_relativePath; } |
| 112 | 124 |
| 113 // Note that this involves synchronous file operation. Think twice before ca lling this function. | 125 // Note that this involves synchronous file operation. Think twice before ca lling this function. |
| 114 void captureSnapshot(long long& snapshotSize, double& snapshotModificationTi me) const; | 126 void captureSnapshot(long long& snapshotSize, double& snapshotModificationTi me) const; |
| 115 | 127 |
| 116 // Returns true if this has a valid snapshot metadata (i.e. m_snapshotSize > = 0). | 128 // Returns true if this has a valid snapshot metadata (i.e. m_snapshotSize > = 0). |
| 117 bool hasValidSnapshotMetadata() const { return m_snapshotSize >= 0; } | 129 bool hasValidSnapshotMetadata() const { return m_snapshotSize >= 0; } |
| 118 | 130 |
| 119 private: | 131 private: |
| 120 File(const String& path, ContentTypeLookupPolicy); | 132 File(const String& path, ContentTypeLookupPolicy, UserVisibility); |
| 121 File(const String& path, const String& name, ContentTypeLookupPolicy); | 133 File(const String& path, const String& name, ContentTypeLookupPolicy, UserVi sibility); |
| 122 File(const String& path, const String& name, const String& relativePath, boo l hasSnaphotData, uint64_t size, double lastModified, PassRefPtr<BlobDataHandle> ); | 134 File(const String& path, const String& name, const String& relativePath, boo l hasSnaphotData, uint64_t size, double lastModified, PassRefPtr<BlobDataHandle> ); |
| 123 File(const String& name, double modificationTime, PassRefPtr<BlobDataHandle> ); | 135 File(const String& name, double modificationTime, PassRefPtr<BlobDataHandle> ); |
| 124 File(const String& name, const FileMetadata&); | 136 File(const String& name, const FileMetadata&); |
| 125 File(const KURL& fileSystemURL, const FileMetadata&); | 137 File(const KURL& fileSystemURL, const FileMetadata&); |
| 126 | 138 |
| 127 void invalidateSnapshotMetadata() { m_snapshotSize = -1; } | 139 void invalidateSnapshotMetadata() { m_snapshotSize = -1; } |
| 128 | 140 |
| 129 #if ENABLE(ASSERT) | 141 #if ENABLE(ASSERT) |
| 130 bool hasValidFileSystemURL() const { return hasBackingFile(); } | 142 bool hasValidFileSystemURL() const { return hasBackingFile(); } |
| 131 // Instances not backed by a file must have an empty path set. | 143 // Instances not backed by a file must have an empty path set. |
| 132 bool hasValidFilePath() const { return hasBackingFile() || m_path.isEmpty(); } | 144 bool hasValidFilePath() const { return hasBackingFile() || m_path.isEmpty(); } |
| 133 #endif | 145 #endif |
| 134 | 146 |
| 135 bool m_hasBackingFile; | 147 bool m_hasBackingFile; |
| 148 UserVisibility m_userVisibility; | |
| 136 String m_path; | 149 String m_path; |
| 137 String m_name; | 150 String m_name; |
| 138 | 151 |
| 139 KURL m_fileSystemURL; | 152 KURL m_fileSystemURL; |
| 140 | 153 |
| 141 // If m_snapshotSize is negative (initialized to -1 by default), the snapsho t metadata is invalid and we retrieve the latest metadata synchronously in size( ), lastModifiedTime() and slice(). | 154 // If m_snapshotSize is negative (initialized to -1 by default), the snapsho t metadata is invalid and we retrieve the latest metadata synchronously in size( ), lastModifiedTime() and slice(). |
| 142 // Otherwise, the snapshot metadata are used directly in those methods. | 155 // Otherwise, the snapshot metadata are used directly in those methods. |
| 143 long long m_snapshotSize; | 156 long long m_snapshotSize; |
| 144 const double m_snapshotModificationTime; | 157 const double m_snapshotModificationTime; |
| 145 | 158 |
| 146 String m_relativePath; | 159 String m_relativePath; |
| 147 }; | 160 }; |
| 148 | 161 |
| 149 DEFINE_TYPE_CASTS(File, Blob, blob, blob->isFile(), blob.isFile()); | 162 DEFINE_TYPE_CASTS(File, Blob, blob, blob->isFile(), blob.isFile()); |
| 150 | 163 |
| 151 } // namespace WebCore | 164 } // namespace WebCore |
| 152 | 165 |
| 153 #endif // File_h | 166 #endif // File_h |
| OLD | NEW |