Revamped the basic Presents client to support attempts to connect to the server

on multiple ports, falling back from one to the next as appropriate.


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

src/java/com/threerings/presents/client/LogonException.java

@@ -1,5 +1,5 @@
 //
-// $Id: LogonException.java,v 1.4 2004/08/27 02:20:18 mdb Exp $
+// $Id$
 //
 // Narya library - tools for developing networked games
 // Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
@@ -33,6 +33,34 @@ public class LogonException extends Exception
      */
     public LogonException (String code)
     {
-        super(code);
+        this(code, false);
     }
+
+    /**
+     * Constructs a logon exception with the supplied logon failure code.
+     *
+     * @param stillInProgress indicates that the logon attempt has not totally
+     * failed, rather we are still trying but want to report that our initial
+     * attempt did not work and that we're falling back to alternative methods.
+     */
+    public LogonException (String code, boolean stillInProgress)
+    {
+        super(code);
+        _stillInProgress = stillInProgress;
+    }
+
+    /**
+     * Returns true if this exception is reporting an intermediate status
+     * rather than total logon failure. The client may be falling back to an
+     * alternative port or delaying an auto-retry attempt due to server
+     * overload. If this method returns true, the client <em>should not</em>
+     * allow additional calls to {@link Client#logon} as the current attempt is
+     * still in progress.
+     */
+    public boolean isStillInProgress ()
+    {
+        return _stillInProgress;
+    }
+
+    protected boolean _stillInProgress;
 }