t.w.s.Site(http.HTTPFactory) : class documentation

Part of twisted.web.server View Source View In Hierarchy

A web site: manage log, sessions, and resources.

Instance Variable	counter	increment value used for generating unique sessions ID.
Instance Variable	requestFactory	factory creating requests objects. Default to `Request`.
Instance Variable	displayTracebacks	if set, Twisted internal errors are displayed on rendered pages. Default to `True`.
Instance Variable	sessionFactory	factory for sessions objects. Default to `Session`.
Instance Variable	sessionCheckTime	Deprecated. See `Session.sessionTimeout` instead.
Method	__init__	No summary
Method	__getstate__	Undocumented
Method	makeSession	Generate a new Session instance, and store it for future reference.
Method	getSession	Get a previously generated session, by its unique ID. This raises a KeyError if the session is not found.
Method	buildProtocol	Generate a channel attached to this site.
Method	render	Redirect because a Site is always a directory.
Method	getChildWithDefault	Emulate a resource's getChild method.
Method	getResourceFor	Get a resource for a request.
Method	_openLogFile	Override in subclasses, e.g. to use `twisted.python.logfile`.
Method	_mkuid	(internal) Generate an opaque, unique ID for a user's session.

Inherited from HTTPFactory:

Method	startFactory	Set up request logging if necessary.
Method	stopFactory	This will be called before I stop listening on all Ports/Connectors.
Method	log	Write a line representing `request` to the access log file.
Instance Variable	_logDateTime	A cached datetime string for log messages, updated by `_logDateTimeCall`. (type: `str`)
Instance Variable	_logDateTimeCall	A delayed call for the next update to the cached log datetime string. (type: `IDelayedCall` provided)
Instance Variable	_logFormatter	See the `logFormatter` parameter to `__init__`
Instance Variable	_nativeize	A flag that indicates whether the log file being written to wants native strings (`True`) or bytes (`False`). This is only to support writing to `twisted.python.log` which, unfortunately, works with native strings.
Instance Variable	_reactor	An `IReactorTime` provider used to compute logging timestamps.
Method	_updateLogDateTime	Update log datetime periodically, so we aren't always recalculating it.

Inherited from Factory (via HTTPFactory, ServerFactory):

Class Method	forProtocol	Create a factory for the given protocol.
Method	logPrefix	Describe this factory for log messages.
Method	doStart	Make sure startFactory is called.
Method	doStop	Make sure stopFactory is called.

counter =

increment value used for generating unique sessions ID.

requestFactory =

factory creating requests objects. Default to Request.

displayTracebacks =

if set, Twisted internal errors are displayed on rendered pages. Default to True.

sessionFactory =

factory for sessions objects. Default to Session.

sessionCheckTime =

Deprecated. See Session.sessionTimeout instead.

def __init__(self, resource, *args, **kwargs): (source)

overrides twisted.web.http.HTTPFactory.__init__

Parameters	resource	The root of the resource hierarchy. All request traversal for requests received by this factory will begin at this resource. (type: `IResource` provider)
See Also	`twisted.web.http.HTTPFactory.__init__`

def _openLogFile(self, path): (source)

overrides twisted.web.http.HTTPFactory._openLogFile

Override in subclasses, e.g. to use twisted.python.logfile.

def __getstate__(self): (source)

Undocumented

def _mkuid(self): (source)

(internal) Generate an opaque, unique ID for a user's session.

def makeSession(self): (source)

Generate a new Session instance, and store it for future reference.

def getSession(self, uid): (source)

Get a previously generated session, by its unique ID. This raises a KeyError if the session is not found.

def buildProtocol(self, addr): (source)

overrides twisted.web.http.HTTPFactory.buildProtocol

Generate a channel attached to this site.

def render(self, request): (source)

Redirect because a Site is always a directory.

def getChildWithDefault(self, pathEl, request): (source)

Emulate a resource's getChild method.

def getResourceFor(self, request): (source)

Get a resource for a request.

This iterates through the resource heirarchy, calling getChildWithDefault on each resource it finds for a path element, stopping when it hits an element where isLeaf is true.

API Documentation for Twisted, generated by pydoctor at 2015-01-30 14:14:53.