eu.aschuetz.nativeutils.api.structs

Class Sockaddr

java.lang.Object

eu.aschuetz.nativeutils.api.structs.Sockaddr

public class Sockaddr
extends Object

Java representation of native struct sockaddr in its many varieties (such as sockaddr_in for example)

Constructor Summary

Constructors

Constructor and Description
Sockaddr() Use this constructor for creating objects to call LinuxNativeUtil.recvfrom(int, byte[], int, int, int, Sockaddr) and similar methods that want to output a socket address.
Sockaddr(int addressFamily, byte[] address) Constructs new native representation of a socket address.
Sockaddr(Sockaddr other)

Method Summary

Modifier and Type	Method and Description
Sockaddr	clone()
void	copyTo(Sockaddr other) Copy this address to the other address object.
boolean	equals(Object o)
byte[]	getAddress() IF you need to store the returned array copy it as it is mutable.
int	getAddressFamily() Returns the Address family of this socket address in a easy to understand format for java.
int	hashCode()
InetSocketAddress	parseWin32_SOCKADDR_INET() Parses the Sockaddr as a Win32 SOCKADDR_INET.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Sockaddr

public Sockaddr()

Use this constructor for creating objects to call LinuxNativeUtil.recvfrom(int, byte[], int, int, int, Sockaddr) and similar methods that want to output a socket address. Be aware that such syscalls may mutate the address array if the size fits the desired size. You should in general copy the address array if you need to store it before reusing a Sockaddr Object as an output

Sockaddr

public Sockaddr(int addressFamily,
                byte[] address)

Constructs new native representation of a socket address. You do not need to call this constructor this manually for AF_UNIX, AF_INET and AF_INET6 as there are conversion methods available to in the LinuxNativeUtils to handle this job for you this

Parameters:

addressFamily - constant address family value. This is the first field within address.

address - binary value of the respective struct sockaddr. This must include the addressFamily. If you construct this value manually then the size must match the native structs size or syscalls using this address may fail because of it. The size for certain addresses may be dependent on the CPU architecture.

Sockaddr

public Sockaddr(Sockaddr other)

Method Detail

getAddressFamily

public int getAddressFamily()

Returns the Address family of this socket address in a easy to understand format for java. This value should be always duplicated inside the first bytes of address.

getAddress

public byte[] getAddress()

IF you need to store the returned array copy it as it is mutable.

clone

public Sockaddr clone()

Overrides:

clone in class Object

copyTo

public void copyTo(Sockaddr other)

Copy this address to the other address object. The address array of the other array will be mutated if the size is the same otherwise the array is cloned.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

parseWin32_SOCKADDR_INET

public InetSocketAddress parseWin32_SOCKADDR_INET()

Parses the Sockaddr as a Win32 SOCKADDR_INET. Returns null if the Sockaddr is not parsable.

toString

public String toString()

Overrides:

toString in class Object