/*\
* Copyright 2006 Klaus Rogall, Hamburg, Germany (klaus.rogall@web.de). All rights reserved.
* _____________________________________________________________________________________________________________________
*
* This class is "Open Source" as defined by the Open Source Initiative (OSI). You can redistribute it and/or modify it
* under the terms of the BSD License. The license text is appended to the end of this file.
\*/
package de.klaro.base.util;
import java.util.Locale;
/**
* Methoden zur Locale-Manupulation und Locale-Verarbeitung.
*
* @see java.util.Locale
*/
public class Locales extends Object
{
/* ______________________________________________________________________________________________________________ *\
\* Konstanten */
/* ______________________________________________________________________________________________________________ *\
\* Klassenvariablen */
/* ______________________________________________________________________________________________________________ *\
\* Instanzvariablen */
/* ______________________________________________________________________________________________________________ *\
\* Konstruktoren */
/**
* Erzeugt eine Instanz dieser Klasse.
*
* Da verhindert werden soll, dass Instanzen dieser Klasse ausserhalb dieser Klasse erzeugt werdem, ist dieser
* Konstruktor 'private' deklariert.
*/
private Locales()
{
super();
}
/* ______________________________________________________________________________________________________________ *\
\* Instanzmethoden */
/* ______________________________________________________________________________________________________________ *\
\* Klassenmethoden */
/**
* Liefert die Locale, die zu einer Locale-Bezeichnung gehrt.
*
* Die Locale-Bezeichnung muss den fr Locales geltenden Konventionen entsprechen.
*
* @param string Die Locale-Bezeichnung
* @return Die Locale
*/
public static Locale parse(CharSequence string)
{
String[] segments = Strings.tokenize(string + "__",'_');
return new Locale(segments[0],segments[1],segments[2]);
}
/**
* Liefert die Locale, die zu einer Locale-Bezeichnung gehrt.
*
* Die Locale-Bezeichnung muss den fr Locales geltenden Konventionen entsprechen. Sollte die Locale nicht bekannt
* (nicht korrekt) sein, dann wird die Default-Locale geliefert.
*
* @param string Die Locale-Bezeichnung
* @param defaultValue Die Default-Locale
* @return Die Locale
*/
public static Locale parse(CharSequence string,Locale defaultValue)
{
if (string == null)
{
return defaultValue;
}
if (Strings.isNullOrEmpty(string))
{
return defaultValue;
}
Locale locale = parse(string);
return (isCorrect(locale))? locale: defaultValue;
}
/**
* Prft, ob die Country- und Language-Komponente der Locale bekannt (korrekt) sind.
*
* @param locale Die Locale
* @return Die Locale ist korrekt (Country- und Language-Komponente sind bekannt)
*/
public static boolean isCorrect(Locale locale)
{
String language = locale.getLanguage();
if (language.length() == 0)
return true;
String[] languages = Locale.getISOLanguages();
for (int l = 0; l < languages.length; l++)
{
if (languages[l].equals(language))
{
String country = locale.getCountry();
if (country.length() == 0) return true;
String[] countries = Locale.getISOCountries();
for (int c = 0; c < countries.length; c++)
{
if (countries[c].equals(country))
return true;
}
return false;
}
}
return false;
}
/**
* Liefert eine Locale, in der die Variant entfernt ist.
*
* @param locale Die Locale
* @return Die Locale ohne Variant
*/
public static Locale truncateVariant(Locale locale)
{
return new Locale(locale.getLanguage(), locale.getCountry());
}
/**
* Liefert eine Locale, in der die Country und Variant entfernt sind.
*
* @param locale Die Locale
* @return Die Locale ohne Country und Variant
*/
public static Locale truncateCountry(Locale locale)
{
return new Locale(locale.getLanguage());
}
/* ______________________________________________________________________________________________________________ *\
\* Klassen */
}
/*\
* _____________________________________________________________________________________________________________________
*
* This software is distributed under the terms of the BSD License:
*
* Copyright 2006 Klaus Rogall, Hamburg, Germany (klaus.rogall@web.de). All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
* following conditions are met:
*
* - Redistributions of source code must retain the above copyright notice, this list of conditions and the following
* disclaimer.
* - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided with the distribution.
* - Neither the name of the Klaus Rogall nor the names of its contributors may be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
* _____________________________________________________________________________________________________________________
\*/
