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 |
alfonx |
256 |
* classes based on Java 1.6, focusing (not only) on Java Swing |
6 |
alfonx |
244 |
* 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 |
|
|
package skrueger.i8n; |
31 |
|
|
|
32 |
alfonx |
292 |
import java.awt.event.ActionEvent; |
33 |
|
|
import java.awt.event.ActionListener; |
34 |
alfonx |
244 |
import java.beans.PropertyChangeEvent; |
35 |
|
|
import java.beans.PropertyChangeListener; |
36 |
|
|
import java.util.ArrayList; |
37 |
|
|
import java.util.HashMap; |
38 |
alfonx |
482 |
import java.util.Iterator; |
39 |
alfonx |
244 |
import java.util.List; |
40 |
|
|
import java.util.Locale; |
41 |
alfonx |
292 |
import java.util.Random; |
42 |
alfonx |
244 |
|
43 |
|
|
import javax.swing.JComponent; |
44 |
|
|
|
45 |
|
|
import org.apache.log4j.Logger; |
46 |
alfonx |
482 |
import org.geotools.util.WeakHashSet; |
47 |
alfonx |
409 |
import org.opengis.util.InternationalString; |
48 |
alfonx |
244 |
|
49 |
alfonx |
420 |
import skrueger.geotools.Copyable; |
50 |
|
|
|
51 |
alfonx |
244 |
/** |
52 |
|
|
* Represents a {@link HashMap} of translations. toString() returns the |
53 |
|
|
* appropriate translation |
54 |
|
|
* |
55 |
|
|
* @author @author <a href="mailto:[email protected]">Stefan Alfons |
56 |
|
|
* Krüger</a> |
57 |
|
|
*/ |
58 |
|
|
|
59 |
alfonx |
482 |
public class Translation extends HashMap<String, String> implements |
60 |
|
|
Copyable<Translation> { |
61 |
alfonx |
244 |
public static final String LOCALECHANGE_PROPERTY = "localechange"; |
62 |
|
|
public static final String NO_TRANSLATION = "NO TRANSLATION"; |
63 |
|
|
public static final String DEFAULT_KEY = "default"; |
64 |
|
|
static final Logger log = Logger.getLogger(Translation.class); |
65 |
alfonx |
268 |
static String activeLang = Locale.getDefault().getLanguage(); |
66 |
alfonx |
244 |
|
67 |
|
|
static protected List<PropertyChangeListener> listeners = new ArrayList<PropertyChangeListener>(); |
68 |
|
|
|
69 |
|
|
static { |
70 |
|
|
|
71 |
|
|
// TODO default aus Locale auslesen und mit möglichen vergleichen... |
72 |
|
|
// mmm.. vor laden von atlasml immer DEFAULT_KEY, also hier nicht |
73 |
|
|
|
74 |
|
|
// Get default locale |
75 |
|
|
Locale locale = Locale.getDefault(); |
76 |
|
|
setActiveLang(locale.getLanguage()); |
77 |
|
|
} |
78 |
|
|
|
79 |
alfonx |
482 |
private WeakHashSet<ActionListener> actionListeners = new WeakHashSet<ActionListener>( |
80 |
|
|
ActionListener.class); |
81 |
alfonx |
292 |
|
82 |
alfonx |
244 |
@Override |
83 |
|
|
/* |
84 |
|
|
* @comment To make a copy of a translation see methods toOneLine() and |
85 |
|
|
* fromOneLine() |
86 |
|
|
*/ |
87 |
|
|
public Translation clone() { |
88 |
alfonx |
420 |
throw new RuntimeException("use copy()"); |
89 |
alfonx |
482 |
// return (Translation) super.clone(); |
90 |
alfonx |
244 |
} |
91 |
|
|
|
92 |
|
|
/** |
93 |
|
|
* Get the two-letter language sting that is active |
94 |
|
|
*/ |
95 |
|
|
public static String getActiveLang() { |
96 |
|
|
return activeLang; |
97 |
|
|
} |
98 |
|
|
|
99 |
|
|
/** |
100 |
|
|
* Set up the {@link Translation}-system to use language. If a change is |
101 |
|
|
* performed, events are fired to listeners. Nothing is done if the new |
102 |
|
|
* language equals the old language. The system's default locale is changed. |
103 |
|
|
* |
104 |
|
|
* @param newLang |
105 |
|
|
* The ISO Code of the new active language |
106 |
|
|
*/ |
107 |
|
|
public static void setActiveLang(String newLang) { |
108 |
|
|
setActiveLang(newLang, true); |
109 |
|
|
} |
110 |
|
|
|
111 |
|
|
/** |
112 |
|
|
* Set up the {@link Translation}-system to use language. If a change is |
113 |
|
|
* performed, events are fired to listeners. Nothing is done if the new |
114 |
|
|
* language equals the old language. |
115 |
|
|
* |
116 |
|
|
* @param newLang |
117 |
|
|
* The ISO Code of the new active language |
118 |
|
|
* |
119 |
|
|
* @param setDefaultLocale |
120 |
|
|
* Shall the system's default locale be changed? |
121 |
|
|
*/ |
122 |
|
|
public static void setActiveLang(String newLang, boolean setDefaultLocale) { |
123 |
|
|
if (getActiveLang().equals(newLang)) { |
124 |
|
|
return; |
125 |
|
|
} |
126 |
|
|
|
127 |
|
|
if (!I8NUtil.isValidISOLangCode(newLang)) { |
128 |
|
|
throw new IllegalArgumentException("'" + newLang |
129 |
|
|
+ "' is not a valid ISO language code."); |
130 |
|
|
} |
131 |
|
|
|
132 |
|
|
Locale newLocale = new Locale(newLang); |
133 |
|
|
if (setDefaultLocale) |
134 |
|
|
Locale.setDefault(newLocale); |
135 |
|
|
|
136 |
|
|
/** |
137 |
|
|
* Setting default locale for Swing JComponents to work around bug |
138 |
|
|
* http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4884480 |
139 |
|
|
*/ |
140 |
|
|
JComponent.setDefaultLocale(newLocale); |
141 |
|
|
|
142 |
|
|
Translation.activeLang = newLang; |
143 |
|
|
|
144 |
|
|
fireLocaleChangeEvents(); |
145 |
|
|
|
146 |
|
|
log.info("skrueger.i8n.Translation switched ActiveLang to " + newLang); |
147 |
|
|
} |
148 |
|
|
|
149 |
|
|
/** |
150 |
|
|
* Initializes a new {@link Translation} with a default translation if a |
151 |
|
|
* simple text is passed. If a "oneLine" text is parsed, it is interpreted. |
152 |
|
|
* Other translations may be added later - this is a HashMap<br/> |
153 |
|
|
* |
154 |
|
|
* @param defaultTranslation |
155 |
|
|
* |
156 |
|
|
* @see public Translation(List<String> languages, String |
157 |
|
|
* defaultTranslation) { |
158 |
|
|
* |
159 |
|
|
*/ |
160 |
|
|
public Translation(String defaultTranslation) { |
161 |
|
|
|
162 |
|
|
fromOneLine(defaultTranslation); |
163 |
|
|
|
164 |
|
|
} |
165 |
|
|
|
166 |
|
|
/** |
167 |
|
|
* Initializes a new {@link Translation}, an uses the given String to |
168 |
|
|
* initialize the {@link Translation} for all languages codes passed. |
169 |
|
|
* |
170 |
|
|
* The translations can be changed later |
171 |
|
|
*/ |
172 |
|
|
public Translation(List<String> languages, String defaultTranslation) { |
173 |
|
|
// put(DEFAULT_KEY, defaultTranslation); |
174 |
|
|
if (languages == null) { |
175 |
|
|
put(DEFAULT_KEY, defaultTranslation); |
176 |
|
|
} else |
177 |
|
|
for (String code : languages) { |
178 |
|
|
if (code.equals(getActiveLang())) { |
179 |
|
|
put(code, defaultTranslation); |
180 |
|
|
} |
181 |
|
|
} |
182 |
|
|
} |
183 |
|
|
|
184 |
|
|
/** |
185 |
|
|
* Sometimes Translations are optional, like for keywords. |
186 |
|
|
*/ |
187 |
|
|
public Translation() { |
188 |
|
|
} |
189 |
|
|
|
190 |
|
|
/** |
191 |
|
|
* Fills the {@link Translation} with the values coded into the String |
192 |
|
|
* Format of {@link String} is: "de{Baum}en{tree}" |
193 |
|
|
* <p> |
194 |
|
|
* <ul> |
195 |
|
|
* <li>If <code>oneLineCoded</code> is empty or null, NO TRANSLATION is set. |
196 |
|
|
* <li>If format can't be recognized, the {@link String} is interpreted as |
197 |
|
|
* the translation in the <code>{@value #DEFAULT_KEY}</code> language |
198 |
|
|
* |
199 |
|
|
* @author Stefan Alfons Krüger |
200 |
|
|
*/ |
201 |
|
|
public void fromOneLine(final String oneLineCoded) { |
202 |
alfonx |
420 |
|
203 |
alfonx |
244 |
clear(); |
204 |
alfonx |
482 |
|
205 |
alfonx |
420 |
try { |
206 |
alfonx |
244 |
|
207 |
alfonx |
482 |
if ((oneLineCoded == null) || (oneLineCoded.equals(""))) { |
208 |
|
|
put(DEFAULT_KEY, ""); |
209 |
|
|
return; |
210 |
|
|
} |
211 |
alfonx |
244 |
|
212 |
alfonx |
482 |
if (oneLineCoded.indexOf("}") == -1) { |
213 |
|
|
// log.warn("The String '"+oneLineCoded+"' is not in oneLine coded => put(DEFAULT_KEY,oneLineCoded);"); |
214 |
|
|
put(DEFAULT_KEY, oneLineCoded); |
215 |
|
|
} |
216 |
alfonx |
244 |
|
217 |
alfonx |
482 |
String eatUp = oneLineCoded; |
218 |
|
|
while (eatUp.indexOf("}") != -1) { |
219 |
|
|
String substring = eatUp.substring(0, eatUp.indexOf("}")); |
220 |
|
|
|
221 |
|
|
// log.debug("substring = "+substring); |
222 |
|
|
String key = substring.substring(0, substring.indexOf("{")); |
223 |
|
|
String value = substring.substring(substring.indexOf("{") + 1, |
224 |
|
|
substring.length()); |
225 |
|
|
// log.debug("key="+key); |
226 |
|
|
// log.debug("value="+value); |
227 |
|
|
put(key, value); |
228 |
|
|
eatUp = eatUp.substring(eatUp.indexOf("}") + 1); |
229 |
|
|
} |
230 |
alfonx |
420 |
} catch (Exception e) { |
231 |
alfonx |
482 |
log.warn("Error while reading the oneLineCode '" + oneLineCoded |
232 |
|
|
+ "'", e); |
233 |
alfonx |
420 |
log.warn("Translation will be empty!"); |
234 |
|
|
} |
235 |
alfonx |
244 |
} |
236 |
|
|
|
237 |
|
|
/** |
238 |
|
|
* Exports the Translations to a String of the Format: "de{Baum}en{tree}" |
239 |
|
|
* |
240 |
|
|
* @author Stefan Alfons Krüger |
241 |
|
|
*/ |
242 |
|
|
public String toOneLine() { |
243 |
|
|
return I8NUtil.toOneLine(this); |
244 |
|
|
} |
245 |
|
|
|
246 |
|
|
/** |
247 |
|
|
* Returns the right translation by using the {@link #activeLang} field. If |
248 |
|
|
* no translation is set, an ugly String {@link #NO_TRANSLATION} will re |
249 |
|
|
* returned. This might be changed for the final release. If the correct |
250 |
|
|
* language was not found, any entry in the {@link Translation} |
251 |
|
|
* {@link HashMap} will be returned, that contains more than an empty |
252 |
|
|
* string. |
253 |
|
|
*/ |
254 |
|
|
@Override |
255 |
|
|
public String toString() { |
256 |
|
|
if (get(activeLang) != null) { |
257 |
|
|
return get(activeLang); |
258 |
|
|
} |
259 |
|
|
// **************************************************************************** |
260 |
|
|
// MS: The ISDSS needs the concept of the default lang!! So I took the |
261 |
|
|
// following in again!! |
262 |
|
|
// **************************************************************************** |
263 |
|
|
// else return ""; |
264 |
|
|
// //**************************************************************************** |
265 |
|
|
// // The following is commented out.. the concept of the default lang |
266 |
|
|
// seems to be bad.... |
267 |
|
|
// //**************************************************************************** |
268 |
|
|
// MS: |
269 |
|
|
else { |
270 |
|
|
if (get(DEFAULT_KEY) != null) { |
271 |
|
|
return get(DEFAULT_KEY); |
272 |
|
|
} |
273 |
|
|
|
274 |
|
|
// log.debug("return first best <> '' "); |
275 |
|
|
if (size() > 0) |
276 |
|
|
for (String s : values()) { |
277 |
|
|
if ((s != null) && (s.trim().length() > 0)) |
278 |
|
|
return s; |
279 |
|
|
} |
280 |
|
|
} |
281 |
alfonx |
482 |
// log.warn("No translation found!"); |
282 |
alfonx |
244 |
return NO_TRANSLATION; |
283 |
|
|
} |
284 |
|
|
|
285 |
|
|
/** |
286 |
|
|
* {@link PropertyChangeListener} can be registered to be informed when the |
287 |
|
|
* {@link Locale} changed. |
288 |
|
|
* |
289 |
|
|
* @param propertyChangeListener |
290 |
|
|
*/ |
291 |
|
|
public static void addLocaleChangeListener( |
292 |
|
|
PropertyChangeListener propertyChangeListener) { |
293 |
|
|
listeners.add(propertyChangeListener); |
294 |
|
|
} |
295 |
|
|
|
296 |
|
|
/** |
297 |
|
|
* Informs all registered {@link PropertyChangeListener}s about a change of |
298 |
|
|
* the the {@link Locale}. |
299 |
|
|
*/ |
300 |
|
|
public static void fireLocaleChangeEvents() { |
301 |
|
|
PropertyChangeEvent pce = new PropertyChangeEvent(new Translation( |
302 |
|
|
new ArrayList<String>(), "fakeSource"), LOCALECHANGE_PROPERTY, |
303 |
|
|
null, getActiveLang()); |
304 |
|
|
for (PropertyChangeListener pcl : listeners) { |
305 |
|
|
if (pcl != null) |
306 |
|
|
pcl.propertyChange(pce); |
307 |
|
|
} |
308 |
|
|
} |
309 |
|
|
|
310 |
alfonx |
482 |
/** |
311 |
|
|
* The listeneras are stored in a {@link WeakHashSet}! So you HAVE TO KEEP a |
312 |
|
|
* reference as long as you need the listener. |
313 |
|
|
*/ |
314 |
alfonx |
292 |
public void addTranslationChangeListener(ActionListener actionListener) { |
315 |
|
|
actionListeners.add(actionListener); |
316 |
|
|
} |
317 |
alfonx |
482 |
|
318 |
|
|
/** |
319 |
|
|
* The listeneras are stored in a {@link WeakHashSet}! You don't have to |
320 |
|
|
* remove the listener, as long as you throw away the reference to the |
321 |
|
|
* listener. |
322 |
|
|
*/ |
323 |
alfonx |
292 |
public boolean removeTranslationChangeListener(ActionListener actionListener) { |
324 |
|
|
return actionListeners.remove(actionListener); |
325 |
|
|
} |
326 |
|
|
|
327 |
alfonx |
300 |
public void fireTranslationChangedEvents(String lang) { |
328 |
|
|
ActionEvent ae = new ActionEvent(this, new Random().nextInt(), lang); |
329 |
alfonx |
482 |
|
330 |
|
|
final Iterator<ActionListener> iterator = actionListeners.iterator(); |
331 |
|
|
while (iterator.hasNext()) { |
332 |
|
|
ActionListener al = iterator.next(); |
333 |
|
|
al.actionPerformed(ae); |
334 |
alfonx |
292 |
} |
335 |
|
|
} |
336 |
alfonx |
482 |
|
337 |
alfonx |
292 |
@Override |
338 |
alfonx |
300 |
public String put(String lang, String value) { |
339 |
|
|
String result = super.put(lang, value); |
340 |
|
|
fireTranslationChangedEvents(lang); |
341 |
alfonx |
292 |
return result; |
342 |
|
|
} |
343 |
alfonx |
409 |
|
344 |
|
|
public void fromOneLine(InternationalString iString) { |
345 |
|
|
if (iString != null) |
346 |
|
|
fromOneLine(iString.toString()); |
347 |
alfonx |
482 |
else |
348 |
|
|
fromOneLine((String) null); |
349 |
alfonx |
409 |
} |
350 |
alfonx |
482 |
|
351 |
alfonx |
420 |
/** |
352 |
|
|
* Copy this {@link Translation} to another {@link Translation} e.g. for |
353 |
|
|
* editing |
354 |
|
|
* |
355 |
|
|
* @return the destination {@link Translation} |
356 |
|
|
*/ |
357 |
|
|
@Override |
358 |
|
|
public Translation copyTo(Translation translation2) { |
359 |
alfonx |
482 |
|
360 |
alfonx |
420 |
if (translation2 == null) |
361 |
alfonx |
482 |
// throw new IllegalArgumentException( |
362 |
|
|
// "Target translation may not be null."); |
363 |
|
|
return copy(); |
364 |
alfonx |
420 |
for (String s : keySet()) { |
365 |
|
|
translation2.put(s, get(s)); |
366 |
|
|
} |
367 |
alfonx |
482 |
|
368 |
alfonx |
420 |
return translation2; |
369 |
|
|
} |
370 |
|
|
|
371 |
|
|
@Override |
372 |
|
|
public Translation copy() { |
373 |
|
|
return copyTo(new Translation()); |
374 |
|
|
} |
375 |
|
|
|
376 |
|
|
/** |
377 |
alfonx |
482 |
* Checks if the {@link String}s stored in the {@link Translation} are all |
378 |
|
|
* valid. |
379 |
|
|
* |
380 |
alfonx |
420 |
* @return <code>true</code> if all good |
381 |
|
|
*/ |
382 |
|
|
public static boolean checkValid(Translation translationToCheck) { |
383 |
alfonx |
482 |
|
384 |
alfonx |
420 |
for (String l : translationToCheck.values()) { |
385 |
alfonx |
482 |
|
386 |
alfonx |
420 |
if (l.contains("{") || l.contains("}")) { |
387 |
alfonx |
482 |
|
388 |
alfonx |
420 |
return false; |
389 |
|
|
} |
390 |
|
|
} |
391 |
|
|
return true; |
392 |
|
|
} |
393 |
alfonx |
482 |
|
394 |
alfonx |
244 |
} |