]> git.tdb.fi Git - libs/datafile.git/blobdiff - source/loader.h
Require C++11 for building
[libs/datafile.git] / source / loader.h
index 9314ab3a8108e110e0dc3be39daf03511a4d8982..574ecce0c11b5bac9af56d82b6a0782a5288d8b6 100644 (file)
@@ -1,18 +1,10 @@
-/* $Id$
-
-This file is part of libmspdatafile
-Copyright © 2006-2008  Mikko Rasa, Mikkosoft Productions
-Distributed under the LGPL
-*/
-
 #ifndef MSP_DATAFILE_LOADER_H_
 #define MSP_DATAFILE_LOADER_H_
 
 #include <map>
-#include <msp/io/buffered.h>
 #include <msp/io/file.h>
-#include "except.h"
 #include "loaderaction.h"
+#include "meta.h"
 #include "parser.h"
 #include "statement.h"
 
@@ -39,30 +31,75 @@ When loading has finished successfully, the virtual function finish() is
 called.  Any post-processing of the data should be placed here and not in the
 destructor.
 
-See also classes BasicLoader and BasicLoader2.
+See also classes ObjectLoader and CollectionObjectLoader in objectloader.h.
 */
-class Loader
+class Loader: private NonCopyable
 {
+protected:
+       class ActionMap: public std::map<StatementKey, LoaderAction *>, private NonCopyable
+       {
+       public:
+               ~ActionMap();
+       };
+
+private:
+       ActionMap local_actions;
+       ActionMap *actions;
+       Parser *cur_parser;
+       unsigned cur_level;
+       const Statement *cur_st;
+       bool sub_loaded;
+       bool direct;
+       std::vector<Loader *> aux_loaders;
+protected:
+       bool check_sub_loads;
+
+       Loader();
 public:
-       /**
-       Loads data from a statement.  This is normally only used by the Loader class
-       itself for loading sub-items, but needs to be public so it can be accessed
-       in derived objects.
-       */
-       void load(const Statement &st);
+       virtual ~Loader() { }
 
-       /**
-       Loads statements from a parser.
-       */
+       /** Loads statements from a parser. */
        void load(Parser &p);
 
-       virtual ~Loader();
+private:
+       /** Loads data from a statement. */
+       void load(const Statement &st);
+
+       /** Loads statemsnts from a parser, feeding them directly to actions. */
+       void load_direct(Parser &, unsigned);
+
+       /** Processes a single statement */
+       void load_statement(const Statement &st);
+
 protected:
-       Loader(): cur_st(0) { }
+       /** Loads a sub-object from the statement being processed.  The Loader class
+       of the sub-object is automatically used. */
+       template<typename S>
+       void load_sub(S &s)
+       {
+               typename S::Loader ldr(s);
+               load_sub_with(ldr);
+       }
+
+       /** Loads a sub-object from the statement being processed with an extra
+       parameter for the Loader.  The Loader class of the sub-object is
+       automatically used. */
+       template<typename S, typename T>
+       void load_sub(S &s, T &p)
+       {
+               typename S::Loader ldr(s, p);
+               load_sub_with(ldr);
+       }
 
-       /**
-       Adds a keyword that is loaded with a zero-argument function.
-       */
+       /** Processes the current statement's substatements with another Loader. */
+       void load_sub_with(Loader &);
+
+       /** Sets the actions to be used when loading.  If the map is empty,
+       init_actions will be called. */
+       void set_actions(ActionMap &);
+       virtual void init_actions() { }
+
+       /** Adds a keyword that is loaded by calling a function. */
        template<typename L>
        void add(const std::string &k, void (L::*func)())
        { add(k, new LoaderFunc0<L>(func)); }
@@ -71,25 +108,17 @@ protected:
        void add(const std::string &k, void (L::*func)(A0))
        { add(k, new LoaderFunc1<L, A0>(func)); }
 
-       template<typename L, typename A0, typename A1>
-       void add(const std::string &k, void (L::*func)(A0, A1))
-       { add(k, new LoaderFunc2<L, A0, A1>(func)); }
-
-       template<typename L, typename A0, typename A1, typename A2>
-       void add(const std::string &k, void (L::*func)(A0, A1, A2))
-       { add(k, new LoaderFunc3<L, A0, A1, A2>(func)); }
-
-       template<typename L, typename A0, typename A1, typename A2, typename A3>
-       void add(const std::string &k, void (L::*func)(A0, A1, A2, A3))
-       { add(k, new LoaderFunc4<L, A0, A1, A2, A3>(func)); }
+       template<typename L, typename... Args>
+       void add(const std::string &k, void (L::*func)(Args...))
+       { add(k, new LoaderFuncN<L, Args...>(func)); }
 
-       template<typename L, typename A0, typename A1, typename A2, typename A3, typename A4>
-       void add(const std::string &k, void (L::*func)(A0, A1, A2, A3, A4))
-       { add(k, new LoaderFunc5<L, A0, A1, A2, A3, A4>(func)); }
+       /** Adds a keyword that is loaded by calling a function with a bound
+       first argument. */
+       template<typename L, typename B0, typename... Args>
+       void add(const std::string &k, void (L::*func)(B0, Args...), const typename RemoveReference<B0>::Type &b0)
+       { add(k, new LoaderFuncNBound1<L, B0, Args...>(func, b0)); }
 
-       /**
-       Adds a keyword that is loaded into a variable of the loaded object.
-       */
+       /** Adds a keyword that is loaded into a member of the loaded object. */
        template<typename L, typename T0>
        void add(const std::string &k, T0 L::*p0)
        { add(k, new LoadValue1<L, T0>(p0)); }
@@ -98,123 +127,78 @@ protected:
        void add(const std::string &k, T0 L::*p0, T1 L::*p1)
        { add(k, new LoadValue2<L, T0, T1>(p0, p1)); }
 
-       /**
-       Adds a keyword that is recognized but ignored.
-       */
+       /** Adds a keyword that is recognized but ignored. */
        void add(const std::string &k)
        { add(k, 0); }
 
-       /**
-       Loads a sub-object from the statement being processed.  The Loader class of
-       the sub-object is automatically used.
-       */
-       template<typename S>
-       void load_sub(S &s)
-       {
-               typename S::Loader ldr(s);
-               load_sub_with(ldr);
-       }
-
-       /**
-       Loads a sub-object from the statement being processed with an extra parameter
-       for the Loader.  The Loader class of the sub-object is automatically used.
-       */
-       template<typename S, typename T>
-       void load_sub(S &s, T &p)
-       {
-               typename S::Loader ldr(s, p);
-               load_sub_with(ldr);
-       }
-
-       /**
-       Processes the current statement's substatements with another Loader.
-       */
-       void load_sub_with(Loader &);
-
-       /**
-       Returns the source of the statement being processed.  This can be used to
-       implement relative paths in include-like statements.  Note that the source
-       may not necessarily be a file.
-       */
-       const std::string &get_source() const
-       {
-               if(!cur_st)
-                       throw InvalidState("get_source called without current statement");
-               return cur_st->source;
-       }
-
-       virtual void finish() { }
 private:
-       typedef std::map<std::string, LoaderAction *> ActionMap;
-
-       ActionMap       actions;
-       const Statement *cur_st;
-
        void add(const std::string &, LoaderAction *);
-       void load_statement(const Statement &st);
-};
 
+protected:
+       void add_auxiliary_loader(Loader &);
 
-/**
-Provides the basic functionality of an object loader.  Deriving from this
-allows loading values directly into member variables of the objects.
-*/
-template<typename O>
-class BasicLoader: public Loader
-{
-public:
-       typedef O Object;
+private:
+       bool has_action(const StatementKey &) const;
+       LoaderAction *find_action(const StatementKey &) const;
 
 protected:
-       O &obj;
+       /** Returns the source of the statement being processed.  This can be used
+       to implement relative paths in include-like statements.  Note that the
+       source may not necessarily be a file. */
+       const std::string &get_source() const;
 
-public:
-       BasicLoader(O &o): obj(o) { }
-       O &get_object() const { return obj; }
+       /** Returns the keyword of the statement being processed.  Can be used to
+       implement dynamic keywords. */
+       const std::string &get_keyword() const;
+
+       virtual void finish() { }
 };
 
 
 /**
-Provides functionality for loading objects with a Collection.  Deriving from
-this allows loading pointers to objects in the collection automatically.
+Loads an object from a file.  The object must have a public Loader class.  Any
+extra arguments are passed to the Loader constructor.
 */
-template<typename O, typename C>
-class BasicLoader2: public BasicLoader<O>
+template<typename T, typename... Args>
+void load(T &obj, const std::string &fn, Args &... args)
 {
-public:
-       typedef C Collection;
-
-protected:
-       C &coll;
-
-public:
-       BasicLoader2(O &o, C &c): BasicLoader<O>(o), coll(c) { }
-       C &get_collection() const { return coll; }
-};
+       IO::BufferedFile in(fn);
 
+       Parser parser(in, fn);
+       typename T::Loader loader(obj, args...);
+       loader.load(parser);
+}
 
 /**
-Loads an object from a file.  The object must have a public Loader class.
+Loads an object from a file stored in a collection.  The object must have a
+public Loader class.  The collection is passed to the Loader constructor,
+followed by any extra arguments.
 */
-template<typename T>
-void load(T &obj, const std::string &fn)
+template<typename T, typename... Args>
+void load(T &obj, typename T::Loader::Collection &coll, const std::string &fn, Args &... args)
 {
-       IO::File in(fn);
-       IO::Buffered buf(in);
+       RefPtr<IO::Seekable> in = coll.open_raw(fn);
+       if(!in)
+               throw IO::file_not_found(fn);
 
-       Parser parser(buf, fn);
-       typename T::Loader loader(obj);
+       Parser parser(*in, fn);
+       typename T::Loader loader(obj, coll, args...);
        loader.load(parser);
 }
 
-template<typename T, typename U>
-void load(T &obj, const std::string &fn, U &arg)
+/**
+Loads an object from a file stored in a collection.  The object must havea
+public Loader class.  Any extra arguments are passed to the Loader constructor.
+*/
+template<typename T, typename C, typename... Args>
+typename EnableIf<NeedsCollection<typename T::Loader>::value, void>::No load(T &obj, C &coll, const std::string &fn, Args &... args)
 {
-       IO::File in(fn);
-       IO::Buffered buf(in);
+       RefPtr<IO::Seekable> in = coll.open_raw(fn);
+       if(!in)
+               throw IO::file_not_found(fn);
 
-       Parser parser(buf, fn);
-       typename T::Loader loader(obj, arg);
+       Parser parser(*in, fn);
+       typename T::Loader loader(obj, args...);
        loader.load(parser);
 }