Eris 1.3.16
|
Underlying Atlas connection, providing a send interface, and receive (dispatch) system. More...
#include <BaseConnection.h>
Public Types | |
enum | Status { INVALID_STATUS = 0, NEGOTIATE, CONNECTING, CONNECTED, DISCONNECTED, DISCONNECTING, QUERY_GET } |
possible states for the connection More... | |
Public Member Functions | |
virtual | ~BaseConnection () |
destructor, will perform a hard disconnect if necessary | |
virtual int | connect (const std::string &host, short port) |
open a connection to the specified host/port; invokes the failure handler if the connection could not be opened. | |
Status | getStatus () const |
get the current status of the connection | |
bool | isConnected () const |
Ascertain whether or not the connection is usable for transport. | |
int | getFileDescriptor () |
get the underlyinmg file descriptor (socket). | |
Public Attributes | |
sigc::signal< void > | Connected |
sent on successful negotiation of a game server connection | |
sigc::signal< void > | Disconnected |
final disconnect (or hard disocnnect) notifcation | |
Protected Member Functions | |
BaseConnection (const std::string &cnm, const std::string &id, Atlas::Bridge *br) | |
create an unconnected instance | |
void | recv () |
perform a blocking read from the underlying socket | |
virtual void | setStatus (Status sc) |
update the connection status and generate signals | |
virtual void | onConnect () |
derived-class notification when connection and negotiation is completed | |
virtual void | handleFailure (const std::string &msg)=0 |
derived-class notification when a failure occurs | |
virtual void | handleTimeout (const std::string &msg)=0 |
void | onConnectTimeout () |
void | onNegotiateTimeout () |
void | hardDisconnect (bool emit) |
performs and instant disconnection from the server specified whether the change of state should be signalled | |
void | nonblockingConnect () |
complete the connection state and start negotiation | |
void | pollNegotiation () |
track negotation of the Atlas codecs / stream | |
Protected Attributes | |
Atlas::Objects::ObjectsEncoder * | _encode |
the objects encoder, bound to _codec | |
Atlas::Net::StreamConnect * | _sc |
negotiation object (NULL after connection!) | |
Atlas::Codec * | m_codec |
Status | _status |
current status of the connection | |
const std::string | _id |
a unique identifier for this connection | |
tcp_socket_stream * | _stream |
the underlying iostream channel | |
std::string | _clientName |
the client identified used during connection | |
Atlas::Bridge * | _bridge |
the connection bridge (i.e something implementing objectArrived()) : this can be the derived class itself, or any other object | |
Timeout * | _timeout |
network level timeouts | |
std::string | _host |
the host name we're connected to | |
short | _port |
the port we're connected to |
Underlying Atlas connection, providing a send interface, and receive (dispatch) system.
possible states for the connection
builddir build BUILD eris Eris BaseConnection cpp Eris::BaseConnection::BaseConnection | ( | const std::string & | cnm, |
const std::string & | id, | ||
Atlas::Bridge * | br | ||
) | [protected] |
create an unconnected instance
Create a new connection, with the client-name string specified. The client-name is sent during Atlas negotiation of the connection. Id is a unique string to identify timeouts created by the connection (and potentially errors in the future)
References _bridge.
int Eris::BaseConnection::connect | ( | const std::string & | host, |
short | port | ||
) | [virtual] |
open a connection to the specified host/port; invokes the failure handler if the connection could not be opened.
References _host, _port, _stream, _timeout, CONNECTING, Eris::Timeout::Expired, hardDisconnect(), and setStatus().
Referenced by Eris::Connection::Connection().
int Eris::BaseConnection::getFileDescriptor | ( | ) |
get the underlyinmg file descriptor (socket).
This is so GUI / widget libraries which steal the main-loop, but can monitor file-decriptors work. The obvious examples being Gtk+/-- and Qt
References _stream.