Package ch.bailu.gtk.gio

Interface SocketClient.OnEvent

Enclosing class:
SocketClient
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 SocketClient.OnEvent

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    onEvent(int event, SocketConnectable connectable, IOStream connection)
    Emitted when @client's activity on @connectable changes state.

  • Method Details

    • onEvent

      void onEvent(int event, @Nonnull SocketConnectable connectable, @Nullable IOStream connection)
      Emitted when @client's activity on @connectable changes state.
      Among other things, this can be used to provide progress
      information about a network connection in the UI. The meanings of
      the different @event values are as follows:

      - %G_SOCKET_CLIENT_RESOLVING: @client is about to look up @connectable
      in DNS. @connection will be %NULL.

      - %G_SOCKET_CLIENT_RESOLVED: @client has successfully resolved
      @connectable in DNS. @connection will be %NULL.

      - %G_SOCKET_CLIENT_CONNECTING: @client is about to make a connection
      to a remote host; either a proxy server or the destination server
      itself. @connection is the #GSocketConnection, which is not yet
      connected. Since GLib 2.40, you can access the remote
      address via g_socket_connection_get_remote_address().

      - %G_SOCKET_CLIENT_CONNECTED: @client has successfully connected
      to a remote host. @connection is the connected #GSocketConnection.

      - %G_SOCKET_CLIENT_PROXY_NEGOTIATING: @client is about to negotiate
      with a proxy to get it to connect to @connectable. @connection is
      the #GSocketConnection to the proxy server.

      - %G_SOCKET_CLIENT_PROXY_NEGOTIATED: @client has negotiated a
      connection to @connectable through a proxy server. @connection is
      the stream returned from g_proxy_connect(), which may or may not
      be a #GSocketConnection.

      - %G_SOCKET_CLIENT_TLS_HANDSHAKING: @client is about to begin a TLS
      handshake. @connection is a #GTlsClientConnection.

      - %G_SOCKET_CLIENT_TLS_HANDSHAKED: @client has successfully completed
      the TLS handshake. @connection is a #GTlsClientConnection.

      - %G_SOCKET_CLIENT_COMPLETE: @client has either successfully connected
      to @connectable (in which case @connection is the #GSocketConnection
      that it will be returning to the caller) or has failed (in which
      case @connection is %NULL and the client is about to return an error).

      Each event except %G_SOCKET_CLIENT_COMPLETE may be emitted
      multiple times (or not at all) for a given connectable (in
      particular, if @client ends up attempting to connect to more than
      one address). However, if @client emits the #GSocketClient::event
      signal at all for a given connectable, then it will always emit
      it with %G_SOCKET_CLIENT_COMPLETE when it is done.

      Note that there may be additional #GSocketClientEvent values in
      the future; unrecognized @event values should be ignored.
      Parameters:
      event - the event that is occurring
      connectable - the #GSocketConnectable that @event is occurring on
      connection - the current representation of the connection