ConnectionReader

from panda3d.net import ConnectionReader
class ConnectionReader

Bases: DTOOL_SUPER_BASE

This is an abstract base class for a family of classes that listen for activity on a socket and respond to it, for instance by reading a datagram and serving it (or queueing it up for later service).

A ConnectionReader may define an arbitrary number of threads (at least one) to process datagrams coming in from an arbitrary number of sockets that it is monitoring. The number of threads is specified at construction time and cannot be changed, but the set of sockets that is to be monitored may be constantly modified at will.

This is an abstract class because it doesn’t define how to process each received datagram. See QueuedConnectionReader. Also note that ConnectionListener derives from this class, extending it to accept connections on a rendezvous socket rather than read datagrams.

Inheritance diagram

Inheritance diagram of ConnectionReader

__init__(*args, **kwargs)
addConnection()

C++ Interface: add_connection(const ConnectionReader self, Connection connection)

/**

  • 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.

*/

add_connection()

C++ Interface: add_connection(const ConnectionReader self, Connection connection)

/**

  • 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.

*/

getManager()

C++ Interface: get_manager(ConnectionReader self)

/**

  • Returns a pointer to the ConnectionManager object that serves this

  • ConnectionReader.

*/

getNumThreads()

C++ Interface: get_num_threads(ConnectionReader self)

/**

  • Returns the number of threads the ConnectionReader has been created with.

*/

getRawMode()

C++ Interface: get_raw_mode(ConnectionReader self)

/**

  • Returns the current setting of the raw mode flag. See set_raw_mode().

*/

getTcpHeaderSize()

C++ Interface: get_tcp_header_size(ConnectionReader self)

/**

  • Returns the current setting of TCP header size. See set_tcp_header_size().

*/

get_manager()

C++ Interface: get_manager(ConnectionReader self)

/**

  • Returns a pointer to the ConnectionManager object that serves this

  • ConnectionReader.

*/

get_num_threads()

C++ Interface: get_num_threads(ConnectionReader self)

/**

  • Returns the number of threads the ConnectionReader has been created with.

*/

get_raw_mode()

C++ Interface: get_raw_mode(ConnectionReader self)

/**

  • Returns the current setting of the raw mode flag. See set_raw_mode().

*/

get_tcp_header_size()

C++ Interface: get_tcp_header_size(ConnectionReader self)

/**

  • Returns the current setting of TCP header size. See set_tcp_header_size().

*/

isConnectionOk()

C++ Interface: is_connection_ok(const ConnectionReader self, 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. (If there

  • was an error condition, normally the ConnectionManager would have been

  • informed and closed the connection.)

*/

isPolling()

C++ Interface: is_polling(ConnectionReader self)

/**

  • Returns true if the reader is a polling reader, i.e. it has no threads.

*/

is_connection_ok()

C++ Interface: is_connection_ok(const ConnectionReader self, 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. (If there

  • was an error condition, normally the ConnectionManager would have been

  • informed and closed the connection.)

*/

is_polling()

C++ Interface: is_polling(ConnectionReader self)

/**

  • Returns true if the reader is a polling reader, i.e. it has no threads.

*/

poll()

C++ Interface: poll(const ConnectionReader self)

/**

  • 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.

*/

removeConnection()

C++ Interface: remove_connection(const ConnectionReader self, Connection connection)

/**

  • 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.

*/

remove_connection()

C++ Interface: remove_connection(const ConnectionReader self, Connection connection)

/**

  • 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.

*/

setRawMode()

C++ Interface: set_raw_mode(const ConnectionReader self, bool mode)

/**

  • 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()

C++ Interface: set_tcp_header_size(const ConnectionReader self, int tcp_header_size)

/**

  • 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.

*/

set_raw_mode()

C++ Interface: set_raw_mode(const ConnectionReader self, bool mode)

/**

  • 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.

*/

set_tcp_header_size()

C++ Interface: set_tcp_header_size(const ConnectionReader self, int tcp_header_size)

/**

  • 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()

C++ Interface: shutdown(const ConnectionReader self)

/**

  • Terminates all threads cleanly. Normally this is only called by the

  • destructor, but it may be called explicitly before destruction.

*/