Example 1 with LanguageTag
use of sun.util.locale.LanguageTag in project jdk8u_jdk by JetBrains.
the class Locale method forLanguageTag.
/**
* Returns a locale for the specified IETF BCP 47 language tag string.
*
* <p>If the specified language tag contains any ill-formed subtags,
* the first such subtag and all following subtags are ignored. Compare
* to {@link Locale.Builder#setLanguageTag} which throws an exception
* in this case.
*
* <p>The following <b>conversions</b> are performed:<ul>
*
* <li>The language code "und" is mapped to language "".
*
* <li>The language codes "he", "yi", and "id" are mapped to "iw",
* "ji", and "in" respectively. (This is the same canonicalization
* that's done in Locale's constructors.)
*
* <li>The portion of a private use subtag prefixed by "lvariant",
* if any, is removed and appended to the variant field in the
* result locale (without case normalization). If it is then
* empty, the private use subtag is discarded:
*
* <pre>
* Locale loc;
* loc = Locale.forLanguageTag("en-US-x-lvariant-POSIX");
* loc.getVariant(); // returns "POSIX"
* loc.getExtension('x'); // returns null
*
* loc = Locale.forLanguageTag("de-POSIX-x-URP-lvariant-Abc-Def");
* loc.getVariant(); // returns "POSIX_Abc_Def"
* loc.getExtension('x'); // returns "urp"
* </pre>
*
* <li>When the languageTag argument contains an extlang subtag,
* the first such subtag is used as the language, and the primary
* language subtag and other extlang subtags are ignored:
*
* <pre>
* Locale.forLanguageTag("ar-aao").getLanguage(); // returns "aao"
* Locale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"
* </pre>
*
* <li>Case is normalized except for variant tags, which are left
* unchanged. Language is normalized to lower case, script to
* title case, country to upper case, and extensions to lower
* case.
*
* <li>If, after processing, the locale would exactly match either
* ja_JP_JP or th_TH_TH with no extensions, the appropriate
* extensions are added as though the constructor had been called:
*
* <pre>
* Locale.forLanguageTag("ja-JP-x-lvariant-JP").toLanguageTag();
* // returns "ja-JP-u-ca-japanese-x-lvariant-JP"
* Locale.forLanguageTag("th-TH-x-lvariant-TH").toLanguageTag();
* // returns "th-TH-u-nu-thai-x-lvariant-TH"
* </pre></ul>
*
* <p>This implements the 'Language-Tag' production of BCP47, and
* so supports grandfathered (regular and irregular) as well as
* private use language tags. Stand alone private use tags are
* represented as empty language and extension 'x-whatever',
* and grandfathered tags are converted to their canonical replacements
* where they exist.
*
* <p>Grandfathered tags with canonical replacements are as follows:
*
* <table summary="Grandfathered tags with canonical replacements">
* <tbody align="center">
* <tr><th>grandfathered tag</th><th> </th><th>modern replacement</th></tr>
* <tr><td>art-lojban</td><td> </td><td>jbo</td></tr>
* <tr><td>i-ami</td><td> </td><td>ami</td></tr>
* <tr><td>i-bnn</td><td> </td><td>bnn</td></tr>
* <tr><td>i-hak</td><td> </td><td>hak</td></tr>
* <tr><td>i-klingon</td><td> </td><td>tlh</td></tr>
* <tr><td>i-lux</td><td> </td><td>lb</td></tr>
* <tr><td>i-navajo</td><td> </td><td>nv</td></tr>
* <tr><td>i-pwn</td><td> </td><td>pwn</td></tr>
* <tr><td>i-tao</td><td> </td><td>tao</td></tr>
* <tr><td>i-tay</td><td> </td><td>tay</td></tr>
* <tr><td>i-tsu</td><td> </td><td>tsu</td></tr>
* <tr><td>no-bok</td><td> </td><td>nb</td></tr>
* <tr><td>no-nyn</td><td> </td><td>nn</td></tr>
* <tr><td>sgn-BE-FR</td><td> </td><td>sfb</td></tr>
* <tr><td>sgn-BE-NL</td><td> </td><td>vgt</td></tr>
* <tr><td>sgn-CH-DE</td><td> </td><td>sgg</td></tr>
* <tr><td>zh-guoyu</td><td> </td><td>cmn</td></tr>
* <tr><td>zh-hakka</td><td> </td><td>hak</td></tr>
* <tr><td>zh-min-nan</td><td> </td><td>nan</td></tr>
* <tr><td>zh-xiang</td><td> </td><td>hsn</td></tr>
* </tbody>
* </table>
*
* <p>Grandfathered tags with no modern replacement will be
* converted as follows:
*
* <table summary="Grandfathered tags with no modern replacement">
* <tbody align="center">
* <tr><th>grandfathered tag</th><th> </th><th>converts to</th></tr>
* <tr><td>cel-gaulish</td><td> </td><td>xtg-x-cel-gaulish</td></tr>
* <tr><td>en-GB-oed</td><td> </td><td>en-GB-x-oed</td></tr>
* <tr><td>i-default</td><td> </td><td>en-x-i-default</td></tr>
* <tr><td>i-enochian</td><td> </td><td>und-x-i-enochian</td></tr>
* <tr><td>i-mingo</td><td> </td><td>see-x-i-mingo</td></tr>
* <tr><td>zh-min</td><td> </td><td>nan-x-zh-min</td></tr>
* </tbody>
* </table>
*
* <p>For a list of all grandfathered tags, see the
* IANA Language Subtag Registry (search for "Type: grandfathered").
*
* <p><b>Note</b>: there is no guarantee that <code>toLanguageTag</code>
* and <code>forLanguageTag</code> will round-trip.
*
* @param languageTag the language tag
* @return The locale that best represents the language tag.
* @throws NullPointerException if <code>languageTag</code> is <code>null</code>
* @see #toLanguageTag()
* @see java.util.Locale.Builder#setLanguageTag(String)
* @since 1.7
*/
public static Locale forLanguageTag(String languageTag) {
LanguageTag tag = LanguageTag.parse(languageTag, null);
InternalLocaleBuilder bldr = new InternalLocaleBuilder();
bldr.setLanguageTag(tag);
BaseLocale base = bldr.getBaseLocale();
LocaleExtensions exts = bldr.getLocaleExtensions();
if (exts == null && base.getVariant().length() > 0) {
exts = getCompatibilityExtensions(base.getLanguage(), base.getScript(), base.getRegion(), base.getVariant());
}
return getInstance(base, exts);
}
Also used :
InternalLocaleBuilder(sun.util.locale.InternalLocaleBuilder)
LanguageTag(sun.util.locale.LanguageTag)
LocaleExtensions(sun.util.locale.LocaleExtensions)
BaseLocale(sun.util.locale.BaseLocale)
Example 2 with LanguageTag
use of sun.util.locale.LanguageTag in project checker-framework by typetools.
the class Locale method forLanguageTag.
/**
* Returns a locale for the specified IETF BCP 47 language tag string.
*
* <p>If the specified language tag contains any ill-formed subtags,
* the first such subtag and all following subtags are ignored. Compare
* to {@link Locale.Builder#setLanguageTag} which throws an exception
* in this case.
*
* <p>The following <b>conversions</b> are performed:<ul>
*
* <li>The language code "und" is mapped to language "".
*
* <li>The language codes "he", "yi", and "id" are mapped to "iw",
* "ji", and "in" respectively. (This is the same canonicalization
* that's done in Locale's constructors.)
*
* <li>The portion of a private use subtag prefixed by "lvariant",
* if any, is removed and appended to the variant field in the
* result locale (without case normalization). If it is then
* empty, the private use subtag is discarded:
*
* <pre>
* Locale loc;
* loc = Locale.forLanguageTag("en-US-x-lvariant-POSIX");
* loc.getVariant(); // returns "POSIX"
* loc.getExtension('x'); // returns null
*
* loc = Locale.forLanguageTag("de-POSIX-x-URP-lvariant-Abc-Def");
* loc.getVariant(); // returns "POSIX_Abc_Def"
* loc.getExtension('x'); // returns "urp"
* </pre>
*
* <li>When the languageTag argument contains an extlang subtag,
* the first such subtag is used as the language, and the primary
* language subtag and other extlang subtags are ignored:
*
* <pre>
* Locale.forLanguageTag("ar-aao").getLanguage(); // returns "aao"
* Locale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"
* </pre>
*
* <li>Case is normalized except for variant tags, which are left
* unchanged. Language is normalized to lower case, script to
* title case, country to upper case, and extensions to lower
* case.
*
* <li>If, after processing, the locale would exactly match either
* ja_JP_JP or th_TH_TH with no extensions, the appropriate
* extensions are added as though the constructor had been called:
*
* <pre>
* Locale.forLanguageTag("ja-JP-x-lvariant-JP").toLanguageTag();
* // returns "ja-JP-u-ca-japanese-x-lvariant-JP"
* Locale.forLanguageTag("th-TH-x-lvariant-TH").toLanguageTag();
* // returns "th-TH-u-nu-thai-x-lvariant-TH"
* </pre></ul>
*
* <p>This implements the 'Language-Tag' production of BCP47, and
* so supports grandfathered (regular and irregular) as well as
* private use language tags. Stand alone private use tags are
* represented as empty language and extension 'x-whatever',
* and grandfathered tags are converted to their canonical replacements
* where they exist.
*
* <p>Grandfathered tags with canonical replacements are as follows:
*
* <table summary="Grandfathered tags with canonical replacements">
* <tbody align="center">
* <tr><th>grandfathered tag</th><th> </th><th>modern replacement</th></tr>
* <tr><td>art-lojban</td><td> </td><td>jbo</td></tr>
* <tr><td>i-ami</td><td> </td><td>ami</td></tr>
* <tr><td>i-bnn</td><td> </td><td>bnn</td></tr>
* <tr><td>i-hak</td><td> </td><td>hak</td></tr>
* <tr><td>i-klingon</td><td> </td><td>tlh</td></tr>
* <tr><td>i-lux</td><td> </td><td>lb</td></tr>
* <tr><td>i-navajo</td><td> </td><td>nv</td></tr>
* <tr><td>i-pwn</td><td> </td><td>pwn</td></tr>
* <tr><td>i-tao</td><td> </td><td>tao</td></tr>
* <tr><td>i-tay</td><td> </td><td>tay</td></tr>
* <tr><td>i-tsu</td><td> </td><td>tsu</td></tr>
* <tr><td>no-bok</td><td> </td><td>nb</td></tr>
* <tr><td>no-nyn</td><td> </td><td>nn</td></tr>
* <tr><td>sgn-BE-FR</td><td> </td><td>sfb</td></tr>
* <tr><td>sgn-BE-NL</td><td> </td><td>vgt</td></tr>
* <tr><td>sgn-CH-DE</td><td> </td><td>sgg</td></tr>
* <tr><td>zh-guoyu</td><td> </td><td>cmn</td></tr>
* <tr><td>zh-hakka</td><td> </td><td>hak</td></tr>
* <tr><td>zh-min-nan</td><td> </td><td>nan</td></tr>
* <tr><td>zh-xiang</td><td> </td><td>hsn</td></tr>
* </tbody>
* </table>
*
* <p>Grandfathered tags with no modern replacement will be
* converted as follows:
*
* <table summary="Grandfathered tags with no modern replacement">
* <tbody align="center">
* <tr><th>grandfathered tag</th><th> </th><th>converts to</th></tr>
* <tr><td>cel-gaulish</td><td> </td><td>xtg-x-cel-gaulish</td></tr>
* <tr><td>en-GB-oed</td><td> </td><td>en-GB-x-oed</td></tr>
* <tr><td>i-default</td><td> </td><td>en-x-i-default</td></tr>
* <tr><td>i-enochian</td><td> </td><td>und-x-i-enochian</td></tr>
* <tr><td>i-mingo</td><td> </td><td>see-x-i-mingo</td></tr>
* <tr><td>zh-min</td><td> </td><td>nan-x-zh-min</td></tr>
* </tbody>
* </table>
*
* <p>For a list of all grandfathered tags, see the
* IANA Language Subtag Registry (search for "Type: grandfathered").
*
* <p><b>Note</b>: there is no guarantee that <code>toLanguageTag</code>
* and <code>forLanguageTag</code> will round-trip.
*
* @param languageTag the language tag
* @return The locale that best represents the language tag.
* @throws NullPointerException if <code>languageTag</code> is <code>null</code>
* @see #toLanguageTag()
* @see java.util.Locale.Builder#setLanguageTag(String)
* @since 1.7
*/
public static Locale forLanguageTag(String languageTag) {
LanguageTag tag = LanguageTag.parse(languageTag, null);
InternalLocaleBuilder bldr = new InternalLocaleBuilder();
bldr.setLanguageTag(tag);
BaseLocale base = bldr.getBaseLocale();
LocaleExtensions exts = bldr.getLocaleExtensions();
if (exts == null && base.getVariant().length() > 0) {
exts = getCompatibilityExtensions(base.getLanguage(), base.getScript(), base.getRegion(), base.getVariant());
}
return getInstance(base, exts);
}
Also used :
InternalLocaleBuilder(sun.util.locale.InternalLocaleBuilder)
LanguageTag(sun.util.locale.LanguageTag)
LocaleExtensions(sun.util.locale.LocaleExtensions)
BaseLocale(sun.util.locale.BaseLocale)
Example 3 with LanguageTag
use of sun.util.locale.LanguageTag in project Bytecoder by mirkosertic.
the class Locale method forLanguageTag.
/**
* Returns a locale for the specified IETF BCP 47 language tag string.
*
* <p>If the specified language tag contains any ill-formed subtags,
* the first such subtag and all following subtags are ignored. Compare
* to {@link Locale.Builder#setLanguageTag} which throws an exception
* in this case.
*
* <p>The following <b>conversions</b> are performed:<ul>
*
* <li>The language code "und" is mapped to language "".
*
* <li>The language codes "he", "yi", and "id" are mapped to "iw",
* "ji", and "in" respectively. (This is the same canonicalization
* that's done in Locale's constructors.)
*
* <li>The portion of a private use subtag prefixed by "lvariant",
* if any, is removed and appended to the variant field in the
* result locale (without case normalization). If it is then
* empty, the private use subtag is discarded:
*
* <pre>
* Locale loc;
* loc = Locale.forLanguageTag("en-US-x-lvariant-POSIX");
* loc.getVariant(); // returns "POSIX"
* loc.getExtension('x'); // returns null
*
* loc = Locale.forLanguageTag("de-POSIX-x-URP-lvariant-Abc-Def");
* loc.getVariant(); // returns "POSIX_Abc_Def"
* loc.getExtension('x'); // returns "urp"
* </pre>
*
* <li>When the languageTag argument contains an extlang subtag,
* the first such subtag is used as the language, and the primary
* language subtag and other extlang subtags are ignored:
*
* <pre>
* Locale.forLanguageTag("ar-aao").getLanguage(); // returns "aao"
* Locale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"
* </pre>
*
* <li>Case is normalized except for variant tags, which are left
* unchanged. Language is normalized to lower case, script to
* title case, country to upper case, and extensions to lower
* case.
*
* <li>If, after processing, the locale would exactly match either
* ja_JP_JP or th_TH_TH with no extensions, the appropriate
* extensions are added as though the constructor had been called:
*
* <pre>
* Locale.forLanguageTag("ja-JP-x-lvariant-JP").toLanguageTag();
* // returns "ja-JP-u-ca-japanese-x-lvariant-JP"
* Locale.forLanguageTag("th-TH-x-lvariant-TH").toLanguageTag();
* // returns "th-TH-u-nu-thai-x-lvariant-TH"
* </pre></ul>
*
* <p>This implements the 'Language-Tag' production of BCP47, and
* so supports grandfathered (regular and irregular) as well as
* private use language tags. Stand alone private use tags are
* represented as empty language and extension 'x-whatever',
* and grandfathered tags are converted to their canonical replacements
* where they exist.
*
* <p>Grandfathered tags with canonical replacements are as follows:
*
* <table class="striped">
* <caption style="display:none">Grandfathered tags with canonical replacements</caption>
* <thead style="text-align:center">
* <tr><th scope="col" style="padding: 0 2px">grandfathered tag</th><th scope="col" style="padding: 0 2px">modern replacement</th></tr>
* </thead>
* <tbody style="text-align:center">
* <tr><th scope="row">art-lojban</th><td>jbo</td></tr>
* <tr><th scope="row">i-ami</th><td>ami</td></tr>
* <tr><th scope="row">i-bnn</th><td>bnn</td></tr>
* <tr><th scope="row">i-hak</th><td>hak</td></tr>
* <tr><th scope="row">i-klingon</th><td>tlh</td></tr>
* <tr><th scope="row">i-lux</th><td>lb</td></tr>
* <tr><th scope="row">i-navajo</th><td>nv</td></tr>
* <tr><th scope="row">i-pwn</th><td>pwn</td></tr>
* <tr><th scope="row">i-tao</th><td>tao</td></tr>
* <tr><th scope="row">i-tay</th><td>tay</td></tr>
* <tr><th scope="row">i-tsu</th><td>tsu</td></tr>
* <tr><th scope="row">no-bok</th><td>nb</td></tr>
* <tr><th scope="row">no-nyn</th><td>nn</td></tr>
* <tr><th scope="row">sgn-BE-FR</th><td>sfb</td></tr>
* <tr><th scope="row">sgn-BE-NL</th><td>vgt</td></tr>
* <tr><th scope="row">sgn-CH-DE</th><td>sgg</td></tr>
* <tr><th scope="row">zh-guoyu</th><td>cmn</td></tr>
* <tr><th scope="row">zh-hakka</th><td>hak</td></tr>
* <tr><th scope="row">zh-min-nan</th><td>nan</td></tr>
* <tr><th scope="row">zh-xiang</th><td>hsn</td></tr>
* </tbody>
* </table>
*
* <p>Grandfathered tags with no modern replacement will be
* converted as follows:
*
* <table class="striped">
* <caption style="display:none">Grandfathered tags with no modern replacement</caption>
* <thead style="text-align:center">
* <tr><th scope="col" style="padding: 0 2px">grandfathered tag</th><th scope="col" style="padding: 0 2px">converts to</th></tr>
* </thead>
* <tbody style="text-align:center">
* <tr><th scope="row">cel-gaulish</th><td>xtg-x-cel-gaulish</td></tr>
* <tr><th scope="row">en-GB-oed</th><td>en-GB-x-oed</td></tr>
* <tr><th scope="row">i-default</th><td>en-x-i-default</td></tr>
* <tr><th scope="row">i-enochian</th><td>und-x-i-enochian</td></tr>
* <tr><th scope="row">i-mingo</th><td>see-x-i-mingo</td></tr>
* <tr><th scope="row">zh-min</th><td>nan-x-zh-min</td></tr>
* </tbody>
* </table>
*
* <p>For a list of all grandfathered tags, see the
* IANA Language Subtag Registry (search for "Type: grandfathered").
*
* <p><b>Note</b>: there is no guarantee that <code>toLanguageTag</code>
* and <code>forLanguageTag</code> will round-trip.
*
* @param languageTag the language tag
* @return The locale that best represents the language tag.
* @throws NullPointerException if <code>languageTag</code> is <code>null</code>
* @see #toLanguageTag()
* @see java.util.Locale.Builder#setLanguageTag(String)
* @since 1.7
*/
public static Locale forLanguageTag(String languageTag) {
LanguageTag tag = LanguageTag.parse(languageTag, null);
InternalLocaleBuilder bldr = new InternalLocaleBuilder();
bldr.setLanguageTag(tag);
BaseLocale base = bldr.getBaseLocale();
LocaleExtensions exts = bldr.getLocaleExtensions();
if (exts == null && base.getVariant().length() > 0) {
exts = getCompatibilityExtensions(base.getLanguage(), base.getScript(), base.getRegion(), base.getVariant());
}
return getInstance(base, exts);
}
Also used :
InternalLocaleBuilder(sun.util.locale.InternalLocaleBuilder)
LanguageTag(sun.util.locale.LanguageTag)
LocaleExtensions(sun.util.locale.LocaleExtensions)
BaseLocale(sun.util.locale.BaseLocale)
Example 4 with LanguageTag
use of sun.util.locale.LanguageTag in project j2objc by google.
the class Locale method toLanguageTag.
/**
* Returns a well-formed IETF BCP 47 language tag representing
* this locale.
*
* <p>If this <code>Locale</code> has a language, country, or
* variant that does not satisfy the IETF BCP 47 language tag
* syntax requirements, this method handles these fields as
* described below:
*
* <p><b>Language:</b> If language is empty, or not <a
* href="#def_language" >well-formed</a> (for example "a" or
* "e2"), it will be emitted as "und" (Undetermined).
*
* <p><b>Country:</b> If country is not <a
* href="#def_region">well-formed</a> (for example "12" or "USA"),
* it will be omitted.
*
* <p><b>Variant:</b> If variant <b>is</b> <a
* href="#def_variant">well-formed</a>, each sub-segment
* (delimited by '-' or '_') is emitted as a subtag. Otherwise:
* <ul>
*
* <li>if all sub-segments match <code>[0-9a-zA-Z]{1,8}</code>
* (for example "WIN" or "Oracle_JDK_Standard_Edition"), the first
* ill-formed sub-segment and all following will be appended to
* the private use subtag. The first appended subtag will be
* "lvariant", followed by the sub-segments in order, separated by
* hyphen. For example, "x-lvariant-WIN",
* "Oracle-x-lvariant-JDK-Standard-Edition".
*
* <li>if any sub-segment does not match
* <code>[0-9a-zA-Z]{1,8}</code>, the variant will be truncated
* and the problematic sub-segment and all following sub-segments
* will be omitted. If the remainder is non-empty, it will be
* emitted as a private use subtag as above (even if the remainder
* turns out to be well-formed). For example,
* "Solaris_isjustthecoolestthing" is emitted as
* "x-lvariant-Solaris", not as "solaris".</li></ul>
*
* <p><b>Special Conversions:</b> Java supports some old locale
* representations, including deprecated ISO language codes,
* for compatibility. This method performs the following
* conversions:
* <ul>
*
* <li>Deprecated ISO language codes "iw", "ji", and "in" are
* converted to "he", "yi", and "id", respectively.
*
* <li>A locale with language "no", country "NO", and variant
* "NY", representing Norwegian Nynorsk (Norway), is converted
* to a language tag "nn-NO".</li></ul>
*
* <p><b>Note:</b> Although the language tag created by this
* method is well-formed (satisfies the syntax requirements
* defined by the IETF BCP 47 specification), it is not
* necessarily a valid BCP 47 language tag. For example,
* <pre>
* new Locale("xx", "YY").toLanguageTag();</pre>
*
* will return "xx-YY", but the language subtag "xx" and the
* region subtag "YY" are invalid because they are not registered
* in the IANA Language Subtag Registry.
*
* @return a BCP47 language tag representing the locale
* @see #forLanguageTag(String)
* @since 1.7
*/
public String toLanguageTag() {
if (languageTag != null) {
return languageTag;
}
LanguageTag tag = LanguageTag.parseLocale(baseLocale, localeExtensions);
StringBuilder buf = new StringBuilder();
String subtag = tag.getLanguage();
if (subtag.length() > 0) {
buf.append(LanguageTag.canonicalizeLanguage(subtag));
}
subtag = tag.getScript();
if (subtag.length() > 0) {
buf.append(LanguageTag.SEP);
buf.append(LanguageTag.canonicalizeScript(subtag));
}
subtag = tag.getRegion();
if (subtag.length() > 0) {
buf.append(LanguageTag.SEP);
buf.append(LanguageTag.canonicalizeRegion(subtag));
}
List<String> subtags = tag.getVariants();
for (String s : subtags) {
buf.append(LanguageTag.SEP);
// preserve casing
buf.append(s);
}
subtags = tag.getExtensions();
for (String s : subtags) {
buf.append(LanguageTag.SEP);
buf.append(LanguageTag.canonicalizeExtension(s));
}
subtag = tag.getPrivateuse();
if (subtag.length() > 0) {
if (buf.length() > 0) {
buf.append(LanguageTag.SEP);
}
buf.append(LanguageTag.PRIVATEUSE).append(LanguageTag.SEP);
// preserve casing
buf.append(subtag);
}
String langTag = buf.toString();
synchronized (this) {
if (languageTag == null) {
languageTag = langTag;
}
}
return languageTag;
}
Also used :
LanguageTag(sun.util.locale.LanguageTag)
Example 5 with LanguageTag
use of sun.util.locale.LanguageTag in project j2objc by google.
the class Locale method forLanguageTag.
/**
* Returns a locale for the specified IETF BCP 47 language tag string.
*
* <p>If the specified language tag contains any ill-formed subtags,
* the first such subtag and all following subtags are ignored. Compare
* to {@link Locale.Builder#setLanguageTag} which throws an exception
* in this case.
*
* <p>The following <b>conversions</b> are performed:<ul>
*
* <li>The language code "und" is mapped to language "".
*
* <li>The language codes "he", "yi", and "id" are mapped to "iw",
* "ji", and "in" respectively. (This is the same canonicalization
* that's done in Locale's constructors.)
*
* <li>The portion of a private use subtag prefixed by "lvariant",
* if any, is removed and appended to the variant field in the
* result locale (without case normalization). If it is then
* empty, the private use subtag is discarded:
*
* <pre>
* Locale loc;
* loc = Locale.forLanguageTag("en-US-x-lvariant-POSIX");
* loc.getVariant(); // returns "POSIX"
* loc.getExtension('x'); // returns null
*
* loc = Locale.forLanguageTag("de-POSIX-x-URP-lvariant-Abc-Def");
* loc.getVariant(); // returns "POSIX_Abc_Def"
* loc.getExtension('x'); // returns "urp"
* </pre>
*
* <li>When the languageTag argument contains an extlang subtag,
* the first such subtag is used as the language, and the primary
* language subtag and other extlang subtags are ignored:
*
* <pre>
* Locale.forLanguageTag("ar-aao").getLanguage(); // returns "aao"
* Locale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"
* </pre>
*
* <li>Case is normalized except for variant tags, which are left
* unchanged. Language is normalized to lower case, script to
* title case, country to upper case, and extensions to lower
* case.
*
* <li>If, after processing, the locale would exactly match either
* ja_JP_JP or th_TH_TH with no extensions, the appropriate
* extensions are added as though the constructor had been called:
*
* <pre>
* Locale.forLanguageTag("ja-JP-x-lvariant-JP").toLanguageTag();
* // returns "ja-JP-u-ca-japanese-x-lvariant-JP"
* Locale.forLanguageTag("th-TH-x-lvariant-TH").toLanguageTag();
* // returns "th-TH-u-nu-thai-x-lvariant-TH"
* </pre></ul>
*
* <p>This implements the 'Language-Tag' production of BCP47, and
* so supports grandfathered (regular and irregular) as well as
* private use language tags. Stand alone private use tags are
* represented as empty language and extension 'x-whatever',
* and grandfathered tags are converted to their canonical replacements
* where they exist.
*
* <p>Grandfathered tags with canonical replacements are as follows:
*
* <table summary="Grandfathered tags with canonical replacements">
* <tbody align="center">
* <tr><th>grandfathered tag</th><th> </th><th>modern replacement</th></tr>
* <tr><td>art-lojban</td><td> </td><td>jbo</td></tr>
* <tr><td>i-ami</td><td> </td><td>ami</td></tr>
* <tr><td>i-bnn</td><td> </td><td>bnn</td></tr>
* <tr><td>i-hak</td><td> </td><td>hak</td></tr>
* <tr><td>i-klingon</td><td> </td><td>tlh</td></tr>
* <tr><td>i-lux</td><td> </td><td>lb</td></tr>
* <tr><td>i-navajo</td><td> </td><td>nv</td></tr>
* <tr><td>i-pwn</td><td> </td><td>pwn</td></tr>
* <tr><td>i-tao</td><td> </td><td>tao</td></tr>
* <tr><td>i-tay</td><td> </td><td>tay</td></tr>
* <tr><td>i-tsu</td><td> </td><td>tsu</td></tr>
* <tr><td>no-bok</td><td> </td><td>nb</td></tr>
* <tr><td>no-nyn</td><td> </td><td>nn</td></tr>
* <tr><td>sgn-BE-FR</td><td> </td><td>sfb</td></tr>
* <tr><td>sgn-BE-NL</td><td> </td><td>vgt</td></tr>
* <tr><td>sgn-CH-DE</td><td> </td><td>sgg</td></tr>
* <tr><td>zh-guoyu</td><td> </td><td>cmn</td></tr>
* <tr><td>zh-hakka</td><td> </td><td>hak</td></tr>
* <tr><td>zh-min-nan</td><td> </td><td>nan</td></tr>
* <tr><td>zh-xiang</td><td> </td><td>hsn</td></tr>
* </tbody>
* </table>
*
* <p>Grandfathered tags with no modern replacement will be
* converted as follows:
*
* <table summary="Grandfathered tags with no modern replacement">
* <tbody align="center">
* <tr><th>grandfathered tag</th><th> </th><th>converts to</th></tr>
* <tr><td>cel-gaulish</td><td> </td><td>xtg-x-cel-gaulish</td></tr>
* <tr><td>en-GB-oed</td><td> </td><td>en-GB-x-oed</td></tr>
* <tr><td>i-default</td><td> </td><td>en-x-i-default</td></tr>
* <tr><td>i-enochian</td><td> </td><td>und-x-i-enochian</td></tr>
* <tr><td>i-mingo</td><td> </td><td>see-x-i-mingo</td></tr>
* <tr><td>zh-min</td><td> </td><td>nan-x-zh-min</td></tr>
* </tbody>
* </table>
*
* <p>For a list of all grandfathered tags, see the
* IANA Language Subtag Registry (search for "Type: grandfathered").
*
* <p><b>Note</b>: there is no guarantee that <code>toLanguageTag</code>
* and <code>forLanguageTag</code> will round-trip.
*
* @param languageTag the language tag
* @return The locale that best represents the language tag.
* @throws NullPointerException if <code>languageTag</code> is <code>null</code>
* @see #toLanguageTag()
* @see java.util.Locale.Builder#setLanguageTag(String)
* @since 1.7
*/
public static Locale forLanguageTag(String languageTag) {
LanguageTag tag = LanguageTag.parse(languageTag, null);
InternalLocaleBuilder bldr = new InternalLocaleBuilder();
bldr.setLanguageTag(tag);
BaseLocale base = bldr.getBaseLocale();
LocaleExtensions exts = bldr.getLocaleExtensions();
if (exts == null && base.getVariant().length() > 0) {
exts = getCompatibilityExtensions(base.getLanguage(), base.getScript(), base.getRegion(), base.getVariant());
}
return getInstance(base, exts);
}
Also used :
InternalLocaleBuilder(sun.util.locale.InternalLocaleBuilder)
LanguageTag(sun.util.locale.LanguageTag)
LocaleExtensions(sun.util.locale.LocaleExtensions)
BaseLocale(sun.util.locale.BaseLocale)
Aggregations
LanguageTag (sun.util.locale.LanguageTag)8
BaseLocale (sun.util.locale.BaseLocale)4
InternalLocaleBuilder (sun.util.locale.InternalLocaleBuilder)4
LocaleExtensions (sun.util.locale.LocaleExtensions)4
