A Unix domain socket address. A Unix domain socket address encapsulates a file-system path that Unix domain sockets bind or connect to.

An unnamed UnixDomainSocketAddress has an empty path. The local address of a SocketChannel to a Unix domain socket that is automatically or implicitly bound will be unnamed.

Path objects used to create instances of this class must be obtained from the system-default file system.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	UnixDomainSocketAddress.Ser A serial proxy for all `UnixDomainSocketAddress` instances.

Field Summary

Modifier and Type	Field and Description
private final transient Path	path
pack-priv static final long	serialVersionUID Hides java.net.SocketAddress.serialVersionUID.

Constructor Summary

Access	Constructor and Description
private	UnixDomainSocketAddress(Path path)

Method Summary

Modifier and Type	Method and Description
public boolean	Returns: true if the path fields are equal equals(Object o) Overrides java.lang.Object.equals. Compares this address with another object.
public Path	Returns: this address's path getPath() Returns this address's path.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns the hash code of this `UnixDomainSocketAddress`
public static UnixDomainSocketAddress	Returns: A UnixDomainSocketAddress of(String The path string, which can be empty pathname) Creates a UnixDomainSocketAddress from the given path string.
public static UnixDomainSocketAddress	Returns: A UnixDomainSocketAddress of(Path The path to the socket, which can be empty path) Creates a UnixDomainSocketAddress for the given path.
private void	readObject(ObjectInputStream the stream s) Throws InvalidObjectException, always.
private void	readObjectNoData() Throws InvalidObjectException, always.
public String	Returns: this address's path which may be empty for an unnamed address toString() Overrides java.lang.Object.toString. Returns a string representation of this `UnixDomainSocketAddress`.
private Object	Returns: a `Ser` representing the path name of this instance writeReplace() Returns a Ser containing the path name of this instance.

Field Detail

path	back to summary
private final transient Path path

serialVersionUID	back to summary
pack-priv static final long serialVersionUID Hides java.net.SocketAddress.serialVersionUID. Annotations @Serial

Constructor Detail

UnixDomainSocketAddress	back to summary
private UnixDomainSocketAddress(Path path)

Method Detail

equals	back to summary
public boolean equals(Object o) Overrides java.lang.Object.equals. Compares this address with another object. Returns:boolean true if the path fields are equal Annotations @Override

equals

back to summary

public boolean equals(Object o)

Overrides java.lang.Object.equals.

Compares this address with another object.

Returns:boolean

true if the path fields are equal

Annotations

@Override

getPath	back to summary
public Path getPath() Returns this address's path. Returns:Path this address's path

getPath

back to summary

public Path getPath()

Returns this address's path.

Returns:Path: this address's path

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Returns the hash code of this `UnixDomainSocketAddress` Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Returns the hash code of this UnixDomainSocketAddress

Annotations

@Override

of back to summary

of	back to summary
public static UnixDomainSocketAddress of(String pathname) Creates a UnixDomainSocketAddress from the given path string. Parameters pathname:String The path string, which can be empty Returns:UnixDomainSocketAddress A UnixDomainSocketAddress Exceptions InvalidPathException: If the path cannot be converted to a Path NullPointerException: if pathname is `null`

public static UnixDomainSocketAddress of(String pathname)

Creates a UnixDomainSocketAddress from the given path string.

Parameters

pathname:String: The path string, which can be empty

Returns:UnixDomainSocketAddress

A UnixDomainSocketAddress

Exceptions

InvalidPathException:: If the path cannot be converted to a Path
NullPointerException:: if pathname is null

of back to summary

of	back to summary
public static UnixDomainSocketAddress of(Path path) Creates a UnixDomainSocketAddress for the given path. Parameters path:Path The path to the socket, which can be empty Returns:UnixDomainSocketAddress A UnixDomainSocketAddress Exceptions IllegalArgumentException: If the path is not associated with the default file system NullPointerException: if path is `null`

public static UnixDomainSocketAddress of(Path path)

Creates a UnixDomainSocketAddress for the given path.

Parameters

path:Path: The path to the socket, which can be empty

Returns:UnixDomainSocketAddress

A UnixDomainSocketAddress

Exceptions

IllegalArgumentException:: If the path is not associated with the default file system
NullPointerException:: if path is null

readObject	back to summary
private void readObject(ObjectInputStream s) throws InvalidObjectException Throws InvalidObjectException, always. Parameters s:ObjectInputStream the stream Annotations @Serial Exceptions InvalidObjectException: always

readObject

back to summary

private void readObject(ObjectInputStream s) throws InvalidObjectException

Throws InvalidObjectException, always.

Parameters

s:ObjectInputStream: the stream

Annotations

@Serial

Exceptions

InvalidObjectException:: always

readObjectNoData	back to summary
private void readObjectNoData() throws InvalidObjectException Throws InvalidObjectException, always. Annotations @Serial Exceptions InvalidObjectException: always

readObjectNoData

back to summary

private void readObjectNoData() throws InvalidObjectException

Throws InvalidObjectException, always.

Annotations

@Serial

Exceptions

InvalidObjectException:: always

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Returns a string representation of this `UnixDomainSocketAddress`. Returns:String this address's path which may be empty for an unnamed address Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Returns a string representation of this UnixDomainSocketAddress.

Returns:String

this address's path which may be empty for an unnamed address

Annotations

@Override

writeReplace back to summary

writeReplace	back to summary
private Object writeReplace() throws ObjectStreamException Returns a Ser containing the path name of this instance. Returns:Object a `Ser` representing the path name of this instance Annotations @Serial Exceptions ObjectStreamException: if an error occurs

private Object writeReplace() throws ObjectStreamException

Returns a Ser containing the path name of this instance.

Returns:Object

a Ser representing the path name of this instance

Annotations

@Serial

Exceptions

ObjectStreamException:: if an error occurs

java.net back to summary

private final Class UnixDomainSocketAddress.Ser

Class Inheritance

extends Object
implements Serializable

java.lang.Object
java.net.UnixDomainSocketAddress.Ser

All Implemented Interfaces

java.io.Serializable

A serial proxy for all UnixDomainSocketAddress instances. It captures the file path name and reconstructs using the public static factory.

Field Summary

Modifier and Type	Field and Description
private final String	pathname The path name.
pack-priv static final long	serialVersionUID

Constructor Summary

Access	Constructor and Description
pack-priv	Ser(String pathname)

Method Summary

Modifier and Type	Method and Description
private Object	Returns: a UnixDomainSocketAddress readResolve() Creates a `UnixDomainSocketAddress` instance, by an invocation of the `factory` method passing the path name.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

pathname	back to summary
private final String pathname The path name.

serialVersionUID	back to summary
pack-priv static final long serialVersionUID Annotations @Serial

Constructor Detail

Ser	back to summary
pack-priv Ser(String pathname)

Method Detail

readResolve back to summary

readResolve	back to summary
private Object readResolve() Creates a `UnixDomainSocketAddress` instance, by an invocation of the `factory` method passing the path name. Returns:Object a UnixDomainSocketAddress Annotations @Serial

private Object readResolve()

Creates a UnixDomainSocketAddress instance, by an invocation of the factory method passing the path name.

Returns:Object

a UnixDomainSocketAddress

Annotations

@Serial

public final Class UnixDomainSocketAddress

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class UnixDomainSocketAddress.Ser

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail