declare namespace javax {
namespace net {
namespace ssl {
/**
* This class extends ServerSocket
s and
* provides secure server sockets using protocols such as the Secure
* Sockets Layer (SSL) or Transport Layer Security (TLS) protocols.
*
* Instances of this class are generally created using a
* SSLServerSocketFactory
. The primary function
* of SSLServerSocket
s
* is to create SSLSocket
s by accept
ing
* connections.
*
* SSLServerSocket
s contain several pieces of state data
* which are inherited by the SSLSocket
at
* socket creation. These include the enabled cipher
* suites and protocols, whether client
* authentication is necessary, and whether created sockets should
* begin handshaking in client or server mode. The state
* inherited by the created SSLSocket
can be
* overriden by calling the appropriate methods.
* @see java.net.ServerSocket
* @see SSLSocket
* @since 1.4
* @author David Brownell
*/
// @ts-ignore
abstract class SSLServerSocket extends java.net.ServerSocket {
/**
* Used only by subclasses.
*
* Create an unbound TCP server socket using the default authentication * context. * @throws IOException if an I/O error occurs when creating the socket */ // @ts-ignore constructor() /** * Used only by subclasses. *
* Create a TCP server socket on a port, using the default * authentication context. The connection backlog defaults to * fifty connections queued up before the system starts to * reject new connection requests. *
* A port number of 0
creates a socket on any free port.
*
* If there is a security manager, its checkListen
* method is called with the port
argument as its
* argument to ensure the operation is allowed. This could result
* in a SecurityException.
* @param port the port on which to listen
* @throws IOException if an I/O error occurs when creating the socket
* @throws SecurityException if a security manager exists and its
* checkListen
method doesn't allow the operation.
* @throws IllegalArgumentException if the port parameter is outside the
* specified range of valid port values, which is between 0 and
* 65535, inclusive.
* @see SecurityManager#checkListen
*/
// @ts-ignore
constructor(port: number /*int*/)
/**
* Used only by subclasses.
*
* Create a TCP server socket on a port, using the default * authentication context and a specified backlog of connections. *
* A port number of 0
creates a socket on any free port.
*
* The backlog
argument is the requested maximum number of
* pending connections on the socket. Its exact semantics are implementation
* specific. In particular, an implementation may impose a maximum length
* or may choose to ignore the parameter altogther. The value provided
* should be greater than 0
. If it is less than or equal to
* 0
, then an implementation specific default will be used.
*
* If there is a security manager, its checkListen
* method is called with the port
argument as its
* argument to ensure the operation is allowed. This could result
* in a SecurityException.
* @param port the port on which to listen
* @param backlog requested maximum length of the queue of incoming
* connections.
* @throws IOException if an I/O error occurs when creating the socket
* @throws SecurityException if a security manager exists and its
* checkListen
method doesn't allow the operation.
* @throws IllegalArgumentException if the port parameter is outside the
* specified range of valid port values, which is between 0 and
* 65535, inclusive.
* @see SecurityManager#checkListen
*/
// @ts-ignore
constructor(port: number /*int*/, backlog: number /*int*/)
/**
* Used only by subclasses.
*
* Create a TCP server socket on a port, using the default * authentication context and a specified backlog of connections * as well as a particular specified network interface. This * constructor is used on multihomed hosts, such as those used * for firewalls or as routers, to control through which interface * a network service is provided. *
* If there is a security manager, its checkListen
* method is called with the port
argument as its
* argument to ensure the operation is allowed. This could result
* in a SecurityException.
*
* A port number of 0
creates a socket on any free port.
*
* The backlog
argument is the requested maximum number of
* pending connections on the socket. Its exact semantics are implementation
* specific. In particular, an implementation may impose a maximum length
* or may choose to ignore the parameter altogther. The value provided
* should be greater than 0
. If it is less than or equal to
* 0
, then an implementation specific default will be used.
*
* If address is null, it will default accepting connections
* on any/all local addresses.
* @param port the port on which to listen
* @param backlog requested maximum length of the queue of incoming
* connections.
* @param address the address of the network interface through
* which connections will be accepted
* @throws IOException if an I/O error occurs when creating the socket
* @throws SecurityException if a security manager exists and its
* checkListen
method doesn't allow the operation.
* @throws IllegalArgumentException if the port parameter is outside the
* specified range of valid port values, which is between 0 and
* 65535, inclusive.
* @see SecurityManager#checkListen
*/
// @ts-ignore
constructor(port: number /*int*/, backlog: number /*int*/, address: java.net.InetAddress)
/**
* Returns the list of cipher suites which are currently enabled
* for use by newly accepted connections.
*
* If this list has not been explicitly modified, a system-provided * default guarantees a minimum quality of service in all enabled * cipher suites. *
* There are several reasons why an enabled cipher suite might * not actually be used. For example: the server socket might * not have appropriate private keys available to it or the cipher * suite might be anonymous, precluding the use of client authentication, * while the server socket has been told to require that sort of * authentication. * @return an array of cipher suites enabled * @see #getSupportedCipherSuites() * @see #setEnabledCipherSuites(String []) */ // @ts-ignore public abstract getEnabledCipherSuites(): string[] /** * Sets the cipher suites enabled for use by accepted connections. *
* The cipher suites must have been listed by getSupportedCipherSuites()
* as being supported. Following a successful call to this method,
* only suites listed in the suites
parameter are enabled
* for use.
*
* Suites that require authentication information which is not available * in this ServerSocket's authentication context will not be used * in any case, even if they are enabled. *
* SSLSocket
s returned from accept()
* inherit this setting.
* @param suites Names of all the cipher suites to enable
* @exception IllegalArgumentException when one or more of ciphers
* named by the parameter is not supported, or when
* the parameter is null.
* @see #getSupportedCipherSuites()
* @see #getEnabledCipherSuites()
*/
// @ts-ignore
public abstract setEnabledCipherSuites(suites: java.lang.String[] | string[]): void
/**
* Returns the names of the cipher suites which could be enabled for use
* on an SSL connection.
*
* Normally, only a subset of these will actually * be enabled by default, since this list may include cipher suites which * do not meet quality of service requirements for those defaults. Such * cipher suites are useful in specialized applications. * @return an array of cipher suite names * @see #getEnabledCipherSuites() * @see #setEnabledCipherSuites(String []) */ // @ts-ignore public abstract getSupportedCipherSuites(): string[] /** * Returns the names of the protocols which could be enabled for use. * @return an array of protocol names supported * @see #getEnabledProtocols() * @see #setEnabledProtocols(String []) */ // @ts-ignore public abstract getSupportedProtocols(): string[] /** * Returns the names of the protocols which are currently * enabled for use by the newly accepted connections. * @return an array of protocol names * @see #getSupportedProtocols() * @see #setEnabledProtocols(String []) */ // @ts-ignore public abstract getEnabledProtocols(): string[] /** * Controls which particular protocols are enabled for use by * accepted connections. *
* The protocols must have been listed by
* getSupportedProtocols() as being supported.
* Following a successful call to this method, only protocols listed
* in the protocols
parameter are enabled for use.
*
* SSLSocket
s returned from accept()
* inherit this setting.
* @param protocols Names of all the protocols to enable.
* @exception IllegalArgumentException when one or more of
* the protocols named by the parameter is not supported or
* when the protocols parameter is null.
* @see #getEnabledProtocols()
* @see #getSupportedProtocols()
*/
// @ts-ignore
public abstract setEnabledProtocols(protocols: java.lang.String[] | string[]): void
/**
* Controls whether accept
ed server-mode
* SSLSockets
will be initially configured to
* require client authentication.
*
* A socket's client authentication setting is one of the following: *
* Unlike {@link #setWantClientAuth(boolean)}, if the accepted * socket's option is set and the client chooses not to provide * authentication information about itself, the negotiations * will stop and the connection will be dropped. *
* Calling this method overrides any previous setting made by * this method or {@link #setWantClientAuth(boolean)}. *
* The initial inherited setting may be overridden by calling
* {@link SSLSocket#setNeedClientAuth(boolean)} or
* {@link SSLSocket#setWantClientAuth(boolean)}.
* @param need set to true if client authentication is required,
* or false if no client authentication is desired.
* @see #getNeedClientAuth()
* @see #setWantClientAuth(boolean)
* @see #getWantClientAuth()
* @see #setUseClientMode(boolean)
*/
// @ts-ignore
public abstract setNeedClientAuth(need: boolean): void
/**
* Returns true if client authentication will be required on
* newly accept
ed server-mode SSLSocket
s.
*
* The initial inherited setting may be overridden by calling
* {@link SSLSocket#setNeedClientAuth(boolean)} or
* {@link SSLSocket#setWantClientAuth(boolean)}.
* @return true if client authentication is required,
* or false if no client authentication is desired.
* @see #setNeedClientAuth(boolean)
* @see #setWantClientAuth(boolean)
* @see #getWantClientAuth()
* @see #setUseClientMode(boolean)
*/
// @ts-ignore
public abstract getNeedClientAuth(): boolean
/**
* Controls whether accept
ed server-mode
* SSLSockets
will be initially configured to
* request client authentication.
*
* A socket's client authentication setting is one of the following: *
* Unlike {@link #setNeedClientAuth(boolean)}, if the accepted * socket's option is set and the client chooses not to provide * authentication information about itself, the negotiations * will continue. *
* Calling this method overrides any previous setting made by * this method or {@link #setNeedClientAuth(boolean)}. *
* The initial inherited setting may be overridden by calling * {@link SSLSocket#setNeedClientAuth(boolean)} or * {@link SSLSocket#setWantClientAuth(boolean)}. * @param want set to true if client authentication is requested, * or false if no client authentication is desired. * @see #getWantClientAuth() * @see #setNeedClientAuth(boolean) * @see #getNeedClientAuth() * @see #setUseClientMode(boolean) */ // @ts-ignore public abstract setWantClientAuth(want: boolean): void /** * Returns true if client authentication will be requested on * newly accepted server-mode connections. *
* The initial inherited setting may be overridden by calling * {@link SSLSocket#setNeedClientAuth(boolean)} or * {@link SSLSocket#setWantClientAuth(boolean)}. * @return true if client authentication is requested, * or false if no client authentication is desired. * @see #setWantClientAuth(boolean) * @see #setNeedClientAuth(boolean) * @see #getNeedClientAuth() * @see #setUseClientMode(boolean) */ // @ts-ignore public abstract getWantClientAuth(): boolean /** * Controls whether accepted connections are in the (default) SSL * server mode, or the SSL client mode. *
* Servers normally authenticate themselves, and clients are not * required to do so. *
* In rare cases, TCP servers * need to act in the SSL client mode on newly accepted * connections. For example, FTP clients acquire server sockets * and listen there for reverse connections from the server. An * FTP client would use an SSLServerSocket in "client" mode to * accept the reverse connection while the FTP server uses an * SSLSocket with "client" mode disabled to initiate the * connection. During the resulting handshake, existing SSL * sessions may be reused. *
* SSLSocket
s returned from accept()
* inherit this setting.
* @param mode true if newly accepted connections should use SSL
* client mode.
* @see #getUseClientMode()
*/
// @ts-ignore
public abstract setUseClientMode(mode: boolean): void
/**
* Returns true if accepted connections will be in SSL client mode.
* @see #setUseClientMode(boolean)
* @return true if the connection should use SSL client mode.
*/
// @ts-ignore
public abstract getUseClientMode(): boolean
/**
* Controls whether new SSL sessions may be established by the
* sockets which are created from this server socket.
*
* SSLSocket
s returned from accept()
* inherit this setting.
* @param flag true indicates that sessions may be created; this
* is the default. false indicates that an existing session
* must be resumed.
* @see #getEnableSessionCreation()
*/
// @ts-ignore
public abstract setEnableSessionCreation(flag: boolean): void
/**
* Returns true if new SSL sessions may be established by the
* sockets which are created from this server socket.
* @return true indicates that sessions may be created; this
* is the default. false indicates that an existing
* session must be resumed
* @see #setEnableSessionCreation(boolean)
*/
// @ts-ignore
public abstract getEnableSessionCreation(): boolean
/**
* Returns the SSLParameters in effect for newly accepted connections.
* The ciphersuites and protocols of the returned SSLParameters
* are always non-null.
* @return the SSLParameters in effect for newly accepted connections
* @see #setSSLParameters(SSLParameters)
* @since 1.7
*/
// @ts-ignore
public getSSLParameters(): javax.net.ssl.SSLParameters
/**
* Applies SSLParameters to newly accepted connections.
*
This means: *