#ifndef ARCLIENTDATA_H
#define ARCLIENTDATA_H

#include "Aria.h"
class ArNetPacket;

/// class to hold information about the different data the client has
/**
   This class is mostly just for holding all the information about one
   of the client data entires in one convenient spot

   Information about the data flags held here... The recognized ones
   right now are just for return values so some forwarding can be done
   intelligently, you should only have one return value, they are:
   RETURN_NONE (There are no return packets), RETURN_SINGLE (There is
   exactly one return packet), RETURN_UNTIL_EMPTY (There return goes
   until an empty packet), RETURN_VIDEO (this is the special case for
   video where basically its something thats always requested at an
   interval and everyone'll want it after we've transfered it),
   RETURN_COMPLEX (The return is more complex (so you'll need a helper
   class))
**/

class ArClientData
{
public:
  /// Constructor
  AREXPORT ArClientData(const char *name, const char *description, 
			unsigned int command, 
			ArFunctor1<ArNetPacket *> *functor);
  /// Destructor
  AREXPORT virtual ~ArClientData();
  /// Gets the name
  const char *getName(void) { return myName.c_str(); }
  /// Gets the description
  const char *getDescription(void) { return myDescription.c_str(); }
  unsigned int getCommand(void) { return myCommand; }
  /// Gets the argument description
  const char *getArgumentDescription(void) 
    { return myArgumentDescription.c_str(); }
  /// Gets the return description
  const char *getReturnDescription(void) 
    { return myReturnDescription.c_str(); }
  /// Gets the command group
  const char *getCommandGroup(void) { return myCommandGroup.c_str(); }
  AREXPORT bool hasDataFlag(const char *dataFlag);
  const char *getDataFlagsString(void) 
    { return myDataFlagsBuilder.getFullString(); }
  /// Gets the list of functors
  const std::list<ArFunctor1<ArNetPacket *> *> *getFunctorList(void) const
    { return &myFunctorList; };
  /// Locks the functor list so we can walk it without it changing
  AREXPORT int lockFunctorList(void) { return myMutex.lock(); }
  /// Tries to lock the functor list so we can walk it without it changing
  AREXPORT int tryLockFunctorList(void) { return myMutex.tryLock(); }
  /// Unlocks the functor list so we can walk it without it changing
  AREXPORT int unlockFunctorList(void) { return myMutex.unlock(); }
  
  /// Adds a new functor the end of the list
  void addFunctor(ArFunctor1<ArNetPacket *> *functor) 
    { myFunctorList.push_back(functor); }
  /// Removes a functor from the list all together
  void remFunctor(ArFunctor1<ArNetPacket *> *functor) 
    { myFunctorList.remove(functor); }
  /// Sets the argument and return descriptions
  void setArgRetDescs(const char *argDesc, const char *retDesc)
    { myArgumentDescription = argDesc; myReturnDescription = retDesc; }
  /// Sets the command group
  void setCommandGroup(const char *commandGroup) 
    { myCommandGroup = commandGroup; }
  /// Sets the data flags
  AREXPORT void addDataFlags(const char *dataFlags);
protected:
  std::string myName;
  std::string myDescription;
  unsigned int myCommand;
  std::string myArgumentDescription;
  std::string myReturnDescription;
  std::string myCommandGroup;
  ArMutex myDataMutex;
  ArArgumentBuilder myDataFlagsBuilder;
  ArMutex myMutex;
  std::list<ArFunctor1<ArNetPacket *> *> myFunctorList;
};

#endif // ARCLIENTDATA_H