Author: buildbot
Date: Mon Mar 26 09:57:21 2018
New Revision: 1027384
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/server-http-transport.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/server-http-transport.html
==============================================================================
--- websites/production/cxf/content/docs/server-http-transport.html (original)
+++ websites/production/cxf/content/docs/server-http-transport.html Mon Mar 26
09:57:21 2018
@@ -32,8 +32,8 @@
<link type="text/css" rel="stylesheet"
href="/resources/highlighter/styles/shThemeCXF.css">
<script src='/resources/highlighter/scripts/shCore.js'></script>
-<script src='/resources/highlighter/scripts/shBrushBash.js'></script>
<script src='/resources/highlighter/scripts/shBrushJava.js'></script>
+<script src='/resources/highlighter/scripts/shBrushBash.js'></script>
<script>
SyntaxHighlighter.defaults['toolbar'] = false;
SyntaxHighlighter.all();
@@ -117,23 +117,8 @@ Apache CXF -- Server HTTP Transport
<td height="100%">
<!-- Content -->
<div class="wiki-content">
-<div id="ConfluenceContent"><h1
id="ServerHTTPTransport-ServerHTTPTransport">Server HTTP Transport</h1>
-
-<p>HTTP server endpoints can specify a number of HTTP connection attributes
including if it will honor keep alive requests, how it interacts with caches,
and how tolerant it is of errors in communicating with a consumer.</p>
-
-<p>A server endpoint can be configured using two mechanisms:</p>
-
-<ul><li>Configuration</li><li>WSDL</li></ul>
-
-
-<h2 id="ServerHTTPTransport-UsingConfiguration">Using Configuration</h2>
-<h3 id="ServerHTTPTransport-Namespace">Namespace</h3>
-
-<p>The elements used to configure an HTTP provider endpoint are defined in the
namespace <code><a shape="rect"
href="http://cxf.apache.org/transports/http/configuration";>http://cxf.apache.org/transports/http/configuration</a></code>.
It is commonly referred to using the prefix <code>http-conf</code>. In order
to use the HTTP configuration elements you will need to add the lines shown
below to the beans element of your endpoint's configuration file. In addition,
you will need to add the configuration elements' namespace to the
<code>xsi:schemaLocation</code> attribute.</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader
panelHeader pdl" style="border-bottom-width: 1px;"><b>Adding the Configuration
Namespace</b></div><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;">
-<beans ...
+<div id="ConfluenceContent"><h1
id="ServerHTTPTransport-ServerHTTPTransport">Server HTTP Transport</h1><p>HTTP
server endpoints can specify a number of HTTP connection attributes including
if it will honor keep alive requests, how it interacts with caches, and how
tolerant it is of errors in communicating with a consumer.</p><p>A server
endpoint can be configured using two
mechanisms:</p><ul><li>Configuration</li><li>WSDL</li></ul><h2
id="ServerHTTPTransport-UsingConfiguration">Using Configuration</h2><h3
id="ServerHTTPTransport-Namespace">Namespace</h3><p>The elements used to
configure an HTTP provider endpoint are defined in the namespace <code><a
shape="rect"
href="http://cxf.apache.org/transports/http/configuration";>http://cxf.apache.org/transports/http/configuration</a></code>.
It is commonly referred to using the prefix <code>http-conf</code>. In order
to use the HTTP configuration elements you will need to add the lines shown
below to the beans element of your endpoint's conf
iguration file. In addition, you will need to add the configuration elements'
namespace to the <code>xsi:schemaLocation</code> attribute.</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl"
style="border-bottom-width: 1px;"><b>Adding the Configuration
Namespace</b></div><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;"><beans ...
xmlns:http-conf="http://cxf.apache.org/transports/http/configuration
...
xsi:schemaLocation="...
@@ -141,41 +126,15 @@ Apache CXF -- Server HTTP Transport
http://cxf.apache.org/schemas/configuration/http-conf.xsd
...">
</pre>
-</div></div>
-
-<h3 id="ServerHTTPTransport-Thedestinationelement">The
<code>destination</code> element</h3>
-
-<p>You configure an HTTP server endpoint using the
<code>http-conf:destination</code> element and its children. The
<code>http-conf:destination</code> element takes a single attribute,
<code>name</code>, the specifies the WSDL port element that corresponds to the
endpoint. The value for the <code>name</code> attribute takes the form
<em>portQName</em><code>.http-destination</code>. The example below shows the
<code>http-conf:destination</code> element that would be used to add
configuration for an endpoint that was specified by the WSDL fragment
<code><port binding="widgetSOAPBinding" name="widgetSOAPPort></code> if
the endpoint's target namespace was <code><a shape="rect" class="external-link"
href="http://widgets.widgetvendor.net";
rel="nofollow">http://widgets.widgetvendor.net</a></code>.</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader
panelHeader pdl" style="border-bottom-width: 1px;"><b>http-conf:destination
Element</b></div><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;">
-
-...
+</div></div><h3 id="ServerHTTPTransport-Thedestinationelement">The
<code>destination</code> element</h3><p>You configure an HTTP server endpoint
using the <code>http-conf:destination</code> element and its children. The
<code>http-conf:destination</code> element takes a single attribute,
<code>name</code>, the specifies the WSDL port element that corresponds to the
endpoint. The value for the <code>name</code> attribute takes the form
<em>portQName</em><code>.http-destination</code>. The example below shows the
<code>http-conf:destination</code> element that would be used to add
configuration for an endpoint that was specified by the WSDL fragment
<code><port binding="widgetSOAPBinding" name="widgetSOAPPort></code> if
the endpoint's target namespace was <code><a shape="rect" class="external-link"
href="http://widgets.widgetvendor.net";
rel="nofollow">http://widgets.widgetvendor.net</a></code>.</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeHeader pane
lHeader pdl" style="border-bottom-width: 1px;"><b>http-conf:destination
Element</b></div><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;">...
<http-conf:destination
name="{http://widgets/widgetvendor.net}widgetSOAPPort.http-destination">
...
</http-conf:destination>
...
</pre>
-</div></div>
-
-<p>The <code>http-conf:destination</code> element has a number of child
elements that specify configuration information. They are described below.</p>
-
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p>Element</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>http-conf:server</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the HTTP connection
properties.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>http-conf:contextMatchStrategy</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the parameters that
configure the context match strategy for processing HTTP
requests.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>http-conf:fixedParameterOrder</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies whether the parameter
order of an HTTP request handled by this destination is
fixed.</p></td></tr></tbody></table></div>
-
-
-<h3 id="ServerHTTPTransport-Theserverelement">The <code>server</code>
element</h3>
-
-<p>The <code>http-conf:server</code> element is used to configure the
properties of a server's HTTP connection. Its attributes, described below,
specify the connection's properties.</p>
-
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p>Attribute</p></th><th
colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>ReceiveTimeout</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Sets the length of time, in
milliseconds, the server tries to receive a request before the connection times
out. The default is 30000. The specify that the server will not timeout use
0.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>SuppressClientSendErrors</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies whether exceptions
are to be thrown when an error is encountered on receiving a request. The
default is <code>false</code>; exceptions are thrown on encountering
errors.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>SuppressClientReceiveErrors</co
de></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Specifies
whether exceptions are to be thrown when an error is encountered on sending a
response to a client. The default is <code>false</code>; exceptions are thrown
on encountering errors.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>HonorKeepAlive</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies whether the server honors
requests for a connection to remain open after a response has been sent. The
default is <code>true</code>; keep-alive requests are
honored.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>RedirectURL</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the URL to which the client
request should be redirected if the URL specified in the client request is no
longer appropriate for the requested resource. In this case, if a status code
is not automatically set in the first line of the server resp
onse, the status code is set to 302 and the status description is set to
Object Moved. The value is used as the value of the HTTP
<code>RedirectURL</code> property.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>CacheControl</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies directives about the behavior
that must be adhered to by caches involved in the chain comprising a response
from a server to a client.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>ContentLocation</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Sets the URL where the resource being sent
in a response is located.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>ContentType</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the media type of the information
being sent in a response. Media types are specified using multipurpose internet
mail extensions (MIME) type
s. The value is used as the value of the HTTP <code>ContentType</code>
location.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>ContentEncoding</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies any additional content encodings
that have been applied to the information being sent by the service provider.
Content encoding labels are regulated by the Internet Assigned Numbers
Authority (IANA). Possible content encoding values include zip, gzip, compress,
deflate, and identity. This value is used as the value of the HTTP
<code>ContentEncoding</code> property.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>ServerType</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies what type of server
is sending the response. Values take the form program-name/version. For
example, Apache/1.2.5.</p></td></tr></tbody></table></div>
-
-
-<h3 id="ServerHTTPTransport-Example">Example</h3>
-
-<p>The example below shows a the configuration for an HTTP service provider
endpoint that honors keep alive requests and suppresses all communication
errors.</p>
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader
panelHeader pdl" style="border-bottom-width: 1px;"><b>HTTP Service Provider
Endpoint Configuration</b></div><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;">
-<beans xmlns="http://www.springframework.org/schema/beans";
+</div></div><p>The <code>http-conf:destination</code> element has a number of
child elements that specify configuration information. They are described
below.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p>Element</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>http-conf:server</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the HTTP connection
properties.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>http-conf:contextMatchStrategy</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies the parameters that
configure the context match strategy for processing HTTP
requests.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>http-conf:fixedParameterOrder</code></p></td><td
colspan="1" rowspan="1" class="confluenceT
d"><p>Specifies whether the parameter order of an HTTP request handled by this
destination is fixed.</p></td></tr></tbody></table></div><h3
id="ServerHTTPTransport-Theserverelement">The <code>server</code>
element</h3><p>The <code>http-conf:server</code> element is used to configure
the properties of a server's HTTP connection. Its attributes, described below,
specify the connection's properties.</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Attribute</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>ReceiveTimeout</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Sets the length of time, in
milliseconds, the server tries to receive a request before the connection times
out. The default is 30000. Use 0 to specify that the server will not
timeout.</p></td></tr><tr><td colspan="1" rowspan="1" class=
"confluenceTd"><p><code>SuppressClientSendErrors</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies whether exceptions
are to be thrown when an error is encountered on receiving a request. The
default is <code>false</code>; exceptions are thrown on encountering
errors.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>SuppressClientReceiveErrors</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies whether exceptions
are to be thrown when an error is encountered on sending a response to a
client. The default is <code>false</code>; exceptions are thrown on
encountering errors.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>HonorKeepAlive</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies whether the server honors
requests for a connection to remain open after a response has been sent. The
default is <code>true</code>; keep-alive requests are honored.</p></td
></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>RedirectURL</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Specifies the URL to which the client
>request should be redirected if the URL specified in the client request is no
>longer appropriate for the requested resource. In this case, if a status code
>is not automatically set in the first line of the server response, the status
>code is set to 302 and the status description is set to Object Moved. The
>value is used as the value of the HTTP <code>RedirectURL</code>
>property.</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>CacheControl</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Specifies directives about the behavior
>that must be adhered to by caches involved in the chain comprising a response
>from a server to a client.</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>ContentLocation</code></p></td><td colspan="1"
>rowspan=
"1" class="confluenceTd"><p>Sets the URL where the resource being sent in a
response is located.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>ContentType</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies the media type of the information
being sent in a response. Media types are specified using multipurpose internet
mail extensions (MIME) types. The value is used as the value of the HTTP
<code>ContentType</code> location.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>ContentEncoding</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies any additional content encodings
that have been applied to the information being sent by the service provider.
Content encoding labels are regulated by the Internet Assigned Numbers
Authority (IANA). Possible content encoding values include zip, gzip, compress,
deflate, and identity. This value is used as the value of the HTTP
<code>ContentEnco
ding</code> property.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>ServerType</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies what type of server is sending
the response. Values take the form program-name/version. For example,
Apache/1.2.5.</p></td></tr></tbody></table></div><h3
id="ServerHTTPTransport-Example">Example</h3><p>The example below shows a the
configuration for an HTTP service provider endpoint that honors keep alive
requests and suppresses all communication errors.</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl"
style="border-bottom-width: 1px;"><b>HTTP Service Provider Endpoint
Configuration</b></div><div class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;"><beans
xmlns="http://www.springframework.org/schema/beans";
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
xmlns:http-conf="http://cxf.apache.org/transports/http/configuration";
xsi:schemaLocation="http://cxf.apache.org/transports/http/configuration
@@ -191,44 +150,19 @@ Apache CXF -- Server HTTP Transport
</http-conf:destination>
</beans>
</pre>
-</div></div>
-
-<h2 id="ServerHTTPTransport-UsingWSDL">Using WSDL</h2>
-<h3 id="ServerHTTPTransport-Namespace.1">Namespace</h3>
-
-<p>The WSDL extension elements used to configure an HTTP server endpoint are
defined in the namespace <code><a shape="rect"
href="http://cxf.apache.org/transports/http/configuration";>http://cxf.apache.org/transports/http/configuration</a></code>.
It is commonly refered to using the prefix <code>http-conf</code>. In order to
use the HTTP configuration elements you will need to add the line shown below
to the <code>definitions</code> element of your endpoint's WSDL document.</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader
panelHeader pdl" style="border-bottom-width: 1px;"><b>HTTP Provider WSDL
Element's Namespace</b></div><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;">
-<definitions ...
+</div></div><h2 id="ServerHTTPTransport-UsingWSDL">Using WSDL</h2><h3
id="ServerHTTPTransport-Namespace.1">Namespace</h3><p>The WSDL extension
elements used to configure an HTTP server endpoint are defined in the namespace
<code><a shape="rect"
href="http://cxf.apache.org/transports/http/configuration";>http://cxf.apache.org/transports/http/configuration</a></code>.
It is commonly refered to using the prefix <code>http-conf</code>. In order to
use the HTTP configuration elements you will need to add the line shown below
to the <code>definitions</code> element of your endpoint's WSDL
document.</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>HTTP
Provider WSDL Element's Namespace</b></div><div class="codeContent panelContent
pdl">
+<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;"><definitions ...
xmlns:http-conf="http://cxf.apache.org/transports/http/configuration
</pre>
-</div></div>
-
-<h3 id="ServerHTTPTransport-Theserverelement.1">The <code>server</code>
element</h3>
-
-<p>The <code>http-conf:server</code> element is used to specify the connection
properties of an HTTP server in a WSDL document. The
<code>http-conf:server</code> element is a child of the WSDL port element. It
has the same attributes as the <code>server</code> element used in the
configuration file.</p>
-
-<h3 id="ServerHTTPTransport-Example.1">Example</h3>
-
-<p>The example below shows a WSDL fragment that configures an HTTP server
endpoint to specify that it will not interact with caches.</p>
-
-<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader
panelHeader pdl" style="border-bottom-width: 1px;"><b>WSDL to Configure an HTTP
Service Provider Endpoint</b></div><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;">
-<service ...>
+</div></div><h3 id="ServerHTTPTransport-Theserverelement.1">The
<code>server</code> element</h3><p>The <code>http-conf:server</code> element is
used to specify the connection properties of an HTTP server in a WSDL document.
The <code>http-conf:server</code> element is a child of the WSDL port element.
It has the same attributes as the <code>server</code> element used in the
configuration file.</p><h3
id="ServerHTTPTransport-Example.1">Example</h3><p>The example below shows a
WSDL fragment that configures an HTTP server endpoint to specify that it will
not interact with caches.</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width:
1px;"><b>WSDL to Configure an HTTP Service Provider Endpoint</b></div><div
class="codeContent panelContent pdl">
+<pre class="brush: java; gutter: false; theme: Default"
style="font-size:12px;"><service ...>
<port ...>
<soap:address ... />
<http-conf:server CacheControl="no-cache" />
</port>
</service>
</pre>
-</div></div>
-
-<h2 id="ServerHTTPTransport-ServerCacheControlDirectives">Server Cache Control
Directives</h2>
-
-<p>The table below lists the cache control directives supported by an HTTP
server.</p>
-
-<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p>Directive</p></th><th
colspan="1" rowspan="1" class="confluenceTh"><p>Behavior</p></th></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>no-cache</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Caches cannot use a particular response to
satisfy subsequent requests without first revalidating that response with the
server. If specific response header fields are specified with this value, the
restriction applies only to those header fields within the response. If no
response header fields are specified, the restriction applies to the entire
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>public</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Any cache can store the response.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>private</code></p></td><td cols
pan="1" rowspan="1" class="confluenceTd"><p>Public (shared) caches cannot
store the response because the response is intended for a single user. If
specific response header fields are specified with this value, the restriction
applies only to those header fields within the response. If no response header
fields are specified, the restriction applies to the entire
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>no-store</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Caches must not store any part of response
or any part of the request that invoked it.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>no-transform</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Caches must not modify the
media type or location of the content in a response between a server and a
client.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>must-revalidate</code></p></td><td colspan=
"1" rowspan="1" class="confluenceTd"><p>Caches must revaildate expired entries
that relate to a response before that entry can be used in a subsequent
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>proxy-revalidate</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Means the same as must-revalidate, except
that it can only be enforced on shared caches and is ignored by private
unshared caches. If using this directive, the public cache directive must also
be used.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>max-age</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Clients can accept a response whose age is
no greater that the specified number of seconds.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>s-max-age</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Means the same as max-age, except that it
can only be enforced on shared caches a
nd is ignored by private unshared caches. The age specified by s-max-age
overrides the age specified by max-age. If using this directive, the
proxy-revalidate directive must also be used.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>cache-extension</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Specifies additional extensions
to the other cache directives. Extensions might be informational or behavioral.
An extended directive is specified in the context of a standard directive, so
that applications not understanding the extended directive can at least adhere
to the behavior mandated by the standard
directive.</p></td></tr></tbody></table></div></div>
+</div></div><h2 id="ServerHTTPTransport-ServerCacheControlDirectives">Server
Cache Control Directives</h2><p>The table below lists the cache control
directives supported by an HTTP server.</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Directive</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Behavior</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>no-cache</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Caches cannot use a particular response to
satisfy subsequent requests without first revalidating that response with the
server. If specific response header fields are specified with this value, the
restriction applies only to those header fields within the response. If no
response header fields are specified, the restriction applies to the entire
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>public</code></p></td>
<td colspan="1" rowspan="1" class="confluenceTd"><p>Any cache can store the
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>private</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Public (shared) caches cannot store the
response because the response is intended for a single user. If specific
response header fields are specified with this value, the restriction applies
only to those header fields within the response. If no response header fields
are specified, the restriction applies to the entire
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>no-store</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Caches must not store any part of response
or any part of the request that invoked it.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>no-transform</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Caches must not modify the
media typ
e or location of the content in a response between a server and a
client.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>must-revalidate</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Caches must revaildate expired entries that
relate to a response before that entry can be used in a subsequent
response.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>proxy-revalidate</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Means the same as must-revalidate, except
that it can only be enforced on shared caches and is ignored by private
unshared caches. If using this directive, the public cache directive must also
be used.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>max-age</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Clients can accept a response whose age is
no greater that the specified number of seconds.</p></td></tr><tr><td
colspan="1" rowspan=
"1" class="confluenceTd"><p><code>s-max-age</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Means the same as max-age, except that it
can only be enforced on shared caches and is ignored by private unshared
caches. The age specified by s-max-age overrides the age specified by max-age.
If using this directive, the proxy-revalidate directive must also be
used.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>cache-extension</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Specifies additional extensions to the
other cache directives. Extensions might be informational or behavioral. An
extended directive is specified in the context of a standard directive, so that
applications not understanding the extended directive can at least adhere to
the behavior mandated by the standard
directive.</p></td></tr></tbody></table></div></div>
</div>
<!-- Content -->
</td>
