Package ch.bailu.gtk.gio

Klasse TlsInteraction

java.lang.Object

ch.bailu.gtk.type.Type

ch.bailu.gtk.type.Pointer

ch.bailu.gtk.gobject.Object

ch.bailu.gtk.type.PropertyHolder

ch.bailu.gtk.gio.TlsInteraction

Alle implementierten Schnittstellen:

PointerInterface

public class TlsInteraction
extends PropertyHolder

`GTlsInteraction` provides a mechanism for the TLS connection and database
code to interact with the user. It can be used to ask the user for passwords.

To use a `GTlsInteraction` with a TLS connection use
[method@Gio.TlsConnection.set_interaction].

Callers should instantiate a derived class that implements the various
interaction methods to show the required dialogs.

Callers should use the 'invoke' functions like
[method@Gio.TlsInteraction.invoke_ask_password] to run interaction methods.
These functions make sure that the interaction is invoked in the main loop
and not in the current thread, if the current thread is not running the
main loop.

Derived classes can choose to implement whichever interactions methods they’d
like to support by overriding those virtual methods in their class
initialization function. Any interactions not implemented will return
`G_TLS_INTERACTION_UNHANDLED`. If a derived class implements an async method,
it must also implement the corresponding finish method.

https://docs.gtk.org/gio/class.TlsInteraction.html

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifizierer und Typ	Klasse	Beschreibung
static interface	TlsInteraction.OnAsyncReadyCallback

Von Klasse geerbte verschachtelte Klassen/Schnittstellen ch.bailu.gtk.gobject.Object

Object.OnBindingTransformFunc, Object.OnDestroyNotify, Object.OnDuplicateFunc, Object.OnNotify, Object.OnToggleNotify, Object.OnWeakNotify

Feldübersicht

Von Klasse geerbte Felder ch.bailu.gtk.gobject.Object

SIGNAL_ON_NOTIFY

Von Klasse geerbte Felder ch.bailu.gtk.type.Pointer

NULL

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
TlsInteraction(PointerContainer pointer)

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
int	askPassword(TlsPassword password, Cancellable cancellable)	Run synchronous interaction to ask the user for a password.
void	askPasswordAsync(TlsPassword password, Cancellable cancellable, TlsInteraction.OnAsyncReadyCallback callback, Pointer user_data)	Run asynchronous interaction to ask the user for a password.
int	askPasswordFinish(AsyncResult result)	Complete an ask password user interaction request.
static ClassHandler	getClassHandler()
static int	getInstanceSize()
static long	getParentTypeID()
static TypeSystem.TypeSize	getParentTypeSize()
static long	getTypeID()
static TypeSystem.TypeSize	getTypeSize()
int	invokeAskPassword(TlsPassword password, Cancellable cancellable)	Invoke the interaction to ask the user for a password.
int	invokeRequestCertificate(TlsConnection connection, int flags, Cancellable cancellable)	Invoke the interaction to ask the user to choose a certificate to use with the connection.
int	requestCertificate(TlsConnection connection, int flags, Cancellable cancellable)	Run synchronous interaction to ask the user to choose a certificate to use with the connection.
void	requestCertificateAsync(TlsConnection connection, int flags, Cancellable cancellable, TlsInteraction.OnAsyncReadyCallback callback, Pointer user_data)	Run asynchronous interaction to ask the user for a certificate to use with the connection.
int	requestCertificateFinish(AsyncResult result)	Complete a request certificate user interaction request.

Von Klasse geerbte Methoden ch.bailu.gtk.type.PropertyHolder

getBooleanProperty, getIntProperty, getObjectProperty, getStringProperty, getStrProperty, setBooleanProperty, setIntProperty, setObjectProperty, setStringProperty, setStrProperty

Von Klasse geerbte Methoden ch.bailu.gtk.gobject.Object

addToggleRef, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, disconnect, disconnect, dupData, dupData, dupQdata, forceFloating, freezeNotify, get, get, getData, getData, getProperty, getProperty, getQdata, interfaceFindProperty, interfaceInstallProperty, isFloating, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, replaceData, replaceData, replaceQdata, runDispose, set, set, setData, setData, setDataFull, setDataFull, setProperty, setProperty, setQdata, setQdataFull, stealData, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref

Von Klasse geerbte Methoden ch.bailu.gtk.type.Pointer

asCPointer, cast, connectSignal, disconnectSignals, disconnectSignals, equals, hashCode, throwIfNull, throwNullPointerException, toString, unregisterCallbacks, unregisterCallbacks

Von Klasse geerbte Methoden ch.bailu.gtk.type.Type

asCPointer, asCPointer, asCPointerNotNull, asJnaPointer, asJnaPointer, asPointer, asPointer, cast, cast, throwIfNull

Von Klasse geerbte Methoden java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Von Schnittstelle geerbte Methoden ch.bailu.gtk.type.PointerInterface

asCPointerNotNull, asJnaPointer, asPointer, isNotNull, isNull

Konstruktordetails

TlsInteraction

public TlsInteraction(PointerContainer pointer)

Methodendetails

getClassHandler

public static ClassHandler getClassHandler()

askPassword

public int askPassword(@Nonnull
 TlsPassword password,
 @Nullable
 Cancellable cancellable)
                throws AllocationError

Run synchronous interaction to ask the user for a password. In general,
g_tls_interaction_invoke_ask_password() should be used instead of this
function.

Derived subclasses usually implement a password prompt, although they may
also choose to provide a password from elsewhere. The @password value will
be filled in and then @callback will be called. Alternatively the user may
abort this password request, which will usually abort the TLS connection.

If the interaction is cancelled by the cancellation object, or by the
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
not support immediate cancellation.

Parameter:

password - a #GTlsPassword object

cancellable - an optional #GCancellable cancellation object

Gibt zurück:

The status of the ask password interaction.

Löst aus:

AllocationError

askPasswordAsync

public void askPasswordAsync(@Nonnull
 TlsPassword password,
 @Nullable
 Cancellable cancellable,
 TlsInteraction.OnAsyncReadyCallback callback,
 @Nullable
 Pointer user_data)

Run asynchronous interaction to ask the user for a password. In general,
g_tls_interaction_invoke_ask_password() should be used instead of this
function.

Derived subclasses usually implement a password prompt, although they may
also choose to provide a password from elsewhere. The @password value will
be filled in and then @callback will be called. Alternatively the user may
abort this password request, which will usually abort the TLS connection.

If the interaction is cancelled by the cancellation object, or by the
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
not support immediate cancellation.

Certain implementations may not support immediate cancellation.

Parameter:

password - a #GTlsPassword object

cancellable - an optional #GCancellable cancellation object

callback - will be called when the interaction completes

user_data - data to pass to the @callback

askPasswordFinish

public int askPasswordFinish(@Nonnull
 AsyncResult result)
                      throws AllocationError

Complete an ask password user interaction request. This should be once
the g_tls_interaction_ask_password_async() completion callback is called.

If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsPassword passed
to g_tls_interaction_ask_password() will have its password filled in.

If the interaction is cancelled by the cancellation object, or by the
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
contains a %G_IO_ERROR_CANCELLED error code.

Parameter:

result - the result passed to the callback

Gibt zurück:

The status of the ask password interaction.

Löst aus:

AllocationError

invokeAskPassword

public int invokeAskPassword(@Nonnull
 TlsPassword password,
 @Nullable
 Cancellable cancellable)
                      throws AllocationError

Invoke the interaction to ask the user for a password. It invokes this
interaction in the main loop, specifically the #GMainContext returned by
g_main_context_get_thread_default() when the interaction is created. This
is called by called by #GTlsConnection or #GTlsDatabase to ask the user
for a password.

Derived subclasses usually implement a password prompt, although they may
also choose to provide a password from elsewhere. The @password value will
be filled in and then @callback will be called. Alternatively the user may
abort this password request, which will usually abort the TLS connection.

The implementation can either be a synchronous (eg: modal dialog) or an
asynchronous one (eg: modeless dialog). This function will take care of
calling which ever one correctly.

If the interaction is cancelled by the cancellation object, or by the
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
not support immediate cancellation.

Parameter:

password - a #GTlsPassword object

cancellable - an optional #GCancellable cancellation object

Gibt zurück:

The status of the ask password interaction.

Löst aus:

AllocationError

invokeRequestCertificate

public int invokeRequestCertificate(@Nonnull
 TlsConnection connection,
 int flags,
 @Nullable
 Cancellable cancellable)
                             throws AllocationError

Invoke the interaction to ask the user to choose a certificate to
use with the connection. It invokes this interaction in the main
loop, specifically the #GMainContext returned by
g_main_context_get_thread_default() when the interaction is
created. This is called by called by #GTlsConnection when the peer
requests a certificate during the handshake.

Derived subclasses usually implement a certificate selector,
although they may also choose to provide a certificate from
elsewhere. Alternatively the user may abort this certificate
request, which may or may not abort the TLS connection.

The implementation can either be a synchronous (eg: modal dialog) or an
asynchronous one (eg: modeless dialog). This function will take care of
calling which ever one correctly.

If the interaction is cancelled by the cancellation object, or by the
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
not support immediate cancellation.

Parameter:

connection - a #GTlsConnection object

flags - flags providing more information about the request

cancellable - an optional #GCancellable cancellation object

Gibt zurück:

The status of the certificate request interaction.

Löst aus:

AllocationError

requestCertificate

public int requestCertificate(@Nonnull
 TlsConnection connection,
 int flags,
 @Nullable
 Cancellable cancellable)
                       throws AllocationError

Run synchronous interaction to ask the user to choose a certificate to use
with the connection. In general, g_tls_interaction_invoke_request_certificate()
should be used instead of this function.

Derived subclasses usually implement a certificate selector, although they may
also choose to provide a certificate from elsewhere. Alternatively the user may
abort this certificate request, which will usually abort the TLS connection.

If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection
passed to g_tls_interaction_request_certificate() will have had its
#GTlsConnection:certificate filled in.

If the interaction is cancelled by the cancellation object, or by the
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
not support immediate cancellation.

Parameter:

connection - a #GTlsConnection object

flags - flags providing more information about the request

cancellable - an optional #GCancellable cancellation object

Gibt zurück:

The status of the request certificate interaction.

Löst aus:

AllocationError

requestCertificateAsync

public void requestCertificateAsync(@Nonnull
 TlsConnection connection,
 int flags,
 @Nullable
 Cancellable cancellable,
 TlsInteraction.OnAsyncReadyCallback callback,
 @Nullable
 Pointer user_data)

Run asynchronous interaction to ask the user for a certificate to use with
the connection. In general, g_tls_interaction_invoke_request_certificate() should
be used instead of this function.

Derived subclasses usually implement a certificate selector, although they may
also choose to provide a certificate from elsewhere. @callback will be called
when the operation completes. Alternatively the user may abort this certificate
request, which will usually abort the TLS connection.

Parameter:

connection - a #GTlsConnection object

flags - flags providing more information about the request

cancellable - an optional #GCancellable cancellation object

callback - will be called when the interaction completes

user_data - data to pass to the @callback

requestCertificateFinish

public int requestCertificateFinish(@Nonnull
 AsyncResult result)
                             throws AllocationError

Complete a request certificate user interaction request. This should be once
the g_tls_interaction_request_certificate_async() completion callback is called.

If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection
passed to g_tls_interaction_request_certificate_async() will have had its
#GTlsConnection:certificate filled in.

If the interaction is cancelled by the cancellation object, or by the
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
contains a %G_IO_ERROR_CANCELLED error code.

Parameter:

result - the result passed to the callback

Gibt zurück:

The status of the request certificate interaction.

Löst aus:

AllocationError

getTypeID

public static long getTypeID()

getParentTypeID

public static long getParentTypeID()

getTypeSize

public static TypeSystem.TypeSize getTypeSize()

getParentTypeSize

public static TypeSystem.TypeSize getParentTypeSize()

getInstanceSize

public static int getInstanceSize()