gov.nist.javax.sip.header.ContentLanguage Maven / Gradle / Ivy
/*
* Conditions Of Use
*
* This software was developed by employees of the National Institute of
* Standards and Technology (NIST), an agency of the Federal Government.
* Pursuant to title 15 Untied States Code Section 105, works of NIST
* employees are not subject to copyright protection in the United States
* and are considered to be in the public domain. As a result, a formal
* license is not needed to use the software.
*
* This software is provided by NIST as a service and is expressly
* provided "AS IS." NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
* OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
* AND DATA ACCURACY. NIST does not warrant or make any representations
* regarding the use of the software or the results thereof, including but
* not limited to the correctness, accuracy, reliability or usefulness of
* the software.
*
* Permission to use this software is contingent upon your acceptance
* of the terms of this agreement
*
* .
*
*/
/*******************************************************************************
* Product of NIST/ITL Advanced Networking Technologies Division (ANTD). *
*******************************************************************************/
package android.gov.nist.javax.sip.header;
import java.util.Locale;
/**
* ContentLanguage header
*
*Fielding, et al. Standards Track [Page 118]
*RFC 2616 HTTP/1.1 June 1999
*
* 14.12 Content-Language
*
* 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.
*
* @author M. Ranganathan
* @version 1.2 $Revision: 1.9 $ $Date: 2010-05-06 14:07:51 $
* @since 1.1
*/
public class ContentLanguage
extends SIPHeader
implements android.javax.sip.header.ContentLanguageHeader {
/**
* Comment for serialVersionUID
*/
private static final long serialVersionUID = -5195728427134181070L;
/** languageTag field.
*/
protected Locale locale;
public ContentLanguage() {
super(CONTENT_LANGUAGE);
}
/**
* Default constructor.
* @param languageTag String to set
*/
public ContentLanguage(String languageTag) {
super(CONTENT_LANGUAGE);
this.setLanguageTag( languageTag );
}
/**
* Canonical encoding of the value of the header.
* @return encoded body of header.
*/
public StringBuilder encodeBody(StringBuilder buffer) {
return buffer.append(getLanguageTag());
}
/** get the languageTag field.
* @return String
*/
public String getLanguageTag() {
// JvB: Need to take sub-tags into account
if ( "".equals(locale.getCountry())) {
return locale.getLanguage();
} else {
return locale.getLanguage() + '-' + locale.getCountry();
}
}
/** set the languageTag field
* @param languageTag -- language tag to set.
*/
public void setLanguageTag(String languageTag) {
final int slash = languageTag.indexOf('-');
if (slash>=0) {
this.locale = new Locale(languageTag.substring(0,slash), languageTag.substring(slash+1) );
} else {
this.locale = new Locale(languageTag);
}
}
/**
* Gets the language value of the ContentLanguageHeader.
*
*
*
* @return the Locale value of this ContentLanguageHeader
*
*/
public Locale getContentLanguage() {
return locale;
}
/**
* Sets the language parameter of this ContentLanguageHeader.
*
* @param language - the new Locale value of the language of
*
* ContentLanguageHeader
*
*/
public void setContentLanguage(Locale language) {
this.locale = language;
}
public Object clone() {
ContentLanguage retval = (ContentLanguage) super.clone();
if (this.locale != null)
retval.locale = (Locale) this.locale.clone();
return retval;
}
}