Package org.gnome.gio

Class SocketAddress

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gio.SocketAddress

All Implemented Interfaces:

SocketConnectable, Proxy

Direct Known Subclasses:

InetSocketAddress, NativeSocketAddress, SocketAddress.SocketAddress$Impl, UnixSocketAddress

@Generated("io.github.jwharm.JavaGI")
public abstract class SocketAddress
extends GObject
implements SocketConnectable

GSocketAddress is the equivalent of struct sockaddr) and its subtypes in the BSD sockets API. This is an abstract class; use InetSocketAddress for internet sockets, or UnixSocketAddress for UNIX domain sockets.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SocketAddress.Builder<B extends SocketAddress.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	SocketAddress.SocketAddress$Impl	The SocketAddress$Impl type represents a native instance of the abstract SocketAddress class.
static class	SocketAddress.SocketAddressClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface org.gnome.gio.SocketConnectable

SocketConnectable.SocketConnectable$Impl, SocketConnectable.SocketConnectableIface

Constructor Summary

Constructors

Constructor	Description
SocketAddress()	Creates a new SocketAddress.
SocketAddress(MemorySegment address)	Create a SocketAddress proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected SocketAddress	asParent()	Returns this instance as if it were its parent type.
static SocketAddress	fromNative(MemorySegment native_, long len)	Creates a GSocketAddress subclass corresponding to the native struct sockaddr native.
SocketFamily	getFamily()	Gets the socket family type of address.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
long	getNativeSize()	Gets the size of address's native struct sockaddr.
static @Nullable Type	getType()	Get the GType of the SocketAddress class
boolean	toNative(@Nullable MemorySegment dest, long destlen)	Converts a GSocketAddress to a native struct sockaddr, which can be passed to low-level functions like connect() or bind().

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, builder, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.javagi.base.Proxy

handle

Methods inherited from interface org.gnome.gio.SocketConnectable

enumerate, formatAsString, proxyEnumerate

Constructor Details

SocketAddress

public SocketAddress(MemorySegment address)

Create a SocketAddress proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

SocketAddress

public SocketAddress()

Creates a new SocketAddress.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the SocketAddress class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected SocketAddress asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

fromNative

public static SocketAddress fromNative(MemorySegment native_,
 long len)

Creates a GSocketAddress subclass corresponding to the native struct sockaddr native.

Parameters:

native_ - a pointer to a struct sockaddr

len - the size of the memory location pointed to by native_

Returns:

a new GSocketAddress if native_ could successfully be converted, otherwise null

Since:

2.22

getFamily

public SocketFamily getFamily()

Gets the socket family type of address.

Returns:

the socket family type of this SocketAddress

Since:

2.22

getNativeSize

public long getNativeSize()

Gets the size of address's native struct sockaddr. You can use this to allocate memory to pass to g_socket_address_to_native().

Returns:

the size of the native struct sockaddr that this SocketAddress represents, or -1 if this SocketAddress is not valid

Since:

2.22

toNative

public boolean toNative(@Nullable MemorySegment dest,
 long destlen)
                 throws GErrorException

Converts a GSocketAddress to a native struct sockaddr, which can be passed to low-level functions like connect() or bind().

If not enough space is available, a IOErrorEnum.NO_SPACE error is returned. If the address type is not known on the system then a IOErrorEnum.NOT_SUPPORTED error is returned.

Parameters:

dest - a pointer to a memory location that will contain the native struct sockaddr

destlen - the size of dest. Must be at least as large as g_socket_address_get_native_size()

Returns:

true if dest was filled in, false on error

Throws:

GErrorException - see GError

Since:

2.22