src/ConverterCache.h

   1 // -*- C++ -*-
   2 /**
   3  * \file ConverterCache.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Baruch Even
   8  * \author Angus Leeming
   9  * \author Georg Baum
  10  *
  11  * Full author contact details are available in file CREDITS.
  12  *
  13  * lyx::ConverterCache is the manager of the file cache.
  14  * It is responsible for creating the lyx::ConverterCacheItem's
  15  * and maintaining them.
  16  *
  17  * lyx::ConverterCache is a singleton class. It is possible to have
  18  * only one instance of it at any moment.
  19  */
  20
  21 #ifndef CONVERTERCACHE_H
  22 #define CONVERTERCACHE_H
  23
  24 #include <boost/noncopyable.hpp>
  25 #include <boost/scoped_ptr.hpp>
  26
  27 #include <string>
  28
  29
  30 namespace lyx {
  31
  32 namespace support { class FileName; }
  33
  34 /**
  35  * Cache for converted files. The cache works as follows:
  36  *
  37  * The key for a cache item consists of the absolute name of the original
  38  * file and the format name of the target format.  The original file in the
  39  * user directory is named \c orig_from in the code, the format name is named
  40  * \c to_format. Example:
  41  * \c orig_from = "/home/me/myfigure.fig"
  42  * \c to_format = "eps"
  43  * A cache item is considered up to date (inCache() returns \c true) if
  44  * - The cache contains an item with key (\c orig_to, \c to_format)
  45  * - The stored timestamp of the item is identical with the actual timestamp
  46  *   of \c orig_from, or, if that is not the case, the stored checksum is
  47  *   identical with the actual checksum of \c orig_from.
  48  * Otherwise the item is not considered up to date, and add() will refresh it.
  49  *
  50  * There is no cache maintenance yet (max size, max age etc.)
  51  */
  52 class ConverterCache : boost::noncopyable {
  53 public:
  54
  55         /// This is a singleton class. Get the instance.
  56         static ConverterCache & get();
  57
  58         /// Init the cache. This must be done after package initialization.
  59         static void init();
  60
  61         /**
  62          * Add \c converted_file (\c orig_from converted to \c to_format) to
  63          * the cache if it is not already in or not up to date.
  64          */
  65         void add(support::FileName const & orig_from, std::string const & to_format,
  66                  support::FileName const & converted_file) const;
  67
  68         /// Remove a file from the cache.
  69         void remove(support::FileName const & orig_from,
  70                     std::string const & to_format) const;
  71
  72         /// Remove all cached \p from_format -> \p to_format conversions
  73         void remove_all(std::string const & from_format,
  74                         std::string const & to_format) const;
  75
  76         /**
  77          * Returns \c true if \c orig_from converted to \c to_format is in
  78          * the cache and up to date.
  79          */
  80         bool inCache(support::FileName const & orig_from,
  81                      std::string const & to_format) const;
  82
  83         /// Get the name of the cached file
  84         support::FileName const & cacheName(support::FileName const & orig_from,
  85                                             std::string const & to_format) const;
  86
  87         /// Copy the file from the cache to \p dest
  88         bool copy(support::FileName const & orig_from, std::string const & to_format,
  89                   support::FileName const & dest) const;
  90
  91 private:
  92         /** Make the c-tor, d-tor private so we can control how many objects
  93          *  are instantiated.
  94          */
  95         ConverterCache();
  96         ///
  97         ~ConverterCache();
  98
  99         /// Use the Pimpl idiom to hide the internals.
 100         class Impl;
 101         /// The pointer never changes although *pimpl_'s contents may.
 102         boost::scoped_ptr<Impl> const pimpl_;
 103 };
 104
 105 } // namespace lyx
 106
 107 #endif