Package org.gnome.gio

Class DBusInterfaceSkeleton.Builder<B extends DBusInterfaceSkeleton.Builder<B>>

java.lang.Object

org.javagi.gobject.Builder<B>

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

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

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

BuilderInterface

Enclosing class:

DBusInterfaceSkeleton

public static class DBusInterfaceSkeleton.Builder<B extends DBusInterfaceSkeleton.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
DBusInterfaceSkeleton	build()	Finish building the DBusInterfaceSkeleton object.
B	onGAuthorizeMethod(DBusInterfaceSkeleton.GAuthorizeMethodCallback handler)	Emitted when a method is invoked by a remote caller and used to determine if the method call is authorized.
B	setGFlags(Set<DBusInterfaceSkeletonFlags> gFlags)	Flags from the GDBusInterfaceSkeletonFlags enumeration.
B	setGFlags(DBusInterfaceSkeletonFlags... gFlags)	Flags from the GDBusInterfaceSkeletonFlags enumeration.

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 DBusInterfaceSkeleton build()

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

Overrides:

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

Returns:

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

setGFlags

public B setGFlags(Set<DBusInterfaceSkeletonFlags> gFlags)

Flags from the GDBusInterfaceSkeletonFlags enumeration.

Parameters:

gFlags - the value for the g-flags property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.30

setGFlags

public B setGFlags(DBusInterfaceSkeletonFlags... gFlags)

Flags from the GDBusInterfaceSkeletonFlags enumeration.

Parameters:

gFlags - the value for the g-flags property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.30

onGAuthorizeMethod

public B onGAuthorizeMethod(DBusInterfaceSkeleton.GAuthorizeMethodCallback handler)

Emitted when a method is invoked by a remote caller and used to determine if the method call is authorized.

Note that this signal is emitted in a thread dedicated to handling the method call so handlers are allowed to perform blocking IO. This means that it is appropriate to call e.g. polkit_authority_check_authorization_sync() with the POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION flag set.

If false is returned then no further handlers are run and the signal handler must take a reference to invocation and finish handling the call (e.g. return an error via g_dbus_method_invocation_return_error()).

Otherwise, if true is returned, signal emission continues. If no handlers return false, then the method is dispatched. If interface_ has an enclosing GDBusObjectSkeleton, then the GDBusObjectSkeleton::authorize-method signal handlers run before the handlers for this signal.

The default class handler just returns true.

Please note that the common case is optimized: if no signals handlers are connected and the default class handler isn't overridden (for both interface_ and the enclosing GDBusObjectSkeleton, if any) and GDBusInterfaceSkeleton:g-flags does not have the DBusInterfaceSkeletonFlags.HANDLE_METHOD_INVOCATIONS_IN_THREAD flags set, no dedicated thread is ever used and the call will be handled in the same thread as the object that interface_ belongs to was exported in.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.30

See Also:

• DBusInterfaceSkeleton.GAuthorizeMethodCallback.run(org.gnome.gio.DBusMethodInvocation)