Package org.gnome.gio

Class NetworkService

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gio.NetworkService

All Implemented Interfaces:

SocketConnectable, Proxy

@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.SocketConnectable$Impl, SocketConnectable.SocketConnectableIface

Constructor Summary

Constructors

Constructor	Description
NetworkService()	Creates a new NetworkService.
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. This will initially be unresolved; use the GSocketConnectable interface to resolve it.

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 srv's protocol name (eg, "tcp").
String	getScheme()	Gets the URI scheme used to resolve proxies.
String	getService()	Gets srv's service name (eg, "ldap").
static @Nullable 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, 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

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

Since:

2.22

NetworkService

public NetworkService()

Creates a new NetworkService.

Method Details

getType

public static @Nullable 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:

srv's domain name

Since:

2.22

getProtocol

public String getProtocol()

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

Returns:

srv's protocol name

Since:

2.22

getScheme

public String getScheme()

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

Returns:

srv's scheme name

Since:

2.26

getService

public String getService()

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

Returns:

srv's service name

Since:

2.22

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

Since:

2.26

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().

Returns:

the builder object