/////////////////////////////////////////////////////////////////////////////
-// Name: filesys.h
+// Name: wx/filesys.h
// Purpose: class for opening files - virtual file system
// Author: Vaclav Slavik
// Copyright: (c) 1999 Vaclav Slavik
// RCS-ID: $Id$
-// Licence: wxWindows Licence
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#ifndef __FILESYS_H__
#define __FILESYS_H__
-#ifdef __GNUG__
-#pragma interface
+#include "wx/defs.h"
+
+#if !wxUSE_STREAMS
+#error You cannot compile virtual file systems without wxUSE_STREAMS
#endif
-#include "wx/setup.h"
+#if wxUSE_HTML && !wxUSE_FILESYSTEM
+#error You cannot compile wxHTML without virtual file systems
+#endif
-#if (wxUSE_HTML || wxUSE_FS_INET || wxUSE_FS_ZIP) && wxUSE_STREAMS
+#if wxUSE_FILESYSTEM
#include "wx/stream.h"
-#include "wx/url.h"
#include "wx/datetime.h"
+#include "wx/filename.h"
+#include "wx/hashmap.h"
-class wxFSFile;
-class wxFileSystemHandler;
-class wxFileSystem;
+class WXDLLIMPEXP_BASE wxFSFile;
+class WXDLLIMPEXP_BASE wxFileSystemHandler;
+class WXDLLIMPEXP_BASE wxFileSystem;
//--------------------------------------------------------------------------------
// wxFSFile
// (in 'index.htm#chapter2', 'chapter2' is anchor)
//--------------------------------------------------------------------------------
-class WXDLLEXPORT wxFSFile : public wxObject
+class WXDLLIMPEXP_BASE wxFSFile : public wxObject
{
- private:
- wxInputStream *m_Stream;
- wxString m_Location;
- wxString m_MimeType;
- wxString m_Anchor;
- wxDateTime m_Modif;
-
- public:
- wxFSFile(wxInputStream *stream, const wxString& loc,
- const wxString& mimetype, const wxString& anchor,
- wxDateTime modif)
- {
- m_Stream = stream;
- m_Location = loc;
- m_MimeType = mimetype; m_MimeType.MakeLower();
- m_Anchor = anchor;
- m_Modif = modif;
- }
- virtual ~wxFSFile()
- {
- if (m_Stream) delete m_Stream;
- }
-
- wxInputStream *GetStream() const {return m_Stream;}
- // returns stream. This doesn't _create_ stream, it only returns
- // pointer to it!!
-
- const wxString& GetMimeType() const {return m_MimeType;}
- // returns file's mime type
-
- const wxString& GetLocation() const {return m_Location;}
- // returns the original location (aka filename) of the file
-
- const wxString& GetAnchor() const {return m_Anchor;}
-
- wxDateTime GetModificationTime() const {return m_Modif;}
+public:
+ wxFSFile(wxInputStream *stream, const wxString& loc,
+ const wxString& mimetype, const wxString& anchor
+#if wxUSE_DATETIME
+ , wxDateTime modif
+#endif // wxUSE_DATETIME
+ )
+ {
+ m_Stream = stream;
+ m_Location = loc;
+ m_MimeType = mimetype.Lower();
+ m_Anchor = anchor;
+#if wxUSE_DATETIME
+ m_Modif = modif;
+#endif // wxUSE_DATETIME
+ }
+
+ virtual ~wxFSFile() { delete m_Stream; }
+
+ // returns stream. This doesn't give away ownership of the stream object.
+ wxInputStream *GetStream() const { return m_Stream; }
+
+ // gives away the ownership of the current stream.
+ wxInputStream *DetachStream()
+ {
+ wxInputStream *stream = m_Stream;
+ m_Stream = NULL;
+ return stream;
+ }
+
+ // deletes the current stream and takes ownership of another.
+ void SetStream(wxInputStream *stream)
+ {
+ delete m_Stream;
+ m_Stream = stream;
+ }
+
+ // returns file's mime type
+ const wxString& GetMimeType() const;
+
+ // returns the original location (aka filename) of the file
+ const wxString& GetLocation() const { return m_Location; }
+
+ const wxString& GetAnchor() const { return m_Anchor; }
+
+#if wxUSE_DATETIME
+ wxDateTime GetModificationTime() const { return m_Modif; }
+#endif // wxUSE_DATETIME
+
+private:
+ wxInputStream *m_Stream;
+ wxString m_Location;
+ wxString m_MimeType;
+ wxString m_Anchor;
+#if wxUSE_DATETIME
+ wxDateTime m_Modif;
+#endif // wxUSE_DATETIME
+
+ DECLARE_ABSTRACT_CLASS(wxFSFile)
+ DECLARE_NO_COPY_CLASS(wxFSFile)
};
// kinds of files (HTPP, FTP, local, tar.gz etc..)
//--------------------------------------------------------------------------------
-class WXDLLEXPORT wxFileSystemHandler : public wxObject
+class WXDLLIMPEXP_BASE wxFileSystemHandler : public wxObject
{
- DECLARE_ABSTRACT_CLASS(wxFileSystemHandler)
+public:
+ wxFileSystemHandler() : wxObject() {}
+
+ // returns true if this handler is able to open given location
+ virtual bool CanOpen(const wxString& location) = 0;
+
+ // opens given file and returns pointer to input stream.
+ // Returns NULL if opening failed.
+ // The location is always absolute path.
+ virtual wxFSFile* OpenFile(wxFileSystem& fs, const wxString& location) = 0;
+
+ // Finds first/next file that matches spec wildcard. flags can be wxDIR for restricting
+ // the query to directories or wxFILE for files only or 0 for either.
+ // Returns filename or empty string if no more matching file exists
+ virtual wxString FindFirst(const wxString& spec, int flags = 0);
+ virtual wxString FindNext();
+
+ // Returns MIME type of the file - w/o need to open it
+ // (default behaviour is that it returns type based on extension)
+ static wxString GetMimeTypeFromExt(const wxString& location);
+
+protected:
+ // returns protocol ("file", "http", "tar" etc.) The last (most right)
+ // protocol is used:
+ // {it returns "tar" for "file:subdir/archive.tar.gz#tar:/README.txt"}
+ static wxString GetProtocol(const wxString& location);
+
+ // returns left part of address:
+ // {it returns "file:subdir/archive.tar.gz" for "file:subdir/archive.tar.gz#tar:/README.txt"}
+ static wxString GetLeftLocation(const wxString& location);
+
+ // returns anchor part of address:
+ // {it returns "anchor" for "file:subdir/archive.tar.gz#tar:/README.txt#anchor"}
+ // NOTE: anchor is NOT a part of GetLeftLocation()'s return value
+ static wxString GetAnchor(const wxString& location);
+
+ // returns right part of address:
+ // {it returns "/README.txt" for "file:subdir/archive.tar.gz#tar:/README.txt"}
+ static wxString GetRightLocation(const wxString& location);
- public:
- wxFileSystemHandler() : wxObject() {}
-
- virtual bool CanOpen(const wxString& location) = 0;
- // returns TRUE if this handler is able to open given location
-
- virtual wxFSFile* OpenFile(wxFileSystem& fs, const wxString& location) = 0;
- // opens given file and returns pointer to input stream.
- // Returns NULL if opening failed.
- // The location is always absolute path.
-
- virtual wxString FindFirst(const wxString& spec, int flags = 0);
- virtual wxString FindNext();
- // Finds first/next file that matches spec wildcard. flags can be wxDIR for restricting
- // the query to directories or wxFILE for files only or 0 for either.
- // Returns filename or empty string if no more matching file exists
-
- protected:
- wxString GetProtocol(const wxString& location) const;
- // returns protocol ("file", "http", "tar" etc.) The last (most right)
- // protocol is used:
- // {it returns "tar" for "file:subdir/archive.tar.gz#tar:/README.txt"}
-
- wxString GetLeftLocation(const wxString& location) const;
- // returns left part of address:
- // {it returns "file:subdir/archive.tar.gz" for "file:subdir/archive.tar.gz#tar:/README.txt"}
-
- wxString GetAnchor(const wxString& location) const;
- // returns anchor part of address:
- // {it returns "anchor" for "file:subdir/archive.tar.gz#tar:/README.txt#anchor"}
- // NOTE: anchor is NOT a part of GetLeftLocation()'s return value
-
- wxString GetRightLocation(const wxString& location) const;
- // returns right part of address:
- // {it returns "/README.txt" for "file:subdir/archive.tar.gz#tar:/README.txt"}
-
- wxString GetMimeTypeFromExt(const wxString& location);
- // Returns MIME type of the file - w/o need to open it
- // (default behaviour is that it returns type based on extension)
+ DECLARE_ABSTRACT_CLASS(wxFileSystemHandler)
};
// kinds of files (HTPP, FTP, local, tar.gz etc..)
//--------------------------------------------------------------------------------
-class WXDLLEXPORT wxFileSystem : public wxObject
+// Open Bit Flags
+enum {
+ wxFS_READ = 1, // Open for reading
+ wxFS_SEEKABLE = 4 // Returned stream will be seekable
+};
+
+WX_DECLARE_VOIDPTR_HASH_MAP_WITH_DECL(wxFileSystemHandler*, wxFSHandlerHash, class WXDLLIMPEXP_BASE);
+
+class WXDLLIMPEXP_BASE wxFileSystem : public wxObject
{
- DECLARE_DYNAMIC_CLASS(wxFileSystem)
+public:
+ wxFileSystem() : wxObject() { m_FindFileHandler = NULL;}
+ virtual ~wxFileSystem();
+
+ // sets the current location. Every call to OpenFile is
+ // relative to this location.
+ // NOTE !!
+ // unless is_dir = true 'location' is *not* the directory but
+ // file contained in this directory
+ // (so ChangePathTo("dir/subdir/xh.htm") sets m_Path to "dir/subdir/")
+ void ChangePathTo(const wxString& location, bool is_dir = false);
+
+ wxString GetPath() const {return m_Path;}
+
+ // opens given file and returns pointer to input stream.
+ // Returns NULL if opening failed.
+ // It first tries to open the file in relative scope
+ // (based on ChangePathTo()'s value) and then as an absolute
+ // path.
+ wxFSFile* OpenFile(const wxString& location, int flags = wxFS_READ);
+
+ // Finds first/next file that matches spec wildcard. flags can be wxDIR for restricting
+ // the query to directories or wxFILE for files only or 0 for either.
+ // Returns filename or empty string if no more matching file exists
+ wxString FindFirst(const wxString& spec, int flags = 0);
+ wxString FindNext();
+
+ // find a file in a list of directories, returns false if not found
+ bool FindFileInPath(wxString *pStr,
+ const wxString& path, const wxString& file);
+
+ // Adds FS handler.
+ // In fact, this class is only front-end to the FS handlers :-)
+ static void AddHandler(wxFileSystemHandler *handler);
+
+ // Removes FS handler
+ static wxFileSystemHandler* RemoveHandler(wxFileSystemHandler *handler);
+
+ // Returns true if there is a handler which can open the given location.
+ static bool HasHandlerForPath(const wxString& location);
+
+ // remove all items from the m_Handlers list
+ static void CleanUpHandlers();
+
+ // Returns the native path for a file URL
+ static wxFileName URLToFileName(const wxString& url);
+
+ // Returns the file URL for a native path
+ static wxString FileNameToURL(const wxFileName& filename);
+
+
+protected:
+ wxFileSystemHandler *MakeLocal(wxFileSystemHandler *h);
+
+ wxString m_Path;
+ // the path (location) we are currently in
+ // this is path, not file!
+ // (so if you opened test/demo.htm, it is
+ // "test/", not "test/demo.htm")
+ wxString m_LastName;
+ // name of last opened file (full path)
+ static wxList m_Handlers;
+ // list of FS handlers
+ wxFileSystemHandler *m_FindFileHandler;
+ // handler that succeed in FindFirst query
+ wxFSHandlerHash m_LocalHandlers;
+ // Handlers local to this instance
- public:
- wxFileSystem() : wxObject() {m_Path = m_LastName = wxEmptyString; m_Handlers.DeleteContents(TRUE); m_FindFileHandler = NULL;}
-
- void ChangePathTo(const wxString& location, bool is_dir = FALSE);
- // sets the current location. Every call to OpenFile is
- // relative to this location.
- // NOTE !!
- // unless is_dir = TRUE 'location' is *not* the directory but
- // file contained in this directory
- // (so ChangePathTo("dir/subdir/xh.htm") sets m_Path to "dir/subdir/")
-
- wxString GetPath() const {return m_Path;}
-
- wxFSFile* OpenFile(const wxString& location);
- // opens given file and returns pointer to input stream.
- // Returns NULL if opening failed.
- // It first tries to open the file in relative scope
- // (based on ChangePathTo()'s value) and then as an absolute
- // path.
-
- wxString FindFirst(const wxString& spec, int flags = 0);
- wxString FindNext();
- // Finds first/next file that matches spec wildcard. flags can be wxDIR for restricting
- // the query to directories or wxFILE for files only or 0 for either.
- // Returns filename or empty string if no more matching file exists
-
-
- static void AddHandler(wxFileSystemHandler *handler);
- // Adds FS handler.
- // In fact, this class is only front-end to the FS hanlers :-)
-
- static void CleanUpHandlers();
- // remove all items from the m_Handlers list
-
- private:
- wxString m_Path;
- // the path (location) we are currently in
- // this is path, not file!
- // (so if you opened test/demo.htm, it is
- // "test/", not "test/demo.htm")
- wxString m_LastName;
- // name of last opened file (full path)
- static wxList m_Handlers;
- // list of FS handlers
- wxFileSystemHandler *m_FindFileHandler;
- // handler that succeed in FindFirst query
+ DECLARE_DYNAMIC_CLASS(wxFileSystem)
+ DECLARE_NO_COPY_CLASS(wxFileSystem)
};
*/
+
+class WXDLLIMPEXP_BASE wxLocalFSHandler : public wxFileSystemHandler
+{
+public:
+ virtual bool CanOpen(const wxString& location);
+ virtual wxFSFile* OpenFile(wxFileSystem& fs, const wxString& location);
+ virtual wxString FindFirst(const wxString& spec, int flags = 0);
+ virtual wxString FindNext();
+
+ // wxLocalFSHandler will prefix all filenames with 'root' before accessing
+ // files on disk. This effectively makes 'root' the top-level directory
+ // and prevents access to files outside this directory.
+ // (This is similar to Unix command 'chroot'.)
+ static void Chroot(const wxString& root) { ms_root = root; }
+
+protected:
+ static wxString ms_root;
+};
+
+
+
#endif
- // (wxUSE_FS_INET || wxUSE_FS_ZIP) && wxUSE_STREAMS
+ // wxUSE_FILESYSTEM
#endif
// __FILESYS_H__
projects / wxWidgets.git / blobdiff