More progress.

git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@3862 542714f4-19e9-0310-aa3c-eee0fc999fb1

src/as/com/threerings/presents/dobj/AttributeChangeListener.as

@@ -0,0 +1,42 @@
+//
+// $Id: AttributeChangeListener.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+/**
+ * Implemented by entites which wish to hear about attribute changes that
+ * take place for a particular distributed object.
+ *
+ * @see DObject#addListener
+ */
+public interface AttributeChangeListener extends ChangeListener
+{
+    /**
+     * Called when an attribute changed event has been dispatched on an
+     * object. This will be called <em>after</em> the event has been
+     * applied to the object. So fetching the attribute during this call
+     * will provide the new value for the attribute.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    function attributeChanged (event :AttributeChangedEvent) :void;
+}
+}

src/as/com/threerings/presents/dobj/CompoundEvent.as

@@ -0,0 +1,180 @@
+//
+// $Id: CompoundEvent.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+import flash.util.StringBuilder;
+
+import mx.collections.IList;
+
+import com.threerings.io.ObjectInputStream;
+import com.threerings.io.ObjectOutputStream;
+
+import com.threerings.util.StreamableArrayList;
+
+/**
+ * Used to manage and submit groups of events on a collection of
+ * distributed objects in a single transaction.
+ *
+ * @see DObject#startTransaction
+ */
+public class CompoundEvent extends DEvent
+{
+    /**
+     * Constructs a compound event and prepares it for operation.
+     */
+    public CompoundEvent (target :DObject, omgr :DObjectManager)
+    {
+        super(target.getOid());
+
+        // sanity check
+        if (omgr == null) {
+            throw new ArgumentError(
+                "Must receive non-null object manager reference");
+        }
+
+        _omgr = omgr;
+        _target = target;
+        _events = new StreamableArrayList();
+    }
+
+    /**
+     * Posts an event to this transaction. The event will be delivered as
+     * part of the entire transaction if it is committed or discarded if
+     * the transaction is cancelled.
+     */
+    public function postEvent (event :DEvent) :void
+    {
+        _events.addItem(event);
+    }
+
+    /**
+     * Returns the list of events contained within this compound event.
+     * Don't mess with it.
+     */
+    public function getEvents () :IList
+    {
+        return _events;
+    }
+
+    /**
+     * Commits this transaction by posting this event to the distributed
+     * object event queue. All participating dobjects will have their
+     * transaction references cleared and will go back to normal
+     * operation.
+     */
+    public function commit () :void
+    {
+        // first clear our target
+        clearTarget();
+
+        // then post this event onto the queue (but only if we actually
+        // accumulated some events)
+        switch (_events.length) {
+        case 0: // nothing doing
+            break;
+        case 1: // no point in being compound
+            _omgr.postEvent(_events.getItemAt(0));
+            break;
+        default: // now we're talking
+            _omgr.postEvent(this);
+            break;
+        }
+    }
+
+    /**
+     * Cancels this transaction. All events posted to this transaction
+     * will be discarded.
+     */
+    public function cancel () :void
+    {
+        // clear our target
+        clearTarget();
+        // clear our event queue in case someone holds onto us
+        _events.removeAll();
+    }
+
+    /**
+     * We need to propagate our source oid to our constituent events.
+     */
+    public override function setSourceOid (sourceOid :int) :void
+    {
+        super.setSourceOid(sourceOid);
+
+        for (var ii :int = 0; ii < _events.length; ii++) {
+            _events.getItemAt(ii).setSourceOid(sourceOid);
+        }
+    }
+
+    /**
+     * Nothing to apply here.
+     */
+    public override function applyToObject (target :DObject) :Boolean
+        //throws ObjectAccessException
+    {
+        return false;
+    }
+
+    /**
+     * Calls out to our target object, clearing its transaction reference.
+     */
+    protected function clearTarget () :void
+    {
+        if (_target != null) {
+            _target.clearTransaction();
+            _target = null;
+        }
+    }
+
+    // documentation inherited
+    protected override function toString (buf :StringBuilder) :void
+    {
+        buf.append("COMPOUND:");
+        super.toString(buf);
+
+        for (var ii :int = 0; ii < _events.length; ii++) {
+            buf.append(", ", _events.getItemAt(ii));
+        }
+    }
+
+    public override function writeObject (out :ObjectOutputStream) :void
+    {
+        super.writeObject(out);
+        out.writeField(_events);
+    }
+
+    public override function readObject (ins :ObjectInputStream) :void
+    {
+        super.readObject(ins);
+        _events = ins.readField(StreamableArrayList);
+    }
+
+    /** The object manager that we'll post ourselves to when we're
+     * committed. */
+    protected var _omgr :DObjectManager;
+
+    /** The object for which we're managing a transaction. */
+    protected var _target :DObject;
+
+    /** A list of the events associated with this compound event. */
+    protected var _events :StreamableArrayList;
+}
+}

src/as/com/threerings/presents/dobj/ElementUpdateListener.as

@@ -0,0 +1,42 @@
+//
+// $Id: ElementUpdateListener.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+/**
+ * Implemented by entites which wish to hear about element updates that
+ * take place for a particular distributed object.
+ *
+ * @see DObject#addListener
+ */
+public interface ElementUpdateListener extends ChangeListener
+{
+    /**
+     * Called when an element updated event has been dispatched on an
+     * object. This will be called <em>after</em> the event has been
+     * applied to the object. So fetching the element during this call
+     * will provide the new value for the element.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    function elementUpdated (event :ElementUpdatedEvent) :void;
+}
+}

src/as/com/threerings/presents/dobj/EventListener.as

@@ -0,0 +1,44 @@
+//
+// $Id: EventListener.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+/**
+ * Implemented by entites which wish to hear about all events being
+ * dispatched on a particular distributed object.
+ *
+ * @see DObject#addListener
+ */
+public interface EventListener extends ChangeListener
+{
+    /**
+     * Called when any event has been dispatched on an object. The event
+     * will be of the derived class that corresponds to the kind of event
+     * that occurred on the object. This will be called <em>after</em> the
+     * event has been applied to the object. So fetching an attribute upon
+     * receiving an attribute changed event will provide the new value for
+     * the attribute.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    function eventReceived (event :DEvent) :void;
+}
+}

src/as/com/threerings/presents/dobj/MessageListener.as

@@ -0,0 +1,39 @@
+//
+// $Id: MessageListener.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+/**
+ * Implemented by entites which wish to hear about message events that are
+ * dispatched on a particular distributed object.
+ *
+ * @see DObject#addListener
+ */
+public interface MessageListener extends ChangeListener
+{
+    /**
+     * Called when an message event has been dispatched on an object.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    function messageReceived (event :MessageEvent) :void;
+}
+}

src/as/com/threerings/presents/dobj/ObjectAccessError.as

@@ -0,0 +1,53 @@
+//
+// $Id: ObjectAccessException.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+/**
+ * An object access exception is delivered when an object is not
+ * accessible to a requesting subscriber for some reason or other. For
+ * some access exceptions, special derived classes exist to communicate
+ * the error. For others, a message string explaining the access failure
+ * is provided.
+ */
+public class ObjectAccessError extends Error
+{
+    /**
+     * Constructs a object access exception with the specified error
+     * message.
+     */
+    public function ObjectAccessError (message :String, cause :Error = null)
+    {
+        super(message);
+        _cause = cause;
+    }
+
+    /**
+     * Return the cause  of this error, if any.
+     */
+    public function getCause () :Error
+    {
+        return _cause;
+    }
+
+    protected var _cause :Error;
+}
+}

src/as/com/threerings/presents/dobj/ObjectDeathListener.as

@@ -0,0 +1,40 @@
+//
+// $Id: ObjectDeathListener.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+/**
+ * Implemented by entites which wish to hear about object destruction
+ * events.
+ *
+ * @see DObject#addListener
+ */
+public interface ObjectDeathListener extends ChangeListener
+{
+    /**
+     * Called when this object has been destroyed. This will be called
+     * <em>after</em> the event has been applied to the object.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    function objectDestroyed (event :ObjectDestroyedEvent) :void;
+}
+}

src/as/com/threerings/presents/dobj/ObjectDestroyedEvent.as

@@ -0,0 +1,75 @@
+//
+// $Id: ObjectDestroyedEvent.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj;
+
+/**
+ * An object destroyed event is dispatched when an object has been removed
+ * from the distributed object system. It can also be constructed to
+ * request an attribute change on an object and posted to the dobjmgr.
+ *
+ * @see DObjectManager#postEvent
+ */
+public class ObjectDestroyedEvent extends DEvent
+{
+    /**
+     * Constructs a new object destroyed event for the specified
+     * distributed object.
+     *
+     * @param targetOid the object id of the object that will be destroyed.
+     */
+    public ObjectDestroyedEvent (int targetOid)
+    {
+        super(targetOid);
+    }
+
+    /**
+     * Constructs a blank instance of this event in preparation for
+     * unserialization from the network.
+     */
+    public ObjectDestroyedEvent ()
+    {
+    }
+
+    // documentation inherited
+    public boolean applyToObject (DObject target)
+        throws ObjectAccessException
+    {
+        // nothing to do in preparation for destruction, the omgr will
+        // have to recognize this type of event and do the right thing
+        return true;
+    }
+
+    // documentation inherited
+    protected void notifyListener (Object listener)
+    {
+        if (listener instanceof ObjectDeathListener) {
+            ((ObjectDeathListener)listener).objectDestroyed(this);
+        }
+    }
+
+    // documentation inherited
+    protected void toString (StringBuffer buf)
+    {
+        buf.append("DESTROY:");
+        super.toString(buf);
+    }
+}

src/as/com/threerings/presents/dobj/ObjectRemovedEvent.as

@@ -19,7 +19,13 @@
 // License along with this library; if not, write to the Free Software
 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
-package com.threerings.presents.dobj;
+package com.threerings.presents.dobj {
+
+import flash.util.StringBuilder;
+
+import com.threerings.io.ObjectInputStream;
+import com.threerings.io.ObjectOutputStream;
+
 
 /**
  * An object removed event is dispatched when an object is removed from an
@@ -42,24 +48,16 @@ public class ObjectRemovedEvent extends NamedEvent
      * remove the specified oid.
      * @param oid the oid to remove from the oid list attribute.
      */
-    public ObjectRemovedEvent (int targetOid, String name, int oid)
+    public function ObjectRemovedEvent (targetOid :int, name :String, oid :int)
     {
         super(targetOid, name);
         _oid = oid;
     }
 
-    /**
-     * Constructs a blank instance of this event in preparation for
-     * unserialization from the network.
-     */
-    public ObjectRemovedEvent ()
-    {
-    }
-
     /**
      * Returns the oid that has been removed.
      */
-    public int getOid ()
+    public function getOid () :int
     {
         return _oid;
     }
@@ -67,29 +65,42 @@ public class ObjectRemovedEvent extends NamedEvent
     /**
      * Applies this event to the object.
      */
-    public boolean applyToObject (DObject target)
-        throws ObjectAccessException
+    public override function applyToObject (target :DObject) :Boolean
+        //throws ObjectAccessException
     {
-        OidList list = (OidList)target.getAttribute(_name);
+        var list :OidList = (target[_name] as OidList);
         list.remove(_oid);
         return true;
     }
 
     // documentation inherited
-    protected void notifyListener (Object listener)
+    protected override function notifyListener (listener :*) :void
     {
         if (listener is OidListListener) {
-            ((OidListListener)listener).objectRemoved(this);
+            listener.objectRemoved(this);
         }
     }
 
+    public override function writeObject (out :ObjectOutputStream) :void
+    {
+        super.writeObject(out);
+        out.writeInt(_oid);
+    }
+
+    public override function readObject (ins :ObjectInputStream) :void
+    {
+        super.readObject(ins);
+        _oid = ins.readInt();
+    }
+
     // documentation inherited
-    protected void toString (StringBuffer buf)
+    protected override function toString (buf :StringBuilder) :void
     {
         buf.append("OBJREM:");
         super.toString(buf);
-        buf.append(", oid=").append(_oid);
+        buf.append(", oid=", _oid);
     }
 
-    protected int _oid;
+    protected var _oid :int;
+}
 }

src/as/com/threerings/presents/dobj/OidListListener.as

@@ -0,0 +1,50 @@
+//
+// $Id: OidListListener.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj {
+
+/**
+ * Implemented by entites which wish to hear about changes that occur to
+ * oid list attributes of a particular distributed object.
+ *
+ * @see DObject#addListener
+ */
+public interface OidListListener extends ChangeListener
+{
+    /**
+     * Called when an object added event has been dispatched on an
+     * object. This will be called <em>after</em> the event has been
+     * applied to the object.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    function objectAdded (event :ObjectAddedEvent) :void;
+
+    /**
+     * Called when an object removed event has been dispatched on an
+     * object. This will be called <em>after</em> the event has been
+     * applied to the object.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    function objectRemoved (event :ObjectRemovedEvent) :void;
+}
+}

src/as/com/threerings/presents/dobj/SetListener.java

@@ -0,0 +1,58 @@
+//
+// $Id: SetListener.java 3099 2004-08-27 02:21:06Z mdb $
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
+// http://www.threerings.net/code/narya/
+//
+// This library is free software; you can redistribute it and/or modify it
+// under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation; either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// This library 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
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+package com.threerings.presents.dobj;
+
+/**
+ * Implemented by entites which wish to hear about changes that occur to
+ * set attributes of a particular distributed object.
+ *
+ * @see DObject#addListener
+ */
+public interface SetListener extends ChangeListener
+{
+    /**
+     * Called when an entry added event has been dispatched on an
+     * object. This will be called <em>after</em> the event has been
+     * applied to the object.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    public void entryAdded (EntryAddedEvent event);
+
+    /**
+     * Called when an entry updated event has been dispatched on an
+     * object. This will be called <em>after</em> the event has been
+     * applied to the object.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    public void entryUpdated (EntryUpdatedEvent event);
+
+    /**
+     * Called when an entry removed event has been dispatched on an
+     * object. This will be called <em>after</em> the event has been
+     * applied to the object.
+     *
+     * @param event The event that was dispatched on the object.
+     */
+    public void entryRemoved (EntryRemovedEvent event);
+}