1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
/*
* %CopyrightBegin%
*
* Copyright Ericsson AB 2000-2022. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions 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 explicitly
* 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("server", "cookie"); // 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);
}
}
|
