Package org.gnome.gio

Class DBusProxy.Builder<B extends DBusProxy.Builder<B>>

java.lang.Object

org.javagi.gobject.Builder<B>

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

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

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

BuilderInterface

Direct Known Subclasses:

Collection.Builder, Item.Builder, Prompt.Builder, Service.Builder

Enclosing class:

DBusProxy

public static class DBusProxy.Builder<B extends DBusProxy.Builder<B>>
extends GObject.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
DBusProxy	build()	Finish building the DBusProxy object.
B	onGPropertiesChanged(DBusProxy.GPropertiesChangedCallback handler)	Emitted when one or more D-Bus properties on proxy changes.
B	onGSignal(@Nullable String detail, DBusProxy.GSignalCallback handler)	Emitted when a signal from the remote object and interface that proxy is for, has been received.
B	setGBusType(BusType gBusType)	If this property is not BusType.NONE, then GDBusProxy:g-connection must be null and will be set to the GDBusConnection obtained by calling g_bus_get() with the value of this property.
B	setGConnection(DBusConnection gConnection)	The GDBusConnection the proxy is for.
B	setGDefaultTimeout(int gDefaultTimeout)	The timeout to use if -1 (specifying default timeout) is passed as timeoutMsec in the g_dbus_proxy_call() and g_dbus_proxy_call_sync() functions.
B	setGFlags(Set<DBusProxyFlags> gFlags)	Flags from the GDBusProxyFlags enumeration.
B	setGFlags(DBusProxyFlags... gFlags)	Flags from the GDBusProxyFlags enumeration.
B	setGInterfaceInfo(DBusInterfaceInfo gInterfaceInfo)	Ensure that interactions with this proxy conform to the given interface.
B	setGInterfaceName(String gInterfaceName)	The D-Bus interface name the proxy is for.
B	setGName(String gName)	The well-known or unique name that the proxy is for.
B	setGObjectPath(String gObjectPath)	The object path the proxy is for.

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

onNotify

Methods inherited from class org.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 DBusProxy build()

Finish building the DBusProxy 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 DBusProxy.

Overrides:

build in class GObject.Builder<B extends DBusProxy.Builder<B>>

Returns:

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

setGBusType

public B setGBusType(BusType gBusType)

If this property is not BusType.NONE, then GDBusProxy:g-connection must be null and will be set to the GDBusConnection obtained by calling g_bus_get() with the value of this property.

Parameters:

gBusType - the value for the g-bus-type property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGConnection

public B setGConnection(DBusConnection gConnection)

The GDBusConnection the proxy is for.

Parameters:

gConnection - the value for the g-connection property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGDefaultTimeout

public B setGDefaultTimeout(int gDefaultTimeout)

The timeout to use if -1 (specifying default timeout) is passed as timeoutMsec in the g_dbus_proxy_call() and g_dbus_proxy_call_sync() functions.

This allows applications to set a proxy-wide timeout for all remote method invocations on the proxy. If this property is -1, the default timeout (typically 25 seconds) is used. If set to G_MAXINT, then no timeout is used.

Parameters:

gDefaultTimeout - the value for the g-default-timeout property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGFlags

public B setGFlags(Set<DBusProxyFlags> gFlags)

Flags from the GDBusProxyFlags enumeration.

Parameters:

gFlags - the value for the g-flags property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGInterfaceInfo

public B setGInterfaceInfo(DBusInterfaceInfo gInterfaceInfo)

Ensure that interactions with this proxy conform to the given interface. This is mainly to ensure that malformed data received from the other peer is ignored. The given GDBusInterfaceInfo is said to be the "expected interface".

The checks performed are:

• When completing a method call, if the type signature of the reply message isn't what's expected, the reply is discarded and the GError is set to IOErrorEnum.INVALID_ARGUMENT.

• Received signals that have a type signature mismatch are dropped and a warning is logged via g_warning().

• Properties received via the initial GetAll() call or via the ::PropertiesChanged signal (on the org.freedesktop.DBus.Properties interface) or set using g_dbus_proxy_set_cached_property() with a type signature mismatch are ignored and a warning is logged via g_warning().

Note that these checks are never done on methods, signals and properties that are not referenced in the given GDBusInterfaceInfo, since extending a D-Bus interface on the service-side is not considered an ABI break.

Parameters:

gInterfaceInfo - the value for the g-interface-info property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGInterfaceName

public B setGInterfaceName(String gInterfaceName)

The D-Bus interface name the proxy is for.

Parameters:

gInterfaceName - the value for the g-interface-name property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGName

public B setGName(String gName)

The well-known or unique name that the proxy is for.

Parameters:

gName - the value for the g-name property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGObjectPath

public B setGObjectPath(String gObjectPath)

The object path the proxy is for.

Parameters:

gObjectPath - the value for the g-object-path property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

setGFlags

public B setGFlags(DBusProxyFlags... gFlags)

Flags from the GDBusProxyFlags enumeration.

Parameters:

gFlags - the value for the g-flags property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

onGPropertiesChanged

public B onGPropertiesChanged(DBusProxy.GPropertiesChangedCallback handler)

Emitted when one or more D-Bus properties on proxy changes. The local cache has already been updated when this signal fires. Note that both changedProperties and invalidatedProperties are guaranteed to never be null (either may be empty though).

If the proxy has the flag DBusProxyFlags.GET_INVALIDATED_PROPERTIES set, then invalidatedProperties will always be empty.

This signal corresponds to the PropertiesChanged D-Bus signal on the org.freedesktop.DBus.Properties interface.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

See Also:

• DBusProxy.GPropertiesChangedCallback.run(org.gnome.glib.Variant, java.lang.String[])

onGSignal

public B onGSignal(@Nullable String detail,
 DBusProxy.GSignalCallback handler)

Emitted when a signal from the remote object and interface that proxy is for, has been received.

Since 2.72 this signal supports detailed connections. You can connect to the detailed signal g-signal::x in order to receive callbacks only when signal x is received from the remote object.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.26

See Also:

• DBusProxy.GSignalCallback.run(java.lang.String, java.lang.String, org.gnome.glib.Variant)