/****************************************************************************** * Icinga 2 * * Copyright (C) 2012 Icinga Development Team (http://www.icinga.org/) * * * * This program is free software; you can redistribute it and/or * * modify it under the terms of the GNU General Public License * * as published by the Free Software Foundation; either version 2 * * of the License, or (at your option) any later version. * * * * This program 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 General Public License for more details. * * * * You should have received a copy of the GNU General Public License * * along with this program; if not, write to the Free Software Foundation * * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. * ******************************************************************************/ #ifndef DYNAMICOBJECT_H #define DYNAMICOBJECT_H #include "base/i2-base.h" #include "base/object.h" #include "base/dictionary.h" #include #include #include namespace icinga { class DynamicType; /** * The type of an attribute for a DynamicObject. * * @ingroup base */ enum AttributeType { Attribute_Transient = 1, /* Unlike transient attributes local attributes are persisted * in the program state file. */ Attribute_Local = 2, /* Attributes read from the config file are implicitly marked * as config attributes. */ Attribute_Config = 4, /* Combination of all attribute types */ Attribute_All = Attribute_Transient | Attribute_Local | Attribute_Config }; /** * A dynamic object that can be instantiated from the configuration file * and that supports attribute replication to remote application instances. * * @ingroup base */ class I2_BASE_API DynamicObject : public Object { public: DECLARE_PTR_TYPEDEFS(DynamicObject); ~DynamicObject(void); Dictionary::Ptr Serialize(int attributeTypes) const; void Deserialize(const Dictionary::Ptr& update, int attributeTypes); static boost::signals2::signal OnStarted; static boost::signals2::signal OnStopped; static boost::signals2::signal OnStateChanged; Value InvokeMethod(const String& method, const std::vector& arguments); shared_ptr GetType(void) const; String GetName(void) const; bool IsActive(void) const; void SetExtension(const String& key, const Object::Ptr& object); Object::Ptr GetExtension(const String& key); void ClearExtension(const String& key); void Register(void); void Activate(void); void Deactivate(void); virtual void Start(void); virtual void Stop(void); template static shared_ptr GetObject(const String& name) { DynamicObject::Ptr object = GetObject(T::GetTypeName(), name); return dynamic_pointer_cast(object); } static void DumpObjects(const String& filename, int attributeTypes = Attribute_Local); static void RestoreObjects(const String& filename, int attributeTypes = Attribute_Local); static void StopObjects(void); Dictionary::Ptr GetCustom(void) const; protected: explicit DynamicObject(void); virtual void InternalSerialize(const Dictionary::Ptr& bag, int attributeTypes) const; virtual void InternalDeserialize(const Dictionary::Ptr& bag, int attributeTypes); private: String m_Name; String m_Type; Dictionary::Ptr m_Extensions; Dictionary::Ptr m_Methods; Dictionary::Ptr m_Custom; bool m_Active; static DynamicObject::Ptr GetObject(const String& type, const String& name); }; #define DECLARE_TYPENAME(klass) \ inline static String GetTypeName(void) \ { \ return #klass; \ } \ \ inline static shared_ptr GetByName(const String& name) \ { \ return DynamicObject::GetObject(name); \ } } #endif /* DYNAMICOBJECT_H */