PluginRegister.h

Go to the documentation of this file.

/********************************************************************
**                Image Component Library (ICL)                    **
**                                                                 **
** Copyright (C) 2006-2013 CITEC, University of Bielefeld          **
**                         Neuroinformatics Group                  **
** Website: www.iclcv.org and                                      **
**          http://opensource.cit-ec.de/projects/icl               **
**                                                                 **
** File   : ICLUtils/src/ICLUtils/PluginRegister.h                 **
** Module : ICLUtils                                               **
** Authors: Christof Elbrechter                                    **
**                                                                 **
**                                                                 **
** GNU LESSER GENERAL PUBLIC LICENSE                               **
** This file may be used under the terms of the GNU Lesser General **
** Public License version 3.0 as published by the                  **
**                                                                 **
** Free Software Foundation and appearing in the file LICENSE.LGPL **
** included in the packaging of this file.  Please review the      **
** following information to ensure the license requirements will   **
** be met: http://www.gnu.org/licenses/lgpl-3.0.txt                **
**                                                                 **
** The development of this software was supported by the           **
** Excellence Cluster EXC 277 Cognitive Interaction Technology.    **
** The Excellence Cluster EXC 277 is a grant of the Deutsche       **
** Forschungsgemeinschaft (DFG) in the context of the German       **
** Excellence Initiative.                                          **
**                                                                 **
********************************************************************/

#pragma once

#include <ICLUtils/Function.h>
#include <ICLUtils/TextTable.h>

#include <string>
#include <map>
#include <sstream>

namespace icl{
  namespace utils{

    template<class T>
    class PluginRegister{
      public:
      
      typedef std::map<std::string,std::string> Data;
      
      typedef utils::Function<T*,const Data&> CreateFunction;

      struct Plugin{
        std::string name;            
        std::string description;     
        std::string creationSyntax;  
        CreateFunction create;       
      };
      
      static PluginRegister<T> &instance(){
        static PluginRegister<T> inst;
        return inst;
      }
        
      inline void add(const std::string &name, CreateFunction create, 
               const std::string &description, const std::string &creationSyntax){
        Plugin p = { name, description, creationSyntax, create };
        plugins[name] = p;
      }
        
      inline T *createInstance(const std::string &name, const Data &data) 
        throw (utils::ICLException){
        typename std::map<std::string,Plugin>::iterator it = plugins.find(name);
        if(it == plugins.end()){
          std::ostringstream all;
          for(typename std::map<std::string,Plugin>::iterator jt = plugins.begin(); jt != plugins.end();){
            all << jt->first;
            if(++jt != plugins.end()) all << ",";
          }
          throw utils::ICLException("PluginRegister<T>: unknow type: '"+ name + "' (registered are: " +all.str() + ")");
          return 0;
        }
        return it->second.create(data);
      }
        
      inline std::string getRegisteredInstanceDescription(){
        utils::TextTable t(3,plugins.size()+1,40);
        t(0,0) = "ID";
        t(1,0) = "Description";
        t(2,0) = "Creation Syntax";
        int i=1;
        for(typename std::map<std::string,Plugin>::iterator it = plugins.begin(); 
            it != plugins.end(); ++it, ++i){
          t(0,i) = it->second.name;
          t(1,i) = it->second.description;
          t(2,i) = it->second.creationSyntax;
        }
        return t.toString();
      }
      
      const std::map<std::string,Plugin> &getRegisteredPlugins() const{
        return plugins;
      }

      private:
      PluginRegister(){}
      
      std::map<std::string,Plugin> plugins;
      
    };
  }
}

#define REGISTER_PLUGIN(TYPE,NAME,CREATE_FUNCTION,DESCRIPTION,SYNTAX)   \
  struct Static_##TYPE##_PluginRegistration__##NAME{                    \
    Static_##TYPE##_PluginRegistration__##NAME(){                       \
      PluginRegister<TYPE> &r = PluginRegister<TYPE>::instance();       \
      r.add(#NAME,CREATE_FUNCTION,DESCRIPTION,SYNTAX);                  \
    }                                                                   \
  } static_##TYPE##_PluginRegistration__##NAME;