Helper function to use eet over a network link

---

Function that reconstruct and prepare packet of Eet Data Serialization to be send.

Functions
Eet_Connection *	eet_connection_new (Eet_Read_Cb *eet_read_cb, Eet_Write_Cb *eet_write_cb, const void *user_data)
	Instanciates a new connection to track.
int	eet_connection_received (Eet_Connection *conn, const void *data, size_t size)
	Processes a raw packet received over the link.
Eina_Bool	eet_connection_empty (Eet_Connection *conn)
	Tells if the Eet_Connection as received some partial data.
Eina_Bool	eet_connection_send (Eet_Connection *conn, Eet_Data_Descriptor *edd, const void *data_in, const char *cipher_key)
	Converts a complex structure and prepare it to be send.
Eina_Bool	eet_connection_node_send (Eet_Connection *conn, Eet_Node *node, const char *cipher_key)
	Converts a Eet_Node tree and prepare it to be send.
void *	eet_connection_close (Eet_Connection *conn, Eina_Bool *on_going)
	Closes a connection and lost its track.
Typedefs
typedef struct _Eet_Connection	Eet_Connection
typedef Eina_Bool	Eet_Read_Cb (const void *eet_data, size_t size, void *user_data)
typedef Eina_Bool	Eet_Write_Cb (const void *data, size_t size, void *user_data)

---

Typedef Documentation

Eet_Connection

Opaque handle to track paquet for a specific connection.

Eet_Read_Cb

Called back when an Eet Data Serialization has been received completely and could be used.

Eet_Write_Cb

Called back when a packet containing Eet Data Serialization data is ready to be send.

---

Function Documentation

void* eet_connection_close	(	Eet_Connection *	conn,
		Eina_Bool *	on_going
	)

Closes a connection and lost its track.

Parameters:

conn	Connection handler to close.
on_going	Signal if a partial packet wasn't completed.

Returns:

the user_data passed to both callback.

Since (EFL) :

1.2.4

Since :

3.0

Eina_Bool eet_connection_empty

(

Eet_Connection *

conn

)

Tells if the Eet_Connection as received some partial data.

Parameters:

conn	Connection handler to request.

Returns:

EINA_TRUE if there is some data pending inside, EINA_FALSE otherwise.

Eet_Connection buffer data until the received data can be unserialized correctly. This function let you know if there is some data inside that buffer waiting for more data to be received before being processed.

Since (EFL) :

1.7

Since :

3.0

Eet_Connection* eet_connection_new	(	Eet_Read_Cb *	eet_read_cb,
		Eet_Write_Cb *	eet_write_cb,
		const void *	user_data
	)

Instanciates a new connection to track.

Parameters:

eet_read_cb	Function to call when one Eet_Data packet has been fully assemble.
eet_write_cb	Function to call when one Eet_Data packet is ready to be send over the wire.
user_data	Pointer provided to both functions to be used as a context handler.

Returns:

NULL on failure, or a valid Eet_Connection handler.

For every connection to track you will need a separate Eet_Connection provider.

Since (EFL) :

1.2.4

Since :

3.0

Eina_Bool eet_connection_node_send	(	Eet_Connection *	conn,
		Eet_Node *	node,
		const char *	cipher_key
	)

Converts a Eet_Node tree and prepare it to be send.

Parameters:

conn	Connection handler to track.
node	The data tree to use when encoding.
cipher_key	The key to use as cipher.

Returns:

EINA_TRUE if the data where correctly send, EINA_FALSE if they don't.

This function serialize node, assemble the packet and call Eet_Write_Cb when ready. The data passed Eet_Write_Cb are temporary allocated and will vanish just after the return of the callback.

See also:

eet_data_node_encode_cipher

Since (EFL) :

1.2.4

Since :

3.0

int eet_connection_received	(	Eet_Connection *	conn,
		const void *	data,
		size_t	size
	)

Processes a raw packet received over the link.

Parameters:

conn	Connection handler to track.
data	Raw data packet.
size	The size of that packet.

Returns:

0 on complete success, any other value indicate where in the stream it got wrong (It could be before that packet).

Every time you receive a packet related to your connection, you should pass it to that function so that it could process and assemble packet has you receive it. It will automatically call Eet_Read_Cb when one is fully received.

Since (EFL) :

1.2.4

Since :

3.0

Eina_Bool eet_connection_send	(	Eet_Connection *	conn,
		Eet_Data_Descriptor *	edd,
		const void *	data_in,
		const char *	cipher_key
	)

Converts a complex structure and prepare it to be send.

Parameters:

conn	Connection handler to track.
edd	The data descriptor to use when encoding.
data_in	The pointer to the struct to encode into data.
cipher_key	The key to use as cipher.

Returns:

EINA_TRUE if the data where correctly send, EINA_FALSE if they don't.

This function serialize data_in with edd, assemble the packet and call Eet_Write_Cb when ready. The data passed Eet_Write_Cb are temporary allocated and will vanish just after the return of the callback.

See also:

eet_data_descriptor_encode_cipher

Since (EFL) :

1.2.4

Since :

3.0