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, focussing (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. Krüger - additional utility classes
 ******************************************************************************/
package skrueger.i8n;

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 (Locale locale : java.util.Locale.getAvailableLocales()) {
                        getLanguageCodes().add(locale.getLanguage());
                }
                // for (String code : java.util.Locale.getISOLanguages()) {
                // getLanguageCodes().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 Krüger
         */
        public static Translation createFromOneLIne(final String oneLineCoded) {
                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 Krüger
         */
        public static String toOneLine(Translation source) {
                StringBuffer oneLine = new StringBuffer();
                for (String key : source.keySet()) {
                        oneLine.append(key + "{" + source.get(key) + "}");
                }
                return oneLine.toString();
        }

        /**
         * @author Stefan Alfons Krüger
         * @param code
         * @return true if the code paramter is a valid ISO Language code
         */
        public static boolean isValidISOLangCode(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;
        }

        /**
         * @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 getLocaleFor(String code) {
                for (Locale l : Locale.getAvailableLocales()) {
                        if (l.getLanguage().equals(code.toLowerCase())) {
                                return l;
                        }
                        // LOGGER.debug(l.getLanguage() + " not = " + code);
                }

                LOGGER.error("Can't create a Locale for code " + code
                                + "! Returning the system default locale to avoid NPEs.");

                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;
        }
}
1	alfonx	244	/*******************************************************************************
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, focussing (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. Krüger - additional utility classes
29			******************************************************************************/
30	mojays	2	package skrueger.i8n;
31
32	alfonx	39	import java.util.Locale;
33	alfonx	38	import java.util.Set;
34			import java.util.TreeSet;
35	mojays	2
36	alfonx	43	import org.apache.log4j.Logger;
37
38	mojays	2	public class I8NUtil {
39	alfonx	43	static final Logger LOGGER = Logger.getLogger(I8NUtil.class);
40	alfonx	39
41	alfonx	38	private static Set<String> languageCodes = new TreeSet<String>();
42	mojays	2	static {
43	alfonx	39	for (Locale locale : java.util.Locale.getAvailableLocales()) {
44			getLanguageCodes().add(locale.getLanguage());
45			}
46			// for (String code : java.util.Locale.getISOLanguages()) {
47			// getLanguageCodes().add(code);
48			// }
49			}
50
51	mojays	2	/**
52	alfonx	185	* Creates a {@link Translation}<br/>
53			* <p>
54			* <li>If <code>oneLineCoded</code> is empty or null, NO TRANSLATION is set.
55			* <li>If format can't be recognized, the {@link String} is interpreted as
56			* the translation in the <code>{@value #DEFAULT_KEY}</code> language
57			*
58	mojays	2	* @author Stefan Alfons Krüger
59	alfonx	185	*/
60			public static Translation createFromOneLIne(final String oneLineCoded) {
61			Translation result = new Translation();
62			result.fromOneLine(oneLineCoded);
63			return result;
64			}
65
66			/**
67			* Returns the Translation to a String of the Format: "de{Baum}en{tree}" <br/>
68			*
69			*
70			* @author Stefan Alfons Krüger
71			*/
72			public static String toOneLine(Translation source) {
73			StringBuffer oneLine = new StringBuffer();
74			for (String key : source.keySet()) {
75			oneLine.append(key + "{" + source.get(key) + "}");
76			}
77			return oneLine.toString();
78			}
79
80			/**
81			* @author Stefan Alfons Krüger
82	mojays	2	* @param code
83			* @return true if the code paramter is a valid ISO Language code
84			*/
85			public static boolean isValidISOLangCode(String code) {
86	alfonx	38	return getLanguageCodes().contains(code);
87	mojays	2	}
88	alfonx	38
89			/**
90	alfonx	39	* @return All language codes available in
91			* java.util.Locale.getISOLanguages() without duplicates.
92	alfonx	38	*/
93			public static Set<String> getLanguageCodes() {
94			return languageCodes;
95			}
96	alfonx	39
97			/**
98			* @param code
99			* A two-letter language code.
100			* @return <code>null</code> or one (of many possible) {@link Locale} that
101			* uses this language.
102			*/
103			public static Locale getLocaleFor(String code) {
104			for (Locale l : Locale.getAvailableLocales()) {
105	alfonx	140	if (l.getLanguage().equals(code.toLowerCase())) {
106	alfonx	39	return l;
107			}
108	alfonx	185	// LOGGER.debug(l.getLanguage() + " not = " + code);
109	alfonx	39	}
110	alfonx	140
111	alfonx	44	LOGGER.error("Can't create a Locale for code " + code
112			+ "! Returning the system default locale to avoid NPEs.");
113	alfonx	140
114	alfonx	43	return Locale.getDefault();
115	alfonx	39	}
116	alfonx	44
117			/**
118			* A convenience method that checks if the {@link Translation} object
119			* contains a translation for the active language. A {@link String}
120			* containing only spaces will return <code>false</code>.
121			*
122			* @param trans
123			* {@link Translation} to check.
124			*/
125			public static boolean isEmpty(final Translation trans) {
126			if (trans == null)
127			return true;
128			return isEmpty(trans.toString());
129			}
130
131			/**
132			* A convenience method that checks if the {@link String} returned by from a
133			* {@link Translation} object contains a "valid" translation for the active
134			* language. A {@link String} containing only spaces or equals
135			* {@link Translation}.NO_TRANSLATION will return <code>false</code>.
136			*
137			* @param transString
138			* {@link String} to check.
139			*/
140			public static boolean isEmpty(final String transString) {
141			if (transString == null)
142			return true;
143			if (transString.trim().isEmpty())
144			return true;
145			if (transString.equals(Translation.NO_TRANSLATION))
146			return true;
147			return false;
148			}
149	mojays	2	}