public interface ClientHeadersFactory

This interface is intended for generating or propagating HTTP headers. It is invoked by the MP Rest Client implementation before invoking any entity providers on the outbound processing chain. It contains a single method, update which takes parameters of headers passed in from the incoming JAX-RS request (if applicable, if not, this will be an empty map) and a read-only map of headers specified by ClientHeaderParam or HeaderParam annotations on the client interface.

This method should return a MultivaluedMap of headers to be merged with the outgoing headers. If it's desired for clientOutgoingHeaders to be present in addition to any propagated headers, update needs to combine the two sets to return. This will determine the final set of HTTP headers that will be sent to the outbound entity provider processing chain - thus any filters, MessageBodyWriters, interceptors, etc. could further refine the set of headers actually sent on the client request.

If the ClientHeadersFactory instance is invoked while in the context of a JAX-RS request, the implementation may optionally support injection of fields and methods annotated with @Context.

If the ClientHeadersFactory instance is managed by CDI (i.e. it is annotated with @ApplicationScoped, etc.), the implementation must use the appropriate CDI-managed instance, and must support @Inject injection.