LeechCraft  0.6.70-6645-gcd10d7e
Modular cross-platform feature rich live environment.
resourceloader.cpp
Go to the documentation of this file.
1 /**********************************************************************
2  * LeechCraft - modular cross-platform feature rich internet client.
3  * Copyright (C) 2006-2014 Georg Rudoy
4  *
5  * Boost Software License - Version 1.0 - August 17th, 2003
6  *
7  * Permission is hereby granted, free of charge, to any person or organization
8  * obtaining a copy of the software and accompanying documentation covered by
9  * this license (the "Software") to use, reproduce, display, distribute,
10  * execute, and transmit the Software, and to prepare derivative works of the
11  * Software, and to permit third-parties to whom the Software is furnished to
12  * do so, all subject to the following:
13  *
14  * The copyright notices in the Software and this entire statement, including
15  * the above license grant, this restriction and the following disclaimer,
16  * must be included in all copies of the Software, in whole or in part, and
17  * all derivative works of the Software, unless such copies or derivative
18  * works are solely in the form of machine-executable object code generated by
19  * a source language processor.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
24  * SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
25  * FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
26  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27  * DEALINGS IN THE SOFTWARE.
28  **********************************************************************/
29 
30 #include "resourceloader.h"
31 #include <QApplication>
32 #include <QFile>
33 #include <QDir>
34 #include <QStandardItemModel>
35 #include <QSortFilterProxyModel>
36 #include <QFileSystemWatcher>
37 #include <QTimer>
38 #include <QtDebug>
39 #include <QBuffer>
40 
41 namespace LeechCraft
42 {
43  namespace Util
44  {
45  ResourceLoader::ResourceLoader (const QString& relPath, QObject* parent)
46  : QObject (parent)
47  , RelativePath_ (relPath)
48  , SubElemModel_ (new QStandardItemModel (this))
49  , AttrFilters_ (QDir::Dirs | QDir::NoDotAndDotDot | QDir::Readable)
50  , SortModel_ (new QSortFilterProxyModel (this))
51  , Watcher_ (new QFileSystemWatcher (this))
52  , CacheFlushTimer_ (new QTimer (this))
53  , CachePathContents_ (0)
54  , CachePixmaps_ (0)
55  {
56  if (RelativePath_.startsWith ('/'))
57  RelativePath_ = RelativePath_.mid (1);
58  if (!RelativePath_.endsWith ('/'))
59  RelativePath_.append ('/');
60 
61  SortModel_->setDynamicSortFilter (true);
62  SortModel_->setSourceModel (SubElemModel_);
63  SortModel_->sort (0);
64 
65  connect (Watcher_,
66  SIGNAL (directoryChanged (const QString&)),
67  this,
68  SLOT (handleDirectoryChanged (const QString&)));
69 
70  connect (CacheFlushTimer_,
71  SIGNAL (timeout ()),
72  this,
73  SLOT (handleFlushCaches ()));
74  }
75 
76  void ResourceLoader::AddLocalPrefix (QString prefix)
77  {
78  if (!prefix.isEmpty () &&
79  !prefix.endsWith ('/'))
80  prefix.append ('/');
81  QString result = QDir::homePath () + "/.leechcraft/data/" + prefix;
82  LocalPrefixesChain_ << result;
83 
84  QDir testDir = QDir::home ();
85  if (!testDir.exists (".leechcraft/data/" + prefix + RelativePath_))
86  {
87  qDebug () << Q_FUNC_INFO
88  << ".leechcraft/data/" + prefix + RelativePath_
89  << "doesn't exist, trying to create it...";
90 
91  if (!testDir.mkpath (".leechcraft/data/" + prefix + RelativePath_))
92  {
93  qWarning () << Q_FUNC_INFO
94  << "failed to create"
95  << ".leechcraft/data/" + prefix + RelativePath_;
96  }
97  }
98 
99  ScanPath (result + RelativePath_);
100 
101  Watcher_->addPath (result + RelativePath_);
102  }
103 
105  {
106 #if defined (Q_OS_MAC) && !defined (USE_UNIX_LAYOUT)
107  const QStringList prefixes { QApplication::applicationDirPath () + "/../Resources/share/" };
108 #elif defined (Q_OS_WIN32)
109  const QStringList prefixes { QApplication::applicationDirPath () + "/share/" };
110 #elif defined (INSTALL_PREFIX)
111  const QStringList prefixes { INSTALL_PREFIX "/share/leechcraft/" };
112 #else
113  const QStringList prefixes
114  {
115  "/usr/local/share/leechcraft/",
116  "/usr/share/leechcraft/"
117  };
118 #endif
119  bool hasBeenAdded = false;
120  for (const auto& prefix : prefixes)
121  {
122  GlobalPrefixesChain_ << prefix;
123  ScanPath (prefix + RelativePath_);
124 
125  if (QFile::exists (prefix + RelativePath_))
126  {
127  Watcher_->addPath (prefix + RelativePath_);
128  hasBeenAdded = true;
129  }
130  }
131 
132  if (!hasBeenAdded)
133  qWarning () << Q_FUNC_INFO
134  << "no prefixes have been added:"
135  << prefixes
136  << "; rel path:"
137  << RelativePath_;
138  }
139 
140  void ResourceLoader::SetCacheParams (int size, int timeout)
141  {
142  if (qApp->property ("no-resource-caching").toBool ())
143  return;
144 
145  if (size <= 0)
146  {
147  CacheFlushTimer_->stop ();
148 
149  handleFlushCaches ();
150  }
151  else
152  {
153  if (timeout > 0)
154  CacheFlushTimer_->start (timeout);
155 
156  CachePathContents_.setMaxCost (size * 1024);
157  CachePixmaps_.setMaxCost (size * 1024);
158  }
159  }
160 
162  {
163  handleFlushCaches ();
164  }
165 
166  QFileInfoList ResourceLoader::List (const QString& option,
167  const QStringList& nameFilters, QDir::Filters filters) const
168  {
169  QSet<QString> alreadyListed;
170  QFileInfoList result;
171  for (const auto& prefix : LocalPrefixesChain_ + GlobalPrefixesChain_)
172  {
173  const QString& path = prefix + RelativePath_ + option;
174  QDir dir (path);
175  const QFileInfoList& list =
176  dir.entryInfoList (nameFilters, filters);
177  for (const auto& info : list)
178  {
179  const QString& fname = info.fileName ();
180  if (alreadyListed.contains (fname))
181  continue;
182 
183  alreadyListed << fname;
184  result << info;
185  }
186  }
187 
188  return result;
189  }
190 
191  QString ResourceLoader::GetPath (const QStringList& pathVariants) const
192  {
193  for (const auto& prefix : LocalPrefixesChain_ + GlobalPrefixesChain_)
194  for (const auto& path : pathVariants)
195  {
196  const QString& can = QFileInfo (prefix + RelativePath_ + path).absoluteFilePath ();
197  if (QFile::exists (can))
198  return can;
199  }
200 
201  return QString ();
202  }
203 
204  namespace
205  {
206  QStringList IconizeBasename (const QString& basename)
207  {
208  QStringList variants;
209  variants << basename + ".svg"
210  << basename + ".png"
211  << basename + ".jpg"
212  << basename + ".gif";
213  return variants;
214  }
215  }
216 
217  QString ResourceLoader::GetIconPath (const QString& basename) const
218  {
219  return GetPath (IconizeBasename (basename));
220  }
221 
222  QIODevice_ptr ResourceLoader::Load (const QStringList& pathVariants, bool open) const
223  {
224  QString path = GetPath (pathVariants);
225  if (path.isNull ())
226  return QIODevice_ptr ();
227 
228  if (CachePathContents_.contains (path))
229  {
230  std::shared_ptr<QBuffer> result (new QBuffer ());
231  result->setData (*CachePathContents_ [path]);
232  if (open)
233  result->open (QIODevice::ReadOnly);
234  return result;
235  }
236 
237  std::shared_ptr<QFile> result (new QFile (path));
238 
239  if (!result->isSequential () &&
240  result->size () < CachePathContents_.maxCost () / 2)
241  {
242  if (result->open (QIODevice::ReadOnly))
243  {
244  const QByteArray& data = result->readAll ();
245  CachePathContents_.insert (path, new QByteArray (data), data.size ());
246  result->close ();
247  }
248  }
249 
250  if (open)
251  result->open (QIODevice::ReadOnly);
252 
253  return result;
254  }
255 
256  QIODevice_ptr ResourceLoader::Load (const QString& pathVariant, bool open) const
257  {
258  return Load (QStringList (pathVariant), open);
259  }
260 
261  QIODevice_ptr ResourceLoader::GetIconDevice (const QString& basename, bool open) const
262  {
263  return Load (IconizeBasename (basename), open);
264  }
265 
266  QPixmap ResourceLoader::LoadPixmap (const QString& basename) const
267  {
268  if (CachePixmaps_.contains (basename))
269  return *CachePixmaps_ [basename];
270 
271  auto dev = GetIconDevice (basename, true);
272  if (!dev)
273  return QPixmap ();
274 
275  const auto& data = dev->readAll ();
276 
277  QPixmap result;
278  result.loadFromData (data);
279  CachePixmaps_.insert (basename, new QPixmap (result), data.size ());
280  return result;
281  }
282 
283  QAbstractItemModel* ResourceLoader::GetSubElemModel () const
284  {
285  return SortModel_;
286  }
287 
288  void ResourceLoader::SetAttrFilters (QDir::Filters filters)
289  {
290  AttrFilters_ = filters;
291  }
292 
293  void ResourceLoader::SetNameFilters (const QStringList& filters)
294  {
295  NameFilters_ = filters;
296  }
297 
298  void ResourceLoader::ScanPath (const QString& path)
299  {
300  for (const auto& entry : QDir (path).entryList (NameFilters_, AttrFilters_))
301  {
302  Entry2Paths_ [entry] << path;
303  if (SubElemModel_->findItems (entry).size ())
304  continue;
305 
306  SubElemModel_->appendRow (new QStandardItem (entry));
307  }
308  }
309 
310  void ResourceLoader::handleDirectoryChanged (const QString& path)
311  {
313 
314  for (auto i = Entry2Paths_.begin (), end = Entry2Paths_.end (); i != end; ++i)
315  i->removeAll (path);
316 
317  QFileInfo fi (path);
318  if (fi.exists () &&
319  fi.isDir () &&
320  fi.isReadable ())
321  ScanPath (path);
322 
323  QStringList toRemove;
324  for (auto i = Entry2Paths_.begin (), end = Entry2Paths_.end (); i != end; ++i)
325  if (i->isEmpty ())
326  toRemove << i.key ();
327 
328  for (const auto& entry : toRemove)
329  {
330  Entry2Paths_.remove (entry);
331 
332  auto items = SubElemModel_->findItems (entry);
333  for (auto item : SubElemModel_->findItems (entry))
334  SubElemModel_->removeRow (item->row ());
335  }
336  }
337 
338  void ResourceLoader::handleFlushCaches ()
339  {
340  CachePathContents_.clear ();
341  CachePixmaps_.clear ();
342  }
343  }
344 }
QPixmap LoadPixmap(const QString &basename) const
Returns the pixmap for the given basename.
QFileInfoList List(const QString &option, const QStringList &names=QStringList(), QDir::Filters filters=QDir::NoFilter) const
Lists the available files for the given option.
void SetAttrFilters(QDir::Filters)
Sets the attribute filters for the subelement model.
void AddLocalPrefix(QString prefix=QString())
Registers a local search prefix.
QAbstractItemModel * GetSubElemModel() const
Returns the subelement model with the contents of registered paths.
void SetNameFilters(const QStringList &)
Sets the name filters for the subelement model.
void SetCacheParams(int size, int timeout)
Sets the caching parameters of this loader.
void AddGlobalPrefix()
Registers global OS-dependent prefixes.
void FlushCache()
Forcefully flushes the cache.
QString GetPath(const QStringList &pathVariants) const
Returns the first found path for the list of variants.
QString GetIconPath(const QString &basename) const
Calls GetPath() with standard variants for the icon extensions.
ResourceLoader(const QString &relPath, QObject *obj=0)
Initializes the loader with the given path.
std::shared_ptr< QIODevice > QIODevice_ptr
QIODevice_ptr GetIconDevice(const QString &basename, bool open=false) const
Returns the QIODevice for the corresponding icon.
QIODevice_ptr Load(const QStringList &pathVariants, bool open=false) const
Returns the QIODevice for the corresponding resource.