pplugin.h

Go to the documentation of this file.

/*
 *   P::Classes - Portable C++ Application Framework
 *   Copyright (C) 2000-2004  Christian Prochnow <cproch@seculogix.de>
 *
 *   This library is free software; you can redistribute it and/or
 *   modify it under the terms of the GNU Lesser General Public
 *   License as published by the Free Software Foundation; either
 *   version 2 of the License, or (at your option) any later version.
 *
 *   This library is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *   Lesser General Public License for more details.
 *
 *   You should have received a copy of the GNU Lesser General Public
 *   License along with this library; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#ifndef _pplugin_h_
#define _pplugin_h_

#include <pclasses/pexport.h>
#include <pclasses/psharedlib.h>
#include <typeinfo>
#include <list>
#include <map>
#include <string>

namespace P {


class PCORE_EXPORT PluginBase {
  public:
    PluginBase();
    virtual ~PluginBase();
};


struct PluginMetaInfo {
  const char* iface;
  const char* feature;
  PluginBase* (*create)();
  void (*destroy)(PluginBase* c);
};

#define P_PLUGINS_BEGIN \
  extern "C" { \
    CXX_CLASS_EXPORT PluginMetaInfo P_plugin[] = {

#define P_PLUGIN(iface, feature, cl) \
  { typeid(iface).name(), feature, &cl::create, &cl::destroy },

#define P_PLUGINS_END \
  { 0, 0, 0, 0 } \
  }; }


class PCORE_EXPORT PluginFactoryImpl {
  public:
    PluginFactoryImpl(const char* iface);
    virtual ~PluginFactoryImpl();

    void addPlugin(const char* path) throw(SystemError);

    void addPluginDir(const char* path) throw(SystemError, IOError);

    PluginBase* create(const char* feature);

    void destroy(PluginBase* inst);

    bool provides(const char* feature) const;

  private:
    struct Plugin;
    Plugin* find(const char* feature) const;

    std::string        m_iface;
    std::list<Plugin*> m_plugins;
    std::map<PluginBase*, Plugin*> m_pinst;
};


/*
  \sa PluginFactoryImpl
  \ingroup core
  \author Christian Prochnow <cproch@seculogix.de>
*/
template <class Iface>
class PluginFactory: public PluginFactoryImpl {
  public:

    inline PluginFactory()
    : PluginFactoryImpl(typeid(Iface).name())
    {}

    inline ~PluginFactory()
    {}

    inline Iface* create(const char* feature)
    { return dynamic_cast<Iface*>(PluginFactoryImpl::create(feature)); }

    inline void destroy(Iface* inst)
    { PluginFactoryImpl::destroy(dynamic_cast<PluginBase*>(inst)); }

};

}

#endif

---