|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectsunlabs.brazil.proxy.ProxyHandler
public class ProxyHandler
Handler for implementing a web proxy. By default, this is a dumb proxy. It can be combined with other handlers to generate side effects, such as content rewriting.
Properties:
Field Summary | |
---|---|
java.lang.String |
auth
The string to send as the value for the "Proxy-Authorization" HTTP header (if needed). |
static java.lang.String |
AUTH
|
static java.lang.String |
PROXY_HOST
|
static java.lang.String |
PROXY_PORT
|
java.lang.String |
proxyHost
The proxy server. |
int |
proxyPort
The proxy server's port. |
static java.lang.String |
USE_PROXY
|
Constructor Summary | |
---|---|
ProxyHandler()
|
Method Summary | |
---|---|
static java.lang.String |
dumpHeaders(int count,
Request request,
MimeHeaders headers,
boolean sent)
Dump the headers on stderr |
boolean |
init(Server server,
java.lang.String prefix)
Do one-time setup. |
boolean |
respond(Request client)
Responds to an HTTP request. |
protected MimeHeaders |
rewriteHeaders(MimeHeaders responseHeaders)
Allow sub-classes to rewrite any or all of the target headers, if needed. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String PROXY_HOST
public static final java.lang.String PROXY_PORT
public static final java.lang.String AUTH
public static final java.lang.String USE_PROXY
public java.lang.String proxyHost
public int proxyPort
public java.lang.String auth
Constructor Detail |
---|
public ProxyHandler()
Method Detail |
---|
public boolean init(Server server, java.lang.String prefix)
init
in interface Handler
server
- The HTTP server that created this Handler
.
Typical Handler
s will use Server.props
to obtain run-time configuration information.prefix
- The handlers name.
The string this Handler
may prepend to all
of the keys that it uses to extract configuration information
from Server.props
. This is set (by the Server
and ChainHandler
) to help avoid configuration parameter
namespace collisions.
true
if this Handler
initialized
successfully, false
otherwise. If
false
is returned, this Handler
should not be used.public boolean respond(Request client) throws java.io.IOException
Handler
respond
in interface Handler
client
- The Request
object that represents the HTTP
request.
true
if the request was handled. A request was
handled if a response was supplied to the client, typically
by calling Request.sendResponse()
or
Request.sendError
.
java.io.IOException
- if there was an I/O error while sending the response to
the client. Typically, in that case, the Server
will (try to) send an error message to the client and then
close the client's connection.
The IOException
should not be used to silently
ignore problems such as being unable to access some
server-side resource (for example getting a
FileNotFoundException
due to not being able
to open a file). In that case, the Handler
's
duty is to turn that IOException
into a
HTTP response indicating, in this case, that a file could
not be found.
Handler.respond(sunlabs.brazil.server.Request)
protected MimeHeaders rewriteHeaders(MimeHeaders responseHeaders)
public static java.lang.String dumpHeaders(int count, Request request, MimeHeaders headers, boolean sent)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |