twisted.web.server.Request : API documentation

Known subclasses: twisted.web.distrib.Request

Implements interfaces: twisted.web.iweb.IRequest

An HTTP request.

Instance Variable	defaultContentType	A `bytes` giving the default Content-Type value to send in responses if no other value is set. `None` disables the default.
Method	__init__
Method	getStateToCopyFor	Gather state to send when I am serialized for a particular perspective.
Method	sibLink	Return the text that links to a sibling of the requested resource.
Method	childLink	Return the text that links to a child of the requested resource.
Method	process	Process a request.
Method	write	Write data to the transport (if not responding to a HEAD request).
Method	finish	Override `http.Request.finish` for possible encoding.
Method	render	Ask a resource to render itself.
Method	processingFailed	Finish this request with an indication that processing failed and possibly display a traceback.
Method	view_write	Remote version of write; same interface.
Method	view_finish	Remote version of finish; same interface.
Method	view_addCookie	Remote version of addCookie; same interface.
Method	view_setHeader	Remote version of setHeader; same interface.
Method	view_setLastModified	Remote version of setLastModified; same interface.
Method	view_setETag	Remote version of setETag; same interface.
Method	view_setResponseCode	Remote version of setResponseCode; same interface.
Method	view_registerProducer	Remote version of registerProducer; same interface. (requires a remote producer.)
Method	view_unregisterProducer	Undocumented
Method	session	No summary
Method	getSession	Check if there is a session cookie, and if not, create it.
Method	prePathURL	At any time during resource traversal or resource rendering, returns an absolute URL to the most nested resource which has yet been reached.
Method	URLPath
Method	rememberRootURL	Remember the currently-processed part of the URL for later recalling.
Method	getRootURL	Get a previously-remembered URL.
Instance Variable	_insecureSession	The `Session` object representing state that will be transmitted over plain-text HTTP.
Instance Variable	_secureSession	The `Session` object representing the state that will be transmitted only over HTTPS.
Method	_prePathURL	Undocumented
Method	_handleStar	Handle receiving a request whose path is '*'.

Inherited from Componentized:

Method	locateAdapterClass	Undocumented
Method	setAdapter	Cache a provider for the given interface, by adapting `self` using the given adapter class.
Method	addAdapter	Utility method that calls addComponent. I take an adapter class and instantiate it with myself as the first argument.
Method	setComponent	Cache a provider of the given interface.
Method	addComponent	Add a component to me, for all appropriate interfaces.
Method	unsetComponent	Remove my component specified by the given interface class.
Method	removeComponent	Remove the given component from me entirely, for all interfaces for which it has been registered.
Method	getComponent	Create or retrieve an adapter for the given interface.
Method	__conform__	Undocumented

Inherited from Componentized:

Method	locateAdapterClass	Undocumented
Method	setAdapter	Cache a provider for the given interface, by adapting `self` using the given adapter class.
Method	addAdapter	Utility method that calls addComponent. I take an adapter class and instantiate it with myself as the first argument.
Method	setComponent	Cache a provider of the given interface.
Method	addComponent	Add a component to me, for all appropriate interfaces.
Method	unsetComponent	Remove my component specified by the given interface class.
Method	removeComponent	Remove the given component from me entirely, for all interfaces for which it has been registered.
Method	getComponent	Create or retrieve an adapter for the given interface.
Method	__conform__	Undocumented

Inherited from Componentized:

Method	locateAdapterClass	Undocumented
Method	setAdapter	Cache a provider for the given interface, by adapting `self` using the given adapter class.
Method	addAdapter	Utility method that calls addComponent. I take an adapter class and instantiate it with myself as the first argument.
Method	setComponent	Cache a provider of the given interface.
Method	addComponent	Add a component to me, for all appropriate interfaces.
Method	unsetComponent	Remove my component specified by the given interface class.
Method	removeComponent	Remove the given component from me entirely, for all interfaces for which it has been registered.
Method	getComponent	Create or retrieve an adapter for the given interface.
Method	__conform__	Undocumented

Inherited from Componentized:

Method	locateAdapterClass	Undocumented
Method	setAdapter	Cache a provider for the given interface, by adapting `self` using the given adapter class.
Method	addAdapter	Utility method that calls addComponent. I take an adapter class and instantiate it with myself as the first argument.
Method	setComponent	Cache a provider of the given interface.
Method	addComponent	Add a component to me, for all appropriate interfaces.
Method	unsetComponent	Remove my component specified by the given interface class.
Method	removeComponent	Remove the given component from me entirely, for all interfaces for which it has been registered.
Method	getComponent	Create or retrieve an adapter for the given interface.
Method	__conform__	Undocumented

Inherited from Componentized:

Method	locateAdapterClass	Undocumented
Method	setAdapter	Cache a provider for the given interface, by adapting `self` using the given adapter class.
Method	addAdapter	Utility method that calls addComponent. I take an adapter class and instantiate it with myself as the first argument.
Method	setComponent	Cache a provider of the given interface.
Method	addComponent	Add a component to me, for all appropriate interfaces.
Method	unsetComponent	Remove my component specified by the given interface class.
Method	removeComponent	Remove the given component from me entirely, for all interfaces for which it has been registered.
Method	getComponent	Create or retrieve an adapter for the given interface.
Method	__conform__	Undocumented

defaultContentType =

A bytes giving the default Content-Type value to send in responses if no other value is set. None disables the default.

_insecureSession =

The Session object representing state that will be transmitted over plain-text HTTP.

_secureSession =

The Session object representing the state that will be transmitted only over HTTPS.

def __init__(self, *args, **kw): (source)

overrides twisted.web.http.Request.__init__

Parameters	channel	the channel we're connected to.
	queued	(deprecated) are we in the request queue, or can we start writing to the transport?

def getStateToCopyFor(self, issuer): (source)

overrides twisted.spread.pb.Copyable.getStateToCopyFor

Gather state to send when I am serialized for a particular perspective.

I will default to calling getStateToCopy. Override this to customize this behavior.

def sibLink(self, name): (source)

Return the text that links to a sibling of the requested resource.

Parameters	name	The sibling resource (type: `bytes`)
Returns	A relative URL. (type: `bytes`)

def childLink(self, name): (source)

Return the text that links to a child of the requested resource.

Parameters	name	The child resource (type: `bytes`)
Returns	A relative URL. (type: `bytes`)

def process(self): (source)

overrides twisted.web.http.Request.process

Process a request.

Find the addressed resource in this request's Site, and call self.render() with it.

See Also Site.getResourceFor()

def write(self, data): (source)

from twisted.web.iweb.IRequest

overrides twisted.web.http.Request.write

overridden in twisted.web.distrib.Request

Write data to the transport (if not responding to a HEAD request).

Parameters data A string to write to the response. (type: bytes)

def finish(self): (source)

from twisted.web.iweb.IRequest

overrides twisted.web.http.Request.finish

Override http.Request.finish for possible encoding.

def render(self, resrc): (source)

Ask a resource to render itself.

If the resource does not support the requested method, generate a NOT IMPLEMENTED or NOT ALLOWED response.

Parameters	resrc	The resource to render. (type: `twisted.web.resource.IResource`)
See Also	`IResource.render()`

def processingFailed(self, reason): (source)

Finish this request with an indication that processing failed and possibly display a traceback.

Parameters	reason	Reason this request has failed. (type: `twisted.python.failure.Failure`)
Returns	The reason passed to this method. (type: `twisted.python.failure.Failure`)

def view_write(self, issuer, data): (source)

Remote version of write; same interface.

def view_finish(self, issuer): (source)

Remote version of finish; same interface.

def view_addCookie(self, issuer, k, v, **kwargs): (source)

Remote version of addCookie; same interface.

def view_setHeader(self, issuer, k, v): (source)

Remote version of setHeader; same interface.

def view_setLastModified(self, issuer, when): (source)

Remote version of setLastModified; same interface.

def view_setETag(self, issuer, tag): (source)

Remote version of setETag; same interface.

def view_setResponseCode(self, issuer, code, message=None): (source)

Remote version of setResponseCode; same interface.

def view_registerProducer(self, issuer, producer, streaming): (source)

Remote version of registerProducer; same interface. (requires a remote producer.)

def view_unregisterProducer(self, issuer): (source)

Undocumented

@property
def session(self): (source)

If a session has already been created or looked up with Request.getSession, this will return that object. (This will always be the session that matches the security of the request; so if forceNotSecure is used on a secure request, this will not return that session.)

Returns the session attribute (type: Session or None)

def getSession(self, sessionInterface=None, forceNotSecure=False): (source)

from twisted.web.iweb.IRequest

Check if there is a session cookie, and if not, create it.

By default, the cookie with be secure for HTTPS requests and not secure for HTTP requests. If for some reason you need access to the insecure cookie from a secure request you can set forceNotSecure = True.

Parameters forceNotSecure Should we retrieve a session that will be transmitted over HTTP, even if this Request was delivered over HTTPS? (type: bool)

def _prePathURL(self, prepath): (source)

Undocumented

def prePathURL(self): (source)

from twisted.web.iweb.IRequest

At any time during resource traversal or resource rendering, returns an absolute URL to the most nested resource which has yet been reached.

Returns	An absolute URL.
See Also	{twisted.web.server.Request.prepath}

def URLPath(self): (source)

from twisted.web.iweb.IRequest

Returns A URLPath instance which identifies the URL for which this request is.

def rememberRootURL(self): (source)

from twisted.web.iweb.IRequest

Remember the currently-processed part of the URL for later recalling.

def getRootURL(self): (source)

from twisted.web.iweb.IRequest

Get a previously-remembered URL.

Returns An absolute URL. (type: bytes)

def _handleStar(self): (source)

Handle receiving a request whose path is '*'.

RFC 7231 defines an OPTIONS * request as being something that a client can send as a low-effort way to probe server capabilities or readiness. Rather than bother the user with this, we simply fast-path it back to an empty 200 OK. Any non-OPTIONS verb gets a 405 Method Not Allowed telling the client they can only use OPTIONS.

API Documentation for Twisted, generated by pydoctor at 2019-08-06 12:10:50.

twisted.web.server.Request(Copyable, http.Request, components.Componentized) class documentation

`twisted.web.server.Request(Copyable, http.Request, components.Componentized)` class documentation