xmltooling/util/ReloadableXMLFile.h

   1 /*
   2  *  Copyright 2001-2006 Internet2
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 /**
  18  * @file xmltooling/util/ReloadableXMLFile.h
  19  *
  20  * Base class for file-based XML configuration.
  21  */
  22
  23 #ifndef __xmltooling_reloadable_h__
  24 #define __xmltooling_reloadable_h__
  25
  26 #include <xmltooling/Lockable.h>
  27 #include <xmltooling/util/Threads.h>
  28
  29 #include <ctime>
  30 #include <string>
  31
  32 namespace xmltooling {
  33
  34     /**
  35      * Base class for file-based XML configuration.
  36      */
  37     class XMLTOOL_API ReloadableXMLFile : protected virtual Lockable
  38     {
  39         MAKE_NONCOPYABLE(ReloadableXMLFile);
  40
  41     protected:
  42         /**
  43          * Constructor taking a DOM element supporting the following content:
  44          *
  45          * <dl>
  46          *  <dt>file | filename | path | pathname</dt>
  47          *  <dd>identifies a local file</dd>
  48          *  <dt>uri | url</dt>
  49          *  <dd>identifies a remote resource</dd>
  50          *  <dt>validate</dt>
  51          *  <dd>use a validating parser</dd>
  52          *  <dt>reloadChanges</dt>
  53          *  <dd>enables monitoring of resources for changes</dd>
  54          * </dl>
  55          *
  56          * @param e DOM to supply configuration
  57          */
  58         ReloadableXMLFile(const DOMElement* e);
  59
  60         virtual ~ReloadableXMLFile() {
  61             delete m_lock;
  62         }
  63
  64     public:
  65         Lockable* lock();
  66
  67         void unlock() {
  68             if (m_lock)
  69                 m_lock->unlock();
  70         }
  71
  72         /**
  73          * Loads configuration material.
  74          *
  75          * <p>This method is called to load configuration material
  76          * initially and any time a change is detected. The base version
  77          * performs basic parsing duties and returns the result.
  78          *
  79          * @return a pair consisting of a flag indicating whether to take ownership of
  80          *      the document, and the root element of the tree to load
  81          */
  82         virtual std::pair<bool,DOMElement*> load();
  83
  84         /**
  85          * Overrideable method to determine whether a remote resource remains valid.
  86          *
  87          * @return  true iff the resource remains valid and should not be reloaded
  88          */
  89         virtual bool isValid() const {
  90             return true;
  91         }
  92
  93     private:
  94         const DOMElement* m_root;
  95         bool m_local, m_validate;
  96         std::string m_source;
  97         time_t m_filestamp;
  98         RWLock* m_lock;
  99     };
 100
 101 };
 102
 103 #endif /* __xmltooling_reloadable_h__ */