attribute_bundle.h

Go to the documentation of this file.

#ifndef ATTRIBUTE_BUNDLE_CLASS
#define ATTRIBUTE_BUNDLE_CLASS

/*****************************************************************************\
*                                                                             *
*  Name   : attribute_bundle                                                  *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 2002-$now By Author.  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 is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/

#include "dll_list_synch.h"

#include <mechanisms/time_stamp.h>
#include <octopus/infoton.h>


class LIST_SYNCHRONIZER_CLASS_STYLE attribute_bundle : public infoton
{
public:
  enum modifications {
    ADDED,     // the object is new.
    CHANGED,   // the object has been modified.
    DELETED    // the object got removed.
  };

  modifications _mod;
    // the type of change that has happened for this object.  the derived
    // class must pack this information in the derived pack() method and
    // retrieve the modification info in unpack().  there are helper functions
    // pack_mod() and unpack_mod() to automate that responsibility.

  time_stamp _updated;
    // when this information was last updated.  this should not be packed,
    // since it is only locally relevant.

  attribute_bundle(const string_array &object_id) : infoton(object_id) {}
    // constructs the base portion of an attribute bundle for an object with
    // the "object_id".  the "object_id" must follow the rules for infoton
    // classifiers.  the last string in the object id is the list-unique
    // identifier for this set of attributes.

  enum outcomes {
    OKAY = common::OKAY,  // the operation completed successfully.
    BAD_TYPE = common::BAD_TYPE,  // provided object had an incompatible type.
    EMPTY = common::IS_EMPTY  // the merge resulted in clearing this entry.
  };

  // helper functions for packing the modification information.
  void pack_mod(byte_array &packed_form) const;
  bool unpack_mod(byte_array &packed_form);
  int packed_mod_size() const { return sizeof(int); }

  virtual outcome merge(const attribute_bundle &to_merge) = 0;
    // overwrites any attributes in "this" bundle with the contents found
    // in "to_merge".  this can fail if the object types are different.

  virtual istring text_form() const = 0;
    // provides a visual form of the data held in this bundle.

  // promote requirements of the infoton to derived objects.
  virtual void pack(byte_array &packed_form) const = 0;
  virtual bool unpack(byte_array &packed_form) = 0;
  virtual clonable *clone() const = 0;
  virtual int packed_size() const = 0;
};

#endif

---