VOS::RemoteMetaObject Class Reference

A RemoteMetaObject is a Remote Vobject supporting the MetaObject extension architechture, allowing you to use meta_cast to select between available C++ interfaces supported by the Vobject type. More...

#include <vos/corelibs/vos/remotemetaobject.hh>

Inheritance diagram for VOS::RemoteMetaObject:

List of all members.

Public Member Functions

• virtual ~RemoteMetaObject ()
• virtual const string & getName ()

  Get the site name of this object.
  
  

• virtual Site & getSite ()

  Get the site this object resides on.
  
  

• virtual const URL & getURL ()

  Get the URL path (in the form "vop://site/name").
  
  

• virtual bool isLocal ()

  Return true if this object is local, false if not.
  
  

• virtual bool isRemote ()

  Return true if this object is remote, false if not.
  
  

• virtual const TypeSet & getTypes () throw (AccessControlError, RemoteError)

  Return a set of type names for the types supported by this object.
  
  

• virtual void addType (const string &s)

  Adds a new type to this object's type set.
  
  

• virtual const ParentSet & getParents () throw (AccessControlError, RemoteError)

  Get the set of parent-child relationships in which this object is the child.
  
  

• virtual const ChildList & getChildren () throw (AccessControlError, RemoteError)

  Get the set of parent-child relationships in which this object is the parent.
  
  

• virtual void sendMessage (Message *m)

  Sends a message to the object.
  
  

• virtual void sendMessage (MessageBlock *m)

  Sends a block of messages to the object.
  
  

• virtual Message * receiveMessage () throw (MessageQueueEmptyError)

  Gets the next message the object has received.
  
  

• virtual bool hasMessageAvailable ()

  Returns if the object has a message available to be dequeued by receiveMessage().
  
  

• virtual void handleNewType (const string &t)
• virtual void sendUpdateMessage (Message *m)

  Gets the next message the update object has received.
  
  

• virtual Message * receiveUpdateMessage () throw (MessageQueueEmptyError)

  Gets the next update message the object has received.
  
  

• virtual bool hasUpdateMessageAvailable ()

  Returns if the object has a message available to be dequeued by receiveUpdateMessage().
  
  

• virtual Vobject & findObject (const string &path) throw (NoSuchSiteError, NoSuchObjectError, URL::BadURLError, AccessControlError, RemoteError)

  Searchs and returns some object similarly to findObjectFromRoot().
  
  

• virtual Vobject::ParentChildRelation & findChild (const string &path) throw (NoSuchObjectError, AccessControlError, RemoteError)

  Find a child.
  
  

• virtual Vobject::ParentChildRelation & findParent (Vobject &parent) throw (NoSuchObjectError, AccessControlError, RemoteError)

  Find a parent.
  
  

• virtual void setChild (int position, const string &contextual_name, Vobject *child) throw (AccessControlError, RemoteError)
• virtual void insertChild (int position, const string &contextual_name, Vobject *child) throw (AccessControlError, RemoteError)

  Insert a child at some position with a new object.
  
  

• virtual void removeChild (int position) throw (AccessControlError, RemoteError)

  Remove the child at some position.
  
  

• virtual void addTypeListener (TypeChangeListener *tl, bool notifyImmediately=true)

  Adds some object callback to be notified when the type set changes.
  
  

• virtual void addParentListener (ParentChangeListener *pl, bool notifyImmediately=true)

  Adds some object callback to be notified when the parent set changes.
  
  

• virtual void addChildListener (ChildChangeListener *cl, bool notifyImmediately=true)

  Adds some object callback to be notified when the child list changes.
  
  

• virtual void removeTypeListener (TypeChangeListener *tl)

  Removes an existing object callback, previously added with addTypeListener().
  
  

• virtual void removeParentListener (ParentChangeListener *pl)

  Removes an existing object callback, previously added with addParentListener().
  
  

• virtual void removeChildListener (ChildChangeListener *cl)

  Removes an existing object callback, previously added with addChildListener().
  
  

• virtual void saveState (MessageBlock &output, set< string > &types, bool portable)

  Create a message block which, when run, will recreate any non-VOS state related to this vobject (such as property values).
  
  

• virtual void addFlag (const string &flag)

  Add a flag string.
  
  

• virtual void removeFlag (const string &flag)

  Remove a flag string.
  
  

• virtual bool checkFlag (const string &flag)

  Check the flag string.
  
  

• virtual void excise ()
• virtual void acquire ()

  Note that this means you have a handle on the entire logical object!
  
  

• virtual void release ()

  Note that this means you are releasing the entire logical object!
  
  

• virtual int getCount ()

  Note that this counts for the entire logical object!
  
  

Protected Member Functions

• RemoteMetaObject (const string &name, RemoteSite *remotesite)

Friends

• class RemoteSite

---

Detailed Description

A RemoteMetaObject is a Remote Vobject supporting the MetaObject extension architechture, allowing you to use meta_cast to select between available C++ interfaces supported by the Vobject type.

Definition at line 42 of file remotemetaobject.hh.

---

Constructor & Destructor Documentation

RemoteMetaObject::RemoteMetaObject (  const string &  name, RemoteSite *  remotesite )  [protected]

Definition at line 34 of file remotemetaobject.cc. Referenced by VOS::RemoteSite::sendUpdateMessage().

RemoteMetaObject::~RemoteMetaObject (   )  [virtual]

Definition at line 41 of file remotemetaobject.cc.

---

Member Function Documentation

void RemoteMetaObject::acquire (   )  [virtual]

Note that this means you have a handle on the entire logical object! Reimplemented from VOS::MetaObject. Definition at line 297 of file remotemetaobject.cc.

void RemoteMetaObject::addChildListener (  ChildChangeListener *  cl, bool  notifyImmediately = true )  [virtual]

Adds some object callback to be notified when the child list changes. The child listener will immediately be issued a notifyChildInserted() for each child. Parameters: cl  The listener object. If this object is also a RefCounted object, reference counting will be done correctly. notifyImmediately  if true, notify listener immediately (before returning). otherwise defer until a future update Reimplemented from VOS::MetaObject. Definition at line 267 of file remotemetaobject.cc.

void RemoteMetaObject::addFlag (  const string &  flag  )  [virtual]

Add a flag string. Mainly useful for doing tree walks, when you want to mark an object as already having been touched. Parameters: flag  the flag string Implements VOS::Vobject. Definition at line 321 of file remotemetaobject.cc.

void RemoteMetaObject::addParentListener (  ParentChangeListener *  pl, bool  notifyImmediately = true )  [virtual]

Adds some object callback to be notified when the parent set changes. Parameters: pl  the listener object notifyImmediately if true, notify listener immediately (before returning). otherwise defer until a future update If this object is also a RefCounted object, reference counting will be done correctly. Reimplemented from VOS::MetaObject. Definition at line 261 of file remotemetaobject.cc.

void RemoteMetaObject::addType (  const string &  s  )  [virtual]

Adds a new type to this object's type set. This only changes the stored set of type name strings and does not necessarily affect the actual code behind the object. See the Local Site class for information about extending the actual functionality of an existing meta objects. Parameters: s  the type string Reimplemented from VOS::RemoteVobject. Definition at line 81 of file remotemetaobject.cc.

void RemoteMetaObject::addTypeListener (  TypeChangeListener *  tl, bool  notifyImmediately = true )  [virtual]

Adds some object callback to be notified when the type set changes. Parameters: tl  the listener object. notifyImmediately  if true, notify listener immediately (before returning). otherwise defer until a future update If this object is also a RefCounted object, reference counting will be done correctly. Reimplemented from VOS::MetaObject. Definition at line 255 of file remotemetaobject.cc.

bool RemoteMetaObject::checkFlag (  const string &  flag  )  [virtual]

Check the flag string. Parameters: flag  the flag string Returns: whether the flag string is set Implements VOS::Vobject. Definition at line 333 of file remotemetaobject.cc.

void RemoteMetaObject::excise (   )  [virtual]

Note: Important: this is delegated to the top object, and means you want the entire logical Vobject to go away! If called on an object with no superobject, it calls doExcise() on its type handlers. Type implementation specific cleanup code (such as calling excise on certain children no longer needed) should override doExcise(). Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteSite, and VOS::RemoteSocketSite. Definition at line 291 of file remotemetaobject.cc.

Vobject::ParentChildRelation & RemoteMetaObject::findChild (  const string &  path  )  throw (NoSuchObjectError, AccessControlError, RemoteError) [virtual]

Find a child. This searchs for a single parent-child relation in the immediate child list of this object. It is distinguished from findObject in that it returns the full parent-child relation structure, and that it only accepts two forms of input: the child name, or the #position. See setChild() for more information about the possible numerical values of positions. Parameters: path  either the child name or #position Returns: the ParentChildRelation structure representing the relation of this parent and the requested child. NOTE YOU MUST CALL release() WHEN DONE OR USE A rREF() BLOCK Exceptions: NoSuchObjectError  if the path is illegal AccessControlError  if the site reported the user is not allowed that information Reimplemented from VOS::RemoteVobject. Definition at line 220 of file remotemetaobject.cc.

Vobject & RemoteMetaObject::findObject (  const string &  path  )  throw (NoSuchSiteError, NoSuchObjectError, URL::BadURLError, AccessControlError, RemoteError) [virtual]

Searchs and returns some object similarly to findObjectFromRoot(). However, if the path does not start with the string "vop://" the path will be intepreted as relative to this object. For example, "foo/bar" will find the first child object named "foo" of this object, then the first child named "bar" of the "foo" object and return it. If there is a leading slash, the path is relative to the object's site, so "/foo/bar" does not necessarily mean the same thing. Note that there should never be a slash at the end, so "foo/" is NOT a legal path. Finally, instead of using child names, one may use "\#position", starting from zero. So "\#0" refers to the first child of this object, "\#1" to the second etc. Obviously if the number in #position is larger than the number of children, an exception will be raised. See setChild() for more information about the possible numerical values of positions. Parameters: path  the path to the object we want to find Returns: the object, if found. NOTE YOU MUST CALL release() WHEN DONE OR USE A rREF() BLOCK Exceptions: NoSuchSiteError  The DNS lookup for the site failed, the site is not listening on the expected port, or the site otherwise could not be connected to (only thrown if there is a site specified in the path.) NoSuchObjectError  if that object path does not exist on the site URL::BadURLError  if there is a syntax error in the supplied URL AccessControlError  if the site reported that the user is not allowed that information Reimplemented from VOS::RemoteVobject. Definition at line 213 of file remotemetaobject.cc.

Vobject::ParentChildRelation & RemoteMetaObject::findParent (  Vobject &  parent  )  throw (NoSuchObjectError, AccessControlError, RemoteError) [virtual]

Find a parent. This tests to see if the supplied Vobject is marked as a parent of this Vobject. Parameters: parent  the parent object Returns: the parent-child relation. NOTE YOU MUST CALL release() WHEN DONE OR USE A rREF() BLOCK Exceptions: NoSuchObjectError  if the object is NOT a parent AccessControlError  if the site reported the user is not allowed that information Reimplemented from VOS::MetaObject. Definition at line 227 of file remotemetaobject.cc.

const deque< Vobject::ParentChildRelation * > & RemoteMetaObject::getChildren (   )  throw (AccessControlError, RemoteError) [virtual]

Get the set of parent-child relationships in which this object is the parent. Returns: a set of parent-child relations Warning: You should always assign the results of getChildren to a variable. Do NOT do this: for(Vobject::ChildList::const_iterator i = v->getChildren().begin(); i != v->getChildren().end(); i++) { ... } Instead, you should do this: const ChildList& cl = v->getChildren(); for(Vobject::ChildList::const_iterator i = cl.begin(); i != cl.end(); i++) { ... } The reason for this is that if vobj is remote, each call to getChildren() may trigger a remote call. In addition to being inefficient, this will wipe and replace the child list you are in the midst of using, which will probably invalidate the iterator and cause your program to crash. Reimplemented from VOS::MetaObject. Definition at line 94 of file remotemetaobject.cc.

int RemoteMetaObject::getCount (   )  [virtual]

Note that this counts for the entire logical object! Reimplemented from VOS::MetaObject. Definition at line 307 of file remotemetaobject.cc. Referenced by VOS::RemoteSite::excise(), VOS::RemoteStreamSite::handleDisconnection(), VOS::RemoteSocketSite::handleDisconnection(), VOS::RemoteStreamSite::sendMessage(), and VOS::RemoteSocketSite::sendMessage().

const string & RemoteMetaObject::getName (   )  [virtual]

Get the site name of this object. Returns: the name string Reimplemented from VOS::MetaObject. Definition at line 45 of file remotemetaobject.cc.

const set< Vobject::ParentChildRelation *, Vobject::ParentChildRelation::Cmp > & RemoteMetaObject::getParents (   )  throw (AccessControlError, RemoteError) [virtual]

Get the set of parent-child relationships in which this object is the child. Returns: a set of parent-child relations Reimplemented from VOS::MetaObject. Definition at line 87 of file remotemetaobject.cc.

Site & RemoteMetaObject::getSite (   )  [virtual]

Get the site this object resides on. Returns: the site object. NOTE YOU MUST CALL release() WHEN DONE OR USE A rREF() BLOCK Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteSite. Definition at line 51 of file remotemetaobject.cc.

const set< string > & RemoteMetaObject::getTypes (   )  throw (AccessControlError, RemoteError) [virtual]

Return a set of type names for the types supported by this object. Returns: the set of type names Reimplemented from VOS::MetaObject. Definition at line 75 of file remotemetaobject.cc. Referenced by VOS::RemoteSite::notifyChildInserted().

const URL & RemoteMetaObject::getURL (   )  [virtual]

Get the URL path (in the form "vop://site/name"). Returns: the URL Reimplemented from VOS::MetaObject. Definition at line 57 of file remotemetaobject.cc. Referenced by VOS::RemoteSite::notifyChildInserted(), VOS::RemoteSite::notifyChildRemoved(), VOS::RemoteSite::notifyChildReplaced(), VOS::RemoteSite::notifyParentInserted(), VOS::RemoteSite::notifyParentRemoved(), VOS::RemoteSite::notifyTypeInserted(), VOS::RemoteSite::notifyTypeRemoved(), VOS::RemoteStreamSite::sendMessage(), VOS::RemoteSocketSite::sendMessage(), VOS::RemoteSite::unlockChildNotifyOutgoing(), VOS::RemoteSite::unlockParentNotifyOutgoing(), VOS::RemoteSite::unlockTypeNotifyOutgoing(), ~RemoteMetaObject(), VOS::RemoteSite::~RemoteSite(), VOS::RemoteSocketSite::~RemoteSocketSite(), and VOS::RemoteStreamSite::~RemoteStreamSite().

void RemoteMetaObject::handleNewType (  const string &  t  )  [virtual]

Definition at line 131 of file remotemetaobject.cc. Referenced by sendUpdateMessage().

bool RemoteMetaObject::hasMessageAvailable (   )  [virtual]

Returns if the object has a message available to be dequeued by receiveMessage(). Returns: True if receiveMessage will succeed, false if receiveMessage will throw an exception. Reimplemented from VOS::MetaObject. Definition at line 125 of file remotemetaobject.cc.

bool RemoteMetaObject::hasUpdateMessageAvailable (   )  [virtual]

Returns if the object has a message available to be dequeued by receiveUpdateMessage(). Returns: True if receiveMessage() will succeed, false if receiveMessage will throw an exception. Reimplemented from VOS::MetaObject. Definition at line 207 of file remotemetaobject.cc.

void RemoteMetaObject::insertChild (  int  position, const string &  contextual_name, Vobject *  child )  throw (AccessControlError, RemoteError) [virtual]

Insert a child at some position with a new object. If the position is positive, the object is inserted such that it now occupies that position, and all objects starting from the previous occupant of that position onward are moved up one. If the position in negative, the object is similarly inserted so that it now occupies that position. For example, position -1 will append the object to the end of the list, position -2 will insert the object in the second-to-last position, etc. See setChild() for more information on positions. Parameters: position  the position contextual_name  This is the name, specific to this parent-child relation, used for refering to this object by path. child  the child object, in question Exceptions: AccessControl  if this object (when it is remote) doesn't approve of this action. Reimplemented from VOS::RemoteVobject. Definition at line 241 of file remotemetaobject.cc.

bool RemoteMetaObject::isLocal (   )  [virtual]

Return true if this object is local, false if not. Returns: whether it is local Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteStreamSite. Definition at line 63 of file remotemetaobject.cc.

bool RemoteMetaObject::isRemote (   )  [virtual]

Return true if this object is remote, false if not. Returns: whether it is remote Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteStreamSite. Definition at line 69 of file remotemetaobject.cc.

Message * RemoteMetaObject::receiveMessage (   )  throw (MessageQueueEmptyError) [virtual]

Gets the next message the object has received. Exceptions: MessageQueueEmptyError  If the message queue is empty. This may be the case if there are no messages available or if the user has set DoNotQueueMsgs to true in VobjectImplementation. Returns: the message. NOTE YOU MUST CALL release() WHEN DONE OR USE vRef! Reimplemented from VOS::MetaObject. Definition at line 119 of file remotemetaobject.cc.

Message * RemoteMetaObject::receiveUpdateMessage (   )  throw (MessageQueueEmptyError) [virtual]

Gets the next update message the object has received. Exceptions: MessageQueueEmptyError  If the message queue is empty. This may be the case if there are no messages available or if the user has set DoNotQueueUpdateMsgs to true in VobjectImplementation. Returns: the message. NOTE YOU MUST CALL release() WHEN DONE OR USE vRef! Reimplemented from VOS::MetaObject. Definition at line 201 of file remotemetaobject.cc.

void RemoteMetaObject::release (   )  [virtual]

Note that this means you are releasing the entire logical object! Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteSite. Definition at line 302 of file remotemetaobject.cc.

void RemoteMetaObject::removeChild (  int  position  )  throw (AccessControlError, RemoteError) [virtual]

Remove the child at some position. See setChild() for more information on positions. Parameters: position  the position Exceptions: AccessControl  if this object (when it is remote) doesn't approve of this action. Reimplemented from VOS::MetaObject. Definition at line 248 of file remotemetaobject.cc.

void RemoteMetaObject::removeChildListener (  ChildChangeListener *  cl  )  [virtual]

Removes an existing object callback, previously added with addChildListener(). Parameters: cl  the listener object If this object is also a RefCounted object, reference counting will be done correctly. Reimplemented from VOS::MetaObject. Definition at line 285 of file remotemetaobject.cc.

void RemoteMetaObject::removeFlag (  const string &  flag  )  [virtual]

Remove a flag string. Parameters: flag  the flag string Implements VOS::Vobject. Definition at line 327 of file remotemetaobject.cc.

void RemoteMetaObject::removeParentListener (  ParentChangeListener *  pl  )  [virtual]

Removes an existing object callback, previously added with addParentListener(). Parameters: pl  the listener object If this object is also a RefCounted object, reference counting will be done correctly. Reimplemented from VOS::MetaObject. Definition at line 279 of file remotemetaobject.cc.

void RemoteMetaObject::removeTypeListener (  TypeChangeListener *  tl  )  [virtual]

Removes an existing object callback, previously added with addTypeListener(). Parameters: tl  the listener object If this object is also a RefCounted object, reference counting will be done correctly. Reimplemented from VOS::MetaObject. Definition at line 273 of file remotemetaobject.cc.

void RemoteMetaObject::saveState (  MessageBlock &  output, set< string > &  types, bool  portable )  [virtual]

Create a message block which, when run, will recreate any non-VOS state related to this vobject (such as property values). In other words, it should not emit anything related to parent-child relationships, but is rather is a hook for other arbitrary state information, encoded as messages. Note: Save-state routines ought to work for saving remote objects as well, based on available state. Also, only the method and the message fields themselves should be used. "To", "from", "nonce" and others will be ignored. Parameters: output  messages should be appended to this message block types  the type set that should be output for this vobject portable  If true, generate a "portable" state. This means that all the data required to restore state should be embedded in the message. If false, fully recreating the state may rely on external resources such as files or databases. Implements VOS::Vobject. Definition at line 312 of file remotemetaobject.cc.

void RemoteMetaObject::sendMessage (  MessageBlock *  m  )  [virtual]

Sends a block of messages to the object. This may trigger immediate processing of the message if the object is local. Parameters: m  A pointer to the message which is being sent. Its reference count will be increased as necssary. Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteSite, VOS::RemoteSocketSite, and VOS::RemoteStreamSite. Definition at line 110 of file remotemetaobject.cc.

void RemoteMetaObject::sendMessage (  Message *  m  )  [virtual]

Sends a message to the object. This may trigger immediate processing of the message if the object is local. Parameters: m  A pointer to the message which is being sent. Its reference count will be increased as necssary. Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteSite, VOS::RemoteSocketSite, and VOS::RemoteStreamSite. Definition at line 101 of file remotemetaobject.cc.

void RemoteMetaObject::sendUpdateMessage (  Message *  m  )  [virtual]

Gets the next message the update object has received. Update messages are special in that they consist of messages sent from remote sites to update changes to our local cache. Parameters: m  A pointer to the message which is being sent. Its reference count will be increased as necssary. Reimplemented from VOS::MetaObject. Reimplemented in VOS::RemoteSite. Definition at line 179 of file remotemetaobject.cc.

void RemoteMetaObject::setChild (  int  position, const string &  contextual_name, Vobject *  child )  throw (AccessControlError, RemoteError) [virtual]

Note: supplying a NULL for child means release child object but do not delete parent-child relation... Reimplemented from VOS::RemoteVobject. Reimplemented in VOS::RemoteSite. Definition at line 234 of file remotemetaobject.cc.

---

Friends And Related Function Documentation

friend class RemoteSite [friend]

Definition at line 104 of file remotemetaobject.hh.

---

The documentation for this class was generated from the following files:

• vos/corelibs/vos/remotemetaobject.hh
• vos/corelibs/vos/remotemetaobject.cc

---