Package org.gnome.gio

Class SrvTarget

java.lang.Object

org.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 target'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 target's port
short	getPriority()	Gets target's priority.
static @Nullable Type	getType()	Get the GType of the SrvTarget class
short	getWeight()	Gets target's weight.
static List<MemorySegment>	listSort(List<MemorySegment> targets)	Sorts targets in place according to the algorithm in RFC 2782.

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

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

Since:

2.22

Method Details

getType

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

Since:

2.22

copy

public SrvTarget copy()

Copies this SrvTarget

Returns:

a copy of this SrvTarget

Since:

2.22

free

public void free()

Frees this SrvTarget

Since:

2.22

getHostname

public String getHostname()

Gets target'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:

target's hostname

Since:

2.22

getPort

public short getPort()

Gets target's port

Returns:

target's port

Since:

2.22

getPriority

public short getPriority()

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

Returns:

target's priority

Since:

2.22

getWeight

public short getWeight()

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

Returns:

target's weight

Since:

2.22