Package org.apache.hc.core5.net

Class URIAuthority

java.lang.Object

org.apache.hc.core5.net.URIAuthority

All Implemented Interfaces:

java.io.Serializable, NamedEndpoint

@Contract(threading=IMMUTABLE)
public final class URIAuthority
extends java.lang.Object
implements NamedEndpoint, java.io.Serializable

Represents authority component of request URI.

Since:

5.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private Host	host
private static long	serialVersionUID
private java.lang.String	userInfo

Constructor Summary

Constructors

Constructor	Description
URIAuthority(java.lang.String hostName)	Constructs a new instance.
URIAuthority(java.lang.String hostName, int port)	Constructs a new instance.
URIAuthority(java.lang.String userInfo, java.lang.String hostName, int port)	Constructs a new instance.
URIAuthority(java.lang.String userInfo, Host host)	Constructs a new instance.
URIAuthority(java.lang.String userInfo, NamedEndpoint endpoint)	Constructs a new instance.
URIAuthority(Host host)	Constructs a new instance.
URIAuthority(NamedEndpoint namedEndpoint)	Constructs a new instance.

Method Summary

Modifier and Type	Method	Description
static URIAuthority	create(java.lang.String s)	Creates a URIAuthority instance from a string.
boolean	equals(java.lang.Object obj)
(package private) static void	format(java.lang.StringBuilder buf, URIAuthority uriAuthority)
(package private) static java.lang.String	format(URIAuthority uriAuthority)
java.lang.String	getHostName()	Returns name (IP or DNS name).
int	getPort()	Returns the port.
java.lang.String	getUserInfo()	Gets the user info String.
int	hashCode()
(package private) static URIAuthority	parse(java.lang.CharSequence s)
(package private) static URIAuthority	parse(java.lang.CharSequence s, Tokenizer.Cursor cursor)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

userInfo

private final java.lang.String userInfo

host

private final Host host

Constructor Detail

URIAuthority

public URIAuthority(java.lang.String userInfo,
                    java.lang.String hostName,
                    int port)

Constructs a new instance.

Parameters:

userInfo - The user info, may be null.

hostName - The host name, not null.

port - The port value, between 0 and 65535, inclusive. -1 indicates the scheme default port.

Throws:

java.lang.NullPointerException - If the name is null.

java.lang.IllegalArgumentException - If the port is outside the specified range of valid port values, which is between 0 and 65535, inclusive. -1 indicates the scheme default port.

URIAuthority

public URIAuthority(java.lang.String hostName,
                    int port)

Constructs a new instance.

Parameters:

hostName - The host name, not null.

port - The port value, between 0 and 65535, inclusive. -1 indicates the scheme default port.

Throws:

java.lang.NullPointerException - If the name is null.

java.lang.IllegalArgumentException - If the port is outside the specified range of valid port values, which is between 0 and 65535, inclusive. -1 indicates the scheme default port.

URIAuthority

public URIAuthority(java.lang.String userInfo,
                    Host host)

Constructs a new instance.

Parameters:

userInfo - The user info, may be null.

host - The host, never null.

Throws:

java.lang.NullPointerException - if the host is null.

Since:

5.2

URIAuthority

public URIAuthority(Host host)

Constructs a new instance.

Parameters:

host - The host, never null.

Throws:

java.lang.NullPointerException - if the host is null.

Since:

5.2

URIAuthority

public URIAuthority(java.lang.String userInfo,
                    NamedEndpoint endpoint)

Constructs a new instance.

Parameters:

userInfo - The user info, may be null.

endpoint - The named end-point, never null.

Throws:

java.lang.NullPointerException - If the end-point is null.

java.lang.NullPointerException - If the end-point name is null.

java.lang.IllegalArgumentException - If the end-point port is outside the specified range of valid port values, which is between 0 and 65535, inclusive. -1 indicates the scheme default port.

Since:

5.2

URIAuthority

public URIAuthority(NamedEndpoint namedEndpoint)

Constructs a new instance.

Parameters:

namedEndpoint - The named end-point, never null.

Throws:

java.lang.NullPointerException - If the end-point is null.

java.lang.NullPointerException - If the end-point name is null.

java.lang.IllegalArgumentException - If the end-point port is outside the specified range of valid port values, which is between 0 and 65535, inclusive. -1 indicates the scheme default port.

URIAuthority

public URIAuthority(java.lang.String hostName)

Constructs a new instance.

Parameters:

hostName - The host name, not null.

Throws:

java.lang.NullPointerException - If the name is null.

Method Detail

parse

static URIAuthority parse(java.lang.CharSequence s,
                          Tokenizer.Cursor cursor)
                   throws java.net.URISyntaxException

Throws:

java.net.URISyntaxException

parse

static URIAuthority parse(java.lang.CharSequence s)
                   throws java.net.URISyntaxException

Throws:

java.net.URISyntaxException

format

static void format(java.lang.StringBuilder buf,
                   URIAuthority uriAuthority)

format

static java.lang.String format(URIAuthority uriAuthority)

create

public static URIAuthority create(java.lang.String s)
                           throws java.net.URISyntaxException

Creates a URIAuthority instance from a string. Text may not contain any blanks.

Parameters:

s - The value to parse

Returns:

The parsed URIAuthority.

Throws:

java.net.URISyntaxException - Thrown if a string could not be parsed as a URIAuthority.

getUserInfo

public java.lang.String getUserInfo()

Gets the user info String.

Returns:

the user info String.

getHostName

public java.lang.String getHostName()

Description copied from interface: NamedEndpoint

Returns name (IP or DNS name).

Specified by:

getHostName in interface NamedEndpoint

Returns:

the host name (IP or DNS name)

getPort

public int getPort()

Description copied from interface: NamedEndpoint

Returns the port.

Specified by:

getPort in interface NamedEndpoint

Returns:

the host port, or -1 if not set

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object