Panda3D
|
This class provides datagrams one-at-a-time as read directly from the net, via a TCP connection. More...
#include "datagramGeneratorNet.h"
Public Member Functions | |
DatagramGeneratorNet (ConnectionManager *manager, int num_threads) | |
Creates a new DatagramGeneratorNet with the indicated number of threads to handle requests. | |
bool | add_connection (Connection *connection) |
Adds a new socket to the list of sockets the ConnectionReader will monitor. | |
int | get_current_queue_size () const |
virtual bool | get_datagram (Datagram &data) |
Reads the next datagram from the stream. | |
virtual VirtualFile * | get_file () |
Returns the VirtualFile that provides the source for these datagrams, if any, or NULL if the datagrams do not originate from a VirtualFile. | |
virtual streampos | get_file_pos () |
Returns the current file position within the data stream, if any, or 0 if the file position is not meaningful or cannot be determined. | |
ConnectionManager * | get_manager () const |
Returns a pointer to the ConnectionManager object that serves this ConnectionReader. | |
int | get_max_queue_size () const |
int | get_num_threads () const |
Returns the number of threads the ConnectionReader has been created with. | |
bool | get_overflow_flag () const |
bool | get_raw_mode () const |
Returns the current setting of the raw mode flag. | |
int | get_tcp_header_size () const |
Returns the current setting of TCP header size. | |
bool | is_connection_ok (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. | |
virtual bool | is_eof () |
Returns true if the stream has been closed normally. | |
virtual bool | is_error () |
Returns true if the stream has an error condition. | |
bool | is_polling () const |
Returns true if the reader is a polling reader, i.e. | |
void | poll () |
Explicitly polls the available sockets to see if any of them have any noise. | |
bool | remove_connection (Connection *connection) |
Removes a socket from the list of sockets being monitored. | |
void | reset_overflow_flag () |
void | set_max_queue_size (int max_size) |
void | set_raw_mode (bool mode) |
Sets the ConnectionReader into raw mode (or turns off raw mode). | |
void | set_tcp_header_size (int tcp_header_size) |
Sets the header size of TCP packets. | |
void | shutdown () |
Terminates all threads cleanly. | |
Protected Types | |
typedef pvector< SocketInfo * > | Sockets |
Protected Member Functions | |
void | clear_manager () |
This should normally only be called when the associated ConnectionManager destructs. | |
bool | enqueue_thing (const Datagram &thing) |
bool | enqueue_unique_thing (const Datagram &thing) |
void | finish_socket (SocketInfo *sinfo) |
To be called when a socket has been fully read and is ready for polling for additional data. | |
virtual void | flush_read_connection (Connection *connection) |
Attempts to read all the possible data from the indicated connection, which has just delivered a write error (and has therefore already been closed). | |
bool | get_thing (Datagram &thing) |
virtual bool | process_incoming_data (SocketInfo *sinfo) |
This is run within a thread when the call to select() indicates there is data available on a socket. | |
virtual bool | process_incoming_tcp_data (SocketInfo *sinfo) |
virtual bool | process_incoming_udp_data (SocketInfo *sinfo) |
virtual bool | process_raw_incoming_tcp_data (SocketInfo *sinfo) |
virtual bool | process_raw_incoming_udp_data (SocketInfo *sinfo) |
virtual void | receive_datagram (const NetDatagram &datagram) |
An internal function called by ConnectionReader() when a new datagram has become available. | |
bool | thing_available () const |
Protected Attributes | |
Mutex | _dg_lock |
ConditionVar | _dg_processed |
ConditionVar | _dg_received |
ConnectionManager * | _manager |
Sockets | _removed_sockets |
Sockets | _sockets |
LightMutex | _sockets_mutex |
This class provides datagrams one-at-a-time as read directly from the net, via a TCP connection.
If a datagram is not available, get_datagram() will block until one is.
Definition at line 35 of file datagramGeneratorNet.h.
DatagramGeneratorNet::DatagramGeneratorNet | ( | ConnectionManager * | manager, |
int | num_threads | ||
) |
Creates a new DatagramGeneratorNet with the indicated number of threads to handle requests.
Normally num_threads should be either 0 or 1 to guarantee that datagrams are generated in the same order in which they were received.
Definition at line 31 of file datagramGeneratorNet.cxx.
bool ConnectionReader::add_connection | ( | 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.
Definition at line 196 of file connectionReader.cxx.
Referenced by PStatServer::listen(), MayaToEggServer::poll(), and PStatReader::set_tcp_connection().
void ConnectionReader::clear_manager | ( | ) | [protected, inherited] |
This should normally only be called when the associated ConnectionManager destructs.
It resets the ConnectionManager pointer to NULL so we don't have a floating pointer. This makes the ConnectionReader invalid; presumably it also will be destructed momentarily.
Definition at line 471 of file connectionReader.cxx.
void ConnectionReader::finish_socket | ( | SocketInfo * | sinfo | ) | [protected, inherited] |
To be called when a socket has been fully read and is ready for polling for additional data.
Definition at line 482 of file connectionReader.cxx.
Referenced by ConnectionListener::process_incoming_data().
void ConnectionReader::flush_read_connection | ( | Connection * | connection | ) | [protected, virtual, inherited] |
Attempts to read all the possible data from the indicated connection, which has just delivered a write error (and has therefore already been closed).
If the connection is not monitered by this reader, does nothing.
Definition at line 431 of file connectionReader.cxx.
References Socket_fdset::clear(), ConnectionReader::process_incoming_data(), and ConnectionReader::remove_connection().
bool DatagramGeneratorNet::get_datagram | ( | Datagram & | data | ) | [virtual] |
Reads the next datagram from the stream.
Blocks until a datagram is available. Returns true on success, false on stream closed or error.
Implements DatagramGenerator.
Definition at line 55 of file datagramGeneratorNet.cxx.
References Thread::force_yield(), Datagram::get_length(), QueuedReturn< Datagram >::get_thing(), is_eof(), ConnectionReader::is_polling(), ConditionVarDirect::notify(), ConnectionReader::poll(), QueuedReturn< Datagram >::thing_available(), and ConditionVarDirect::wait().
VirtualFile * DatagramGenerator::get_file | ( | ) | [virtual, inherited] |
Returns the VirtualFile that provides the source for these datagrams, if any, or NULL if the datagrams do not originate from a VirtualFile.
Reimplemented in DatagramInputFile.
Definition at line 38 of file datagramGenerator.cxx.
Referenced by BamReader::get_file().
streampos DatagramGenerator::get_file_pos | ( | ) | [virtual, inherited] |
Returns the current file position within the data stream, if any, or 0 if the file position is not meaningful or cannot be determined.
For DatagramGenerators that return a meaningful file position, this will be pointing to the first byte following the datagram returned after a call to get_datagram().
Reimplemented in DatagramInputFile.
Definition at line 55 of file datagramGenerator.cxx.
Referenced by BamReader::get_file_pos().
ConnectionManager * ConnectionReader::get_manager | ( | ) | const [inherited] |
Returns a pointer to the ConnectionManager object that serves this ConnectionReader.
Definition at line 330 of file connectionReader.cxx.
int ConnectionReader::get_num_threads | ( | ) | const [inherited] |
Returns the number of threads the ConnectionReader has been created with.
Definition at line 341 of file connectionReader.cxx.
bool ConnectionReader::get_raw_mode | ( | ) | const [inherited] |
Returns the current setting of the raw mode flag.
See set_raw_mode().
Definition at line 368 of file connectionReader.cxx.
int ConnectionReader::get_tcp_header_size | ( | ) | const [inherited] |
Returns the current setting of TCP header size.
Definition at line 393 of file connectionReader.cxx.
bool ConnectionReader::is_connection_ok | ( | 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.)
Definition at line 258 of file connectionReader.cxx.
bool DatagramGeneratorNet::is_eof | ( | ) | [virtual] |
Returns true if the stream has been closed normally.
This test may only be made after a call to get_datagram() has failed.
Implements DatagramGenerator.
Definition at line 119 of file datagramGeneratorNet.cxx.
Referenced by get_datagram().
bool DatagramGeneratorNet::is_error | ( | ) | [virtual] |
Returns true if the stream has an error condition.
Implements DatagramGenerator.
Definition at line 131 of file datagramGeneratorNet.cxx.
bool ConnectionReader::is_polling | ( | ) | const [inline, inherited] |
Returns true if the reader is a polling reader, i.e.
it has no threads.
Definition at line 23 of file connectionReader.I.
Referenced by get_datagram().
void ConnectionReader::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.
Definition at line 292 of file connectionReader.cxx.
References TrueClock::get_global_ptr(), and ConnectionReader::process_incoming_data().
Referenced by QueuedConnectionReader::data_available(), get_datagram(), QueuedConnectionListener::new_connection_available(), PStatServer::poll(), and MayaToEggServer::poll().
bool ConnectionReader::process_incoming_data | ( | SocketInfo * | sinfo | ) | [protected, virtual, inherited] |
This is run within a thread when the call to select() indicates there is data available on a socket.
Returns true if the data is read successfully, false on failure (for instance, because the connection is closed).
Reimplemented in ConnectionListener.
Definition at line 500 of file connectionReader.cxx.
Referenced by ConnectionReader::flush_read_connection(), and ConnectionReader::poll().
void DatagramGeneratorNet::receive_datagram | ( | const NetDatagram & | datagram | ) | [protected, virtual] |
An internal function called by ConnectionReader() when a new datagram has become available.
This call may be received in a sub-thread.
Implements ConnectionReader.
Definition at line 153 of file datagramGeneratorNet.cxx.
References QueuedReturn< Datagram >::enqueue_thing(), ConditionVarDirect::notify(), and ConditionVarDirect::wait().
bool ConnectionReader::remove_connection | ( | 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.
Definition at line 227 of file connectionReader.cxx.
Referenced by ConnectionReader::flush_read_connection().
void ConnectionReader::set_raw_mode | ( | 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.
Definition at line 357 of file connectionReader.cxx.
void ConnectionReader::set_tcp_header_size | ( | 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.
Definition at line 382 of file connectionReader.cxx.
void ConnectionReader::shutdown | ( | ) | [inherited] |
Terminates all threads cleanly.
Normally this is only called by the destructor, but it may be called explicitly before destruction.
Definition at line 405 of file connectionReader.cxx.