org.apache.juneau.http

Class ContentLanguage

java.lang.Object

org.apache.juneau.http.HeaderStringArray

org.apache.juneau.http.ContentLanguage

@Header(value="Content-Language")
public final class ContentLanguage
extends HeaderStringArray

Represents a parsed Content-Language HTTP response header.

The natural language or languages of the intended audience for the enclosed content.

Example

Content-Language: da

RFC2616 Specification

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.

Content-Language = "Content-Language" ":" 1#language-tag

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 user's own preferred language. Thus, if the body content is intended only for a Danish-literate audience, the appropriate field is...

Content-Language: da

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.

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 versions, would call for...

Content-Language: mi, en

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

Content-Language MAY be applied to any media type -- it is not limited to textual documents.

• Hypertext Transfer Protocol -- HTTP/1.1

Constructor Summary

Constructors

Constructor and Description
ContentLanguage(String[] value) Constructor.

Method Summary

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

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

asString, contains, containsIC, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ContentLanguage

public ContentLanguage(String[] value)

Constructor.

Parameters:

value - The value for this header.

Method Detail

forString

public static ContentLanguage forString(String value)

Returns a parsed Content-Language header.

Parameters:

value - The Content-Language header string.

Returns:

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