/****************************************************************************** * 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 namespace icinga { /** * The type of an attribute for a DynamicObject. * * @ingroup base */ enum DynamicAttributeType { Attribute_Transient = 1, /* Unlike transient attributes local attributes are persisted * in the program state file. */ Attribute_Local = 2, /* Replicated attributes are sent to other daemons for which * replication is enabled. */ Attribute_Replicated = 4, /* Attributes read from the config file are implicitly marked * as config attributes. */ Attribute_Config = 8, /* Combination of all attribute types */ Attribute_All = Attribute_Transient | Attribute_Local | Attribute_Replicated | Attribute_Config }; /** * An attribute for a DynamicObject. * * @ingroup base */ struct DynamicAttribute { Value Data; /**< The current value of the attribute. */ DynamicAttributeType Type; /**< The type of the attribute. */ double Tx; /**< The timestamp of the last value change. */ }; /** * 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: typedef shared_ptr Ptr; typedef weak_ptr WeakPtr; typedef function Factory; typedef map ClassMap; typedef map NameMap; typedef map TypeMap; typedef map AttributeMap; typedef AttributeMap::iterator AttributeIterator; typedef AttributeMap::const_iterator AttributeConstIterator; DynamicObject(const Dictionary::Ptr& serializedObject); Dictionary::Ptr BuildUpdate(double sinceTx, int attributeTypes) const; void ApplyUpdate(const Dictionary::Ptr& serializedUpdate, int allowedTypes); void RegisterAttribute(const String& name, DynamicAttributeType type); void Set(const String& name, const Value& data); void Touch(const String& name); Value Get(const String& name) const; bool HasAttribute(const String& name) const; void ClearAttributesByType(DynamicAttributeType type); static boost::signal OnRegistered; static boost::signal OnUnregistered; static boost::signal&)> OnTransactionClosing; ScriptTask::Ptr InvokeMethod(const String& method, const vector& arguments, ScriptTask::CompletionCallback callback); String GetType(void) const; String GetName(void) const; bool IsLocal(void) const; bool IsAbstract(void) const; void SetSource(const String& value); String GetSource(void) const; void SetTx(double tx); double GetTx(void) const; void Register(void); void Unregister(void); virtual void Start(void); static DynamicObject::Ptr GetObject(const String& type, const String& name); static pair GetTypes(void); static pair GetObjects(const String& type); static void DumpObjects(const String& filename); static void RestoreObjects(const String& filename); static void DeactivateObjects(void); static void RegisterClass(const String& type, Factory factory); static bool ClassExists(const String& type); static DynamicObject::Ptr Create(const String& type, const Dictionary::Ptr& serializedUpdate); static double GetCurrentTx(void); static void BeginTx(void); static void FinishTx(void); protected: virtual void OnAttributeChanged(const String& name, const Value& oldValue); private: void InternalSetAttribute(const String& name, const Value& data, double tx, bool suppressEvent = false); Value InternalGetAttribute(const String& name) const; static ClassMap& GetClasses(void); static TypeMap& GetAllObjects(void); AttributeMap m_Attributes; double m_ConfigTx; static double m_CurrentTx; static set m_ModifiedObjects; void InternalApplyUpdate(const Dictionary::Ptr& serializedUpdate, int allowedTypes, bool suppressEvents); }; /** * Helper class for registering DynamicObject implementation classes. * * @ingroup base */ class RegisterClassHelper { public: RegisterClassHelper(const String& name, DynamicObject::Factory factory) { if (!DynamicObject::ClassExists(name)) DynamicObject::RegisterClass(name, factory); } }; /** * Factory function for DynamicObject-based classes. * * @ingroup base */ template shared_ptr DynamicObjectFactory(const Dictionary::Ptr& serializedUpdate) { return boost::make_shared(serializedUpdate); } #define REGISTER_CLASS_ALIAS(klass, alias) \ static RegisterClassHelper g_Register ## klass(alias, DynamicObjectFactory) #define REGISTER_CLASS(klass) \ REGISTER_CLASS_ALIAS(klass, #klass) } #endif /* DYNAMICOBJECT_H */