You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2018/01/14 23:07:06 UTC
[23/51] [partial] juneau-website git commit: Update javadocs.
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/ContentLanguage.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/ContentLanguage.html b/content/site/apidocs/org/apache/juneau/http/ContentLanguage.html
index f300ef2..a26eaf3 100644
--- a/content/site/apidocs/org/apache/juneau/http/ContentLanguage.html
+++ b/content/site/apidocs/org/apache/juneau/http/ContentLanguage.html
@@ -116,24 +116,24 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/ContentLanguage.html#line.76">ContentLanguage</a>
extends <a href="../../../../org/apache/juneau/http/HeaderStringArray.html" title="class in org.apache.juneau.http">HeaderStringArray</a></pre>
<div class="block">Represents a parsed <l>Content-Language</l> HTTP response header.
-
+
<p>
The natural language or languages of the intended audience for the enclosed content.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Content-Language: da
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Content-Language entity-header field describes the natural language(s) of the intended audience for the
enclosed entity.
Note that this might not be equivalent to all the languages used within the entity-body.
<p class='bcode'>
Content-Language = "Content-Language" ":" 1#language-tag
</p>
-
+
<p>
Language tags are defined in section 3.10.
The primary purpose of Content-Language is to allow a user to identify and differentiate entities according to the
@@ -142,12 +142,12 @@ extends <a href="../../../../org/apache/juneau/http/HeaderStringArray.html" titl
<p class='bcode'>
Content-Language: da
</p>
-
+
<p>
If no Content-Language is specified, the default is that the content is intended for all language audiences.
This might mean that the sender does not consider it to be specific to any natural language, or that the sender
does not know for which language it is intended.
-
+
<p>
Multiple languages MAY be listed for content that is intended for multiple audiences.
For example, a rendition of the "Treaty of Waitangi," presented simultaneously in the original Maori and English
@@ -155,17 +155,17 @@ extends <a href="../../../../org/apache/juneau/http/HeaderStringArray.html" titl
<p class='bcode'>
Content-Language: mi, en
</p>
-
+
<p>
However, just because multiple languages are present within an entity does not mean that it is intended for
multiple linguistic audiences.
An example would be a beginner's language primer, such as "A First Lesson in Latin," which is clearly intended to
be used by an English-literate audience.
In this case, the Content-Language would properly only include "en".
-
+
<p>
Content-Language MAY be applied to any media type -- it is not limited to textual documents.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/ContentLength.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/ContentLength.html b/content/site/apidocs/org/apache/juneau/http/ContentLength.html
index fa8dbe4..bab62e9 100644
--- a/content/site/apidocs/org/apache/juneau/http/ContentLength.html
+++ b/content/site/apidocs/org/apache/juneau/http/ContentLength.html
@@ -116,44 +116,44 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/ContentLength.html#line.64">ContentLength</a>
extends <a href="../../../../org/apache/juneau/http/HeaderInteger.html" title="class in org.apache.juneau.http">HeaderInteger</a></pre>
<div class="block">Represents a parsed <l>Content-Length</l> HTTP request/response header.
-
+
<p>
The length of the response body in octets (8-bit bytes).
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Content-Length: 348
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Content-Length entity-header field indicates the size of the entity-body, in decimal number of OCTETs, sent to
the recipient or, in the case of the HEAD method, the size of the entity-body that would have been sent had the
request been a GET.
<p class='bcode'>
Content-Length = "Content-Length" ":" 1*DIGIT
</p>
-
+
<p>
An example is...
<p class='bcode'>
Content-Length: 3495
</p>
-
+
<p>
Applications SHOULD use this field to indicate the transfer-length of the message-body, unless this is prohibited by
the rules in section 4.4.
-
+
<p>
Any Content-Length greater than or equal to zero is a valid value.
Section 4.4 describes how to determine the length of a message-body if a Content-Length is not given.
-
+
<p>
Note that the meaning of this field is significantly different from the corresponding definition in MIME, where it is
an optional field used within the "message/external-body" content-type.
In HTTP, it SHOULD be sent whenever the message's length can be determined prior to being transferred, unless this is
prohibited by the rules in section 4.4.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/ContentLocation.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/ContentLocation.html b/content/site/apidocs/org/apache/juneau/http/ContentLocation.html
index f01524b..5c31cb0 100644
--- a/content/site/apidocs/org/apache/juneau/http/ContentLocation.html
+++ b/content/site/apidocs/org/apache/juneau/http/ContentLocation.html
@@ -116,17 +116,17 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/ContentLocation.html#line.70">ContentLocation</a>
extends <a href="../../../../org/apache/juneau/http/HeaderUri.html" title="class in org.apache.juneau.http">HeaderUri</a></pre>
<div class="block">Represents a parsed <l>Content-Location</l> HTTP response header.
-
+
<p>
An alternate location for the returned data.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Content-Location: /index.htm
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Content-Location entity-header field MAY be used to supply the resource location for the entity enclosed in the
message when that entity is accessible from a location separate from the requested resource's URI.
A server SHOULD provide a Content-Location for the variant corresponding to the response entity; especially in the
@@ -137,29 +137,29 @@ extends <a href="../../../../org/apache/juneau/http/HeaderUri.html" title="class
Content-Location = "Content-Location" ":"
( absoluteURI | relativeURI )
</p>
-
+
<p>
The value of Content-Location also defines the base URI for the entity.
-
+
<p>
The Content-Location value is not a replacement for the original requested URI; it is only a statement of the
location of the resource corresponding to this particular entity at the time of the request.
Future requests MAY specify the Content-Location URI as the request- URI if the desire is to identify the source of
that particular entity.
-
+
<p>
A cache cannot assume that an entity with a Content-Location different from the URI used to retrieve it can be used
to respond to later requests on that Content-Location URI.
However, the Content- Location can be used to differentiate between multiple entities retrieved from a single
requested resource, as described in section 13.6.
-
+
<p>
If the Content-Location is a relative URI, the relative URI is interpreted relative to the Request-URI.
-
+
<p>
The meaning of the Content-Location header in PUT or POST requests is undefined; servers are free to ignore it in
those cases.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/ContentRange.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/ContentRange.html b/content/site/apidocs/org/apache/juneau/http/ContentRange.html
index c8966be..c7f1a82 100644
--- a/content/site/apidocs/org/apache/juneau/http/ContentRange.html
+++ b/content/site/apidocs/org/apache/juneau/http/ContentRange.html
@@ -116,17 +116,17 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/ContentRange.html#line.132">ContentRange</a>
extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="class in org.apache.juneau.http">HeaderString</a></pre>
<div class="block">Represents a parsed <l>Content-Range</l> HTTP response header.
-
+
<p>
Where in a full body message this partial message belongs.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Content-Range: bytes 21010-47021/47022
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Content-Range entity-header is sent with a partial entity-body to specify where in the full entity-body the
partial body should be applied.
Range units are defined in section 3.12.
@@ -140,28 +140,28 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
| "*"
instance-length = 1*DIGIT
</p>
-
+
<p>
The header SHOULD indicate the total length of the full entity-body, unless this length is unknown or difficult to
determine.
The asterisk "*" character means that the instance-length is unknown at the time when the response was generated.
-
+
<p>
Unlike byte-ranges-specifier values (see section 14.35.1), a byte- range-resp-spec MUST only specify one range, and
MUST contain absolute byte positions for both the first and last byte of the range.
-
+
<p>
A byte-content-range-spec with a byte-range-resp-spec whose last- byte-pos value is less than its first-byte-pos
value, or whose instance-length value is less than or equal to its last-byte-pos value, is invalid.
The recipient of an invalid byte-content-range- spec MUST ignore it and any content transferred along with it.
-
+
<p>
A server sending a response with status code 416 (Requested range not satisfiable) SHOULD include a Content-Range
field with a byte-range- resp-spec of "*".
The instance-length specifies the current length of the selected resource.
A response with status code 206 (Partial Content) MUST NOT include a Content-Range field with a byte-range-resp-spec
of "*".
-
+
<p>
Examples of byte-content-range-spec values, assuming that the entity contains a total of 1234 bytes:
<p class='bcode'>
@@ -174,7 +174,7 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
The last 500 bytes:
bytes 734-1233/1234
</p>
-
+
<p>
When an HTTP message includes the content of a single range (for example, a response to a request for a single range,
or to a request for a set of ranges that overlap without any holes), this content is transmitted with a Content-Range
@@ -188,40 +188,40 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
Content-Length: 26012
Content-Type: image/gif
</p>
-
+
<p>
When an HTTP message includes the content of multiple ranges (for example, a response to a request for multiple
non-overlapping ranges), these are transmitted as a multipart message.
The multipart media type used for this purpose is "multipart/byteranges" as defined in appendix 19.2.
See appendix 19.6.3 for a compatibility issue.
-
+
<p>
A response to a request for a single range MUST NOT be sent using the multipart/byteranges media type.
A response to a request for multiple ranges, whose result is a single range, MAY be sent as a multipart/byteranges
media type with one part.
A client that cannot decode a multipart/byteranges message MUST NOT ask for multiple byte-ranges in a single request.
-
+
<p>
When a client requests multiple byte-ranges in one request, the server SHOULD return them in the order that they
appeared in the request.
-
+
<p>
If the server ignores a byte-range-spec because it is syntactically invalid, the server SHOULD treat the request as
if the invalid Range header field did not exist.
(Normally, this means return a 200 response containing the full entity).
-
+
<p>
If the server receives a request (other than one including an If- Range request-header field) with an unsatisfiable
Range request- header field
(that is, all of whose byte-range-spec values have a first-byte-pos value greater than the current length of the
selected resource),
it SHOULD return a response code of 416 (Requested range not satisfiable) (section 10.4.17).
-
+
<p>
Note: clients cannot depend on servers to send a 416 (Requested range not satisfiable) response instead of a 200 (OK)
response for
an unsatisfiable Range request-header, since not all servers implement this request-header.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/ContentType.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/ContentType.html b/content/site/apidocs/org/apache/juneau/http/ContentType.html
index ddd4810..bbf9742 100644
--- a/content/site/apidocs/org/apache/juneau/http/ContentType.html
+++ b/content/site/apidocs/org/apache/juneau/http/ContentType.html
@@ -120,30 +120,30 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/ContentType.html#line.54">ContentType</a>
extends <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a></pre>
<div class="block">Represents a parsed <l>Content-Type</l> HTTP request/response header.
-
+
<p>
The MIME type of this content.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Content-Type: text/html; charset=utf-8
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Content-Type entity-header field indicates the media type of the entity-body sent to the recipient or, in the
case of the HEAD method, the media type that would have been sent had the request been a GET.
<p class='bcode'>
Content-Type = "Content-Type" ":" media-type
</p>
-
+
<p>
Media types are defined in section 3.7.
An example of the field is...
<p class='bcode'>
Content-Type: text/html; charset=ISO-8859-4
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -250,7 +250,7 @@ extends <a href="../../../../org/apache/juneau/http/MediaType.html" title="class
<h4>findMatch</h4>
<pre>public int <a href="../../../../src-html/org/apache/juneau/http/ContentType.html#line.93">findMatch</a>(<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>[] mediaTypes)</pre>
<div class="block">Given a list of media types, returns the best match for this <code>Content-Type</code> header.
-
+
<p>
Note that fuzzy matching is allowed on the media types where the <code>Content-Types</code> header may
contain additional subtype parts.
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/Date.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/Date.html b/content/site/apidocs/org/apache/juneau/http/Date.html
index 4395831..fc19f32 100644
--- a/content/site/apidocs/org/apache/juneau/http/Date.html
+++ b/content/site/apidocs/org/apache/juneau/http/Date.html
@@ -116,30 +116,30 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/Date.html#line.82">Date</a>
extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="class in org.apache.juneau.http">HeaderDate</a></pre>
<div class="block">Represents a parsed <l>Date</l> HTTP request/response header.
-
+
<p>
The date and time that the message was sent (in "HTTP-date" format as defined by RFC 7231).
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Date: Tue, 15 Nov 1994 08:12:31 GMT
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Date general-header field represents the date and time at which the message was originated, having the same
semantics as orig-date in RFC 822.
The field value is an HTTP-date, as described in section 3.3.1; it MUST be sent in RFC 1123 [8]-date format.
<p class='bcode'>
Date = "Date" ":" HTTP-date
</p>
-
+
<p>
An example is...
<p class='bcode'>
Date: Tue, 15 Nov 1994 08:12:31 GMT
</p>
-
+
<p>
Origin servers MUST include a Date header field in all responses, except in these cases:
<ol>
@@ -151,19 +151,19 @@ extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="clas
responses MUST NOT include a Date header field.
In this case, the rules in section 14.18.1 MUST be followed.
</ol>
-
+
<p>
A received message that does not have a Date header field MUST be assigned one by the recipient if the message will
be cached by that recipient or gatewayed via a protocol which requires a Date.
An HTTP implementation without a clock MUST NOT cache responses without revalidating them on every use.
An HTTP cache, especially a shared cache, SHOULD use a mechanism, such as NTP, to synchronize its clock with a
reliable external standard.
-
+
<p>
Clients SHOULD only send a Date header field in messages that include an entity-body, as in the case of the PUT and
POST requests, and even then it is optional.
A client without a clock MUST NOT send a Date header field in a request.
-
+
<p>
The HTTP-date sent in a Date header SHOULD NOT represent a date and time subsequent to the generation of the message.
It SHOULD represent the best available approximation of the date and time of message generation, unless the
@@ -171,7 +171,7 @@ extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="clas
In theory, the date ought to represent the moment just before the entity is generated.
In practice, the date can be generated at any time during the message origination without affecting its semantic
value.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/ETag.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/ETag.html b/content/site/apidocs/org/apache/juneau/http/ETag.html
index 449dafc..1422303 100644
--- a/content/site/apidocs/org/apache/juneau/http/ETag.html
+++ b/content/site/apidocs/org/apache/juneau/http/ETag.html
@@ -116,25 +116,25 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/ETag.html#line.53">ETag</a>
extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="class in org.apache.juneau.http">HeaderString</a></pre>
<div class="block">Represents a parsed <l>ETag</l> HTTP response header.
-
+
<p>
An identifier for a specific version of a resource, often a message digest.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
ETag: "737060cd8c284d8af7ad3082f209582d"
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The ETag response-header field provides the current value of the entity tag for the requested variant.
The headers used with entity tags are described in sections 14.24, 14.26 and 14.44.
The entity tag MAY be used for comparison with other entities from the same resource (see section 13.3.3).
-
+
<p class='bcode'>
ETag = "ETag" ":" entity-tag
</p>
-
+
<p>
Examples:
<p class='bcode'>
@@ -142,7 +142,7 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
ETag: W/"xyzzy"
ETag: ""
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/EntityValidator.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/EntityValidator.html b/content/site/apidocs/org/apache/juneau/http/EntityValidator.html
index 710525e..b8690e2 100644
--- a/content/site/apidocs/org/apache/juneau/http/EntityValidator.html
+++ b/content/site/apidocs/org/apache/juneau/http/EntityValidator.html
@@ -111,14 +111,14 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/EntityValidator.html#line.34">EntityValidator</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Represents a validator value.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
ETag: "123456789" – A strong ETag validator
ETag: W/"123456789" – A weak ETag validator
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/Expect.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/Expect.html b/content/site/apidocs/org/apache/juneau/http/Expect.html
index 42dee1d..77ec972 100644
--- a/content/site/apidocs/org/apache/juneau/http/Expect.html
+++ b/content/site/apidocs/org/apache/juneau/http/Expect.html
@@ -116,17 +116,17 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/Expect.html#line.72">Expect</a>
extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="class in org.apache.juneau.http">HeaderString</a></pre>
<div class="block">Represents a parsed <l>Expect</l> HTTP request header.
-
+
<p>
Indicates that particular server behaviors are required by the client.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Expect: 100-continue
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Expect request-header field is used to indicate that particular server behaviors are required by the client.
<p class='bcode'>
Expect = "Expect" ":" 1#expectation
@@ -135,33 +135,33 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
*expect-params ]
expect-params = ";" token [ "=" ( token | quoted-string ) ]
</p>
-
+
<p>
A server that does not understand or is unable to comply with any of the expectation values in the Expect field of a
request MUST respond with appropriate error status.
The server MUST respond with a 417 (Expectation Failed) status if any of the expectations cannot be met or, if there
are other problems with the request, some other 4xx status.
-
+
<p>
This header field is defined with extensible syntax to allow for future extensions.
If a server receives a request containing an Expect field that includes an expectation-extension that it does not
support, it MUST respond with a 417 (Expectation Failed) status.
-
+
<p>
Comparison of expectation values is case-insensitive for unquoted tokens (including the 100-continue token), and is
case-sensitive for quoted-string expectation-extensions.
-
+
<p>
The Expect mechanism is hop-by-hop: that is, an HTTP/1.1 proxy MUST return a 417 (Expectation Failed) status if it
receives a request with an expectation that it cannot meet.
However, the Expect request-header itself is end-to-end; it MUST be forwarded if the request is forwarded.
-
+
<p>
Many older HTTP/1.0 and HTTP/1.1 applications do not understand the Expect header.
-
+
<p>
See section 8.2.3 for the use of the 100 (continue) status.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/Expires.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/Expires.html b/content/site/apidocs/org/apache/juneau/http/Expires.html
index a6f59fa..1b9a041 100644
--- a/content/site/apidocs/org/apache/juneau/http/Expires.html
+++ b/content/site/apidocs/org/apache/juneau/http/Expires.html
@@ -116,63 +116,63 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/Expires.html#line.83">Expires</a>
extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="class in org.apache.juneau.http">HeaderDate</a></pre>
<div class="block">Represents a parsed <l>Expires</l> HTTP response header.
-
+
<p>
Gives the date/time after which the response is considered stale (in "HTTP-date" format as defined by RFC 7231).
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Expires: Thu, 01 Dec 1994 16:00:00 GMT
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Expires entity-header field gives the date/time after which the response is considered stale.
A stale cache entry may not normally be returned by a cache (either a proxy cache or a user agent cache) unless it is
first validated with the origin server
(or with an intermediate cache that has a fresh copy of the entity).
See section 13.2 for further discussion of the expiration model.
-
+
<p>
The presence of an Expires field does not imply that the original resource will change or cease to exist at, before,
or after that time.
-
+
<p>
The format is an absolute date and time as defined by HTTP-date in section 3.3.1; it MUST be in RFC 1123 date format:
-
+
<p class='bcode'>
Expires = "Expires" ":" HTTP-date
</p>
-
+
<p>
An example of its use is...
<p class='bcode'>
Expires: Thu, 01 Dec 1994 16:00:00 GMT
</p>
-
+
<p>
Note: if a response includes a Cache-Control field with the max-age directive (see section 14.9.3), that directive
overrides the Expires field.
-
+
<p>
HTTP/1.1 clients and caches MUST treat other invalid date formats, especially including the value "0", as in the past
(i.e., "already expired").
-
+
<p>
To mark a response as "already expired," an origin server sends an Expires date that is equal to the Date header
value.
(See the rules for expiration calculations in section 13.2.4.)
-
+
<p>
To mark a response as "never expires," an origin server sends an Expires date approximately one year from the time
the response is sent.
HTTP/1.1 servers SHOULD NOT send Expires dates more than one year in the future.
-
+
<p>
The presence of an Expires header field with a date value of some time in the future on a response that otherwise
would by default be non-cacheable indicates that the response is cacheable, unless indicated otherwise by a
Cache-Control header field (section 14.9).
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/From.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/From.html b/content/site/apidocs/org/apache/juneau/http/From.html
index ea3017f..49aee62 100644
--- a/content/site/apidocs/org/apache/juneau/http/From.html
+++ b/content/site/apidocs/org/apache/juneau/http/From.html
@@ -116,31 +116,31 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/From.html#line.70">From</a>
extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="class in org.apache.juneau.http">HeaderString</a></pre>
<div class="block">Represents a parsed <l>From</l> HTTP request header.
-
+
<p>
The email address of the user making the request.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
From: user@example.com
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The From request-header field, if given, SHOULD contain an Internet e-mail address for the human user who controls
the requesting user agent.
The address SHOULD be machine-usable, as defined by "mailbox" in RFC 822 [9] as updated by RFC 1123 [8]:
-
+
<p class='bcode'>
From = "From" ":" mailbox
</p>
-
+
<p>
An example is:
<p class='bcode'>
From: webmaster@w3.org
</p>
-
+
<p>
This header field MAY be used for logging purposes and as a means for identifying the source of invalid or unwanted
requests.
@@ -149,17 +149,17 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
responsibility for the method performed.
In particular, robot agents SHOULD include this header so that the person responsible for running the robot can be
contacted if problems occur on the receiving end.
-
+
<p>
The Internet e-mail address in this field MAY be separate from the Internet host which issued the request.
For example, when a request is passed through a proxy the original issuer's address SHOULD be used.
-
+
<p>
The client SHOULD NOT send the From header field without the user's approval, as it might conflict with the user's
privacy interests or their site's security policy.
It is strongly recommended that the user be able to disable, enable, and modify the value of this field at any time
prior to a request.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderDate.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderDate.html b/content/site/apidocs/org/apache/juneau/http/HeaderDate.html
index 74d67ab..0b81bfc 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderDate.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderDate.html
@@ -115,13 +115,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderDate.html#line.35">HeaderDate</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a single HTTP-date.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidator.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidator.html b/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidator.html
index 0cc0674..a389308 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidator.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidator.html
@@ -111,13 +111,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderEntityValidator.html#line.33">HeaderEntityValidator</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a single entity validator value.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
ETag: "xyzzy"
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidatorArray.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidatorArray.html b/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidatorArray.html
index f15dc9d..83e0874 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidatorArray.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderEntityValidatorArray.html
@@ -115,7 +115,7 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderEntityValidatorArray.html#line.37">HeaderEntityValidatorArray</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a comma-delimited list of entity validator values.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
@@ -123,7 +123,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
If-Match: *
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderEnum.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderEnum.html b/content/site/apidocs/org/apache/juneau/http/HeaderEnum.html
index 6fb8e5e..153322c 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderEnum.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderEnum.html
@@ -119,13 +119,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderEnum.html#line.35">HeaderEnum</a><E extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang">Enum</a><E>>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a single enum value.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
Accept-Ranges: bytes
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -263,7 +263,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>asString</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/http/HeaderEnum.html#line.75">asString</a>()</pre>
<div class="block">Returns this header as a simple string value.
-
+
<p>
Functionally equivalent to calling <a href="../../../../org/apache/juneau/http/HeaderEnum.html#toString--"><code>toString()</code></a>.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderInteger.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderInteger.html b/content/site/apidocs/org/apache/juneau/http/HeaderInteger.html
index 2079428..8c4b001 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderInteger.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderInteger.html
@@ -115,13 +115,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderInteger.html#line.33">HeaderInteger</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a single integer value.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
Age: 300
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -231,7 +231,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>asInt</h4>
<pre>public int <a href="../../../../src-html/org/apache/juneau/http/HeaderInteger.html#line.63">asInt</a>()</pre>
<div class="block">Returns this header as a simple string value.
-
+
<p>
Functionally equivalent to calling <a href="../../../../org/apache/juneau/http/HeaderInteger.html#toString--"><code>toString()</code></a>.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderRangeArray.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderRangeArray.html b/content/site/apidocs/org/apache/juneau/http/HeaderRangeArray.html
index e6abddf..01687e0 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderRangeArray.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderRangeArray.html
@@ -115,13 +115,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderRangeArray.html#line.37">HeaderRangeArray</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of simple comma-delimited lists of strings with q-values.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
Accept-Encoding: compress;q=0.5, gzip;q=1.0
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -253,7 +253,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>asSimpleRanges</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../org/apache/juneau/http/StringRange.html" title="class in org.apache.juneau.http">StringRange</a>> <a href="../../../../src-html/org/apache/juneau/http/HeaderRangeArray.html#line.78">asSimpleRanges</a>()</pre>
<div class="block">Returns the list of the types ranges that make up this header.
-
+
<p>
The types ranges in the list are sorted by their q-value in descending order.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderString.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderString.html b/content/site/apidocs/org/apache/juneau/http/HeaderString.html
index 05c53ab..f214e83 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderString.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderString.html
@@ -115,13 +115,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderString.html#line.35">HeaderString</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a single string value.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
Accept-Ranges: bytes
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -275,7 +275,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>asString</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/http/HeaderString.html#line.76">asString</a>()</pre>
<div class="block">Returns this header as a simple string value.
-
+
<p>
Functionally equivalent to calling <a href="../../../../org/apache/juneau/http/HeaderString.html#toString--"><code>toString()</code></a>.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderStringArray.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderStringArray.html b/content/site/apidocs/org/apache/juneau/http/HeaderStringArray.html
index 0f4ee3e..b8844f6 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderStringArray.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderStringArray.html
@@ -115,13 +115,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderStringArray.html#line.35">HeaderStringArray</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a comma-delimited list of string values.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
Allow: GET, PUT
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -243,7 +243,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>asString</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/http/HeaderStringArray.html#line.56">asString</a>()</pre>
<div class="block">Returns this header as a simple string value.
-
+
<p>
Functionally equivalent to calling <a href="../../../../org/apache/juneau/http/HeaderStringArray.html#toString--"><code>toString()</code></a>.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HeaderUri.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HeaderUri.html b/content/site/apidocs/org/apache/juneau/http/HeaderUri.html
index 38c2719..53bd314 100644
--- a/content/site/apidocs/org/apache/juneau/http/HeaderUri.html
+++ b/content/site/apidocs/org/apache/juneau/http/HeaderUri.html
@@ -115,13 +115,13 @@ var activeTableTab = "activeTableTab";
<pre>public class <a href="../../../../src-html/org/apache/juneau/http/HeaderUri.html#line.37">HeaderUri</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Category of headers that consist of a single URL value.
-
+
<p>
<h6 class='figure'>Example</h6>
<p class='bcode'>
Location: http://www.w3.org/pub/WWW/People.html
</p>
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -251,7 +251,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
<h4>asString</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/http/HeaderUri.html#line.67">asString</a>()</pre>
<div class="block">Returns this header as a simple string value.
-
+
<p>
Functionally equivalent to calling <a href="../../../../org/apache/juneau/http/HeaderUri.html#toString--"><code>toString()</code></a>.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/Host.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/Host.html b/content/site/apidocs/org/apache/juneau/http/Host.html
index 1e90321..26ff577 100644
--- a/content/site/apidocs/org/apache/juneau/http/Host.html
+++ b/content/site/apidocs/org/apache/juneau/http/Host.html
@@ -116,31 +116,31 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/Host.html#line.72">Host</a>
extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="class in org.apache.juneau.http">HeaderString</a></pre>
<div class="block">Represents a parsed <l>Host</l> HTTP request header.
-
+
<p>
The domain name of the server (for virtual hosting), and the TCP port number on which the server is listening.
The port number may be omitted if the port is the standard port for the service requested.
Mandatory since HTTP/1.1.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Host: en.wikipedia.org:8080
Host: en.wikipedia.org
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Host request-header field specifies the Internet host and port number of the resource being requested, as
obtained from the original URI given by the user or referring resource (generally an HTTP URL, as described in
section 3.2.2).
The Host field value MUST represent the naming authority of the origin server or gateway given by the original URL.
This allows the origin server or gateway to differentiate between internally-ambiguous URLs, such as the root "/" URL
of a server for multiple host names on a single IP address.
-
+
<p class='bcode'>
Host = "Host" ":" host [ ":" port ] ; Section 3.2.2
</p>
-
+
<p>
A "host" without any trailing port information implies the default port for the service requested (e.g., "80" for an
HTTP URL).
@@ -149,7 +149,7 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
GET /pub/WWW/ HTTP/1.1
Host: www.w3.org
</p>
-
+
<p>
A client MUST include a Host header field in all HTTP/1.1 request messages.
If the requested URI does not include an Internet host name for the service being requested, then the Host header
@@ -158,10 +158,10 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
identifies the service being requested by the proxy.
All Internet-based HTTP/1.1 servers MUST respond with a 400 (Bad Request) status code to any HTTP/1.1 request
message which lacks a Host header field.
-
+
<p>
See sections 5.2 and 19.6.1.1 for other requirements relating to Host.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HttpMethod.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HttpMethod.html b/content/site/apidocs/org/apache/juneau/http/HttpMethod.html
index 25ac322..d525939 100644
--- a/content/site/apidocs/org/apache/juneau/http/HttpMethod.html
+++ b/content/site/apidocs/org/apache/juneau/http/HttpMethod.html
@@ -120,7 +120,7 @@ var activeTableTab = "activeTableTab";
<pre>public enum <a href="../../../../src-html/org/apache/juneau/http/HttpMethod.html#line.29">HttpMethod</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang">Enum</a><<a href="../../../../org/apache/juneau/http/HttpMethod.html" title="enum in org.apache.juneau.http">HttpMethod</a>></pre>
<div class="block">Represents valid HTTP 1.1 method names per the RFC 2616 spec.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -402,7 +402,7 @@ not permitted.)</div>
<h4>forString</h4>
<pre>public static <a href="../../../../org/apache/juneau/http/HttpMethod.html" title="enum in org.apache.juneau.http">HttpMethod</a> <a href="../../../../src-html/org/apache/juneau/http/HttpMethod.html#line.79">forString</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> key)</pre>
<div class="block">Returns the enum for the specified key.
-
+
<p>
Case is ignored.</div>
<dl>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/HttpMethodName.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/HttpMethodName.html b/content/site/apidocs/org/apache/juneau/http/HttpMethodName.html
index 88227b3..2c647c8 100644
--- a/content/site/apidocs/org/apache/juneau/http/HttpMethodName.html
+++ b/content/site/apidocs/org/apache/juneau/http/HttpMethodName.html
@@ -105,7 +105,7 @@
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/HttpMethodName.html#line.25">HttpMethodName</a>
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Represents valid HTTP 1.1 method name static strings per the RFC 2616 spec.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='extlink'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/IfMatch.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/IfMatch.html b/content/site/apidocs/org/apache/juneau/http/IfMatch.html
index d91906d..989638c 100644
--- a/content/site/apidocs/org/apache/juneau/http/IfMatch.html
+++ b/content/site/apidocs/org/apache/juneau/http/IfMatch.html
@@ -116,19 +116,19 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/IfMatch.html#line.94">IfMatch</a>
extends <a href="../../../../org/apache/juneau/http/HeaderEntityValidatorArray.html" title="class in org.apache.juneau.http">HeaderEntityValidatorArray</a></pre>
<div class="block">Represents a parsed <l>If-Match</l> HTTP request header.
-
+
<p>
Only perform the action if the client supplied entity matches the same entity on the server.
This is mainly for methods like PUT to only update a resource if it has not been modified since the user last
updated it.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
If-Match: "737060cd8c284d8af7ad3082f209582d"
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The If-Match request-header field is used with a method to make it conditional.
A client that has one or more entities previously obtained from the resource can verify that one of those entities
is current by including a list of their associated entity tags in the If-Match header field.
@@ -137,41 +137,41 @@ extends <a href="../../../../org/apache/juneau/http/HeaderEntityValidatorArray.h
overhead.
It is also used, on updating requests, to prevent inadvertent modification of the wrong version of a resource.
As a special case, the value "*" matches any current entity of the resource.
-
+
<p class='bcode'>
If-Match = "If-Match" ":" ( "*" | 1#entity-tag )
</p>
-
+
<p>
If any of the entity tags match the entity tag of the entity that would have been returned in the response to a
similar GET request (without the If-Match header) on that resource, or if "*" is given and any current entity exists
for that resource, then the server MAY perform the requested method as if the If-Match header field did not exist.
-
+
<p>
A server MUST use the strong comparison function (see section 13.3.3) to compare the entity tags in If-Match.
-
+
<p>
If none of the entity tags match, or if "*" is given and no current entity exists, the server MUST NOT perform the
requested method, and MUST return a 412 (Precondition Failed) response.
This behavior is most useful when the client wants to prevent an updating method, such as PUT, from modifying a
resource that has changed since the client last retrieved it.
-
+
<p>
If the request would, without the If-Match header field, result in anything other than a 2xx or 412 status, then the
If-Match header MUST be ignored.
-
+
<p>
The meaning of "If-Match: *" is that the method SHOULD be performed if the representation selected by the origin
server (or by a cache, possibly using the Vary mechanism, see section 14.44) exists, and MUST NOT be performed if the
representation does not exist.
-
+
<p>
A request intended to update a resource (e.g., a PUT) MAY include an If-Match header field to signal that the request
method MUST NOT be applied if the entity corresponding to the If-Match value (a single entity tag) is no longer a
representation of that resource.
This allows the user to indicate that they do not wish the request to be successful if the resource has been changed
without their knowledge.
-
+
<p>
Examples:
<p class='bcode'>
@@ -179,11 +179,11 @@ extends <a href="../../../../org/apache/juneau/http/HeaderEntityValidatorArray.h
If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
If-Match: *
</p>
-
+
<p>
The result of a request having both an If-Match header field and either an If-None-Match or an If-Modified-Since
header fields is undefined by this specification.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/IfModifiedSince.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/IfModifiedSince.html b/content/site/apidocs/org/apache/juneau/http/IfModifiedSince.html
index d188472..8454906 100644
--- a/content/site/apidocs/org/apache/juneau/http/IfModifiedSince.html
+++ b/content/site/apidocs/org/apache/juneau/http/IfModifiedSince.html
@@ -116,31 +116,31 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/IfModifiedSince.html#line.94">IfModifiedSince</a>
extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="class in org.apache.juneau.http">HeaderDate</a></pre>
<div class="block">Represents a parsed <l>If-Modified-Since</l> HTTP request header.
-
+
<p>
Allows a 304 Not Modified to be returned if content is unchanged.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The If-Modified-Since request-header field is used with a method to make it conditional:
if the requested variant has not been modified since the time specified in this field, an entity will not be returned
from the server; instead, a 304 (not modified) response will be returned without any message-body.
-
+
<p class='bcode'>
If-Modified-Since = "If-Modified-Since" ":" HTTP-date
</p>
-
+
<p>
An example of the field is:
<p class='bcode'>
If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT
</p>
-
+
<p>
A GET method with an If-Modified-Since header and no Range header requests that the identified entity be transferred
only if it has been modified since the date given by the If-Modified-Since header.
@@ -154,23 +154,23 @@ extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="clas
<li>If the variant has not been modified since a valid If-Modified-Since date, the server SHOULD return a 304
(Not Modified) response.
</ol>
-
+
<p>
The purpose of this feature is to allow efficient updates of cached information with a minimum amount of transaction
overhead.
-
+
<p>
Note: The Range request-header field modifies the meaning of If-Modified-Since; see section 14.35 for full details.
-
+
<p>
Note: If-Modified-Since times are interpreted by the server, whose clock might not be synchronized with the client.
-
+
<p>
Note: When handling an If-Modified-Since header field, some servers will use an exact date comparison function,
rather than a less-than function, for deciding whether to send a 304 (Not Modified) response.
To get best results when sending an If-Modified-Since header field for cache validation, clients are
advised to use the exact date string received in a previous Last-Modified header field whenever possible.
-
+
<p>
Note: If a client uses an arbitrary date in the If-Modified-Since header instead of a date taken from the
Last-Modified header for the same request, the client should be aware of the fact that this date is interpreted in
@@ -183,7 +183,7 @@ extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="clas
Corrections for different time bases between client and server are at best approximate due to network latency.
The result of a request having both an If-Modified-Since header field and either an If-Match or an
If-Unmodified-Since header fields is undefined by this specification.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/IfNoneMatch.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/IfNoneMatch.html b/content/site/apidocs/org/apache/juneau/http/IfNoneMatch.html
index a4fa859..4dadee0 100644
--- a/content/site/apidocs/org/apache/juneau/http/IfNoneMatch.html
+++ b/content/site/apidocs/org/apache/juneau/http/IfNoneMatch.html
@@ -116,17 +116,17 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/IfNoneMatch.html#line.97">IfNoneMatch</a>
extends <a href="../../../../org/apache/juneau/http/HeaderEntityValidatorArray.html" title="class in org.apache.juneau.http">HeaderEntityValidatorArray</a></pre>
<div class="block">Represents a parsed <l>If-None-Match</l> HTTP request header.
-
+
<p>
Allows a 304 Not Modified to be returned if content is unchanged.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
If-None-Match: "737060cd8c284d8af7ad3082f209582d"
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The If-None-Match request-header field is used with a method to make it conditional.
A client that has one or more entities previously obtained from the resource can verify that none of those entities
is current by including a list of their associated entity tags in the If-None-Match header field.
@@ -134,14 +134,14 @@ extends <a href="../../../../org/apache/juneau/http/HeaderEntityValidatorArray.h
overhead.
It is also used to prevent a method (e.g. PUT) from inadvertently modifying an existing resource when the client
believes that the resource does not exist.
-
+
<p>
As a special case, the value "*" matches any current entity of the resource.
-
+
<p class='bcode'>
If-None-Match = "If-None-Match" ":" ( "*" | 1#entity-tag )
</p>
-
+
<p>
If any of the entity tags match the entity tag of the entity that would have been returned in the response to a
similar GET request (without the If-None-Match header) on that resource, or if "*" is given
@@ -151,28 +151,28 @@ extends <a href="../../../../org/apache/juneau/http/HeaderEntityValidatorArray.h
Instead, if the request method was GET or HEAD, the server SHOULD respond with a 304 (Not Modified) response,
including the cache- related header fields (particularly ETag) of one of the entities that matched.
For all other request methods, the server MUST respond with a status of 412 (Precondition Failed).
-
+
<p>
See section 13.3.3 for rules on how to determine if two entities tags match.
The weak comparison function can only be used with GET or HEAD requests.
-
+
<p>
If none of the entity tags match, then the server MAY perform the requested method as if the If-None-Match header
field did not exist, but MUST also ignore any If-Modified-Since header field(s) in the request.
That is, if no entity tags match, then the server MUST NOT return a 304 (Not Modified) response.
-
+
<p>
If the request would, without the If-None-Match header field, result in anything other than a 2xx or 304 status,
then the If-None-Match header MUST be ignored.
(See section 13.3.4 for a discussion of server behavior when both If-Modified-Since and If-None-Match appear in the
same request.)
-
+
<p>
The meaning of "If-None-Match: *" is that the method MUST NOT be performed if the representation selected by the
origin server (or by a cache, possibly using the Vary mechanism, see section 14.44) exists, and SHOULD be performed
if the representation does not exist.
This feature is intended to be useful in preventing races between PUT operations.
-
+
<p>
Examples:
<p class='bcode'>
@@ -182,11 +182,11 @@ extends <a href="../../../../org/apache/juneau/http/HeaderEntityValidatorArray.h
If-None-Match: W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz"
If-None-Match: *
</p>
-
+
<p>
The result of a request having both an If-None-Match header field and either an If-Match or an If-Unmodified-Since
header fields is undefined by this specification.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/IfRange.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/IfRange.html b/content/site/apidocs/org/apache/juneau/http/IfRange.html
index a59d717..6685d3e 100644
--- a/content/site/apidocs/org/apache/juneau/http/IfRange.html
+++ b/content/site/apidocs/org/apache/juneau/http/IfRange.html
@@ -116,23 +116,23 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/IfRange.html#line.68">IfRange</a>
extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="class in org.apache.juneau.http">HeaderString</a></pre>
<div class="block">Represents a parsed <l>If-Range</l> HTTP request header.
-
+
<p>
If the entity is unchanged, send me the part(s) that I am missing; otherwise, send me the entire new entity.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
If-Range: "737060cd8c284d8af7ad3082f209582d"
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
If a client has a partial copy of an entity in its cache, and wishes to have an up-to-date copy of the entire entity
in its cache, it could use the Range request-header with a conditional GET (using either or both of
If-Unmodified-Since and If-Match.)
However, if the condition fails because the entity has been modified, the client would then have to make a second
request to obtain the entire current entity-body.
-
+
<p>
The If-Range header allows a client to "short-circuit" the second request.
Informally, its meaning is `if the entity is unchanged, send me the part(s) that I am missing; otherwise, send me
@@ -140,7 +140,7 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
<p class='bcode'>
If-Range = "If-Range" ":" ( entity-tag | HTTP-date )
</p>
-
+
<p>
If the client has no entity tag for an entity, but does have a Last- Modified date, it MAY use that date in an
If-Range header.
@@ -148,12 +148,12 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
characters.)
The If-Range header SHOULD only be used together with a Range header, and MUST be ignored if the request does not
include a Range header, or if the server does not support the sub-range operation.
-
+
<p>
If the entity tag given in the If-Range header matches the current entity tag for the entity, then the server SHOULD
provide the specified sub-range of the entity using a 206 (Partial content) response.
If the entity tag does not match, then the server SHOULD return the entire entity using a 200 (OK) response.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/IfUnmodifiedSince.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/IfUnmodifiedSince.html b/content/site/apidocs/org/apache/juneau/http/IfUnmodifiedSince.html
index 9f7e987..c0eccab 100644
--- a/content/site/apidocs/org/apache/juneau/http/IfUnmodifiedSince.html
+++ b/content/site/apidocs/org/apache/juneau/http/IfUnmodifiedSince.html
@@ -116,46 +116,46 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/IfUnmodifiedSince.html#line.66">IfUnmodifiedSince</a>
extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="class in org.apache.juneau.http">HeaderDate</a></pre>
<div class="block">Represents a parsed <l>If-Unmodified-Since</l> HTTP request header.
-
+
<p>
Only send the response if the entity has not been modified since a specific time.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The If-Unmodified-Since request-header field is used with a method to make it conditional.
If the requested resource has not been modified since the time specified in this field, the server SHOULD perform the
requested operation as if the If-Unmodified-Since header were not present.
-
+
<p>
If the requested variant has been modified since the specified time, the server MUST NOT perform the requested
operation, and MUST return a 412 (Precondition Failed).
-
+
<p class='bcode'>
If-Unmodified-Since = "If-Unmodified-Since" ":" HTTP-date
</p>
-
+
<p>
An example of the field is:
<p class='bcode'>
If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT
</p>
-
+
<p>
If the request normally (i.e., without the If-Unmodified-Since header) would result in anything other than a 2xx or
412 status, the If-Unmodified-Since header SHOULD be ignored.
-
+
<p>
If the specified date is invalid, the header is ignored.
-
+
<p>
The result of a request having both an If-Unmodified-Since header field and either an If-None-Match or an
If-Modified-Since header fields is undefined by this specification.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/LastModified.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/LastModified.html b/content/site/apidocs/org/apache/juneau/http/LastModified.html
index 9731c2b..c7deb45 100644
--- a/content/site/apidocs/org/apache/juneau/http/LastModified.html
+++ b/content/site/apidocs/org/apache/juneau/http/LastModified.html
@@ -116,30 +116,30 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/LastModified.html#line.73">LastModified</a>
extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="class in org.apache.juneau.http">HeaderDate</a></pre>
<div class="block">Represents a parsed <l>Last-Modified</l> HTTP response header.
-
+
<p>
The last modified date for the requested object (in "HTTP-date" format as defined by RFC 7231).
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Last-Modified entity-header field indicates the date and time at which the origin server believes the variant was
last modified.
-
+
<p class='bcode'>
Last-Modified = "Last-Modified" ":" HTTP-date
</p>
-
+
<p>
An example of its use is...
<p class='bcode'>
Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT
</p>
-
+
<p>
The exact meaning of this header field depends on the implementation of the origin server and the nature of the
original resource.
@@ -148,21 +148,21 @@ extends <a href="../../../../org/apache/juneau/http/HeaderDate.html" title="clas
component parts.
For database gateways, it may be the last-update time stamp of the record.
For virtual objects, it may be the last time the internal state changed.
-
+
<p>
An origin server MUST NOT send a Last-Modified date which is later than the server's time of message origination.
In such cases, where the resource's last modification would indicate some time in the future, the server MUST replace
that date with the message origination date.
-
+
<p>
An origin server SHOULD obtain the Last-Modified value of the entity as close as possible to the time that it
generates the Date value of its response.
This allows a recipient to make an accurate assessment of the entity's modification time, especially if the entity
changes near the time that the response is generated.
-
+
<p>
HTTP/1.1 servers SHOULD send Last-Modified whenever feasible.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/Location.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/Location.html b/content/site/apidocs/org/apache/juneau/http/Location.html
index 1cb8d43..79233bc 100644
--- a/content/site/apidocs/org/apache/juneau/http/Location.html
+++ b/content/site/apidocs/org/apache/juneau/http/Location.html
@@ -116,39 +116,39 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/Location.html#line.59">Location</a>
extends <a href="../../../../org/apache/juneau/http/HeaderUri.html" title="class in org.apache.juneau.http">HeaderUri</a></pre>
<div class="block">Represents a parsed <l>Location</l> HTTP response header.
-
+
<p>
Used in redirection, or when a new resource has been created.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Location: http://www.w3.org/pub/WWW/People.html
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Location response-header field is used to redirect the recipient to a location other than the Request-URI for
completion of the request or identification of a new resource.
For 201 (Created) responses, the Location is that of the new resource which was created by the request.
For 3xx responses, the location SHOULD indicate the server's preferred URI for automatic redirection to the resource.
The field value consists of a single absolute URI.
-
+
<p class='bcode'>
Location = "Location" ":" absoluteURI
</p>
-
+
<p>
An example is:
<p class='bcode'>
Location: http://www.w3.org/pub/WWW/People.html
</p>
-
+
<p>
Note: The Content-Location header field (section 14.14) differs from Location in that the Content-Location identifies
the original location of the entity enclosed in the request.
It is therefore possible for a response to contain header fields for both Location and Content-Location.
Also see section 13.10 for cache requirements of some methods.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/MaxForwards.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/MaxForwards.html b/content/site/apidocs/org/apache/juneau/http/MaxForwards.html
index e45d3d8..05dbbc1 100644
--- a/content/site/apidocs/org/apache/juneau/http/MaxForwards.html
+++ b/content/site/apidocs/org/apache/juneau/http/MaxForwards.html
@@ -116,30 +116,30 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/MaxForwards.html#line.62">MaxForwards</a>
extends <a href="../../../../org/apache/juneau/http/HeaderInteger.html" title="class in org.apache.juneau.http">HeaderInteger</a></pre>
<div class="block">Represents a parsed <l>Max-Forwards</l> HTTP request header.
-
+
<p>
Limit the number of times the message can be forwarded through proxies or gateways.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Max-Forwards: 10
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Max-Forwards request-header field provides a mechanism with the TRACE (section 9.8) and OPTIONS (section 9.2)
methods to limit the number of proxies or gateways that can forward the request to the next inbound server.
This can be useful when the client is attempting to trace a request chain which appears to be failing or looping in
mid-chain.
-
+
<p class='bcode'>
Max-Forwards = "Max-Forwards" ":" 1*DIGIT
</p>
-
+
<p>
The Max-Forwards value is a decimal integer indicating the remaining number of times this request message may be
forwarded.
-
+
<p>
Each proxy or gateway recipient of a TRACE or OPTIONS request containing a Max-Forwards header field MUST check and
update its value prior to forwarding the request.
@@ -147,11 +147,11 @@ extends <a href="../../../../org/apache/juneau/http/HeaderInteger.html" title="c
recipient.
If the received Max-Forwards value is greater than zero, then the forwarded message MUST contain an updated
Max-Forwards field with a value decremented by one (1).
-
+
<p>
The Max-Forwards header field MAY be ignored for all other methods defined by this specification and for any
extension methods for which it is not explicitly referred to as part of that method definition.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/MediaType.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/MediaType.html b/content/site/apidocs/org/apache/juneau/http/MediaType.html
index d80dce3..f83735b 100644
--- a/content/site/apidocs/org/apache/juneau/http/MediaType.html
+++ b/content/site/apidocs/org/apache/juneau/http/MediaType.html
@@ -122,7 +122,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a>></pre>
<div class="block">Describes a single media type used in content negotiation between an HTTP client and server, as described in
Section 14.1 and 14.7 of RFC2616 (the HTTP/1.1 specification).
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -500,7 +500,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<div class="block">Returns the media type for the specified string.
The same media type strings always return the same objects so that these objects
can be compared for equality using '=='.
-
+
<h5 class='section'>Notes:</h5>
<ul>
<li>
@@ -592,7 +592,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>getSubTypes</h4>
<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>> <a href="../../../../src-html/org/apache/juneau/http/MediaType.html#line.223">getSubTypes</a>()</pre>
<div class="block">Returns the subtypes broken down by fragments delimited by <js>"'"</js>.
-
+
<P>
For example, the media type <js>"text/foo+bar"</js> will return a list of
<code>[<js>'foo'</js>,<js>'bar'</js>]</code></div>
@@ -625,11 +625,11 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<pre>public final int <a href="../../../../src-html/org/apache/juneau/http/MediaType.html#line.278">match</a>(<a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> o,
boolean allowExtraSubTypes)</pre>
<div class="block">Returns a match metric against the specified media type where a larger number represents a better match.
-
+
<p>
This media type can contain <js>'*'</js> metacharacters.
<br>The comparison media type must not.
-
+
<ul>
<li>Exact matches (e.g. <js>"text/json"<js>/</js>"text/json"</js>) should match
better than meta-character matches (e.g. <js>"text/*"<js>/</js>"text/json"</js>)
@@ -644,7 +644,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
</ul>
More token matches should result in a higher match number.
</ul>
-
+
The formula is as follows for <code>type/subTypes</code>:
<ul>
<li>An exact match is <code>100,000</code>.
@@ -677,7 +677,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>getParameters</h4>
<pre>public final <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>>> <a href="../../../../src-html/org/apache/juneau/http/MediaType.html#line.333">getParameters</a>()</pre>
<div class="block">Returns the additional parameters on this media type.
-
+
<p>
For example, given the media type string <js>"text/html;level=1"</js>, will return a map
with the single entry <code>{level:[<js>'1'</js>]}</code>.</div>
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/MediaTypeRange.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/MediaTypeRange.html b/content/site/apidocs/org/apache/juneau/http/MediaTypeRange.html
index 496ae63..557b8ab 100644
--- a/content/site/apidocs/org/apache/juneau/http/MediaTypeRange.html
+++ b/content/site/apidocs/org/apache/juneau/http/MediaTypeRange.html
@@ -118,7 +118,7 @@ extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?
implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../../org/apache/juneau/http/MediaTypeRange.html" title="class in org.apache.juneau.http">MediaTypeRange</a>></pre>
<div class="block">Describes a single type used in content negotiation between an HTTP client and server, as described in
Section 14.1 and 14.7 of RFC2616 (the HTTP/1.1 specification).
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>
@@ -224,18 +224,18 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>parse</h4>
<pre>public static <a href="../../../../org/apache/juneau/http/MediaTypeRange.html" title="class in org.apache.juneau.http">MediaTypeRange</a>[] <a href="../../../../src-html/org/apache/juneau/http/MediaTypeRange.html#line.73">parse</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> value)</pre>
<div class="block">Parses an <code>Accept</code> header value into an array of media ranges.
-
+
<p>
The returned media ranges are sorted such that the most acceptable media is available at ordinal position
<js>'0'</js>, and the least acceptable at position n-1.
-
+
<p>
The syntax expected to be found in the referenced <code>value</code> complies with the syntax described in
RFC2616, Section 14.1, as described below:
<p class='bcode'>
Accept = "Accept" ":"
#( media-range [ accept-params ] )
-
+
media-range = ( "*\/*"
| ( type "/" "*" )
| ( type "/" subtype )
@@ -262,7 +262,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>getMediaType</h4>
<pre>public <a href="../../../../org/apache/juneau/http/MediaType.html" title="class in org.apache.juneau.http">MediaType</a> <a href="../../../../src-html/org/apache/juneau/http/MediaTypeRange.html#line.157">getMediaType</a>()</pre>
<div class="block">Returns the media type enclosed by this media range.
-
+
<h5 class='section'>Examples:</h5>
<ul>
<li><js>"text/html"</js>
@@ -283,10 +283,10 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>getQValue</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Float.html?is-external=true" title="class or interface in java.lang">Float</a> <a href="../../../../src-html/org/apache/juneau/http/MediaTypeRange.html#line.173">getQValue</a>()</pre>
<div class="block">Returns the <js>'q'</js> (quality) value for this type, as described in Section 3.9 of RFC2616.
-
+
<p>
The quality value is a float between <code>0.0</code> (unacceptable) and <code>1.0</code> (most acceptable).
-
+
<p>
If 'q' value doesn't make sense for the context (e.g. this range was extracted from a <js>"content-*"</js>
header, as opposed to <js>"accept-*"</js> header, its value will always be <js>"1"</js>.</div>
@@ -304,7 +304,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>getExtensions</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a><<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>>> <a href="../../../../src-html/org/apache/juneau/http/MediaTypeRange.html#line.185">getExtensions</a>()</pre>
<div class="block">Returns the optional set of custom extensions defined for this type.
-
+
<p>
Values are lowercase and never <jk>null</jk>.</div>
<dl>
@@ -321,7 +321,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>toString</h4>
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../src-html/org/apache/juneau/http/MediaTypeRange.html#line.198">toString</a>()</pre>
<div class="block">Provides a string representation of this media range, suitable for use as an <code>Accept</code> header value.
-
+
<p>
The literal text generated will be all lowercase.</div>
<dl>
@@ -373,7 +373,7 @@ implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparabl
<h4>compareTo</h4>
<pre>public int <a href="../../../../src-html/org/apache/juneau/http/MediaTypeRange.html#line.268">compareTo</a>(<a href="../../../../org/apache/juneau/http/MediaTypeRange.html" title="class in org.apache.juneau.http">MediaTypeRange</a> o)</pre>
<div class="block">Compares two MediaRanges for equality.
-
+
<p>
The values are first compared according to <code>qValue</code> values.
Should those values be equal, the <code>type</code> is then lexicographically compared (case-insensitive) in
http://git-wip-us.apache.org/repos/asf/juneau-website/blob/c319662c/content/site/apidocs/org/apache/juneau/http/Pragma.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/org/apache/juneau/http/Pragma.html b/content/site/apidocs/org/apache/juneau/http/Pragma.html
index 10e5e6f..9fad284 100644
--- a/content/site/apidocs/org/apache/juneau/http/Pragma.html
+++ b/content/site/apidocs/org/apache/juneau/http/Pragma.html
@@ -116,28 +116,28 @@ var activeTableTab = "activeTableTab";
<pre>public final class <a href="../../../../src-html/org/apache/juneau/http/Pragma.html#line.70">Pragma</a>
extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="class in org.apache.juneau.http">HeaderString</a></pre>
<div class="block">Represents a parsed <l>Pragma</l> HTTP request/response header.
-
+
<p>
Implementation-specific fields that may have various effects anywhere along the request-response chain.
-
+
<h6 class='figure'>Example</h6>
<p class='bcode'>
Pragma: no-cache
</p>
-
+
<h6 class='topic'>RFC2616 Specification</h6>
-
+
The Pragma general-header field is used to include implementation- specific directives that might apply to any
recipient along the request/response chain.
All pragma directives specify optional behavior from the viewpoint of the protocol; however, some systems MAY
require that behavior be consistent with the directives.
-
+
<p class='bcode'>
Pragma = "Pragma" ":" 1#pragma-directive
pragma-directive = "no-cache" | extension-pragma
extension-pragma = token [ "=" ( token | quoted-string ) ]
</p>
-
+
<p>
When the no-cache directive is present in a request message, an application SHOULD forward the request toward the
origin server even if it has a cached copy of what is being requested.
@@ -145,21 +145,21 @@ extends <a href="../../../../org/apache/juneau/http/HeaderString.html" title="cl
for backward compatibility with HTTP/1.0.
Clients SHOULD include both header fields when a no-cache request is sent to a server not known to be HTTP/1.1
compliant.
-
+
<p>
Pragma directives MUST be passed through by a proxy or gateway application, regardless of their significance to that
application, since the directives might be applicable to all recipients along the request/response chain.
It is not possible to specify a pragma for a specific recipient; however, any pragma directive not relevant to a
recipient SHOULD be ignored by that recipient.
-
+
<p>
HTTP/1.1 caches SHOULD treat "Pragma: no-cache" as if the client had sent "Cache-Control: no-cache".
No new Pragma directives will be defined in HTTP.
-
+
<p>
Note: because the meaning of "Pragma: no-cache as a response header field is not actually specified, it does not
provide a reliable replacement for "Cache-Control: no-cache" in a response.
-
+
<h6 class='topic'>Additional Information</h6>
<ul class='doctree'>
<li class='jp'>