All Downloads are FREE. Search and download functionalities are using the official Maven repository.

android.gov.nist.javax.sip.header.ContentLanguage Maven / Gradle / Ivy

There is a newer version: 1.3.0-91
Show newest version
/*
* 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; } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy