t.w.s.Request(pb.Copyable, http.Request, components.Componentized) : class documentation

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

Known subclasses: twisted.web.distrib.Request

Implements interfaces: twisted.web.iweb.IRequest

An HTTP request.
Instance Variable defaultContentType A str 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 render Ask a resource to render itself.
Method processingFailed Undocumented
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 getSession Look up the session associated with this request or create a new one if there is not one.
Method prePathURL
Method URLPath
Method rememberRootURL Remember the currently-processed part of the URL for later recalling.
Method getRootURL Get a previously-remembered URL.
Method _prePathURL Undocumented

Inherited from Copyable:

Method getStateToCopy Gather state to send when I am serialized for a peer.
Method getTypeToCopy Determine what type tag to send for me.
Method getTypeToCopyFor Determine what type tag to send for me.
Method jellyFor Assemble type tag and state to copy for this broker.

Inherited from Serializable (via Copyable):

Method processUniqueID Return an ID which uniquely represents this object for this process.

Inherited from Jellyable (via Copyable, Serializable):

Method getStateFor Undocumented

Inherited from Request:

Instance Variable method The HTTP method that was used.
Instance Variable uri The full URI that was requested (includes arguments).
Instance Variable path The path only (arguments not included).
Instance Variable args All of the arguments, including URL and POST arguments. (type: A mapping of strings (the argument names) to lists of values. i.e., ?foo=bar&foo=baz&quux=spam results in {'foo': ['bar', 'baz'], 'quux': ['spam']}.)
Instance Variable requestHeaders All received HTTP request headers. (type: http_headers.Headers)
Instance Variable received_headers Backwards-compatibility access to requestHeaders. Use requestHeaders instead. received_headers behaves mostly like a dict and does not provide access to all header values.
Instance Variable responseHeaders All HTTP response headers to be sent. (type: http_headers.Headers)
Instance Variable headers Backwards-compatibility access to responseHeaders. Use responseHeaders instead. headers behaves mostly like a dict and does not provide access to all header values nor does it allow multiple values for one header to be set.
Instance Variable notifications A list of Deferreds which are waiting for notification that the response to this request has been finished (successfully or with an error). Don't use this attribute directly, instead use the Request.notifyFinish method.
Method __setattr__ Support assignment of dict instances to received_headers for backwards-compatibility.
Method noLongerQueued Notify the object that it is no longer queued.
Method gotLength Called when HTTP channel got length of content in this request.
Method parseCookies Parse cookie headers.
Method handleContentChunk Write a chunk of data.
Method requestReceived Called by channel when all data has been received.
Method __repr__ Undocumented
Method registerProducer Register a producer.
Method unregisterProducer Unregister the producer.
Method getHeader Get an HTTP request header.
Method getCookie Get a cookie that was sent from the network.
Method notifyFinish Notify when the response to this request has finished.
Method finish Indicate that all response data has been written to this Request.
Method addCookie Set an outgoing HTTP cookie.
Method setResponseCode Set the HTTP response code.
Method setHeader Set an HTTP response header. Overrides any previously set values for this header.
Method redirect Utility function that does a redirect.
Method setLastModified Set the Last-Modified time for the response to this request.
Method setETag Set an entity tag for the outgoing response.
Method getAllHeaders Return dictionary mapping the names of all received headers to the last value received for each.
Method getRequestHostname Get the hostname that the user passed in to the request.
Method getHost Get my originally requesting transport's host.
Method setHost Change the host and port the request thinks it's using.
Method getClientIP Return the IP address of the client who submitted this request.
Method isSecure Return True if this request is using a secure transport.
Method getUser Return the HTTP user sent with this request, if any.
Method getPassword Return the HTTP password sent with this request, if any.
Method getClient Undocumented
Method connectionLost There is no longer a connection for this request to respond over. Clean up anything which can't be useful anymore.
Instance Variable _disconnected A flag which is False until the connection over which this request was received is closed and which is True after that. (type: bool)
Method _cleanup Called when have finished responding and are no longer queued.
Method _sendError Undocumented
Method _authorize Undocumented

Inherited from Componentized:

Method locateAdapterClass Undocumented
Method setAdapter Undocumented
Method addAdapter Utility method that calls addComponent. I take an adapter class and instantiate it with myself as the first argument.
Method setComponent Undocumented
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 Versioned (via Componentized):

Method __setstate__ Undocumented
Method __getstate__ Get state, adding a version number to it on its way out.
Method versionUpgrade (internal) Do a version upgrade.
defaultContentType =
A str giving the default Content-Type value to send in responses if no other value is set. None disables the default.
def __init__(self, *args, **kw): (source)
overrides twisted.web.http.Request.__init__
Parameterschannelthe channel we're connected to.
queuedare we in the request queue, or can we start writing to the transport?
def getStateToCopyFor(self, issuer): (source)
overrides twisted.spread.flavors.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.
def childLink(self, name): (source)
Return the text that links to a child of the requested resource.
def process(self): (source)
overrides twisted.web.http.Request.process
Process a request.
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).
ParametersdataA string to write to the response.
def render(self, resrc): (source)
Ask a resource to render itself.
Parametersresrca twisted.web.resource.IResource.
def processingFailed(self, reason): (source)
Undocumented
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
def getSession(self, sessionInterface=None): (source)
from twisted.web.iweb.IRequest
Look up the session associated with this request or create a new one if there is not one.
ReturnsThe Session instance identified by the session cookie in the request, or the sessionInterface component of that session if sessionInterface is specified.
def _prePathURL(self, prepath): (source)
Undocumented
def prePathURL(self): (source)
from twisted.web.iweb.IRequest
ReturnsAt any time during resource traversal, a str giving an absolute URL to the most nested resource which has yet been reached.
def URLPath(self): (source)
from twisted.web.iweb.IRequest
ReturnsA 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.
API Documentation for Twisted, generated by pydoctor at 2012-06-04 17:20:01.