The Merge Header filter combines multiple headers by the same name into a single, comma-separated value. You can use the filter with the request and the response.
Filter name: merge-header
Filter configuration: merge-header.cfg.xml
Headers: The Merge Header filter has no required request headers.
Preceding filters: The Merge Header filter has no required preceding filters.
Standard filter order: You may use two instances of this filter.
- If you plan use the filter for responses, place it at the beginning of the filter sequence.
- If you plan to use the the filter for requests, place it at the end of the filter sequence.
The merge-header.cfg.xml file contains the following elements and attributes. Add the filter to your Repose deployment through the system model configuration.
|<merge-header>||-||Required||Specifies the sub-elements and attributes to define your merge-header configuration.|
|<request>||-||Optional||Specifies a list of headers to merge for a request.|
|<response>||-||Optional||Specifies a list of headers to merge for a response.|
|<header>||-||Required||Name of each header to merge for request or response.|
Repose splits the following headers by default:
|Headers that Repose splits by default|
Return codes and conditions
This filter does not return specific response codes. The request will simply pass through to the next filter or to the origin service.
The Merge Header filter does not create unique request headers; it merges multiple headers into a single, comma-separated value.