The R13B03 release.OTP_R13B03

1 files changed, 110 insertions, 0 deletions

diff --git a/lib/jinterface/java_src/com/ericsson/otp/erlang/OtpServer.java b/lib/jinterface/java_src/com/ericsson/otp/erlang/OtpServer.java
new file mode 100644
index 0000000000..0de399ac61
--- /dev/null
+++ b/lib/jinterface/java_src/com/ericsson/otp/erlang/OtpServer.java
@@ -0,0 +1,110 @@
+/*
+ * %CopyrightBegin%
+ * 
+ * Copyright Ericsson AB 2000-2009. All Rights Reserved.
+ * 
+ * The contents of this file are subject to the Erlang Public License,
+ * Version 1.1, (the "License"); you may not use this file except in
+ * compliance with the License. You should have received a copy of the
+ * Erlang Public License along with this software. If not, it can be
+ * retrieved online at http://www.erlang.org/.
+ * 
+ * Software distributed under the License is distributed on an "AS IS"
+ * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
+ * the License for the specific language governing rights and limitations
+ * under the License.
+ * 
+ * %CopyrightEnd%
+ */
+package com.ericsson.otp.erlang;
+
+import java.io.IOException;
+
+/**
+ * Represents a local OTP client or server node. It is used when you want other
+ * nodes to be able to establish connections to this one.
+ * 
+ * When you create an instance of this class, it will bind a socket to a port so
+ * that incoming connections can be accepted. However the port number will not
+ * be made available to other nodes wishing to connect until you explicitely
+ * register with the port mapper daemon by calling {@link #publishPort()}.
+ * 
+ * <p>
+ * When the Java node will be connecting to a remote Erlang, Java or C node, it
+ * must first identify itself as a node by creating an instance of this class,
+ * after which it may connect to the remote node.
+ * 
+ * <p>
+ * Setting up a connection may be done as follows:
+ * 
+ * 
+ * <pre>
+ * OtpServer self = new OtpServer(&quot;server&quot;, &quot;cookie&quot;); // identify self
+ * self.publishPort(); // make port information available
+ * 
+ * OtpConnection conn = self.accept(); // get incoming connection
+ * </pre>
+ * 
+ * @see OtpSelf
+ * 
+ * @deprecated the functionality of this class has been moved to {@link OtpSelf}.
+ */
+@Deprecated
+public class OtpServer extends OtpSelf {
+    /**
+     * Create an {@link OtpServer} from an existing {@link OtpSelf}.
+     * 
+     * @param self
+     *                an existing self node.
+     * 
+     * @exception java.io.IOException
+     *                    if a ServerSocket could not be created.
+     * 
+     */
+    public OtpServer(final OtpSelf self) throws IOException {
+	super(self.node(), self.cookie());
+    }
+
+    /**
+     * Create an OtpServer, using a vacant port chosen by the operating system.
+     * To determine what port was chosen, call the object's {@link #port()}
+     * method.
+     * 
+     * @param node
+     *                the name of the node.
+     * 
+     * @param cookie
+     *                the authorization cookie that will be used by this node
+     *                when accepts connections from remote nodes.
+     * 
+     * @exception java.io.IOException
+     *                    if a ServerSocket could not be created.
+     * 
+     */
+    public OtpServer(final String node, final String cookie) throws IOException {
+	super(node, cookie);
+    }
+
+    /**
+     * Create an OtpServer, using the specified port number.
+     * 
+     * @param node
+     *                a name for this node, as above.
+     * 
+     * @param cookie
+     *                the authorization cookie that will be used by this node
+     *                when accepts connections from remote nodes.
+     * 
+     * @param port
+     *                the port number to bind the socket to.
+     * 
+     * @exception java.io.IOException
+     *                    if a ServerSocket could not be created or if the
+     *                    chosen port number was not available.
+     * 
+     */
+    public OtpServer(final String node, final String cookie, final int port)
+	    throws IOException {
+	super(node, cookie, port);
+    }
+}