Package org.gnome.gio

Interface DtlsConnection.Builder<B extends Builder<B>>

All Superinterfaces:

BuilderInterface

Enclosing interface:

DtlsConnection

public static interface DtlsConnection.Builder<B extends Builder<B>>
extends BuilderInterface

Method Summary

Modifier and Type	Method	Description
default B	setAdvertisedProtocols(String[] advertisedProtocols)	The list of application-layer protocols that the connection advertises that it is willing to speak.
default B	setBaseSocket(DatagramBased baseSocket)	The GDatagramBased that the connection wraps.
default B	setCertificate(TlsCertificate certificate)	The connection's certificate; see g_dtls_connection_set_certificate().
default B	setDatabase(TlsDatabase database)	The certificate database to use when verifying this TLS connection.
default B	setInteraction(TlsInteraction interaction)	A GTlsInteraction object to be used when the connection or certificate database need to interact with the user.
default B	setRehandshakeMode(TlsRehandshakeMode rehandshakeMode)	Deprecated. The rehandshake mode is ignored.
default B	setRequireCloseNotify(boolean requireCloseNotify)	Whether or not proper TLS close notification is required.

Methods inherited from interface org.javagi.gobject.BuilderInterface

addBuilderProperty, connect, connect, getArena

Method Details

setAdvertisedProtocols

default B setAdvertisedProtocols(String[] advertisedProtocols)

The list of application-layer protocols that the connection advertises that it is willing to speak. See g_dtls_connection_set_advertised_protocols().

Parameters:

advertisedProtocols - the value for the advertised-protocols property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.60

setBaseSocket

default B setBaseSocket(DatagramBased baseSocket)

The GDatagramBased that the connection wraps. Note that this may be any implementation of GDatagramBased, not just a GSocket.

Parameters:

baseSocket - the value for the base-socket property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.48

setCertificate

default B setCertificate(TlsCertificate certificate)

The connection's certificate; see g_dtls_connection_set_certificate().

Parameters:

certificate - the value for the certificate property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.48

setDatabase

default B setDatabase(TlsDatabase database)

The certificate database to use when verifying this TLS connection. If no certificate database is set, then the default database will be used. See g_tls_backend_get_default_database().

When using a non-default database, GDtlsConnection must fall back to using the GTlsDatabase to perform certificate verification using g_tls_database_verify_chain(), which means certificate verification will not be able to make use of TLS session context. This may be less secure. For example, if you create your own GTlsDatabase that just wraps the default GTlsDatabase, you might expect that you have not changed anything, but this is not true because you may have altered the behavior of GDtlsConnection by causing it to use g_tls_database_verify_chain(). See the documentation of g_tls_database_verify_chain() for more details on specific security checks that may not be performed. Accordingly, setting a non-default database is discouraged except for specialty applications with unusual security requirements.

Parameters:

database - the value for the database property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.48

setInteraction

default B setInteraction(TlsInteraction interaction)

A GTlsInteraction object to be used when the connection or certificate database need to interact with the user. This will be used to prompt the user for passwords where necessary.

Parameters:

interaction - the value for the interaction property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.48

setRehandshakeMode

@Deprecated
default B setRehandshakeMode(TlsRehandshakeMode rehandshakeMode)

Deprecated.

The rehandshake mode is ignored.

The rehandshaking mode. See g_dtls_connection_set_rehandshake_mode().

Parameters:

rehandshakeMode - the value for the rehandshake-mode property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.48

setRequireCloseNotify

default B setRequireCloseNotify(boolean requireCloseNotify)

Whether or not proper TLS close notification is required. See g_dtls_connection_set_require_close_notify().

Parameters:

requireCloseNotify - the value for the require-close-notify property

Returns:

the Builder instance is returned, to allow method chaining

Since:

2.48