/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */

/*

 * Copyright (c) 2008 INRIA

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License version 2 as

 * published by the Free Software Foundation;

 *

 * 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 *

 * Authors: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>

 */

#ifndef OBJECT_BASE_H

#define OBJECT_BASE_H

#include "type-id.h"

#include "callback.h"

#include <string>

#include <list>

/**

 * \ingroup object

 *

 * This macro should be invoked once for every class which

 * defines a new GetTypeId method.

 *

 * If the class is in a namespace, then the macro call should also be

 * in the namespace.

 */

#define NS_OBJECT_ENSURE_REGISTERED(type)               \

  static struct Object ## type ## RegistrationClass     \

  {                                                     \

    Object ## type ## RegistrationClass () {            \

      ns3::TypeId tid = type::GetTypeId ();             \

      tid.SetSize (sizeof (type));                      \

      tid.GetParent ();                                 \

    }                                                   \

  } Object ## type ## RegistrationVariable

namespace ns3 {

class AttributeConstructionList;

/**

 * \ingroup object

 *

 *

 * Every class which wants to integrate in the ns-3 type and attribute

 * system should derive from this base class. This base class provides:

 */

class ObjectBase

{

public:

  /**

   * Get the type ID.

   */

  static TypeId GetTypeId (void);

  /**

   */

  virtual ~ObjectBase ();

  /**

   *

   * This method is typically implemented by ns3::Object::GetInstanceTypeId

   * but some classes which derive from ns3::ObjectBase directly

   * have to implement it themselves.

   */

  virtual TypeId GetInstanceTypeId (void) const = 0;

  /**

   *

   */

  void SetAttribute (std::string name, const AttributeValue &value);

  /**

   */

  bool SetAttributeFailSafe (std::string name, const AttributeValue &value);

  /**

   *

   */

  void GetAttribute (std::string name, AttributeValue &value) const;

  /**

   */

  /**

   *

   */

  bool TraceConnect (std::string name, std::string context, const CallbackBase &cb);

  /**

   *

   */

  bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb);

  /**

   *

   */

  bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb);

  /**

   *

   */

  bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb);

protected:

  /**

   * This method is invoked once all member attributes have been 

   * initialized. Subclasses can override this method to be notified

   * of this event but if they do this, they must chain up to their

   * parent's NotifyConstructionCompleted method.

   */

  virtual void NotifyConstructionCompleted (void);

  /**

   *

   * Invoked from subclasses to initialize all of their 

   * attribute members. This method will typically be invoked

   * automatically from ns3::CreateObject if your class derives

   * from ns3::Object. If you derive from ns3::ObjectBase directly,

   * you should make sure that you invoke this method from

   * your most-derived constructor.

   */

  void ConstructSelf (const AttributeConstructionList &attributes);

private:

  /**

   * Attempt to set the value referenced by the accessor \p spec

   * to a valid value according to the \c checker, based on \p value.

   *

   * \param [in] spec The accessor for the storage location.

   * \param [in] checker The checker to use in validating the value.

   * \param [in] value The value to attempt to store.

   *          and written to the storage location.

   */

  bool DoSet (Ptr<const AttributeAccessor> spec,

              Ptr<const AttributeChecker> checker, 

              const AttributeValue &value);

};

} // namespace ns3

#endif /* OBJECT_BASE_H */