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 16:02:46 UTC
[18/32] juneau git commit: Javadoc updates.
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Date.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Date.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Date.java
index 3b5be3e..6334c58 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Date.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Date.java
@@ -14,30 +14,30 @@ package org.apache.juneau.http;
/**
* 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>
@@ -49,19 +49,19 @@ package org.apache.juneau.http;
* 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
@@ -69,7 +69,7 @@ package org.apache.juneau.http;
* 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'>
@@ -83,7 +83,7 @@ public final class Date extends HeaderDate {
/**
* Returns a parsed <code>Date</code> header.
- *
+ *
* @param value The <code>Date</code> header string.
* @return The parsed <code>Date</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ETag.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ETag.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ETag.java
index 23a41df..2c050c7 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ETag.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ETag.java
@@ -14,25 +14,25 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -40,7 +40,7 @@ package org.apache.juneau.http;
* ETag: W/"xyzzy"
* ETag: ""
* </p>
- *
+ *
* <h6 class='topic'>Additional Information</h6>
* <ul class='doctree'>
* <li class='jp'>
@@ -54,7 +54,7 @@ public final class ETag extends HeaderString {
/**
* Returns a parsed <code>ETag</code> header.
- *
+ *
* @param value The <code>ETag</code> header string.
* @return The parsed <code>ETag</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/EntityValidator.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/EntityValidator.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/EntityValidator.java
index e4a3439..72980a4 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/EntityValidator.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/EntityValidator.java
@@ -14,14 +14,14 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -38,7 +38,7 @@ public class EntityValidator {
/**
* Constructor.
- *
+ *
* @param value The validator string value.
*/
protected EntityValidator(String value) {
@@ -53,7 +53,7 @@ public class EntityValidator {
/**
* Returns the validator value stripped of quotes and weak tag.
- *
+ *
* @return The validator value.
*/
public String asString() {
@@ -62,7 +62,7 @@ public class EntityValidator {
/**
* Returns <jk>true</jk> if the weak flag is present in the value.
- *
+ *
* @return <jk>true</jk> if the weak flag is present in the value.
*/
public boolean isWeak() {
@@ -71,7 +71,7 @@ public class EntityValidator {
/**
* Returns <jk>true</jk> if the validator string value is <code>*</code>.
- *
+ *
* @return <jk>true</jk> if the validator string value is <code>*</code>.
*/
public boolean isAny() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expect.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expect.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expect.java
index 6fa204b..4976a6f 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expect.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expect.java
@@ -14,17 +14,17 @@ package org.apache.juneau.http;
/**
* 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
@@ -33,33 +33,33 @@ package org.apache.juneau.http;
* *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'>
@@ -73,7 +73,7 @@ public final class Expect extends HeaderString {
/**
* Returns a parsed <code>Expect</code> header.
- *
+ *
* @param value The <code>Expect</code> header string.
* @return The parsed <code>Expect</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expires.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expires.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expires.java
index cce726d..8116f5e 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expires.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Expires.java
@@ -14,63 +14,63 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -84,7 +84,7 @@ public final class Expires extends HeaderDate {
/**
* Returns a parsed <code>Expires</code> header.
- *
+ *
* @param value The <code>Expires</code> header string.
* @return The parsed <code>Expires</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/From.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/From.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/From.java
index 7a3706f..d261e0e 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/From.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/From.java
@@ -14,31 +14,31 @@ package org.apache.juneau.http;
/**
* 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.
@@ -47,17 +47,17 @@ package org.apache.juneau.http;
* 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'>
@@ -71,7 +71,7 @@ public final class From extends HeaderString {
/**
* Returns a parsed <code>From</code> header.
- *
+ *
* @param value The <code>From</code> header string.
* @return The parsed <code>From</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderDate.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderDate.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderDate.java
index 1a1ad66..d668bc2 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderDate.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderDate.java
@@ -16,13 +16,13 @@ import org.apache.juneau.internal.*;
/**
* 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'>
@@ -39,7 +39,7 @@ public class HeaderDate {
/**
* Constructor.
- *
+ *
* @param raw The raw header value.
*/
protected HeaderDate(String raw) {
@@ -49,7 +49,7 @@ public class HeaderDate {
/**
* Returns this header value as a {@link java.util.Date}.
- *
+ *
* @return This header value as a {@link java.util.Date}, or <jk>null</jk> if the header could not be parsed.
*/
public java.util.Date asDate() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidator.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidator.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidator.java
index d1b1cc4..91642da 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidator.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidator.java
@@ -14,13 +14,13 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -36,7 +36,7 @@ public class HeaderEntityValidator {
/**
* Constructor.
- *
+ *
* @param value The raw header value.
*/
protected HeaderEntityValidator(String value) {
@@ -45,7 +45,7 @@ public class HeaderEntityValidator {
/**
* Returns this header value as a {@link EntityValidator} object.
- *
+ *
* @return this header value as a {@link EntityValidator} object.
*/
public EntityValidator asValidator() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidatorArray.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidatorArray.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidatorArray.java
index b8675c1..05cc7b1 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidatorArray.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEntityValidatorArray.java
@@ -16,7 +16,7 @@ import org.apache.juneau.internal.*;
/**
* Category of headers that consist of a comma-delimited list of entity validator values.
- *
+ *
* <p>
* <h6 class='figure'>Example</h6>
* <p class='bcode'>
@@ -24,7 +24,7 @@ import org.apache.juneau.internal.*;
* If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
* If-Match: *
* </p>
- *
+ *
* <h6 class='topic'>Additional Information</h6>
* <ul class='doctree'>
* <li class='jp'>
@@ -40,7 +40,7 @@ public class HeaderEntityValidatorArray {
/**
* Constructor.
- *
+ *
* @param value The raw header value.
*/
protected HeaderEntityValidatorArray(String value) {
@@ -53,7 +53,7 @@ public class HeaderEntityValidatorArray {
/**
* Returns this header value as an array of {@link EntityValidator} objects.
- *
+ *
* @return this header value as an array of {@link EntityValidator} objects.
*/
public EntityValidator[] asValidators() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEnum.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEnum.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEnum.java
index 56a202f..0704f6e 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEnum.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderEnum.java
@@ -14,13 +14,13 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -29,7 +29,7 @@ package org.apache.juneau.http;
* <a class='doclink' href='https://www.w3.org/Protocols/rfc2616/rfc2616.html'>
* Hypertext Transfer Protocol -- HTTP/1.1</a>
* </ul>
- *
+ *
* @param <E> The enum type.
*/
public class HeaderEnum<E extends Enum<E>> {
@@ -39,7 +39,7 @@ public class HeaderEnum<E extends Enum<E>> {
/**
* Constructor.
- *
+ *
* @param value The raw header value.
* @param enumClass The enum class.
* @param def The default enum value if the value could not be parsed.
@@ -57,7 +57,7 @@ public class HeaderEnum<E extends Enum<E>> {
/**
* Returns <jk>true</jk> if the specified value is the same using {@link String#equalsIgnoreCase(String)}.
- *
+ *
* @return <jk>true</jk> if the specified value is the same.
*/
public E asEnum() {
@@ -66,10 +66,10 @@ public class HeaderEnum<E extends Enum<E>> {
/**
* Returns this header as a simple string value.
- *
+ *
* <p>
* Functionally equivalent to calling {@link #toString()}.
- *
+ *
* @return This header as a simple string.
*/
public String asString() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderInteger.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderInteger.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderInteger.java
index 2e58b32..5b1cf97 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderInteger.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderInteger.java
@@ -14,13 +14,13 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -36,7 +36,7 @@ public class HeaderInteger {
/**
* Constructor.
- *
+ *
* @param value The raw header value.
*/
protected HeaderInteger(String value) {
@@ -54,10 +54,10 @@ public class HeaderInteger {
/**
* Returns this header as a simple string value.
- *
+ *
* <p>
* Functionally equivalent to calling {@link #toString()}.
- *
+ *
* @return This header as a simple string.
*/
public int asInt() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderRangeArray.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderRangeArray.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderRangeArray.java
index 8567ca4..6e3f9c0 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderRangeArray.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderRangeArray.java
@@ -18,13 +18,13 @@ import org.apache.juneau.internal.*;
/**
* 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'>
@@ -41,7 +41,7 @@ public class HeaderRangeArray {
/**
* Constructor.
- *
+ *
* @param value The raw header value.
*/
protected HeaderRangeArray(String value) {
@@ -51,7 +51,7 @@ public class HeaderRangeArray {
/**
* Given a list of type values, returns the best match for this header.
- *
+ *
* @param types The types to match against.
* @return The index into the array of the best match, or <code>-1</code> if no suitable matches could be found.
*/
@@ -69,10 +69,10 @@ public class HeaderRangeArray {
/**
* 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.
- *
+ *
* @return An unmodifiable list of type ranges.
*/
public List<StringRange> asSimpleRanges() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderString.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderString.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderString.java
index 659300c..8efa2e1 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderString.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderString.java
@@ -16,13 +16,13 @@ import org.apache.juneau.internal.*;
/**
* 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'>
@@ -38,7 +38,7 @@ public class HeaderString {
/**
* Constructor.
- *
+ *
* @param value The raw header value.
*/
protected HeaderString(String value) {
@@ -47,7 +47,7 @@ public class HeaderString {
/**
* Returns <jk>true</jk> if the specified value is the same using {@link String#equalsIgnoreCase(String)}.
- *
+ *
* @param compare The value to compare against.
* @return <jk>true</jk> if the specified value is the same.
*/
@@ -57,7 +57,7 @@ public class HeaderString {
/**
* Returns <jk>true</jk> if the specified value is the same using {@link String#equals(Object)}.
- *
+ *
* @param compare The value to compare against.
* @return <jk>true</jk> if the specified value is the same.
*/
@@ -67,10 +67,10 @@ public class HeaderString {
/**
* Returns this header as a simple string value.
- *
+ *
* <p>
* Functionally equivalent to calling {@link #toString()}.
- *
+ *
* @return This header as a simple string.
*/
public String asString() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderStringArray.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderStringArray.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderStringArray.java
index ca07d3c..99fb5bf 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderStringArray.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderStringArray.java
@@ -16,13 +16,13 @@ import org.apache.juneau.internal.*;
/**
* 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'>
@@ -38,7 +38,7 @@ public class HeaderStringArray {
/**
* Constructor.
- *
+ *
* @param value The raw header value.
*/
protected HeaderStringArray(String value) {
@@ -47,10 +47,10 @@ public class HeaderStringArray {
/**
* Returns this header as a simple string value.
- *
+ *
* <p>
* Functionally equivalent to calling {@link #toString()}.
- *
+ *
* @return This header as a simple string.
*/
public String asString() {
@@ -59,7 +59,7 @@ public class HeaderStringArray {
/**
* Returns <jk>true</jk> if this header contains the specified value.
- *
+ *
* @param val The value to check for.
* @return <jk>true</jk> if this header contains the specified value.
*/
@@ -73,7 +73,7 @@ public class HeaderStringArray {
/**
* Returns <jk>true</jk> if this header contains the specified value using {@link String#equalsIgnoreCase(String)}.
- *
+ *
* @param val The value to check for.
* @return <jk>true</jk> if this header contains the specified value.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderUri.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderUri.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderUri.java
index feae45d..106fa27 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderUri.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HeaderUri.java
@@ -18,13 +18,13 @@ import org.apache.juneau.internal.*;
/**
* 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'>
@@ -40,7 +40,7 @@ public class HeaderUri{
/**
* Constructor.
- *
+ *
* @param value The raw header value.
*/
protected HeaderUri(String value) {
@@ -49,7 +49,7 @@ public class HeaderUri{
/**
* Returns this header as a {@link URI}.
- *
+ *
* @return This header as a {@link URI}.
*/
public URI asURI() {
@@ -58,10 +58,10 @@ public class HeaderUri{
/**
* Returns this header as a simple string value.
- *
+ *
* <p>
* Functionally equivalent to calling {@link #toString()}.
- *
+ *
* @return This header as a simple string.
*/
public String asString() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Host.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Host.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Host.java
index cc548da..f3e058e 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Host.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Host.java
@@ -14,31 +14,31 @@ package org.apache.juneau.http;
/**
* 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).
@@ -47,7 +47,7 @@ package org.apache.juneau.http;
* 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
@@ -56,10 +56,10 @@ package org.apache.juneau.http;
* 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'>
@@ -73,7 +73,7 @@ public final class Host extends HeaderString {
/**
* Returns a parsed <code>Host</code> header.
- *
+ *
* @param value The <code>Host</code> header string.
* @return The parsed <code>Host</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethod.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethod.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethod.java
index 285a698..1fc3335 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethod.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethod.java
@@ -16,7 +16,7 @@ import java.util.*;
/**
* Represents valid HTTP 1.1 method names per the RFC 2616 spec.
- *
+ *
* <h6 class='topic'>Additional Information</h6>
* <ul class='doctree'>
* <li class='jp'>
@@ -69,10 +69,10 @@ public enum HttpMethod {
/**
* Returns the enum for the specified key.
- *
+ *
* <p>
* Case is ignored.
- *
+ *
* @param key The HTTP method name.
* @return The HttpMethod enum, or {@link #OTHER} if it's not a standard method name.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethodName.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethodName.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethodName.java
index 73f64df..6eff6fc 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethodName.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/HttpMethodName.java
@@ -14,7 +14,7 @@ package org.apache.juneau.http;
/**
* 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/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfMatch.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfMatch.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfMatch.java
index a2d5b02..a466dda 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfMatch.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfMatch.java
@@ -14,19 +14,19 @@ package org.apache.juneau.http;
/**
* 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.
@@ -35,41 +35,41 @@ package org.apache.juneau.http;
* 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'>
@@ -77,11 +77,11 @@ package org.apache.juneau.http;
* 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'>
@@ -95,7 +95,7 @@ public final class IfMatch extends HeaderEntityValidatorArray {
/**
* Returns a parsed <code>If-Match</code> header.
- *
+ *
* @param value The <code>If-Match</code> header string.
* @return The parsed <code>If-Match</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfModifiedSince.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfModifiedSince.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfModifiedSince.java
index 5deef37..8261ea2 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfModifiedSince.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfModifiedSince.java
@@ -14,31 +14,31 @@ package org.apache.juneau.http;
/**
* 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.
@@ -52,23 +52,23 @@ package org.apache.juneau.http;
* <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
@@ -81,7 +81,7 @@ package org.apache.juneau.http;
* 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'>
@@ -95,7 +95,7 @@ public final class IfModifiedSince extends HeaderDate {
/**
* Returns a parsed <code>If-Modified-Since</code> header.
- *
+ *
* @param value The <code>If-Modified-Since</code> header string.
* @return The parsed <code>If-Modified-Since</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfNoneMatch.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfNoneMatch.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfNoneMatch.java
index 81c00fa..8ee1c06 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfNoneMatch.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfNoneMatch.java
@@ -14,17 +14,17 @@ package org.apache.juneau.http;
/**
* 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.
@@ -32,14 +32,14 @@ package org.apache.juneau.http;
* 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
@@ -49,28 +49,28 @@ package org.apache.juneau.http;
* 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'>
@@ -80,11 +80,11 @@ package org.apache.juneau.http;
* 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'>
@@ -98,7 +98,7 @@ public final class IfNoneMatch extends HeaderEntityValidatorArray {
/**
* Returns a parsed <code>If-None-Match</code> header.
- *
+ *
* @param value The <code>If-None-Match</code> header string.
* @return The parsed <code>If-None-Match</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfRange.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfRange.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfRange.java
index b941b2b..c5bf5be 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfRange.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfRange.java
@@ -18,23 +18,23 @@ import org.apache.juneau.internal.*;
/**
* 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
@@ -42,7 +42,7 @@ import org.apache.juneau.internal.*;
* <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.
@@ -50,12 +50,12 @@ import org.apache.juneau.internal.*;
* 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'>
@@ -69,7 +69,7 @@ public final class IfRange extends HeaderString {
/**
* Returns a parsed <code>If-Range</code> header.
- *
+ *
* @param value The <code>If-Range</code> header string.
* @return The parsed <code>If-Range</code> header, or <jk>null</jk> if the string was null.
*/
@@ -85,7 +85,7 @@ public final class IfRange extends HeaderString {
/**
* Returns this header value as a {@link java.util.Date} object.
- *
+ *
* @return This header value as a {@link java.util.Date} object, or <jk>null</jk> if the value is not a date.
*/
public java.util.Date asDate() {
@@ -97,7 +97,7 @@ public final class IfRange extends HeaderString {
/**
* Returns this header value as an {@link EntityValidator} object.
- *
+ *
* @return
* This header value as a {@link EntityValidator} object, or <jk>null</jk> if the value is not an entity
* validator.
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfUnmodifiedSince.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfUnmodifiedSince.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfUnmodifiedSince.java
index 5d1f74f..b6c2428 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfUnmodifiedSince.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/IfUnmodifiedSince.java
@@ -14,46 +14,46 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -67,7 +67,7 @@ public final class IfUnmodifiedSince extends HeaderDate {
/**
* Returns a parsed <code>If-Unmodified-Since</code> header.
- *
+ *
* @param value The <code>If-Unmodified-Since</code> header string.
* @return The parsed <code>If-Unmodified-Since</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/LastModified.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/LastModified.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/LastModified.java
index 94d543a..796e078 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/LastModified.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/LastModified.java
@@ -14,30 +14,30 @@ package org.apache.juneau.http;
/**
* 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.
@@ -46,21 +46,21 @@ package org.apache.juneau.http;
* 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'>
@@ -74,7 +74,7 @@ public final class LastModified extends HeaderDate {
/**
* Returns a parsed <code>Last-Modified</code> header.
- *
+ *
* @param value The <code>Last-Modified</code> header string.
* @return The parsed <code>Last-Modified</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Location.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Location.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Location.java
index 8734aaf..33b46a9 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Location.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Location.java
@@ -14,39 +14,39 @@ package org.apache.juneau.http;
/**
* 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'>
@@ -60,7 +60,7 @@ public final class Location extends HeaderUri {
/**
* Returns a parsed <code>Location</code> header.
- *
+ *
* @param value The <code>Location</code> header string.
* @return The parsed <code>Location</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MaxForwards.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MaxForwards.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MaxForwards.java
index fa8dc07..3fd3ecb 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MaxForwards.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MaxForwards.java
@@ -14,30 +14,30 @@ package org.apache.juneau.http;
/**
* 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.
@@ -45,11 +45,11 @@ package org.apache.juneau.http;
* 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'>
@@ -63,7 +63,7 @@ public final class MaxForwards extends HeaderInteger {
/**
* Returns a parsed <code>Max-Forwards</code> header.
- *
+ *
* @param value The <code>Max-Forwards</code> header string.
* @return The parsed <code>Max-Forwards</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaType.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaType.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaType.java
index c4a6c92..8e1ca2a 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaType.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaType.java
@@ -25,7 +25,7 @@ import org.apache.juneau.json.*;
/**
* 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'>
@@ -74,7 +74,7 @@ public class MediaType implements Comparable<MediaType> {
* 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>
@@ -85,7 +85,7 @@ public class MediaType implements Comparable<MediaType> {
* <li>
* Anything including and following the <js>';'</js> character is ignored (e.g. <js>";charset=X"</js>).
* </ul>
- *
+ *
* @param s
* The media type string.
* Will be lowercased.
@@ -108,7 +108,7 @@ public class MediaType implements Comparable<MediaType> {
/**
* Same as {@link #forString(String)} but allows you to construct an array of <code>MediaTypes</code> from an
* array of strings.
- *
+ *
* @param s
* The media type strings.
* @return
@@ -179,7 +179,7 @@ public class MediaType implements Comparable<MediaType> {
/**
* Returns the <js>'type'</js> fragment of the <js>'type/subType'</js> string.
- *
+ *
* @return The media type.
*/
public final String getType() {
@@ -188,7 +188,7 @@ public class MediaType implements Comparable<MediaType> {
/**
* Returns the <js>'subType'</js> fragment of the <js>'type/subType'</js> string.
- *
+ *
* @return The media subtype.
*/
public final String getSubType() {
@@ -197,7 +197,7 @@ public class MediaType implements Comparable<MediaType> {
/**
* Returns <jk>true</jk> if the subtype contains the specified <js>'+'</js> delimited subtype value.
- *
+ *
* @param st
* The subtype string.
* Case is ignored.
@@ -213,11 +213,11 @@ public class MediaType implements Comparable<MediaType> {
/**
* 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>
- *
+ *
* @return An unmodifiable list of subtype fragments. Never <jk>null</jk>.
*/
public final List<String> getSubTypes() {
@@ -226,7 +226,7 @@ public class MediaType implements Comparable<MediaType> {
/**
* Returns <jk>true</jk> if this media type contains the <js>'*'</js> meta character.
- *
+ *
* @return <jk>true</jk> if this media type contains the <js>'*'</js> meta character.
*/
public final boolean isMeta() {
@@ -235,11 +235,11 @@ public class MediaType implements Comparable<MediaType> {
/**
* 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>)
@@ -254,7 +254,7 @@ public class MediaType implements Comparable<MediaType> {
* </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>.
@@ -270,7 +270,7 @@ public class MediaType implements Comparable<MediaType> {
* <li><code>10</code> for a subtype entry meta match (e.g. <js>"*"</js>/<js>"json"</js> or <js>"json+*"</js>/<js>"json+foo"</js>)
* </ul>
* </ul>
- *
+ *
* @param o The media type to compare with.
* @param allowExtraSubTypes If <jk>true</jk>,
* @return <jk>true</jk> if the media types match.
@@ -323,11 +323,11 @@ public class MediaType implements Comparable<MediaType> {
/**
* 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>.
- *
+ *
* @return The map of additional parameters, or an empty map if there are no parameters.
*/
public final Map<String,Set<String>> getParameters() {
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaTypeRange.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaTypeRange.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaTypeRange.java
index 18e6971..98bf611 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaTypeRange.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/MediaTypeRange.java
@@ -21,7 +21,7 @@ import org.apache.juneau.internal.*;
/**
* 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'>
@@ -42,18 +42,18 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* 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 )
@@ -61,7 +61,7 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
* accept-params = ";" "q" "=" qvalue *( accept-extension )
* accept-extension = ";" token [ "=" ( token | quoted-string ) ]
* </p>
- *
+ *
* @param value
* The value to parse.
* If <jk>null</jk> or empty, returns a single <code>MediaTypeRange</code> is returned that represents all types.
@@ -144,14 +144,14 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* Returns the media type enclosed by this media range.
- *
+ *
* <h5 class='section'>Examples:</h5>
* <ul>
* <li><js>"text/html"</js>
* <li><js>"text/*"</js>
* <li><js>"*\/*"</js>
* </ul>
- *
+ *
* @return The media type of this media range, lowercased, never <jk>null</jk>.
*/
public MediaType getMediaType() {
@@ -160,14 +160,14 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* 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>.
- *
+ *
* @return The 'q' value for this type, never <jk>null</jk>.
*/
public Float getQValue() {
@@ -176,10 +176,10 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* Returns the optional set of custom extensions defined for this type.
- *
+ *
* <p>
* Values are lowercase and never <jk>null</jk>.
- *
+ *
* @return The optional list of extensions, never <jk>null</jk>.
*/
public Map<String,Set<String>> getExtensions() {
@@ -188,10 +188,10 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* 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.
- *
+ *
* @return A media range suitable for use as an Accept header value, never <code>null</code>.
*/
@Override /* Object */
@@ -222,7 +222,7 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* Returns <jk>true</jk> if the specified object is also a <code>MediaType</code>, and has the same qValue, type,
* parameters, and extensions.
- *
+ *
* @return <jk>true</jk> if object is equivalent.
*/
@Override /* Object */
@@ -242,7 +242,7 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* Returns a hash based on this instance's <code>media-type</code>.
- *
+ *
* @return A hash based on this instance's <code>media-type</code>.
*/
@Override /* Object */
@@ -252,7 +252,7 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
/**
* 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
@@ -261,7 +261,7 @@ public final class MediaTypeRange implements Comparable<MediaTypeRange> {
* promoted over the 'wildcard' subtype.
* <code>MediaRanges</code> with the same types but with extensions are promoted over those same types with no
* extensions.
- *
+ *
* @param o The range to compare to. Never <jk>null</jk>.
*/
@Override /* Comparable */
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Pragma.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Pragma.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Pragma.java
index e95b1cc..bc1c682 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Pragma.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Pragma.java
@@ -14,28 +14,28 @@ package org.apache.juneau.http;
/**
* 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.
@@ -43,21 +43,21 @@ package org.apache.juneau.http;
* 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'>
@@ -71,7 +71,7 @@ public final class Pragma extends HeaderString {
/**
* Returns a parsed <code>Pragma</code> header.
- *
+ *
* @param value The <code>Pragma</code> header string.
* @return The parsed <code>Pragma</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthenticate.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthenticate.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthenticate.java
index fc5da1c..91c28fa 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthenticate.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthenticate.java
@@ -14,33 +14,33 @@ package org.apache.juneau.http;
/**
* Represents a parsed <l> Proxy-Authenticate</l> HTTP response header.
- *
+ *
* <p>
* Request authentication to access the proxy.
- *
+ *
* <h6 class='figure'>Example</h6>
* <p class='bcode'>
* Proxy-Authenticate: Basic
* </p>
- *
+ *
* <h6 class='topic'>RFC2616 Specification</h6>
- *
+ *
* The Proxy-Authenticate response-header field MUST be included as part of a 407 (Proxy Authentication Required)
* response.
* The field value consists of a challenge that indicates the authentication scheme and parameters applicable to the
* proxy for this Request-URI.
- *
+ *
* <p class='bcode'>
* Proxy-Authenticate = "Proxy-Authenticate" ":" 1#challenge
* </p>
- *
+ *
* <p>
* The HTTP access authentication process is described in "HTTP Authentication: Basic and Digest Access Authentication".
* Unlike WWW-Authenticate, the Proxy-Authenticate header field applies only to the current connection and SHOULD NOT
* be passed on to downstream clients.
* However, an intermediate proxy might need to obtain its own credentials by requesting them from the downstream
* client, which in some circumstances will appear as if the proxy is forwarding the Proxy-Authenticate header field.
- *
+ *
* <h6 class='topic'>Additional Information</h6>
* <ul class='doctree'>
* <li class='jp'>
@@ -54,7 +54,7 @@ public final class ProxyAuthenticate extends HeaderString {
/**
* Returns a parsed <code>Proxy-Authenticate</code> header.
- *
+ *
* @param value The <code>Proxy-Authenticate</code> header string.
* @return The parsed <code>Proxy-Authenticate</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthorization.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthorization.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthorization.java
index f6bb7ab..cf80d43 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthorization.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/ProxyAuthorization.java
@@ -14,26 +14,26 @@ package org.apache.juneau.http;
/**
* Represents a parsed <l>Proxy-Authorization</l> HTTP request header.
- *
+ *
* <p>
* Authorization credentials for connecting to a proxy.
- *
+ *
* <h6 class='figure'>Example</h6>
* <p class='bcode'>
* Proxy-Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
* </p>
- *
+ *
* <h6 class='topic'>RFC2616 Specification</h6>
- *
+ *
* The Proxy-Authorization request-header field allows the client to identify itself (or its user) to a proxy which
* requires authentication.
* The Proxy-Authorization field value consists of credentials containing the authentication information of the user
* agent for the proxy and/or realm of the resource being requested.
- *
+ *
* <p class='bcode'>
* Proxy-Authorization = "Proxy-Authorization" ":" credentials
* </p>
- *
+ *
* <p>
* The HTTP access authentication process is described in "HTTP Authentication: Basic and Digest Access Authentication".
* Unlike Authorization, the Proxy-Authorization header field applies only to the next outbound proxy that demanded
@@ -42,7 +42,7 @@ package org.apache.juneau.http;
* proxy that was expecting to receive credentials.
* A proxy MAY relay the credentials from the client request to the next proxy if that is the mechanism by which the
* proxies cooperatively authenticate a given request.
- *
+ *
* <h6 class='topic'>Additional Information</h6>
* <ul class='doctree'>
* <li class='jp'>
@@ -56,7 +56,7 @@ public final class ProxyAuthorization extends HeaderString {
/**
* Returns a parsed <code>Proxy-Authorization</code> header.
- *
+ *
* @param value The <code>Proxy-Authorization</code> header string.
* @return The parsed <code>Proxy-Authorization</code> header, or <jk>null</jk> if the string was null.
*/
http://git-wip-us.apache.org/repos/asf/juneau/blob/5686b8d6/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Range.java
----------------------------------------------------------------------
diff --git a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Range.java b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Range.java
index 2c105fe..b1916b1 100644
--- a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Range.java
+++ b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/http/Range.java
@@ -14,25 +14,25 @@ package org.apache.juneau.http;
/**
* Represents a parsed <l>Range</l> HTTP request header.
- *
+ *
* <p>
* Request only part of an entity. Bytes are numbered from 0.
- *
+ *
* <h6 class='figure'>Example</h6>
* <p class='bcode'>
* Range: bytes=500-999
* </p>
- *
+ *
* <h6 class='topic'>RFC2616 Specification</h6>
- *
+ *
* Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is
* meaningful for any HTTP entity.
* (However, not all clients and servers need to support byte- range operations.)
- *
+ *
* <p>
* Byte range specifications in HTTP apply to the sequence of bytes in the entity-body (not necessarily the same as the
* message-body).
- *
+ *
* <p>
* A byte range operation MAY specify a single range of bytes, or a set of ranges within a single entity.
* <p class='bcode'>
@@ -43,23 +43,23 @@ package org.apache.juneau.http;
* first-byte-pos = 1*DIGIT
* last-byte-pos = 1*DIGIT
* </p>
- *
+ *
* <p>
* The first-byte-pos value in a byte-range-spec gives the byte-offset of the first byte in a range.
* The last-byte-pos value gives the byte-offset of the last byte in the range; that is, the byte positions specified
* are inclusive.
* Byte offsets start at zero.
- *
+ *
* <p>
* If the last-byte-pos value is present, it MUST be greater than or equal to the first-byte-pos in that
* byte-range-spec, or the byte- range-spec is syntactically invalid.
* The recipient of a byte-range- set that includes one or more syntactically invalid byte-range-spec values MUST
* ignore the header field that includes that byte-range-set.
- *
+ *
* <p>
* If the last-byte-pos value is absent, or if the value is greater than or equal to the current length of the
* entity-body, last-byte-pos is taken to be equal to one less than the current length of the entity-body in bytes.
- *
+ *
* <p>
* By its choice of last-byte-pos, a client can limit the number of bytes retrieved without knowing the size of the
* entity.
@@ -67,13 +67,13 @@ package org.apache.juneau.http;
* suffix-byte-range-spec = "-" suffix-length
* suffix-length = 1*DIGIT
* </p>
- *
+ *
* <p>
* A suffix-byte-range-spec is used to specify the suffix of the entity-body, of a length given by the suffix-length
* value.
* (That is, this form specifies the last N bytes of an entity-body.)
* If the entity is shorter than the specified suffix-length, the entire entity-body is used.
- *
+ *
* <p>
* If a syntactically valid byte-range-set includes at least one byte- range-spec whose first-byte-pos is less than the
* current length of the entity-body, or at least one suffix-byte-range-spec with a non-zero suffix-length, then the
@@ -83,7 +83,7 @@ package org.apache.juneau.http;
* not satisfiable).
* Otherwise, the server SHOULD return a response with a status of 206 (Partial Content) containing the satisfiable
* ranges of the entity-body.
- *
+ *
* <p>
* Examples of byte-ranges-specifier values (assuming an entity-body of length 10000):
* <p class='bcode'>
@@ -96,22 +96,22 @@ package org.apache.juneau.http;
* bytes=500-600,601-999
* bytes=500-700,601-999
* </p>
- *
+ *
* <p>
* HTTP retrieval requests using conditional or unconditional GET methods MAY request one or more sub-ranges of the
* entity, instead of the entire entity, using the Range request header, which applies to the entity returned as the
* result of the request:
- *
+ *
* <p class='bcode'>
* Range = "Range" ":" ranges-specifier
* </p>
- *
+ *
* <p>
* A server MAY ignore the Range header.
* However, HTTP/1.1 origin servers and intermediate caches ought to support byte ranges when possible, since Range
* supports efficient recovery from partially failed transfers, and supports efficient partial retrieval of large
* entities.
- *
+ *
* <p>
* If the server supports the Range header and the specified range or ranges are appropriate for the entity:
* <ul>
@@ -123,16 +123,16 @@ package org.apache.juneau.http;
* otherwise successful and the condition is true. It does not affect the 304 (Not Modified) response returned if
* the conditional is false.
* </ul>
- *
+ *
* <p>
* In some cases, it might be more appropriate to use the If-Range header (see section 14.27) in addition to the Range
* header.
- *
+ *
* <p>
* If a proxy that supports ranges receives a Range request, forwards the request to an inbound server, and receives an
* entire entity in reply, it SHOULD only return the requested range to its client.
* It SHOULD store the entire received response in its cache if that is consistent with its cache allocation policies.
- *
+ *
* <h6 class='topic'>Additional Information</h6>
* <ul class='doctree'>
* <li class='jp'>
@@ -146,7 +146,7 @@ public final class Range extends HeaderString {
/**
* Returns a parsed <code>Range</code> header.
- *
+ *
* @param value The <code>Range</code> header string.
* @return The parsed <code>Range</code> header, or <jk>null</jk> if the string was null.
*/