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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
/*
* Conditions Of Use
*
* This software was developed by employees of the National Institute of
* Standards and Technology (NIST), an agency of the Federal Government.
* Pursuant to title 15 Untied States Code Section 105, works of NIST
* employees are not subject to copyright protection in the United States
* and are considered to be in the public domain. As a result, a formal
* license is not needed to use the software.
*
* This software is provided by NIST as a service and is expressly
* provided "AS IS." NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
* OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
* AND DATA ACCURACY. NIST does not warrant or make any representations
* regarding the use of the software or the results thereof, including but
* not limited to the correctness, accuracy, reliability or usefulness of
* the software.
*
* Permission to use this software is contingent upon your acceptance
* of the terms of this agreement
*
* .
*
*/
package gov.nist.core.net;
import java.io.IOException;
import java.net.DatagramSocket;
import java.net.InetAddress;
import java.net.ServerSocket;
import java.net.Socket;
import java.net.SocketException;
// Added by Daniel J. Martinez Manzano <dani@dif.um.es>
import javax.net.ssl.SSLServerSocket;
import javax.net.ssl.SSLSocket;
/**
* basic interface to the network layer
*
* @author m.andrews
*
*/
public interface NetworkLayer {
/**
* Creates a server with the specified port, listen backlog, and local IP address to bind to.
* comparable to "new java.net.ServerSocket(port,backlog,bindAddress);"
*
* @param port
* @param backlog
* @param bindAddress
* @return the server socket
*/
public ServerSocket createServerSocket(int port, int backlog,
InetAddress bindAddress) throws IOException;
/**
* Creates an SSL server with the specified port, listen backlog, and local IP address to bind to.
* Added by Daniel J. Martinez Manzano <dani@dif.um.es>
*
* @param port
* @param backlog
* @param bindAddress
* @return the server socket
*/
public SSLServerSocket createSSLServerSocket(int port, int backlog,
InetAddress bindAddress) throws IOException;
/**
* Creates a stream socket and connects it to the specified port number at the specified IP address.
* comparable to "new java.net.Socket(address, port);"
*
* @param address
* @param port
* @return the socket
*/
public Socket createSocket(InetAddress address, int port) throws IOException;
/**
* Creates a stream socket and connects it to the specified port number at the specified IP address.
* comparable to "new java.net.Socket(address, port,localaddress);"
*
* @param address
* @param port
* @param localAddress
* @return the socket
*/
public Socket createSocket(InetAddress address, int port, InetAddress localAddress) throws IOException;
/**
* Creates a new Socket, binds it to myAddress:myPort and connects it to
* address:port.
*
* @param address the InetAddress that we'd like to connect to.
* @param port the port that we'd like to connect to
* @param myAddress the address that we are supposed to bind on or null
* for the "any" address.
* @param myPort the port that we are supposed to bind on or 0 for a random
* one.
*
* @return a new Socket, bound on myAddress:myPort and connected to
* address:port.
* @throws IOException if binding or connecting the socket fail for a reason
* (exception relayed from the correspoonding Socket methods)
*/
public Socket createSocket(InetAddress address, int port,
InetAddress myAddress, int myPort)
throws IOException;
/**
* Creates a stream SSL socket and connects it to the specified port number at the specified IP address.
* Added by Daniel J. Martinez Manzano <dani@dif.um.es>
*
* @param address
* @param port
* @return the socket
*/
public SSLSocket createSSLSocket(InetAddress address, int port) throws IOException;
/**
* Creates a stream SSL socket and connects it to the specified port number at the specified IP address.
* Added by Daniel J. Martinez Manzano <dani@dif.um.es>
*
* @param address
* @param port
* @param localAddress -- my address.
* @return the socket
*/
public SSLSocket createSSLSocket(InetAddress address, int port, InetAddress localAddress) throws IOException;
/**
* Constructs a datagram socket and binds it to any available port on the local host machine.
* comparable to "new java.net.DatagramSocket();"
*
* @return the datagram socket
*/
public DatagramSocket createDatagramSocket() throws SocketException;
/**
* Creates a datagram socket, bound to the specified local address.
* comparable to "new java.net.DatagramSocket(port,laddr);"
*
* @param port
* @param laddr
* @return the datagram socket
*/
public DatagramSocket createDatagramSocket(int port, InetAddress laddr)
throws SocketException;
}
|
