The basis of cluster support for Presents servers. All servers in a cluster

make connections to other servers in the cluster and can exchange events (in a limited fashion). This is different than Liz's project wherein servers share an oid space and one can interchangably work with distributed objects from any server. This package provides a means by which certain services (by default, presence and chat) can be communicated between servers to allow communication between players scattered around a bunch of otherwise independent server instances. This is less general purpose but also less likely to encourage people to write code that tightly couples multiple servers and then falls over because it generates gobs of network traffic as events are flung willy nilly behind the scenes. git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@4238 542714f4-19e9-0310-aa3c-eee0fc999fb1
2006-07-01 00:19:59 +00:00
parent 06680b789f
commit 33a758dfce
15 changed files with 837 additions and 84 deletions
@@ -0,0 +1,74 @@
+//
+// $Id$
+//
+// Narya library - tools for developing networked games
+// Copyright (C) 2002-2006 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.peer.net;
+
+import com.samskivert.util.StringUtil;
+
+import com.threerings.util.Name;
+
+import com.threerings.presents.net.UsernamePasswordCreds;
+
+/**
+ * Used by peer servers in a cluster installation to authenticate with one
+ * another.
+ */
+public class PeerCreds extends UsernamePasswordCreds
+{
+    /** A prefix prepended to the node name used as a peer's username to
+     * prevent the username from colliding with a normal authenticating user's
+     * username. We assume that colons are not allowed in a normal username. */
+    public static final String PEER_PREFIX = "peer:";
+
+    /**
+     * Creates a unique password for the specified node using the supplied
+     * shared secret.
+     */
+    public static String createPassword (String nodeName, String sharedSecret)
+    {
+        return StringUtil.md5hex(nodeName + sharedSecret);
+    }
+
+    /**
+     * Creates credentials for the specified peer.
+     */
+    public PeerCreds (String nodeName, String sharedSecret)
+    {
+        super(new Name(PEER_PREFIX + nodeName),
+              createPassword(nodeName, sharedSecret));
+    }
+
+    /**
+     * Used when unserializing an instance from the network.
+     */
+    public PeerCreds ()
+    {
+    }
+
+    /**
+     * Returns the node name of this authenticating peer (which does not
+     * include the {@link #PEER_PREFIX}.
+     */
+    public String getNodeName ()
+    {
+        return getUsername().toString().substring(PEER_PREFIX.length());
+    }
+}