Package org.gnome.gio

Class SrvTarget

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gio.SrvTarget

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class SrvTarget
extends ProxyInstance

A single target host/port that a network service is running on.

SRV (service) records are used by some network protocols to provide service-specific aliasing and load-balancing. For example, XMPP (Jabber) uses SRV records to locate the XMPP server for a domain; rather than connecting directly to ‘example.com’ or assuming a specific server hostname like ‘xmpp.example.com’, an XMPP client would look up the xmpp-client SRV record for ‘example.com’, and then connect to whatever host was pointed to by that record.

You can use Resolver.lookupService(java.lang.String, java.lang.String, java.lang.String, org.gnome.gio.Cancellable) or Resolver.lookupServiceAsync(java.lang.String, java.lang.String, java.lang.String, org.gnome.gio.Cancellable, org.gnome.gio.AsyncReadyCallback) to find the GSrvTargets for a given service. However, if you are simply planning to connect to the remote service, you can use NetworkService’s SocketConnectable interface and not need to worry about GSrvTarget at all.

Constructor Summary

Constructors

Constructor	Description
SrvTarget(MemorySegment address)	Create a SrvTarget proxy instance for the provided memory address.
SrvTarget(String hostname, short port, short priority, short weight)	Creates a new GSrvTarget with the given parameters.

Method Summary

Modifier and Type	Method	Description
SrvTarget	copy()	Copies this SrvTarget
void	free()	Frees this SrvTarget
String	getHostname()	Gets this SrvTarget's hostname (in ASCII form; if you are going to present this to the user, you should use g_hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use g_hostname_to_unicode() to convert it if it does.)
short	getPort()	Gets this SrvTarget's port
short	getPriority()	Gets this SrvTarget's priority.
static Type	getType()	Get the GType of the SrvTarget class
short	getWeight()	Gets this SrvTarget's weight.
static List<MemorySegment>	listSort(List<MemorySegment> targets)	Sorts targets in place according to the algorithm in RFC 2782.

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

Constructor Details

SrvTarget

public SrvTarget(MemorySegment address)

Create a SrvTarget proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

SrvTarget

public SrvTarget(String hostname,
 short port,
 short priority,
 short weight)

Creates a new GSrvTarget with the given parameters.

You should not need to use this; normally GSrvTargets are created by GResolver.

Parameters:

hostname - the host that the service is running on

port - the port that the service is running on

priority - the target's priority

weight - the target's weight

Method Details

getType

public static Type getType()

Get the GType of the SrvTarget class

Returns:

the GType

listSort

public static List<MemorySegment> listSort(List<MemorySegment> targets)

Sorts targets in place according to the algorithm in RFC 2782.

Parameters:

targets - a GList of GSrvTarget

Returns:

the head of the sorted list.

copy

public SrvTarget copy()

Copies this SrvTarget

Returns:

a copy of this SrvTarget

free

public void free()

Frees this SrvTarget

getHostname

public String getHostname()

Gets this SrvTarget's hostname (in ASCII form; if you are going to present this to the user, you should use g_hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use g_hostname_to_unicode() to convert it if it does.)

Returns:

this SrvTarget's hostname

getPort

public short getPort()

Gets this SrvTarget's port

Returns:

this SrvTarget's port

getPriority

public short getPriority()

Gets this SrvTarget's priority. You should not need to look at this; GResolver already sorts the targets according to the algorithm in RFC 2782.

Returns:

this SrvTarget's priority

getWeight

public short getWeight()

Gets this SrvTarget's weight. You should not need to look at this; GResolver already sorts the targets according to the algorithm in RFC 2782.

Returns:

this SrvTarget's weight