1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
/*
* Copyright (C) 2005-2018 Team Kodi
* This file is part of Kodi - https://kodi.tv
*
* SPDX-License-Identifier: GPL-2.0-or-later
* See LICENSES/README.md for more information.
*/
#pragma once
#include "utils/Variant.h"
#include <string>
class CFileItemList;
class CProfileManager;
class CURL;
namespace XFILE
{
enum DIR_CACHE_TYPE
{
DIR_CACHE_NEVER = 0, ///< Never cache this directory to memory
DIR_CACHE_ONCE, ///< Cache this directory to memory for each fetch (so that FileExists() checks are fast)
DIR_CACHE_ALWAYS ///< Always cache this directory to memory, so that each additional fetch of this folder will utilize the cache (until it's cleared)
};
/*! \brief Available directory flags
The defaults are to allow file directories, no prompting, retrieve file information, hide hidden files, and utilise the directory cache
based on the implementation's wishes.
*/
enum DIR_FLAG
{
DIR_FLAG_DEFAULTS = 0,
DIR_FLAG_NO_FILE_DIRS = (2 << 0), ///< Don't convert files (zip, rar etc.) to directories
DIR_FLAG_ALLOW_PROMPT = (2 << 1), ///< Allow prompting for further info (passwords etc.)
DIR_FLAG_NO_FILE_INFO = (2 << 2), ///< Don't read additional file info (stat for example)
DIR_FLAG_GET_HIDDEN = (2 << 3), ///< Get hidden files
DIR_FLAG_READ_CACHE = (2 << 4), ///< Force reading from the directory cache (if available)
DIR_FLAG_BYPASS_CACHE = (2 << 5) ///< Completely bypass the directory cache (no reading, no writing)
};
/*!
\ingroup filesystem
\brief Interface to the directory on a file system.
This Interface is retrieved from CDirectoryFactory and can be used to
access the directories on a filesystem.
\sa CDirectoryFactory
*/
class IDirectory
{
public:
static void RegisterProfileManager(const CProfileManager &profileManager);
static void UnregisterProfileManager();
IDirectory();
virtual ~IDirectory(void);
/*!
\brief Get the \e items of the directory \e strPath.
\param url Directory to read.
\param items Retrieves the directory entries.
\return Returns \e true, if successful.
\sa CDirectoryFactory
*/
virtual bool GetDirectory(const CURL& url, CFileItemList &items) = 0;
/*!
\brief Retrieve the progress of the current directory fetch (if possible).
\return the progress as a float in the range 0..100.
\sa GetDirectory, CancelDirectory
*/
virtual float GetProgress() const { return 0.0f; }
/*!
\brief Cancel the current directory fetch (if possible).
\sa GetDirectory
*/
virtual void CancelDirectory() {}
/*!
\brief Create the directory
\param url Directory to create.
\return Returns \e true, if directory is created or if it already exists
\sa CDirectoryFactory
*/
virtual bool Create(const CURL& url) { return false; }
/*!
\brief Check for directory existence
\param url Directory to check.
\return Returns \e true, if directory exists
\sa CDirectoryFactory
*/
virtual bool Exists(const CURL& url) { return false; }
/*!
\brief Removes the directory
\param url Directory to remove.
\return Returns \e false if not successful
*/
virtual bool Remove(const CURL& url) { return false; }
/*!
\brief Recursively removes the directory
\param url Directory to remove.
\return Returns \e false if not successful
*/
virtual bool RemoveRecursive(const CURL& url) { return false; }
/*!
\brief Whether this file should be listed
\param url File to test.
\return Returns \e true if the file should be listed
*/
virtual bool IsAllowed(const CURL& url) const;
/*! \brief Whether to allow all files/folders to be listed.
\return Returns \e true if all files/folder should be listed.
*/
virtual bool AllowAll() const { return false; }
/*!
\brief How this directory should be cached
\param url Directory at hand.
\return Returns the cache type.
*/
virtual DIR_CACHE_TYPE GetCacheType(const CURL& url) const { return DIR_CACHE_ONCE; }
void SetMask(const std::string& strMask);
void SetFlags(int flags);
/*! \brief Process additional requirements before the directory fetch is performed.
Some directory fetches may require authentication, keyboard input etc. The IDirectory subclass
should call GetKeyboardInput, SetErrorDialog or RequireAuthentication and then return false
from the GetDirectory method. CDirectory will then prompt for input from the user, before
re-calling the GetDirectory method.
\sa GetKeyboardInput, SetErrorDialog, RequireAuthentication
*/
bool ProcessRequirements();
protected:
/*! \brief Prompt the user for some keyboard input
Call this method from the GetDirectory method to retrieve additional input from the user.
If this function returns false then no input has been received, and the GetDirectory call
should return false.
\param heading an integer or string heading for the keyboard dialog
\param input [out] the returned input (if available).
\return true if keyboard input has been received. False if it hasn't.
\sa ProcessRequirements
*/
bool GetKeyboardInput(const CVariant &heading, std::string &input, bool hiddenInput = false);
/*! \brief Show an error dialog on failure of GetDirectory call
Call this method from the GetDirectory method to set an error message to be shown to the user
\param heading an integer or string heading for the error dialog.
\param line1 the first line to be displayed (integer or string).
\param line2 the first line to be displayed (integer or string).
\param line3 the first line to be displayed (integer or string).
\sa ProcessRequirements
*/
void SetErrorDialog(const CVariant &heading, const CVariant &line1, const CVariant &line2 = 0, const CVariant &line3 = 0);
/*! \brief Prompt the user for authentication of a URL.
Call this method from the GetDirectory method when authentication is required from the user, before returning
false from the GetDirectory call. The user will be prompted for authentication, and GetDirectory will be
re-called.
\param url the URL to authenticate.
\sa ProcessRequirements
*/
void RequireAuthentication(const CURL& url);
static const CProfileManager *m_profileManager;
std::string m_strFileMask; ///< Holds the file mask specified by SetMask()
int m_flags; ///< Directory flags - see DIR_FLAG
CVariant m_requirements;
};
}
|
