twisted.web2.vhost.AutoVHostURIRewrite : API documentation

I do request mangling to insure that children know what host they are being accessed from behind apache2.

Usage:

Twisted:

   root = MyResource()
   vur = vhost.AutoVHostURIRewrite(root)

Apache2:
```
   <Location /whatever/>
     ProxyPass http://localhost:8538/
     RequestHeader set X-App-Location /whatever/
   </Location>
```
If the trailing / is ommitted in the second argument to ProxyPass VHostURIRewrite will return a 404 response code.

If proxying HTTPS, add this to the Apache config:
```
   RequestHeader set X-App-Scheme https
```

def __init__(self, resource, sendsRealHost=False): (source)

Parameters	resource	The resource to serve after mutating the request. (type: `twisted.web2.iweb.IResource` )
	sendsRealHost	If True then the proxy will be expected to send the HTTP 'Host' header that was sent by the requesting client. (type: `bool` )

def renderHTTP(self, req): (source)

from twisted.web2.iweb.IResource

Return an IResponse or a deferred which will fire an IResponse. This response will be written to the web browser which initiated the request.

def locateChild(self, req, segments): (source)

from twisted.web2.iweb.IResource

Locate another object which can be adapted to IResource.

Returns

A 2-tuple of (resource, remaining-path-segments), or a deferred which will fire the above.

Causes the object publishing machinery to continue on with specified resource and segments, calling the appropriate method on the specified resource.

If you return (self, server.StopTraversal), this instructs web2 to immediately stop the lookup stage, and switch to the rendering stage, leaving the remaining path alone for your render function to handle.

Method	__init__
Method	renderHTTP	Return an IResponse or a deferred which will fire an
Method	locateChild	Locate another object which can be adapted to IResource.

t.w.v.AutoVHostURIRewrite(object) : class documentation