/******************************************************************************* * Product of NIST/ITL Advanced Networking Technologies Division (ANTD). * *******************************************************************************/ package 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. ** @version JAIN-SIP-1.1 $Revision: 1.2 $ $Date: 2005/10/16 15:47:02 $ */ public class ContentLanguage extends SIPHeader implements 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 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 t) {
final int slash = t.indexOf('-');
if (slash>=0) {
this.locale = new Locale(t.substring(0,slash), t.substring(slash+1) );
} else {
this.locale = new Locale(t);
}
}
/**
* 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;
}
}
/*
* $Log: ContentLanguage.java,v $
* Revision 1.2 2005/10/16 15:47:02 jeroen
* fixed language sub tag handling
*
* Revision 1.1.1.1 2005/10/04 17:12:34 mranga
*
* Import
*
*
* Revision 1.5 2005/04/16 20:38:49 dmuresan
* Canonical clone() implementations for the GenericObject and GenericObjectList hierarchies
*
* Revision 1.4 2004/04/06 12:28:23 mranga
* Reviewed by: mranga
* changed locale to Locale.getDefault().getCountry()
* moved check for valid transaction state up in the stack so unfruitful responses
* are pruned early.
*
* Revision 1.3 2004/01/22 13:26:29 sverker
* Issue number:
* Obtained from:
* Submitted by: sverker
* Reviewed by: mranga
*
* Major reformat of code to conform with style guide. Resolved compiler and javadoc warnings. Added CVS tags.
*
* CVS: ----------------------------------------------------------------------
* CVS: Issue number:
* CVS: If this change addresses one or more issues,
* CVS: then enter the issue number(s) here.
* CVS: Obtained from:
* CVS: If this change has been taken from another system,
* CVS: then name the system in this line, otherwise delete it.
* CVS: Submitted by:
* CVS: If this code has been contributed to the project by someone else; i.e.,
* CVS: they sent us a patch or a set of diffs, then include their name/email
* CVS: address here. If this is your work then delete this line.
* CVS: Reviewed by:
* CVS: If we are doing pre-commit code reviews and someone else has
* CVS: reviewed your changes, include their name(s) here.
* CVS: If you have not had it reviewed then delete this line.
*
*/