gvsig-tools / org.gvsig.tools / library / trunk / org.gvsig.tools / org.gvsig.tools.lib / src / main / java / org / gvsig / tools / i18n / I18nManager.java @ 1947
History | View | Annotate | Download (2.7 KB)
1 |
/**
|
---|---|
2 |
* gvSIG. Desktop Geographic Information System.
|
3 |
*
|
4 |
* Copyright (C) 2007-2013 gvSIG Association.
|
5 |
*
|
6 |
* This program is free software; you can redistribute it and/or
|
7 |
* modify it under the terms of the GNU General Public License
|
8 |
* as published by the Free Software Foundation; either version 2
|
9 |
* of the License, or (at your option) any later version.
|
10 |
*
|
11 |
* This program is distributed in the hope that it will be useful,
|
12 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14 |
* GNU General Public License for more details.
|
15 |
*
|
16 |
* You should have received a copy of the GNU General Public License
|
17 |
* along with this program; if not, write to the Free Software
|
18 |
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
19 |
* MA 02110-1301, USA.
|
20 |
*
|
21 |
* For any additional information, do not hesitate to contact us
|
22 |
* at info AT gvsig.com, or visit our website www.gvsig.com.
|
23 |
*/
|
24 |
package org.gvsig.tools.i18n; |
25 |
|
26 |
import java.io.File; |
27 |
import java.util.List; |
28 |
import java.util.Locale; |
29 |
|
30 |
public interface I18nManager { |
31 |
|
32 |
/**
|
33 |
* Get translation for the current language of <b>message</b>.
|
34 |
*
|
35 |
* If the translation not found return the message it self.
|
36 |
*
|
37 |
* @param message
|
38 |
* the message key used for translation.
|
39 |
*
|
40 |
* @return the traslated message
|
41 |
*/
|
42 |
public String getTranslation(String message); |
43 |
|
44 |
/**
|
45 |
* Get translation for the current language of <b>message</b>.
|
46 |
* This use the java MessageFormat utiity to replace args in the
|
47 |
* resulting translation message.
|
48 |
*
|
49 |
* If the translation not found return the message it self.
|
50 |
*
|
51 |
* @param message
|
52 |
* the message key used for translation.
|
53 |
*
|
54 |
* @param args
|
55 |
* @return the traslated message
|
56 |
*/
|
57 |
public String getTranslation(String message, String[] args); |
58 |
|
59 |
public void addResourceFamily(String family, ClassLoader loader, String callerName); |
60 |
|
61 |
/**
|
62 |
* Adds an additional family of resource files containing some translations.
|
63 |
* The search path to locate the files is provided by the dir parameter.
|
64 |
*
|
65 |
* Example:
|
66 |
* <code>i18nManager.addResourceFamily("text", new File("./resources"))</code>
|
67 |
*
|
68 |
* @param family The family name (or base name) which is used to search
|
69 |
* actual properties files.
|
70 |
* @param folder The search path to locate the property files
|
71 |
*/
|
72 |
|
73 |
public void addResourceFamily(String family, File folder); |
74 |
|
75 |
public List<Locale> getPreferredLocales(); |
76 |
|
77 |
public Locale getCurrentLocale(); |
78 |
} |