From 586acc5fe142f498261f52c66862fa417c3d52d2 Mon Sep 17 00:00:00 2001 From: "initial.commit" Date: Sat, 26 Jul 2008 22:42:52 +0000 Subject: Add net to the repository. git-svn-id: svn://svn.chromium.org/chrome/trunk/src@14 0039d316-1c4b-4281-b951-d872f2087c98 --- net/disk_cache/file.h | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 net/disk_cache/file.h (limited to 'net/disk_cache/file.h') diff --git a/net/disk_cache/file.h b/net/disk_cache/file.h new file mode 100644 index 0000000..db42026 --- /dev/null +++ b/net/disk_cache/file.h @@ -0,0 +1,112 @@ +// Copyright 2008, Google Inc. +// All rights reserved. +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// See net/disk_cache/disk_cache.h for the public interface of the cache. + +#ifndef NET_DISK_CACHE_FILE_H__ +#define NET_DISK_CACHE_FILE_H__ + +#include "base/ref_counted.h" + +namespace disk_cache { + +// This interface is used to support asynchronous ReadData and WriteData calls. +class FileIOCallback { + public: + // Notified of the actual number of bytes read or written. This value is + // negative if an error occurred. + virtual void OnFileIOComplete(int bytes_copied) = 0; +}; + +// Simple wrapper around a file that allows asynchronous operations. +class File : public base::RefCounted { + friend class base::RefCounted; + public: + File() : init_(false), mixed_(false) {} + // mixed_mode set to true enables regular synchronous operations for the file. + explicit File(bool mixed_mode) : init_(false), mixed_(mixed_mode) {} + + // Initializes the object to point to a given file. The file must aready exist + // on disk, and allow shared read and write. + bool Init(const std::wstring name); + +#ifdef WIN32 + HANDLE handle() const { + return handle_; + } +#else + int file_descriptor() const { + return file_descriptor_; + } +#endif + + // Performs synchronous IO. + bool Read(void* buffer, size_t buffer_len, size_t offset); + bool Write(const void* buffer, size_t buffer_len, size_t offset); + + // Performs asynchronous IO. callback will be called when the IO completes, + // as an APC on the thread that queued the operation. + bool Read(void* buffer, size_t buffer_len, size_t offset, + FileIOCallback* callback, bool* completed); + bool Write(const void* buffer, size_t buffer_len, size_t offset, + FileIOCallback* callback, bool* completed); + + // Performs asynchronous writes, but doesn't notify when done. Automatically + // deletes buffer when done. + bool PostWrite(const void* buffer, size_t buffer_len, size_t offset); + + // Sets the file's length. The file is truncated or extended with zeros to + // the new length. + bool SetLength(size_t length); + size_t GetLength(); + + protected: + virtual ~File(); + + // Performs the actual asynchronous write. If notify is set and there is no + // callback, the call will be re-synchronized. + bool AsyncWrite(const void* buffer, size_t buffer_len, size_t offset, + bool notify, FileIOCallback* callback, bool* completed); + + private: + bool init_; + bool mixed_; +#ifdef WIN32 + HANDLE handle_; // Regular, asynchronous IO handle. + HANDLE sync_handle_; // Synchronous IO hanlde. +#else + int file_descriptor_; +#endif + + DISALLOW_EVIL_CONSTRUCTORS(File); +}; + +} // namespace disk_cache + +#endif // NET_DISK_CACHE_FILE_H__ -- cgit v1.1