DispatchHandler
When a request is handled, the first condition in the list of conditions is
evaluated. If the condition expression yields true, the request is
dispatched to the associated handler with no further processing. Otherwise,
the next condition in the list is evaluated.
Usage
{
"name": string,
"type": "DispatchHandler",
"config": {
"bindings": [
{
"condition": runtime expression<boolean>,
"handler": Handler reference,
"baseURI": runtime expression<url>,
}, ...
]
}
}Properties
"bindings": array of objects, required-
One or more condition and handler bindings.
"condition": runtime expression<boolean>, optional-
A flag to indicate that a condition is met. The condition can be based on the request, context, or PingGateway runtime environment, such as system properties or environment variables.
Conditions are defined using PingGateway expressions, as described in Expressions, and are evaluated as follows:
-
true: The request is dispatched to the associated handler. -
false: The next condition in the list is evaluated.
For examples, refer to Example conditions and requests.
Default:
${true} -
"handler": Handler reference, required-
The Handler to which PingGateway dispaches the request if the associated condition yields
true.Provide the name of a Handler object defined in the heap or an inline Handler configuration object.
"baseURI": runtime expression<url>,optional-
A base URI that overrides the existing request URI. Only scheme, host, and port are used in the supplied URI.
The result of the expression must be a string that represents a valid URI, but is not a real
java.net.URIobject. For example, it would be incorrect to use${request.uri}, which is not a String but a MutableUri.In the following example, the binding condition looks up the hostname of the request. If it finds a match, the value is used for the
baseURI. Otherwise, the default value is used:{ "properties": { "uris": { "app1.example.com": { "baseURI": "http://backend1:8080/" }, "app2.example.com": { "baseURI": "http://backend2:8080/" }, "default": { "baseURI": "http://backend3:8080/" } } }, "handler": { "type": "DispatchHandler", "config": { "bindings": [ { "condition": "${not empty uris[contexts.router.originalUri.host]}", "baseURI": "${uris[contexts.router.originalUri.host].baseURI}", "handler": "ReverseProxyHandler" }, { "baseURI": "${uris['default'].baseURI}", "handler": "ReverseProxyHandler" } ] } } }Default: No change to the base URI
Example
For an example that uses a DispatchHandler, refer to Implement not-enforced URIs with a DispatchHandler