Bureaucracy

* Fixed signature of Receiver methods
* Implemented create/destroy mechanism and bootstrap request in BureauDirector
* Added BureauContext class to expose bureau information on top of usual 
  presents stuff
* Added BureauContext implementation in BureauClient
* Added code to kick off the director when the client logs on
* Added credentials for a bureau logon, which is just a token passed to 
  command line launcher
* Added concept of bureau types to distinguish between executable and command 
  line arguments; includes interface BureauRegistry.Launcher
* Implemented backend for the registry


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

src/java/com/threerings/bureau/data/AgentObject.java

@@ -29,16 +29,25 @@ public class AgentObject extends DObject
     /** The field name of the <code>bureauId</code> field. */
     public static final String BUREAU_ID = "bureauId";
 
+    /** The field name of the <code>bureauType</code> field. */
+    public static final String BUREAU_TYPE = "bureauType";
+
     /** The field name of the <code>agentCode</code> field. */
     public static final String AGENT_CODE = "agentCode";
-
-    /** The field name of the <code>startConfirmed</code> field. */
-    public static final String START_CONFIRMED = "startConfirmed";
     // AUTO-GENERATED: FIELDS END
 
+    /** The id of the bureau the agent is running in. This is normally a unique id corresponding
+     *  to the game or item that requires some server-side processing. */
     public String bureauId;
+
+    /** The type of bureau that the agent is running in. This is normally derived from the kind
+     *  of media that the game or item has specified for its code and determines the method of
+     *  launching the bureau when the first agent is requested. */
+    public String bureauType;
+
+    /** The location of the code for the agent. This could be a URL to an action script file or
+     *  some other description that the bureau can use to load and execute the agent's code. */
     public String agentCode;
-    public boolean startConfirmed;
 
     // AUTO-GENERATED: METHODS START
     /**
@@ -57,6 +66,22 @@ public class AgentObject extends DObject
         this.bureauId = value;
     }
 
+    /**
+     * Requests that the <code>bureauType</code> field be set to the
+     * specified value. The local value will be updated immediately and an
+     * event will be propagated through the system to notify all listeners
+     * that the attribute did change. Proxied copies of this object (on
+     * clients) will apply the value change when they received the
+     * attribute changed notification.
+     */
+    public void setBureauType (String value)
+    {
+        String ovalue = this.bureauType;
+        requestAttributeChange(
+            BUREAU_TYPE, value, ovalue);
+        this.bureauType = value;
+    }
+
     /**
      * Requests that the <code>agentCode</code> field be set to the
      * specified value. The local value will be updated immediately and an
@@ -72,21 +97,5 @@ public class AgentObject extends DObject
             AGENT_CODE, value, ovalue);
         this.agentCode = value;
     }
-
-    /**
-     * Requests that the <code>startConfirmed</code> field be set to the
-     * specified value. The local value will be updated immediately and an
-     * event will be propagated through the system to notify all listeners
-     * that the attribute did change. Proxied copies of this object (on
-     * clients) will apply the value change when they received the
-     * attribute changed notification.
-     */
-    public void setStartConfirmed (boolean value)
-    {
-        boolean ovalue = this.startConfirmed;
-        requestAttributeChange(
-            START_CONFIRMED, Boolean.valueOf(value), Boolean.valueOf(ovalue));
-        this.startConfirmed = value;
-    }
     // AUTO-GENERATED: METHODS END
 }

src/java/com/threerings/bureau/data/BureauCredentials.java

@@ -0,0 +1,38 @@
+//
+// $Id$
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2007 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.bureau.data;
+
+import com.threerings.presents.net.Credentials;
+import com.threerings.util.Name;
+
+public class BureauCredentials extends Credentials
+{
+    /**
+     * The token to pass to the server when logging in. This is usually just passed to the bureau 
+     * on the command line to guard against outside connections being established. */
+    public String sessionToken;
+
+    public BureauCredentials ()
+    {
+        super(new Name("$$$BUREAU$$$"));
+    }
+}