twisted.internet.protocol.ReconnectingClientFactory : API documentation

Factory which auto-reconnects clients with an exponential back-off.

Note that clients should call my resetDelay method after they have connected successfully.

Instance Variables	maxDelay	Maximum number of seconds between connection attempts.
	initialDelay	Delay for the first reconnection attempt.
	factor	A multiplicitive factor by which the delay grows
	jitter	Percentage of randomness to introduce into the delay length to prevent stampeding.
	clock	The clock used to schedule reconnection. It's mainly useful to be parametrized in tests. If the factory is serialized, this attribute will not be serialized, and the default value (the reactor) will be restored when deserialized. (type: `IReactorTime` )
	maxRetries	Maximum number of consecutive unsuccessful connection attempts, after which no further connection attempts will be made. If this is not explicitly set, no maximum is applied.

Method	clientConnectionFailed	Called when a connection has failed to connect.
Method	clientConnectionLost	Called when an established connection is lost.
Method	retry	Have this connector connect again, after a suitable delay.
Method	stopTrying	Put a stop to any attempt to reconnect in progress.
Method	resetDelay	Call this method after a successful connection: it resets the delay and the retry counter.
Method	__getstate__	No summary

Inherited from ClientFactory:

Method

startedConnecting

Called when a connection has been started.

Inherited from Factory (via ClientFactory):

Method	doStart	Make sure startFactory is called.
Method	doStop	Make sure stopFactory is called.
Method	startFactory	This will be called before I begin listening on a Port or Connector.
Method	stopFactory	This will be called before I stop listening on all Ports/Connectors.
Method	buildProtocol	Create an instance of a subclass of Protocol.

def clientConnectionFailed(self, connector, reason): (source)

overrides twisted.internet.protocol.ClientFactory.clientConnectionFailed

Called when a connection has failed to connect.

It may be useful to call connector.connect() - this will reconnect.

Parameters reason (type: twisted.python.failure.Failure )

def clientConnectionLost(self, connector, unused_reason): (source)

overrides twisted.internet.protocol.ClientFactory.clientConnectionLost

Called when an established connection is lost.

It may be useful to call connector.connect() - this will reconnect.

Parameters reason (type: twisted.python.failure.Failure )

def __getstate__(self): (source)

Remove all of the state which is mutated by connection attempts and failures, returning just the state which describes how reconnections should be attempted. This will make the unserialized instance behave just as this one did when it was first instantiated.

t.i.p.ReconnectingClientFactory(ClientFactory) : class documentation