skrueger/i8n/I8NUtil.java

/*******************************************************************************
 * Copyright (c) 2009 Martin O. J. Schmitz.
 * 
 * This file is part of the SCHMITZM library - a collection of utility 
 * classes based on Java 1.6, focusing (not only) on Java Swing 
 * and the Geotools library.
 * 
 * The SCHMITZM project is hosted at:
 * http://wald.intevation.org/projects/schmitzm/
 * 
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public License (license.txt)
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 * or try this link: http://www.gnu.org/licenses/lgpl.html
 * 
 * Contributors:
 *     Martin O. J. Schmitz - initial API and implementation
 *     Stefan A. Tzeggai - additional utility classes
 ******************************************************************************/
package skrueger.i8n;

import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Set;
import java.util.TreeSet;

import org.apache.log4j.Logger;

public class I8NUtil {
        static final Logger LOGGER = Logger.getLogger(I8NUtil.class);

        private static Set<String> languageCodes = new TreeSet<String>();
        static {
                for (final Locale locale : java.util.Locale.getAvailableLocales()) {
                        languageCodes.add(locale.getLanguage());
                }
                for (String code : java.util.Locale.getISOLanguages()) {
                        languageCodes.add(code);
                }
        }

        /**
         * Creates a {@link Translation}<br/>
         * <p>
         * <li>If <code>oneLineCoded</code> is empty or null, NO TRANSLATION is set.
         * <li>If format can't be recognized, the {@link String} is interpreted as
         * the translation in the <code>{@value #DEFAULT_KEY}</code> language
         * 
         * @author Stefan Alfons Tzeggai
         */
        public static Translation createFromOneLine(final String oneLineCoded) {
                final Translation result = new Translation();
                result.fromOneLine(oneLineCoded);
                return result;
        }

        /**
         * Returns the Translation to a String of the Format: "de{Baum}en{tree}" <br/>
         * 
         * 
         * @author Stefan Alfons Tzeggai
         */
        public static String toOneLine(final Translation source) {
                final StringBuffer oneLine = new StringBuffer();
                for (final String key : source.keySet()) {
                        oneLine.append(key + "{" + source.get(key) + "}");
                }
                return oneLine.toString();
        }

        /**
         * @author Stefan Alfons Tzeggai
         * @param code
         * @return true if the code paramter is a valid ISO Language code
         */
        public static boolean isValidISOLangCode(final String code) {
                return getLanguageCodes().contains(code);
        }

        /**
         * @return All language codes available in
         *         java.util.Locale.getISOLanguages() without duplicates.
         */
        public static Set<String> getLanguageCodes() {
                return languageCodes;
        }

        /**
         * Lookup {@link Locale} where they speak the 2 letter code language.
         * 
         * @param code
         *            A two-letter language code.
         * @return <code>null</code> or one (of many possible) {@link Locale} that
         *         uses this language.
         */
        public static List<Locale> getLocalesForLang(final String code) {

                final ArrayList<Locale> locales = new ArrayList<Locale>();

                for (final Locale l : Locale.getAvailableLocales()) {
                        if (l.getLanguage().equals(code.toLowerCase())) {
                                locales.add(l);
                        }
                }

                return locales;
        }

        /**
         * Lookup first country where they speak the 2 letter code language.
         * 
         * @param code
         *            A two-letter language code.
         * @return <code>null</code> or one (of many possible) {@link Locale} that
         *         uses this language.
         */
        public static Locale getFirstLocaleForLang(final String code) {

                List<Locale> locales = getLocalesForLang(code);

                if (locales.size() > 0)
                        return locales.get(0);

                Locale l = new Locale(code);
//              LOGGER.error("Can't find Locale for code " + code
//                              + "! Returning a selfmade locale");
                return l;

                // return Locale.getDefault();
        }

        /**
         * A convenience method that checks if the {@link Translation} object
         * contains a translation for the active language. A {@link String}
         * containing only spaces will return <code>false</code>.
         * 
         * @param trans
         *            {@link Translation} to check.
         */
        public static boolean isEmpty(final Translation trans) {
                if (trans == null)
                        return true;
                return isEmpty(trans.toString());
        }

        /**
         * A convenience method that checks if the {@link String} returned by from a
         * {@link Translation} object contains a "valid" translation for the active
         * language. A {@link String} containing only spaces or equals
         * {@link Translation}.NO_TRANSLATION will return <code>false</code>.
         * 
         * @param transString
         *            {@link String} to check.
         */
        public static boolean isEmpty(final String transString) {
                if (transString == null)
                        return true;
                if (transString.trim().isEmpty())
                        return true;
                if (transString.equals(Translation.NO_TRANSLATION))
                        return true;
                return false;
        }

        /**
         * @return a {@link Double} between 0 and 1 representing the part of the
         *         given {@link Translation} that has been filled.
         * @param ac
         *            {@link AtlasConfig} to determine the languages to expect.
         * @param trans
         *            The {@link Translation} to check.
         */
        public static double qmTranslation(final List<String> languages,
                        final Translation trans) {

                if (trans == null)
                        return 0.;

                Integer cunt = 0;
                for (final String l : languages) {
                        final String t = trans.get(l);
                        if (!isEmpty(t))
                                cunt++;
                }
                return cunt.doubleValue() / (double) languages.size();
        }

        /**
         * The German Umlaute have standard ASCII alternatives that are sometimes
         * use. This method will replace any possible ASCII-Umlaut Representation
         * into real Umlaute. E.g. "ae" to "ä" and "ue" to "ü". Umlaute are returned
         * as inline-UTF8.
         */
        public static String mitUmlaute(final String withoutUmlaute) {
                String replaced = withoutUmlaute;

                replaced = replaced.replaceAll("ue", "\u00FC");
                replaced = replaced.replaceAll("Ue", "\u00DC");

                replaced = replaced.replaceAll("oe", "\u00F6");
                replaced = replaced.replaceAll("Oe", "\u00D6");

                replaced = replaced.replaceAll("ae", "\u00E4");
                replaced = replaced.replaceAll("Ae", "\u00C4");
                return replaced;
        }
}
1	/*******************************************************************************
2	* Copyright (c) 2009 Martin O. J. Schmitz.
3	*
4	* This file is part of the SCHMITZM library - a collection of utility
5	* classes based on Java 1.6, focusing (not only) on Java Swing
6	* and the Geotools library.
7	*
8	* The SCHMITZM project is hosted at:
9	* http://wald.intevation.org/projects/schmitzm/
10	*
11	* This program is free software; you can redistribute it and/or
12	* modify it under the terms of the GNU Lesser General Public License
13	* as published by the Free Software Foundation; either version 3
14	* of the License, or (at your option) any later version.
15	*
16	* This program is distributed in the hope that it will be useful,
17	* but WITHOUT ANY WARRANTY; without even the implied warranty of
18	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19	* GNU General Public License for more details.
20	*
21	* You should have received a copy of the GNU Lesser General Public License (license.txt)
22	* along with this program; if not, write to the Free Software
23	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
24	* or try this link: http://www.gnu.org/licenses/lgpl.html
25	*
26	* Contributors:
27	* Martin O. J. Schmitz - initial API and implementation
28	* Stefan A. Tzeggai - additional utility classes
29	******************************************************************************/
30	package skrueger.i8n;
31
32	import java.util.ArrayList;
33	import java.util.List;
34	import java.util.Locale;
35	import java.util.Set;
36	import java.util.TreeSet;
37
38	import org.apache.log4j.Logger;
39
40	public class I8NUtil {
41	static final Logger LOGGER = Logger.getLogger(I8NUtil.class);
42
43	private static Set<String> languageCodes = new TreeSet<String>();
44	static {
45	for (final Locale locale : java.util.Locale.getAvailableLocales()) {
46	languageCodes.add(locale.getLanguage());
47	}
48	for (String code : java.util.Locale.getISOLanguages()) {
49	languageCodes.add(code);
50	}
51	}
52
53	/**
54	* Creates a {@link Translation}<br/>
55	* <p>
56	* <li>If <code>oneLineCoded</code> is empty or null, NO TRANSLATION is set.
57	* <li>If format can't be recognized, the {@link String} is interpreted as
58	* the translation in the <code>{@value #DEFAULT_KEY}</code> language
59	*
60	* @author Stefan Alfons Tzeggai
61	*/
62	public static Translation createFromOneLine(final String oneLineCoded) {
63	final Translation result = new Translation();
64	result.fromOneLine(oneLineCoded);
65	return result;
66	}
67
68	/**
69	* Returns the Translation to a String of the Format: "de{Baum}en{tree}" <br/>
70	*
71	*
72	* @author Stefan Alfons Tzeggai
73	*/
74	public static String toOneLine(final Translation source) {
75	final StringBuffer oneLine = new StringBuffer();
76	for (final String key : source.keySet()) {
77	oneLine.append(key + "{" + source.get(key) + "}");
78	}
79	return oneLine.toString();
80	}
81
82	/**
83	* @author Stefan Alfons Tzeggai
84	* @param code
85	* @return true if the code paramter is a valid ISO Language code
86	*/
87	public static boolean isValidISOLangCode(final String code) {
88	return getLanguageCodes().contains(code);
89	}
90
91	/**
92	* @return All language codes available in
93	* java.util.Locale.getISOLanguages() without duplicates.
94	*/
95	public static Set<String> getLanguageCodes() {
96	return languageCodes;
97	}
98
99	/**
100	* Lookup {@link Locale} where they speak the 2 letter code language.
101	*
102	* @param code
103	* A two-letter language code.
104	* @return <code>null</code> or one (of many possible) {@link Locale} that
105	* uses this language.
106	*/
107	public static List<Locale> getLocalesForLang(final String code) {
108
109	final ArrayList<Locale> locales = new ArrayList<Locale>();
110
111	for (final Locale l : Locale.getAvailableLocales()) {
112	if (l.getLanguage().equals(code.toLowerCase())) {
113	locales.add(l);
114	}
115	}
116
117	return locales;
118	}
119
120	/**
121	* Lookup first country where they speak the 2 letter code language.
122	*
123	* @param code
124	* A two-letter language code.
125	* @return <code>null</code> or one (of many possible) {@link Locale} that
126	* uses this language.
127	*/
128	public static Locale getFirstLocaleForLang(final String code) {
129
130	List<Locale> locales = getLocalesForLang(code);
131
132	if (locales.size() > 0)
133	return locales.get(0);
134
135	Locale l = new Locale(code);
136	// LOGGER.error("Can't find Locale for code " + code
137	// + "! Returning a selfmade locale");
138	return l;
139
140	// return Locale.getDefault();
141	}
142
143	/**
144	* A convenience method that checks if the {@link Translation} object
145	* contains a translation for the active language. A {@link String}
146	* containing only spaces will return <code>false</code>.
147	*
148	* @param trans
149	* {@link Translation} to check.
150	*/
151	public static boolean isEmpty(final Translation trans) {
152	if (trans == null)
153	return true;
154	return isEmpty(trans.toString());
155	}
156
157	/**
158	* A convenience method that checks if the {@link String} returned by from a
159	* {@link Translation} object contains a "valid" translation for the active
160	* language. A {@link String} containing only spaces or equals
161	* {@link Translation}.NO_TRANSLATION will return <code>false</code>.
162	*
163	* @param transString
164	* {@link String} to check.
165	*/
166	public static boolean isEmpty(final String transString) {
167	if (transString == null)
168	return true;
169	if (transString.trim().isEmpty())
170	return true;
171	if (transString.equals(Translation.NO_TRANSLATION))
172	return true;
173	return false;
174	}
175
176	/**
177	* @return a {@link Double} between 0 and 1 representing the part of the
178	* given {@link Translation} that has been filled.
179	* @param ac
180	* {@link AtlasConfig} to determine the languages to expect.
181	* @param trans
182	* The {@link Translation} to check.
183	*/
184	public static double qmTranslation(final List<String> languages,
185	final Translation trans) {
186
187	if (trans == null)
188	return 0.;
189
190	Integer cunt = 0;
191	for (final String l : languages) {
192	final String t = trans.get(l);
193	if (!isEmpty(t))
194	cunt++;
195	}
196	return cunt.doubleValue() / (double) languages.size();
197	}
198
199	/**
200	* The German Umlaute have standard ASCII alternatives that are sometimes
201	* use. This method will replace any possible ASCII-Umlaut Representation
202	* into real Umlaute. E.g. "ae" to "ä" and "ue" to "ü". Umlaute are returned
203	* as inline-UTF8.
204	*/
205	public static String mitUmlaute(final String withoutUmlaute) {
206	String replaced = withoutUmlaute;
207
208	replaced = replaced.replaceAll("ue", "\u00FC");
209	replaced = replaced.replaceAll("Ue", "\u00DC");
210
211	replaced = replaced.replaceAll("oe", "\u00F6");
212	replaced = replaced.replaceAll("Oe", "\u00D6");
213
214	replaced = replaced.replaceAll("ae", "\u00E4");
215	replaced = replaced.replaceAll("Ae", "\u00C4");
216	return replaced;
217	}
218	}