dxFeed Graal Native SDK 3.16.0-rc1
Loading...
Searching...
No Matches
dxfg_v4_message_connector.h File Reference

The message connectors of an endpoint: their state, addresses and statistics (see the group Message connectors (v4)). More...

#include "dxfg_v4_common.h"
#include "dxfg_v4_endpoint.h"
#include "dxfg_v4_javac.h"

Go to the source code of this file.

Data Structures

struct  dxfg_v4_message_connector_t
 The handle of a message connector (dxfg_v4_DXEndpoint_getConnectors()). More...
struct  dxfg_v4_message_connector_list
 A list of message connectors (dxfg_v4_DXEndpoint_getConnectors()). More...
struct  dxfg_v4_message_connector_stats_t
 The statistics of a message connector (dxfg_v4_MessageConnector_getStatistics()). More...
struct  dxfg_v4_message_connector_listener_t
 The handle of a listener of the state changes of the message connectors of an endpoint (dxfg_v4_MessageConnectorListener_new()). More...
struct  dxfg_v4_connection_error_t
 A connection error of a message connector (dxfg_v4_MessageConnector_getLastError(), dxfg_v4_DXEndpoint_getLastConnectionError()). More...

Macros

#define DXFG_V4_MESSAGE_CONNECTOR_KIND_CLIENT_SOCKET   ((int32_t)0)
 The kind of a message connector: a client socket connector (an address host:port).
#define DXFG_V4_MESSAGE_CONNECTOR_KIND_SERVER_SOCKET   ((int32_t)1)
 The kind of a message connector: a server socket connector (an address :port).
#define DXFG_V4_MESSAGE_CONNECTOR_KIND_OTHER   ((int32_t)2)
 The kind of a message connector: any other connector (a file, a non-blocking or a custom connector).
#define DXFG_V4_MESSAGE_CONNECTOR_STATE_CONNECTING   ((int32_t)0)
 The state of a message connector: started, not connected yet, or reconnecting after a failure or a drop.
#define DXFG_V4_MESSAGE_CONNECTOR_STATE_CONNECTED   ((int32_t)1)
 The state of a message connector: at least one of its connections is established (a server socket connector: it accepts connections).
#define DXFG_V4_MESSAGE_CONNECTOR_STATE_DISCONNECTED   ((int32_t)2)
 The state of a message connector: stopped, e.g. replaced by a connect to another address, or its endpoint disconnected or closed.
#define DXFG_V4_CONNECTION_ERROR_OTHER   ((int32_t)0)
 The category of a connection error: none of the others (e.g. an error of the protocol or of the authentication).
#define DXFG_V4_CONNECTION_ERROR_DNS   ((int32_t)1)
 The category of a connection error: the host name of the address is not resolved (Java: java.net.UnknownHostException).
#define DXFG_V4_CONNECTION_ERROR_CONNECT_FAILED   ((int32_t)2)
 The category of a connection error: the connect failed, refused or timed out; QD reports both with one exception type (Java: java.net.ConnectException, NoRouteToHostException, PortUnreachableException).
#define DXFG_V4_CONNECTION_ERROR_READ_TIMEOUT   ((int32_t)3)
 The category of a connection error: a read of an established connection timed out (Java: java.net.SocketTimeoutException).
#define DXFG_V4_CONNECTION_ERROR_HEARTBEAT_TIMEOUT   ((int32_t)4)
 The category of a connection error: the remote side sent no data and no heartbeat within the heartbeat timeout (the address option [heartbeatTimeout=...]), so QD closed the connection; the error has no exception.
#define DXFG_V4_CONNECTION_ERROR_CLOSED_BY_REMOTE   ((int32_t)5)
 The category of a connection error: the remote side closed the connection (Java: java.io.EOFException).
#define DXFG_V4_CONNECTION_ERROR_TLS   ((int32_t)6)
 The category of a connection error: the TLS handshake or a TLS record failed, e.g. a tls+ address of a port without TLS or a certificate that is not trusted (Java: javax.net.ssl.SSLException).
#define DXFG_V4_CONNECTION_ERROR_IO   ((int32_t)7)
 The category of a connection error: another I/O error, e.g. a connection reset (Java: java.io.IOException).

Typedefs

typedef struct dxfg_v4_message_connector_t dxfg_v4_message_connector_t
 The handle of a message connector (dxfg_v4_DXEndpoint_getConnectors()).
typedef struct dxfg_v4_message_connector_list dxfg_v4_message_connector_list
 A list of message connectors (dxfg_v4_DXEndpoint_getConnectors()).
typedef struct dxfg_v4_message_connector_stats_t dxfg_v4_message_connector_stats_t
 The statistics of a message connector (dxfg_v4_MessageConnector_getStatistics()).
typedef struct dxfg_v4_message_connector_listener_t dxfg_v4_message_connector_listener_t
 The handle of a listener of the state changes of the message connectors of an endpoint (dxfg_v4_MessageConnectorListener_new()).
typedef void(*) dxfg_v4_message_connector_listener_func(graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, void *user_data)
 The function of a listener of the state changes of the message connectors of an endpoint (dxfg_v4_MessageConnectorListener_new()).
typedef struct dxfg_v4_connection_error_t dxfg_v4_connection_error_t
 A connection error of a message connector (dxfg_v4_MessageConnector_getLastError(), dxfg_v4_DXEndpoint_getLastConnectionError()).

Functions

int32_t dxfg_v4_DXEndpoint_getConnectors (graal_isolatethread_t *thread, dxfg_v4_endpoint_t *endpoint, DXFG_OUT dxfg_v4_message_connector_list **connectors)
 Returns the current message connectors of an endpoint.
int32_t dxfg_v4_message_connector_list_release (graal_isolatethread_t *thread, dxfg_v4_message_connector_list *connectors)
 Releases a list of message connectors: every connector handle of the list, its array of elements and the list itself.
int32_t dxfg_v4_MessageConnector_getName (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT const char **name)
 Returns the name of a message connector, as in QD's log and JMX (e.g. ClientSocket-Distributor).
int32_t dxfg_v4_MessageConnector_getKind (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT int32_t *kind)
 Returns the kind of a message connector.
int32_t dxfg_v4_MessageConnector_getAddress (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT const char **address)
 Returns the address a message connector was configured with (e.g. 127.0.0.1:7300), the user and the password masked as in QD's log.
int32_t dxfg_v4_MessageConnector_getCurrentAddresses (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT dxfg_v4_string_list **addresses)
 Returns the host:port addresses a client socket connector is connected to now, one per connected connection (a striped connector has several).
int32_t dxfg_v4_MessageConnector_getState (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT int32_t *state)
 Returns the state of a message connector.
int32_t dxfg_v4_MessageConnector_isActive (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT int32_t *active)
 Checks whether a message connector is started (it connects or reconnects), as opposed to stopped.
int32_t dxfg_v4_MessageConnector_getConnectionCount (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT int32_t *count)
 Returns the number of the open connections of a message connector: those of a client socket connector (more than one for a striped connector) or those that a server socket connector accepted.
int32_t dxfg_v4_MessageConnector_getClosedConnectionCount (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT int64_t *count)
 Returns the number of the connections of a message connector closed since it was created: it grows on each drop and on each reconnect.
int32_t dxfg_v4_MessageConnector_getStatistics (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT dxfg_v4_message_connector_stats_t *stats)
 Reads the statistics of a message connector: the bytes and data records read and written, the open and the closed connections.
int32_t dxfg_v4_MessageConnectorListener_new (graal_isolatethread_t *thread, dxfg_v4_message_connector_listener_func user_func, void *user_data, DXFG_OUT dxfg_v4_message_connector_listener_t **listener)
 Creates a new listener of the state changes of the message connectors of an endpoint.
int32_t dxfg_v4_DXEndpoint_addMessageConnectorListener (graal_isolatethread_t *thread, dxfg_v4_endpoint_t *endpoint, dxfg_v4_message_connector_listener_t *listener)
 Adds a listener of the state changes of the message connectors to an endpoint.
int32_t dxfg_v4_DXEndpoint_removeMessageConnectorListener (graal_isolatethread_t *thread, dxfg_v4_endpoint_t *endpoint, dxfg_v4_message_connector_listener_t *listener)
 Removes a listener of the state changes of the message connectors from an endpoint.
int32_t dxfg_v4_MessageConnector_getLastError (graal_isolatethread_t *thread, dxfg_v4_message_connector_t *connector, DXFG_OUT dxfg_v4_connection_error_t **error)
 Returns the last connection error of a message connector: the newest failed connect or dropped connection.
int32_t dxfg_v4_DXEndpoint_getLastConnectionError (graal_isolatethread_t *thread, dxfg_v4_endpoint_t *endpoint, DXFG_OUT dxfg_v4_connection_error_t **error)
 Returns the last connection error of an endpoint: the newest error of all its connectors.
int32_t dxfg_v4_ConnectionError_release (graal_isolatethread_t *thread, dxfg_v4_connection_error_t *error)
 Releases a connection error and its strings.

Detailed Description

The message connectors of an endpoint: their state, addresses and statistics (see the group Message connectors (v4)).