pekko/akka-docs/rst/java/http/routing-dsl/directives/respond-with-directives/respondWithDefaultHeader.rst
Felipe Fernández d9c7f9b7f0 =doc,htp #20466 Include Respond Directives Examples for Java. (#20595)
* Include Respond Directives Examples for Java.

* Include license on RespondWithDirectivesExamplesTest.
2016-05-24 10:54:44 +02:00

21 lines
826 B
ReStructuredText

.. _-respondWithDefaultHeader-java-:
respondWithDefaultHeader
========================
Description
-----------
Adds a given HTTP header to all responses coming back from its inner route only if a header with the same name doesn't
exist yet in the response.
This directive transforms ``HttpResponse`` and ``ChunkedResponseStart`` messages coming back from its inner route by
potentially adding the given ``HttpHeader`` instance to the headers list.
The header is only added if there is no header instance with the same name (case insensitively) already present in the
response.
See also :ref:`-respondWithDefaultHeaders-java-` if you'd like to add more than one header.
Example
-------
.. includecode:: ../../../../code/docs/http/javadsl/server/directives/RespondWithDirectivesExamplesTest.java#respondWithDefaultHeader