/****************************************************************************** * Copyright (c) 2015, Bradley J Chambers (brad.chambers@gmail.com) * * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following * conditions are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided * with the distribution. * * Neither the name of Hobu, Inc. or Flaxen Geo Consulting nor the * names of its contributors may be used to endorse or promote * products derived from this software without specific prior * written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY * OF SUCH DAMAGE. ****************************************************************************/ // The PluginManager was modeled very closely after the work of Gigi Sayfan in // the Dr. Dobbs article: // http://www.drdobbs.com/cpp/building-your-own-plugin-framework-part/206503957 // The original work was released under the Apache License v2. #pragma once #include #include #include #include #include #include #include #include #include namespace pdal { class DynamicLibrary; /* * I think PluginManager can eventually be a private header, only accessible * through the factories, but we'll leave it as public for now. */ template class PDAL_DLL PluginManager { struct Info { std::string name; std::string link; std::string description; std::function create; }; typedef std::shared_ptr DynLibPtr; typedef std::map DynamicLibraryMap; typedef std::map RegistrationInfoMap; public: PluginManager(const PluginManager&) = delete; PluginManager& operator=(const PluginManager&) = delete; ~PluginManager(); static std::string description(const std::string& name); static std::string link(const std::string& name); template static bool registerPlugin(const PluginInfo& info) { return get().template l_registerPlugin(info); } template static bool registerPlugin(const StaticPluginInfo& info) { return get().template l_registerPlugin(info); } static bool loadPlugin(const std::string& pluginFilename); static T *createObject(const std::string& objectType); static StringList names(); static void setLog(LogPtr& log); static void loadAll(); static bool loadDynamic(const std::string& driverName); static PluginManager& get(); static StageExtensions& extensions(); private: PluginManager(); std::string getPath(const std::string& driver); void shutdown(); bool loadByPath(const std::string & path); bool l_loadDynamic(const std::string& driverName); DynamicLibrary *libraryLoaded(const std::string& path); DynamicLibrary *loadLibrary(const std::string& path); T *l_createObject(const std::string& objectType); template bool l_registerPlugin(const PluginInfo& pi) { auto f = [&]() { T *t = dynamic_cast(new C); return t; }; Info info {pi.name, pi.link, pi.description, f}; std::lock_guard lock(m_pluginMutex); m_plugins.insert(std::make_pair(pi.name, info)); return true; } template bool l_registerPlugin(const StaticPluginInfo& pi) { l_registerPlugin((const PluginInfo&)pi); m_extensions.set(pi.name, pi.extensions); return true; } bool l_loadPlugin(const std::string& pluginFilename); StringList l_names(); std::string l_description(const std::string& name); std::string l_link(const std::string& name); void l_loadAll(); DynamicLibraryMap m_dynamicLibraryMap; RegistrationInfoMap m_plugins; std::mutex m_pluginMutex; std::mutex m_libMutex; LogPtr m_log; StageExtensions m_extensions; }; } // namespace pdal