org.apache.juneau.http

Class ContentLength

java.lang.Object

org.apache.juneau.http.HeaderInteger

org.apache.juneau.http.ContentLength

public final class ContentLength
extends HeaderInteger

Represents a parsed Content-Length HTTP request/response header.

The length of the response body in octets (8-bit bytes).

Example

Content-Length: 348

RFC2616 Specification

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.

Content-Length = "Content-Length" ":" 1*DIGIT

An example is...

Content-Length: 3495

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.

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.

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.

See Also:

• Hypertext Transfer Protocol -- HTTP/1.1

Method Summary

Modifier and Type	Method and Description
static ContentLength	forString(String value) Returns a parsed Content-Length header.

Methods inherited from class org.apache.juneau.http.HeaderInteger

asInt, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

forString

public static ContentLength forString(String value)

Returns a parsed Content-Length header.

Parameters:

value - The Content-Length header string.

Returns:

The parsed Content-Length header, or null if the string was null.