org.apache.juneau.http

Class ContentLength

java.lang.Object

org.apache.juneau.http.HeaderLong

org.apache.juneau.http.ContentLength

@Header(value="Content-Length")
public final class ContentLength
extends HeaderLong

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.

• Hypertext Transfer Protocol -- HTTP/1.1

Constructor Summary

Constructors

Constructor and Description
ContentLength(Long value) Constructor.

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.HeaderLong

asLong, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ContentLength

public ContentLength(Long value)

Constructor.

Parameters:

value - The value for this header.

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.