content: /*
  * 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 gov2.nist.javax2.sip.header;
  
  import java.util.Locale;
  
  /**
  * ContentLanguage header
  * <pre>
  *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.
  *</pre>
  * @author M. Ranganathan
  * @version 1.2 $Revision: 1.8 $ $Date: 2009/07/17 18:57:29 $
  * @since 1.1
  */
  public class ContentLanguage
      extends SIPHeader
      implements javax2.sip.header.ContentLanguageHeader {
  
      /**
       * Comment for <code>serialVersionUID</code>
       */
      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 String encodeBody() {
          return this.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;
      }
  }
  