PingGateway object model

PingGateway processes HTTP requests and responses by passing them through user-defined chains of filters and handlers. The filters and handlers can access the request and response at each step in the chain. They make it possible to alter the request or response and collect contextual information.

The following image illustrates how PingGateway processes a request and response through a chain:

When PingGateway processes a request, it first builds an object representation of the request. The object representation includes parsed query/form parameters, cookies, headers, and the entity. PingGateway initializes a runtime context to provide metadata about the request and applied transformations. PingGateway passes the request representation into the chain.

In the request flow, filters modify the request representation and can enrich the runtime context with computed information. A ClientHandler serializes the entity content and can encode additional query parameters as described in RFC 3986: Query.

In the response flow, filters build a response representation with headers and the entity.

The route configuration in Adding headers and logging results shows the flow through a chain to a protected application.