Package org.gnome.gio

Class NetworkService

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gio.NetworkService

All Implemented Interfaces:

Proxy, SocketConnectable

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

Like NetworkAddress does with hostnames, GNetworkService provides an easy way to resolve a SRV record, and then attempt to connect to one of the hosts that implements that service, handling service priority/weighting, multiple IP addresses, and multiple address families.

See Gio.SrvTarget for more information about SRV records, and see SocketConnectable for an example of using the connectable interface.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	NetworkService.Builder<B extends NetworkService.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	NetworkService.NetworkServiceClass

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.SocketConnectableIface, SocketConnectable.SocketConnectableImpl

Constructor Summary

Constructors

Constructor	Description
NetworkService(MemorySegment address)	Create a NetworkService proxy instance for the provided memory address.
NetworkService(String service, String protocol, String domain)	Creates a new GNetworkService representing the given service, protocol, and domain.

Method Summary

Modifier and Type	Method	Description
protected NetworkService	asParent()	Returns this instance as if it were its parent type.
static NetworkService.Builder<? extends NetworkService.Builder>	builder()	A NetworkService.Builder object constructs a NetworkService with the specified properties.
String	getDomain()	Gets the domain that this NetworkService serves.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
String	getProtocol()	Gets this NetworkService's protocol name (eg, "tcp").
String	getScheme()	Gets the URI scheme used to resolve proxies.
String	getService()	Gets this NetworkService's service name (eg, "ldap").
static Type	getType()	Get the GType of the NetworkService class
void	setScheme(String scheme)	Set's the URI scheme used to resolve proxies.

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, 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, 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, getPrivate, readGClass, writeGClass

Methods inherited from class io.github.jwharm.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 io.github.jwharm.javagi.base.Proxy

handle

Methods inherited from interface org.gnome.gio.SocketConnectable

enumerate, proxyEnumerate, toString_

Constructor Details

NetworkService

public NetworkService(MemorySegment address)

Create a NetworkService proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

NetworkService

public NetworkService(String service,
 String protocol,
 String domain)

Creates a new GNetworkService representing the given service, protocol, and domain. This will initially be unresolved; use the GSocketConnectable interface to resolve it.

Parameters:

service - the service type to look up (eg, "ldap")

protocol - the networking protocol to use for service (eg, "tcp")

domain - the DNS domain to look up the service in

Method Details

getType

public static Type getType()

Get the GType of the NetworkService class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected NetworkService 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

getDomain

public String getDomain()

Gets the domain that this NetworkService serves. This might be either UTF-8 or ASCII-encoded, depending on what this NetworkService was created with.

Returns:

this NetworkService's domain name

getProtocol

public String getProtocol()

Gets this NetworkService's protocol name (eg, "tcp").

Returns:

this NetworkService's protocol name

getScheme

public String getScheme()

Gets the URI scheme used to resolve proxies. By default, the service name is used as scheme.

Returns:

this NetworkService's scheme name

getService

public String getService()

Gets this NetworkService's service name (eg, "ldap").

Returns:

this NetworkService's service name

setScheme

public void setScheme(String scheme)

Set's the URI scheme used to resolve proxies. By default, the service name is used as scheme.

Parameters:

scheme - a URI scheme

builder

public static NetworkService.Builder<? extends NetworkService.Builder> builder()

A NetworkService.Builder object constructs a NetworkService with the specified properties. Use the various set...() methods to set properties, and finish construction with NetworkService.Builder.build().