Package org.gnome.soup

Interface Message.RequestCertificatePasswordCallback

All Superinterfaces:

FunctionPointer

Enclosing class:

Message

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public static interface Message.RequestCertificatePasswordCallback
extends FunctionPointer

Functional interface declaration of the RequestCertificatePasswordCallback callback.

See Also:

• run(org.gnome.gio.TlsPassword)

Method Summary

Modifier and Type	Method	Description
boolean	run(@Nullable TlsPassword tlsPassword)	Emitted during the msg's connection TLS handshake when tlsConnection requests a certificate password from the client.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment) method.
default int	upcall(MemorySegment sourceMessage, MemorySegment tlsPassword)	The upcall method is called from native code.

Method Details

run

boolean run(@Nullable TlsPassword tlsPassword)

Emitted during the msg's connection TLS handshake when tlsConnection requests a certificate password from the client.

You can set the certificate password on password, then call Message.tlsClientCertificatePasswordRequestComplete() and return true to handle the signal synchronously. It's possible to handle the request asynchornously by calling GObject.ref() on password, then returning true and call Message.tlsClientCertificatePasswordRequestComplete() later after setting the password on password. Note that this signal is not emitted if Session:tls-interaction was set.

upcall

default int upcall(MemorySegment sourceMessage,
 MemorySegment tlsPassword)

The upcall method is called from native code. The parameters are marshaled and run(org.gnome.gio.TlsPassword) is executed.

toCallback

default MemorySegment toCallback(Arena arena)

Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, java.lang.foreign.MemorySegment) method.

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the arena in which the function pointer is allocated

Returns:

the native function pointer