ej.websocket

Class WebSocketURI

java.lang.Object

ej.websocket.WebSocketURI

public class WebSocketURI
extends java.lang.Object

WebSocketURI is a container for a WebSocket URI as described in RFC 6455. See section 3 (and section 4.1).

Limitations of this implementation:

• Queries with ? are not checked.
• Fragments are not checked.
• '#' character is not managed.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_NOT_SECURE_PORT The default port for a ws:// URI as defined in RFC6455 (see section 3).
static int	DEFAULT_SECURE_PORT The default port for a wss:// URI.

Constructor Summary

Constructors

Constructor and Description
WebSocketURI(java.lang.String host) Create a new (not secure) websocket URI.
WebSocketURI(java.lang.String host, int port) Create a new (not secure) websocket URI.
WebSocketURI(java.lang.String host, int port, java.lang.String resourceName) Create a new (not secure) websocket URI.
WebSocketURI(java.lang.String host, int port, java.lang.String resourceName, boolean isSecure) Create a new websocket URI.
WebSocketURI(java.lang.String host, java.lang.String resourceName) Create a new (not secure) websocket URI.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getHost() Get the host (hostname or IP address).
int	getPort() Get the port of the host.
java.lang.String	getResourceName() Get the resource name, that is the name of the remote websocket endpoint.
boolean	isSecure() Tell if the websocket is secured or not.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT_NOT_SECURE_PORT

public static final int DEFAULT_NOT_SECURE_PORT

The default port for a ws:// URI as defined in RFC6455 (see section 3). If port is not specified during URI creation, then this port will be used.

See Also:

Constant Field Values

DEFAULT_SECURE_PORT

public static final int DEFAULT_SECURE_PORT

The default port for a wss:// URI. If port is not specified during URI creation, then this port will be used.

See Also:

Constant Field Values

Constructor Detail

WebSocketURI

public WebSocketURI(java.lang.String host,
                    int port,
                    java.lang.String resourceName,
                    boolean isSecure)
             throws java.lang.IllegalArgumentException

Create a new websocket URI.

Parameters:

host - hostname or IP address of the remote host

port - port of the remote host

resourceName - identifier for the service provided by the server

isSecure - flag indicating if the websocket is secure (wss) or not

Throws:

java.lang.IllegalArgumentException - if host is null or empty; if port is 0 (zero); if resourceName is null

WebSocketURI

public WebSocketURI(java.lang.String host,
                    int port,
                    java.lang.String resourceName)
             throws java.lang.IllegalArgumentException

Create a new (not secure) websocket URI.

Parameters:

host - hostname or IP address of the remote host

port - port of the remote host

resourceName - identifier for the service provided by the server

Throws:

java.lang.IllegalArgumentException - if host is null or empty; if port is 0 (zero); if resourceName is null

WebSocketURI

public WebSocketURI(java.lang.String host,
                    java.lang.String resourceName)
             throws java.lang.IllegalArgumentException

Create a new (not secure) websocket URI. Default port (DEFAULT_NOT_SECURE_PORT) is used.

Parameters:

host - hostname or IP address of the remote host

resourceName - identifier for the service provided by the server

Throws:

java.lang.IllegalArgumentException - if resourceName is null

WebSocketURI

public WebSocketURI(java.lang.String host,
                    int port)
             throws java.lang.IllegalArgumentException

Create a new (not secure) websocket URI. Resource name is assumed to be "/".

Parameters:

host - hostname or IP address of the remote host

port - port of the remote host

Throws:

java.lang.IllegalArgumentException - if resourceName is null

WebSocketURI

public WebSocketURI(java.lang.String host)
             throws java.lang.IllegalArgumentException

Create a new (not secure) websocket URI. Resource name is assumed to be "/". Default port (DEFAULT_NOT_SECURE_PORT) is used.

Parameters:

host - hostname or IP address of the remote host

Throws:

java.lang.IllegalArgumentException - if resourceName is null

Method Detail

getHost

public java.lang.String getHost()

Get the host (hostname or IP address).

Returns:

hostname of the peer

getPort

public int getPort()

Get the port of the host.

Returns:

port of the remote peer

getResourceName

public java.lang.String getResourceName()

Get the resource name, that is the name of the remote websocket endpoint.

Returns:

the request-URI of the remote endpoint

isSecure

public boolean isSecure()

Tell if the websocket is secured or not.

Returns:

true is this URI is intended to be create a secured connection (wss://); false otherwise (ws://)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object