SocketConnection

SocketConnection

Object Hierarchy:

Description:

public class SocketConnection : IOStream

SocketConnection is a IOStream for a connected socket.

They can be created either by SocketClient when connecting to a host, or by SocketListener when accepting a new client.

The type of the SocketConnection object returned from these calls depends on the type of the underlying socket that is in use. For instance, for a TCP/IP connection it will be a TcpConnection.

Choosing what type of object to construct is done with the socket connection factory, and it is possible for 3rd parties to register custom socket connection types for specific combination of socket family/type/protocol using factory_register_type.

To close a SocketConnection, use close. Closing both substreams of the IOStream separately will not close the underlying Socket.

All known sub-classes:

TcpConnection

TcpWrapperConnection

Namespace: GLib

Package: gio-2.0

Content:

Properties:

public Socket socket { construct; get; }

Static methods:

public static SocketConnection factory_create_connection (Socket socket)
Creates a SocketConnection subclass of the right type for this.
public static Type factory_lookup_type (SocketFamily family, SocketType type, int protocol_id)
Looks up the Type to be used when creating socket connections on sockets with the specified family, type and protocol_id.
public static void factory_register_type (Type g_type, SocketFamily family, SocketType type, int protocol)
Looks up the Type to be used when creating socket connections on sockets with the specified family, type and protocol.

Creation methods:

protected SocketConnection ()

Methods:

public bool connect (SocketAddress address, Cancellable? cancellable = null) throws Error
Connect this to the specified remote address.
public async bool connect_async (SocketAddress address, Cancellable? cancellable = null) throws Error
Asynchronously connect this to the specified remote address.
public SocketAddress get_local_address () throws Error
Try to get the local address of a socket connection.
public SocketAddress get_remote_address () throws Error
Try to get the remote address of a socket connection.
public weak Socket get_socket ()
Gets the underlying Socket object of the connection.
public bool is_connected ()
Checks if this is connected.

Inherited Members:

All known members inherited from class GLib.IOStream

All known members inherited from class GLib.Object