platform/include/pion/platform/ProtocolFactory.hpp

00001 // ------------------------------------------------------------------------
00002 // Pion is a development platform for building Reactors that process Events
00003 // ------------------------------------------------------------------------
00004 // Copyright (C) 2007-2008 Atomic Labs, Inc.  (http://www.atomiclabs.com)
00005 //
00006 // Pion is free software: you can redistribute it and/or modify it under the
00007 // terms of the GNU Affero General Public License as published by the Free
00008 // Software Foundation, either version 3 of the License, or (at your option)
00009 // any later version.
00010 //
00011 // Pion is distributed in the hope that it will be useful, but WITHOUT ANY
00012 // WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
00013 // FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for
00014 // more details.
00015 //
00016 // You should have received a copy of the GNU Affero General Public License
00017 // along with Pion.  If not, see <http://www.gnu.org/licenses/>.
00018 //
00019 
00020 #ifndef __PION_PROTOCOLFACTORY_HEADER__
00021 #define __PION_PROTOCOLFACTORY_HEADER__
00022 
00023 #include <string>
00024 #include <libxml/tree.h>
00025 #include <pion/PionConfig.hpp>
00026 #include <pion/PionException.hpp>
00027 #include <pion/platform/Protocol.hpp>
00028 #include <pion/platform/PluginConfig.hpp>
00029 
00030 
00031 namespace pion {        // begin namespace pion
00032 namespace platform {    // begin namespace platform (Pion Platform Library)
00033 
00037 class PION_PLATFORM_API ProtocolFactory :
00038     public PluginConfig<Protocol>
00039 {
00040 public:
00041 
00043     class ProtocolNotFoundException : public PionException {
00044     public:
00045         ProtocolNotFoundException(const std::string& protocol_id)
00046             : PionException("No protocol found for identifier: ", protocol_id) {}
00047     };
00048 
00049     
00051     virtual ~ProtocolFactory() {}
00052     
00058     explicit ProtocolFactory(const VocabularyManager& vocab_mgr);
00059 
00066     ProtocolPtr getProtocol(const std::string& protocol_id);
00067 
00075     void setProtocolConfig(const std::string& protocol_id, const xmlNodePtr config_ptr);
00076 
00085     std::string addProtocol(const xmlNodePtr config_ptr);
00086     
00092     void removeProtocol(const std::string& protocol_id);
00093 
00102     static xmlNodePtr createProtocolConfig(const char *buf, std::size_t len) {
00103         return ConfigManager::createResourceConfig(PROTOCOL_ELEMENT_NAME, buf, len);
00104     }
00105     
00106 protected:
00107     
00119     virtual void addPluginNoLock(const std::string& plugin_id,
00120                                  const std::string& plugin_name,
00121                                  const xmlNodePtr config_ptr)
00122     {
00123         try {
00124             Protocol *new_plugin_ptr = m_plugins.load(plugin_id, plugin_name);
00125             new_plugin_ptr->setId(plugin_id);
00126             new_plugin_ptr->setProtocolFactory(*this);
00127             if (config_ptr != NULL) {
00128                 VocabularyPtr vocab_ptr(m_vocab_mgr.getVocabulary());
00129                 new_plugin_ptr->setConfig(*vocab_ptr, config_ptr);
00130             }
00131         } catch (PionPlugin::PluginNotFoundException&) {
00132             throw;
00133         } catch (std::exception& e) {
00134             throw PluginException(e.what());
00135         }
00136     }
00137 
00138     
00139 private:
00140     
00142     static const std::string        DEFAULT_CONFIG_FILE;
00143 
00145     static const std::string        PROTOCOL_ELEMENT_NAME;
00146 };
00147 
00148 
00149 }   // end namespace platform
00150 }   // end namespace pion
00151 
00152 #endif

Generated on Wed Apr 13 16:38:34 2011 for pion-platform by  doxygen 1.4.7