io.muserver.murp

Class ReverseProxy

java.lang.Object

io.muserver.murp.ReverseProxy

All Implemented Interfaces:

io.muserver.MuHandler

public class ReverseProxy
extends Object
implements io.muserver.MuHandler

Field Summary

Fields

Modifier and Type	Field and Description
static Set<String>	HOP_BY_HOP_HEADERS An unmodifiable set of the Hop By Hop headers.

Method Summary

Modifier and Type	Method and Description
boolean	handle(io.muserver.MuRequest clientReq, io.muserver.MuResponse clientResp)
static void	setForwardedHeaders(io.muserver.MuRequest clientRequest, org.eclipse.jetty.client.api.Request targetRequest, boolean discardClientForwardedHeaders, boolean sendLegacyForwardedHeaders) Sets Forwarded and optionally X-Forwarded-* headers to the target request, based on the client request
static boolean	setRequestHeaders(io.muserver.MuRequest clientRequest, org.eclipse.jetty.client.api.Request targetRequest, boolean discardClientForwardedHeaders, boolean sendLegacyForwardedHeaders, String viaValue) Copies headers from the clientRequest to the targetRequest, removing any Hop-By-Hop headers and adding Forwarded headers.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

HOP_BY_HOP_HEADERS

public static final Set<String> HOP_BY_HOP_HEADERS

An unmodifiable set of the Hop By Hop headers. All are in lowercase.

Method Detail

handle

public boolean handle(io.muserver.MuRequest clientReq,
                      io.muserver.MuResponse clientResp)
               throws Exception

Specified by:

handle in interface io.muserver.MuHandler

Throws:

Exception

setRequestHeaders

public static boolean setRequestHeaders(io.muserver.MuRequest clientRequest,
                                        org.eclipse.jetty.client.api.Request targetRequest,
                                        boolean discardClientForwardedHeaders,
                                        boolean sendLegacyForwardedHeaders,
                                        String viaValue)

Copies headers from the clientRequest to the targetRequest, removing any Hop-By-Hop headers and adding Forwarded headers.

Parameters:

clientRequest - The original Mu request to copy headers from.

targetRequest - A Jetty request to copy the headers to.

discardClientForwardedHeaders - Set true to ignore Forwarded headers from the client request

sendLegacyForwardedHeaders - Set true to send X-Forwarded-* headers along with Forwarded headers

viaValue - The value to set on the Via header, for example HTTP/1.1 myserver

Returns:

Returns true if the client request has a body; otherwise false.

setForwardedHeaders

public static void setForwardedHeaders(io.muserver.MuRequest clientRequest,
                                       org.eclipse.jetty.client.api.Request targetRequest,
                                       boolean discardClientForwardedHeaders,
                                       boolean sendLegacyForwardedHeaders)

Sets Forwarded and optionally X-Forwarded-* headers to the target request, based on the client request

Parameters:

clientRequest - the received client request

targetRequest - the target request to write the headers to

discardClientForwardedHeaders - if true then existing Forwarded headers on the client request will be discarded (normally false, unless you do not trust the upstream system)

sendLegacyForwardedHeaders - if true then X-Forwarded-Proto/Host/For headers will also be added