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
 }