Package org.gnome.gio

Class SocketService.Builder<B extends SocketService.Builder<B>>

java.lang.Object

io.github.jwharm.javagi.gobject.Builder<B>

org.gnome.gobject.GObject.Builder<B>

org.gnome.gio.SocketListener.Builder<B>

org.gnome.gio.SocketService.Builder<B>

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

BuilderInterface

Direct Known Subclasses:

ThreadedSocketService.Builder

Enclosing class:

SocketService

public static class SocketService.Builder<B extends SocketService.Builder<B>>
extends SocketListener.Builder<B>

Inner class implementing a builder pattern to construct a GObject with properties.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder()	Default constructor for a Builder object.

Method Summary

Modifier and Type	Method	Description
SocketService	build()	Finish building the SocketService object.
B	onIncoming(SocketService.IncomingCallback handler)	The ::incoming signal is emitted when a new incoming connection to service needs to be handled.
B	setActive(boolean active)	Whether the service is currently accepting connections.

Methods inherited from class org.gnome.gio.SocketListener.Builder

onEvent, setListenBacklog

Methods inherited from class org.gnome.gobject.GObject.Builder

onNotify

Methods inherited from class io.github.jwharm.javagi.gobject.Builder

addBuilderProperty, connect, connect, connectSignals, getArena, getNames, getValues

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

protected Builder()

Default constructor for a Builder object.

Method Details

build

public SocketService build()

Finish building the SocketService object. This will call GObject.withProperties(org.gnome.glib.Type, java.lang.String[], org.gnome.gobject.Value[]) to create a new GObject instance, which is then cast to SocketService.

Overrides:

build in class SocketListener.Builder<B extends SocketService.Builder<B>>

Returns:

a new instance of SocketService with the properties that were set in the Builder object.

setActive

public B setActive(boolean active)

Whether the service is currently accepting connections.

Parameters:

active - the value for the active property

Returns:

the Builder instance is returned, to allow method chaining

onIncoming

public B onIncoming(SocketService.IncomingCallback handler)

The ::incoming signal is emitted when a new incoming connection to service needs to be handled. The handler must initiate the handling of connection, but may not block; in essence, asynchronous operations must be used.

connection will be unreffed once the signal handler returns, so you need to ref it yourself if you are planning to use it.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• SocketService.IncomingCallback.run(org.gnome.gio.SocketConnection, org.gnome.gobject.GObject)