t.i.t.Connection(_TLSConnectionMixin, abstract.FileDescriptor, _SocketCloser, _AbortingMixin) : class documentation

Part of twisted.internet.tcp View Source View In Hierarchy

Known subclasses: twisted.internet.tcp.BaseClient, twisted.internet.tcp.Server

Superclass of all socket-based FileDescriptors.

This is an abstract superclass of all objects which represent a TCP/IP connection based socket.

Instance Variable logstr prefix used when logging events related to this connection. (type: str)
Method __init__
Method getHandle Return the socket for this connection.
Method doRead Calls self.protocol.dataReceived with all available data.
Method writeSomeData Write as much as possible of the given data to this TCP connection.
Method readConnectionLost Undocumented
Method connectionLost See abstract.FileDescriptor.connectionLost().
Method logPrefix Return the prefix to log with when I own the logging thread.
Method getTcpNoDelay Undocumented
Method setTcpNoDelay Undocumented
Method getTcpKeepAlive Undocumented
Method setTcpKeepAlive Undocumented
Method _dataReceived Undocumented
Method _closeWriteConnection Undocumented

Inherited from FileDescriptor:

Method doWrite Called when data can be written.
Method writeConnectionLost Undocumented
Method write Reliably write some data.
Method writeSequence Reliably write a sequence of data.
Method loseConnection Close the connection at the next available opportunity.
Method loseWriteConnection Undocumented
Method stopReading Stop waiting for read availability.
Method stopWriting Stop waiting for write availability.
Method startReading Start waiting for read availability.
Method startWriting Start waiting for write availability.
Method stopConsuming Stop consuming data.
Method resumeProducing Undocumented
Method pauseProducing Undocumented
Method stopProducing Undocumented
Method fileno File Descriptor number for select().
Method _postLoseConnection Called after a loseConnection(), when all data has been written.
Method _isSendBufferFull Determine whether the user-space send buffer for this transport is full or not.
Method _maybePauseProducer Possibly pause a producer, if there is one and the send buffer is full.

Inherited from _ConsumerMixin (via FileDescriptor):

Instance Variable producer None if no producer is registered, otherwise the registered producer.
Instance Variable producerPaused A flag indicating whether the producer is currently paused. (type: bool)
Instance Variable streamingProducer 0 A flag indicating whether the producer was registered as a streaming (ie push) producer or not (ie a pull producer). This will determine whether the consumer may ever need to pause and resume it, or if it can merely call resumeProducing on it when buffer space is available.
Instance Variable streamingProducer bool or int
Method registerProducer Register to receive data from a producer.
Method unregisterProducer Stop consuming data from a producer, without disconnecting.

Inherited from _LogOwner (via FileDescriptor):

Method _getLogPrefix Determine the log prefix to use for messages related to applicationObject, which may or may not be an interfaces.ILoggingContext provider.

Inherited from _SocketCloser:

Instance Variable _shouldShutdown Set to True if shutdown should be called before callling close on the underlying socket. (type: bool)
Method _closeSocket Undocumented

Inherited from _AbortingMixin:

Method abortConnection Aborts the connection immediately, dropping any buffered data.
Instance Variable _aborting Set to True when abortConnection is called. (type: bool)
logstr =
prefix used when logging events related to this connection. (type: str)
def __init__(self, skt, protocol, reactor=None): (source)
overrides twisted.internet.abstract.FileDescriptor.__init__
overridden in twisted.internet.ssl.Client, twisted.internet.tcp.Server, twisted.internet.unix.Client
ParametersreactorAn IReactorFDSet provider which this descriptor will use to get readable and writeable event notifications. If no value is given, the global reactor will be used.
def getHandle(self): (source)
Return the socket for this connection.
def doRead(self): (source)
overrides twisted.internet.abstract.FileDescriptor.doRead
Calls self.protocol.dataReceived with all available data.

This reads up to self.bufferSize bytes of data from its socket, then calls self.dataReceived(data) to process it. If the connection is not lost through an error in the physical recv(), this function will return the result of the dataReceived call.

def _dataReceived(self, data): (source)
Undocumented
def writeSomeData(self, data): (source)
overrides twisted.internet.abstract.FileDescriptor.writeSomeData
Write as much as possible of the given data to this TCP connection.

This sends up to self.SEND_LIMIT bytes from data. If the connection is lost, an exception is returned. Otherwise, the number of bytes successfully written is returned.

def _closeWriteConnection(self): (source)
overrides twisted.internet.abstract.FileDescriptor._closeWriteConnection
Undocumented
def readConnectionLost(self, reason): (source)
overrides twisted.internet.abstract.FileDescriptor.readConnectionLost
Undocumented
def connectionLost(self, reason): (source)
overrides twisted.internet.abstract.FileDescriptor.connectionLost
See abstract.FileDescriptor.connectionLost().
def logPrefix(self): (source)
overrides twisted.internet.abstract._LogOwner.logPrefix
Return the prefix to log with when I own the logging thread.
def getTcpNoDelay(self): (source)
Undocumented
def setTcpNoDelay(self, enabled): (source)
Undocumented
def getTcpKeepAlive(self): (source)
Undocumented
def setTcpKeepAlive(self, enabled): (source)
Undocumented
API Documentation for Twisted, generated by pydoctor at 2014-05-12 18:27:00.