Panda3D
|
This flavor of ConnectionListener will queue up all of the TCP connections it established for later detection by the client code. More...
Public Member Functions | |
QueuedConnectionListener (ConnectionManager manager, int num_threads) | |
bool | addConnection (Connection connection) |
Adds a new socket to the list of sockets the ConnectionReader will monitor. | |
int | getCurrentQueueSize () |
ConnectionManager | getManager () |
Returns a pointer to the ConnectionManager object that serves this ConnectionReader. | |
int | getMaxQueueSize () |
bool | getNewConnection (PointerToConnection rendezvous, NetAddress address, PointerToConnection new_connection) |
If a previous call to new_connection_available() returned true, this function will return information about the newly established connection. | |
bool | getNewConnection (PointerToConnection new_connection) |
This flavor of get_new_connection() simply returns a new connection, assuming the user doesn't care about the rendezvous socket that originated it or the address it came from. | |
int | getNumThreads () |
Returns the number of threads the ConnectionReader has been created with. | |
bool | getOverflowFlag () |
bool | getRawMode () |
Returns the current setting of the raw mode flag. | |
int | getTcpHeaderSize () |
Returns the current setting of TCP header size. | |
bool | isConnectionOk (Connection connection) |
Returns true if the indicated connection has been added to the ConnectionReader and is being monitored properly, false if it is not known, or if there was some error condition detected on the connection. | |
bool | isPolling () |
Returns true if the reader is a polling reader, i.e. | |
bool | newConnectionAvailable () |
Returns true if a new connection was recently established; the connection information may then be retrieved via get_new_connection(). | |
poll () | |
Explicitly polls the available sockets to see if any of them have any noise. | |
bool | removeConnection (Connection connection) |
Removes a socket from the list of sockets being monitored. | |
resetOverflowFlag () | |
setMaxQueueSize (int max_size) | |
setRawMode (bool mode) | |
Sets the ConnectionReader into raw mode (or turns off raw mode). | |
setTcpHeaderSize (int tcp_header_size) | |
Sets the header size of TCP packets. | |
shutdown () | |
Terminates all threads cleanly. |
This flavor of ConnectionListener will queue up all of the TCP connections it established for later detection by the client code.
QueuedConnectionListener | ( | ConnectionManager | manager, |
int | num_threads | ||
) |
bool addConnection | ( | Connection | connection | ) | [inherited] |
Adds a new socket to the list of sockets the ConnectionReader will monitor.
A datagram that comes in on any of the monitored sockets will be reported. In the case of a ConnectionListener, this adds a new rendezvous socket; any activity on any of the monitored sockets will cause a connection to be accepted.
The return value is true if the connection was added, false if it was already there.
add_connection() is thread-safe, and may be called at will by any thread.
int getCurrentQueueSize | ( | ) | [inherited] |
ConnectionManager getManager | ( | ) | [inherited] |
Returns a pointer to the ConnectionManager object that serves this ConnectionReader.
int getMaxQueueSize | ( | ) | [inherited] |
bool getNewConnection | ( | PointerToConnection | new_connection | ) |
This flavor of get_new_connection() simply returns a new connection, assuming the user doesn't care about the rendezvous socket that originated it or the address it came from.
bool getNewConnection | ( | PointerToConnection | rendezvous, |
NetAddress | address, | ||
PointerToConnection | new_connection | ||
) |
If a previous call to new_connection_available() returned true, this function will return information about the newly established connection.
The rendezvous parameter is the particular rendezvous socket this new connection originally communicated with; it is provided in case the ConnectionListener was monitorind more than one and you care which one it was. The address parameter is the net address of the new client, and new_connection is the socket of the newly established connection.
The return value is true if a connection was successfully returned, or false if there was, in fact, no new connection. (This may happen if there are multiple threads accessing the QueuedConnectionListener).
int getNumThreads | ( | ) | [inherited] |
Returns the number of threads the ConnectionReader has been created with.
bool getOverflowFlag | ( | ) | [inherited] |
bool getRawMode | ( | ) | [inherited] |
Returns the current setting of the raw mode flag.
See set_raw_mode().
int getTcpHeaderSize | ( | ) | [inherited] |
Returns the current setting of TCP header size.
See set_tcp_header_size().
bool isConnectionOk | ( | Connection | connection | ) | [inherited] |
Returns true if the indicated connection has been added to the ConnectionReader and is being monitored properly, false if it is not known, or if there was some error condition detected on the connection.
(If there was an error condition, normally the ConnectionManager would have been informed and closed the connection.)
bool isPolling | ( | ) | [inherited] |
Returns true if the reader is a polling reader, i.e.
it has no threads.
bool newConnectionAvailable | ( | ) |
Returns true if a new connection was recently established; the connection information may then be retrieved via get_new_connection().
poll | ( | ) | [inherited] |
Explicitly polls the available sockets to see if any of them have any noise.
This function does nothing unless this is a polling-type ConnectionReader, i.e. it was created with zero threads (and is_polling() will return true).
It is not necessary to call this explicitly for a QueuedConnectionReader.
bool removeConnection | ( | Connection | connection | ) | [inherited] |
Removes a socket from the list of sockets being monitored.
Returns true if the socket was correctly removed, false if it was not on the list in the first place.
remove_connection() is thread-safe, and may be called at will by any thread.
resetOverflowFlag | ( | ) | [inherited] |
setMaxQueueSize | ( | int | max_size | ) | [inherited] |
setRawMode | ( | bool | mode | ) | [inherited] |
Sets the ConnectionReader into raw mode (or turns off raw mode).
In raw mode, datagram headers are not expected; instead, all the data available on the pipe is treated as a single datagram.
This is similar to set_tcp_header_size(0), except that it also turns off headers for UDP packets.
setTcpHeaderSize | ( | int | tcp_header_size | ) | [inherited] |
Sets the header size of TCP packets.
At the present, legal values for this are 0, 2, or 4; this specifies the number of bytes to use encode the datagram length at the start of each TCP datagram. Sender and receiver must independently agree on this.
shutdown | ( | ) | [inherited] |
Terminates all threads cleanly.
Normally this is only called by the destructor, but it may be called explicitly before destruction.