Package org.forgerock.openig.handler

Class ReverseProxyHandlerHeaplet

java.lang.Object

org.forgerock.openig.heap.GenericHeaplet

org.forgerock.openig.handler.HttpClientHandlerHeaplet

org.forgerock.openig.handler.ReverseProxyHandlerHeaplet

All Implemented Interfaces:

Heaplet

public class ReverseProxyHandlerHeaplet
extends HttpClientHandlerHeaplet

Creates a reverse proxy Handler in a heap environment.

A reverse proxy Handler serves the purpose of proxying requests from the client to the protected application.

It supports the following configuration items:

   
     "config": {
       "websocket": {
           "enabled": false,
           "soTimeout: "10 seconds",
           "connectionTimeout": "10 seconds",
           "maxConnections": 100,
           "tls": "RefToTlsOptions",
           "proxyOptions": "myProxyOptions"
       }
     }
   
 

The websocket optional attribute, if present gives access to Web Socket specific configuration options. It's disabled by default, and if the inner attributes are not valued, they default to the corresponding attribute's value in the ClientHandler configuration (/websocket/soTimeout -> /soTimeout for instance).

See Also:

• BadGatewayFilter

Field Summary

Fields

Modifier and Type	Field	Description
static final String	NAME	Public name used by resolver.

Fields inherited from class org.forgerock.openig.heap.GenericHeaplet

config, heap, name, object, qualified

Constructor Summary

Constructors

Constructor	Description
ReverseProxyHandlerHeaplet()

Method Summary

Modifier and Type	Method	Description
void	destroy()	Releases observability resources: deregisters the HTTP endpoint, all meters, and startup metrics.
protected List<Filter>	filters(Options options)	Returns a list of Filter that will be executed on every request before the HttpClientHandler.
protected String	getType()	Returns the type of the IG object.

Methods inherited from class org.forgerock.openig.handler.HttpClientHandlerHeaplet

circuitBreakerFilter, create, retryFilter

Methods inherited from class org.forgerock.openig.heap.GenericHeaplet

create, endpointRegistry, evaluatedWithHeapProperties, expression, getConfig, getHeap, initialBindings, meterRegistryHolder, start

Methods inherited from class java.lang.Object

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

Field Details

NAME

public static final String NAME

Public name used by resolver.

See Also:

• Constant Field Values

Constructor Details

ReverseProxyHandlerHeaplet

public ReverseProxyHandlerHeaplet()

Method Details

filters

protected List<Filter> filters(Options options)
                        throws HeapException

Description copied from class: HttpClientHandlerHeaplet

Returns a list of Filter that will be executed on every request before the HttpClientHandler.

Specified by:

filters in class HttpClientHandlerHeaplet

Parameters:

options - the options that will be used to create the HttpClientHandler.

Returns:

A list of Filter that will be executed on every request before the HttpClientHandler.

Throws:

HeapException - if any error occurs during the setup of the filters.

getType

protected String getType()

Description copied from class: GenericHeaplet

Returns the type of the IG object.

Overrides:

getType in class GenericHeaplet

Returns:

the type of the IG object

destroy

public void destroy()

Description copied from class: GenericHeaplet

Releases observability resources: deregisters the HTTP endpoint, all meters, and startup metrics.

Subclasses that override this method must call super.destroy() last, after releasing their own domain resources. This ensures that monitoring remains active for the full lifetime of those resources and that any metrics emitted during shutdown are not lost.

Specified by:

destroy in interface Heaplet

Overrides:

destroy in class HttpClientHandlerHeaplet