ResourceBundle that returns the key as a value.
*
* FIXME needs to implement proper plural handling
* FIXME the bundle needs to have a valid locale for proper sourceCodeLocale handling
*/
class EmptyResourceBundle extends ResourceBundle
{
private Locale locale;
public EmptyResourceBundle(Locale locale)
{
this.locale = locale;
}
/**
* Returns the key as value.
*/
protected Object handleGetObject(String key)
{
return key;
}
public Enumeration getKeys()
{
return new EmptyStringEnumeration();
}
public Locale getLocale()
{
return locale;
}
private static class EmptyStringEnumeration implements Enumeration
{
public boolean hasMoreElements()
{
return false;
}
public Object nextElement()
{
throw new IllegalStateException("nextElement must not be " +
"called on empty enumeration");
}
}
} gettext-commons-gettext-commons-0_9_8/src/java/org/xnap/commons/i18n/I18n.java 0000664 0000000 0000000 00000041651 12243607320 0027251 0 ustar 00root root 0000000 0000000 /*
* Gettext Commons
*
* Copyright (C) 2005 Felix Berger
* Copyright (C) 2005 Steffen Pingel
*
* This library 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 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package org.xnap.commons.i18n;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.text.MessageFormat;
import java.util.Locale;
import java.util.MissingResourceException;
import java.util.ResourceBundle;
/**
* Provides methods for internationalization.
*
* To learn how message strings wrapped in one of the tr*()
* methods can be extracted and localized, see this tutorial.
*
* @author Steffen Pingel
* @author Felix Berger
* @author Tammo van Lessen
* @since 0.9
*/
public class I18n {
private static final String CONTEXT_GLUE = "\u0004";
/**
* Reference to the current localization bundles.
*/
private volatile ResourceBundle bundle;
/**
* The locale of the strings used in the source code.
*
* @see #trc(String, String)
*/
private volatile Locale sourceCodeLocale = Locale.ENGLISH;
private String baseName;
private ClassLoader loader;
private volatile Locale locale;
/**
* Constructs an I18n object for a resource bundle.
*
* @param bundle
* must not be null
* @throws NullPointerException
* if bundle is null
* @since 0.9
*/
public I18n(ResourceBundle bundle)
{
setResources(bundle);
}
/**
* Constructs an I18n object by calling {@link #setResources(String, Locale,
* ClassLoader)}.
*
* @throws MissingResourceException
* if the resource bundle could not be loaded
* @throws NullPointerException
* if one of the arguments is null
* @since 0.9
*/
public I18n(String baseName, Locale locale, ClassLoader loader)
{
setResources(baseName, locale, loader);
}
/**
* Returns the current resource bundle.
*
* @since 0.9
*/
public ResourceBundle getResources()
{
return bundle;
}
/**
* Returns the locale this instance was created with. This can be different
* from the locale of the resource bundle returned by
* {@link #getResources()}.
*
* @return the locale or null, if this instance was directly created from a
* resource bundle
* @since 0.9
*/
public Locale getLocale()
{
return locale;
}
/**
* Sets a resource bundle to be used for message translations.
*
* If this is called, the possibly previously specified class loader and
* baseName are invalidated, since the bundle might be from a different
* context. Subsequent calls to {@link #setLocale(Locale)} won't have any
* effect.
*
* @since 0.9
*/
public synchronized void setResources(ResourceBundle bundle)
{
if (bundle == null) {
throw new NullPointerException();
}
this.bundle = bundle;
this.baseName = null;
this.locale = bundle.getLocale();
this.loader = null;
}
/**
* Tries to load a resource bundle using {@link
* ResourceBundle#getBundle(java.lang.String, java.util.Locale,
* java.lang.ClassLoader)}.
*
* @throws MissingResourceException
* if the bundle could not be loaded
* @throws NullPointerException
* if one of the arguments is null
* @since 0.9
*/
public synchronized void setResources(String baseName, Locale locale, ClassLoader loader)
{
this.bundle = ResourceBundle.getBundle(baseName, locale, loader);
this.baseName = baseName;
this.locale = locale;
this.loader = loader;
}
/**
* Marks text to be translated, but doesn't return the
* translation but text itself.
*
* @since 0.9
*/
public static final String marktr(String text)
{
return text;
}
/**
* Tries to load a resource bundle for the locale.
*
* The resource bundle is then used for message translations. Note, you have * to retrieve all messages anew after a locale change in order for them to * be translated to the language specified by the new locale. *
*
* @return false if there is not enough information for loading a new
* resource bundle, see {@link #setResources(ResourceBundle)}.
* @throws MissingResourceException
* if the resource bundle for locale could not be
* found
* @throws NullPointerException
* if locale is null
* @since 0.9
*/
public synchronized boolean setLocale(Locale locale)
{
if (baseName != null && loader != null) {
setResources(baseName, locale, loader);
return true;
}
else {
this.locale = locale;
}
return false;
}
/**
* Sets the locale of the text in the source code.
*
* Only languages that have one singular and one plural form can be used as
* source code locales, since {@link #trn(String, String, long)} takes
* exactly these two forms as parameters.
*
* @param locale
* the locale
* @throws NullPointerException
* if locale is null
* @see #trc(String, String)
* @since 0.9
*/
public void setSourceCodeLocale(Locale locale)
{
if (locale == null) {
throw new NullPointerException("locale must not be null");
}
sourceCodeLocale = locale;
}
/**
* Returns text translated into the currently selected
* language. Every user-visible string in the program must be wrapped into
* this function.
*
* @param text
* text to translate
* @return the translation
* @since 0.9
*/
public final String tr(String text)
{
try {
return bundle.getString(text);
}
catch (MissingResourceException e) {
return text;
}
}
/**
* Returns text translated into the currently selected
* language.
*
* Occurrences of {number} placeholders in text are replaced by
* objects.
*
* Invokes
* {@link MessageFormat#format(java.lang.String, java.lang.Object[])}.
*
* @param text
* text to translate
* @param objects
* arguments to
* Given a {@link Class} object the factory looks up the resource bundle
* responsible for handling message translations. The bundle is returned with an
* {@link I18n} object wrapped around it, which provides the translation
* methods. The lookup is described at {@link #getI18n(Class,String)}.
*
* Use the factory for creating
* Lookup works by iterating upwards in the package hierarchy: First the
* internal cache is asked for an I18n object for a package, otherwise the
* algorithm looks for an
* If after the first iteration no I18n instance has been found, a second
* search begins by looking for resource bundles having the name
*
* The locale of all managed
* Use this method to globally change the locale for all I18n based
* translations.
*
* NOTE: This only works if the objects that display messages do not cache
* translated messages.
*
*
* @param locale
* the new default locale
* @see I18n#setLocale(Locale)
* @since 0.9
*/
public void setDefaultLocale(Locale locale)
{
synchronized (i18ns) {
for (Iterator it = i18ns.iterator(); it.hasNext();) {
I18n i18n = (I18n)it.next();
i18n.setLocale(locale);
}
}
fireLocaleChangedEvent(locale);
}
/**
* Adds a listener that is notified when the default locale has been
* changed.
*
* @param listener
* the listener
* @see #setDefaultLocale(Locale)
* @since 0.9
*/
public void addLocaleChangeListener(LocaleChangeListener listener)
{
synchronized (localeChangeListeners) {
localeChangeListeners.add(listener);
}
}
/**
* Adds a listener that is notified when the default locale has been changed
* using a {@link WeakReference}. The listener is removed when it has been
* cleaned up by the garbage collection.
*
* This is useful for temporary objects that may have an indeterminate
* lifetime such as dialogs.
*
* @param listener
* the listener
* @see #setDefaultLocale(Locale)
* @since 0.9
*/
public void addWeakLocaleChangeListener(LocaleChangeListener listener)
{
synchronized (localeChangeListeners) {
localeChangeListeners.add(new WeakLocaleChangeListener(listener));
}
}
/**
* Removes A component that implements this interface may dynamically change the
* language of all user visible strings.
*
* @see org.xnap.commons.i18n.I18nManager#setDefaultLocale(Locale)
* @author Steffen Pingel
* @since 0.9
*/
public interface LocaleChangeListener {
/**
* Invoked when the local has changed.
*
* @param event provides information about the new locale
* @since 0.9
*/
void localeChanged(LocaleChangeEvent event);
}
gettext-commons-gettext-commons-0_9_8/src/java/org/xnap/commons/i18n/package.html 0000664 0000000 0000000 00000000516 12243607320 0030143 0 ustar 00root root 0000000 0000000
Provides classes for internationalization (i18n). To learn how to make use of the Gettext Commons internationalization,
please have a look at this tutorial. The Gettext Commons project provides Java classes for
internationalization (i18n) through GNU gettext. See
the project
page for more information and downloads. We maintain a repository that can be used for automated
dependency downloading with Maven. If you are using Maven 2.x add the following sections to your
pom.xml: If you are using Maven 1.x add the following dependencies to
your project.xml: And add the XNap Commons repository to your
project.properties: This page gives an overview of the Gettext Commons and
describes how to integrate the library into existing Java
applications. Quick Links: I18nExample.java, API
Documentation Most Unix systems and Linux distributions ship with gettext
packages. The Gettext Commons provide the class I18n
that has methods that need to be invoked each time a user visible
string is used: I18n also supports proper handling of plurals: In addition there are convenience methods that use the Java API
MessageFormat.format() for substitution: And sometimes it is necessary to provide different
translations of the same word as some words may have multiple
meanings in the native language the program is written but
not in other languages: The preferable way to create an I18n object is through the I18nFactory.
The factory caches the I18n object internally using the the package
name of the provided class object and registers it with
I18nManager. Thus all classes of the same package will use the same
I18n instance. I18nManager
lets you register independently created I18n objects and provides
the facility to change the locale of all registered I18n objects thereby
notifying possible LocaleChangeListeners: Once the source code has been internationalized, i.e. all
user visible strings are wrapped by a call to
This 3 step process is illustrated in this figure: Here is a simple example of running the gettext commands: In order to specify the name of the resource bundles you want to
use, you create an i18n.properties file and place it in your
application's toplevel package. All subpackages will use this
configuration file unless they find a different one on the way up in
the package hierarchy. i18n.properties expects the base name of the resources as
the value of the key basename: For more information on how the resource lookup works, please read here. If Maven is used for building, the invocation of gettext can
be easily integrated into the build process. Follow the
appropriate link below for more information:MessageFormat.format()
* @return the translated text
* @since 0.9
*/
public final String tr(String text, Object[] objects)
{
return MessageFormat.format(tr(text), objects);
}
/**
* Convenience method that invokes {@link #tr(String, Object[])}.
*
* @since 0.9
*/
public final String tr(String text, Object o1)
{
return tr(text, new Object[]{ o1 });
}
/**
* Convenience method that invokes {@link #tr(String, Object[])}.
*
* @since 0.9
*/
public final String tr(String text, Object o1, Object o2)
{
return tr(text, new Object[]{ o1, o2 });
}
/**
* Convenience method that invokes {@link #tr(String, Object[])}.
*
* @since 0.9
*/
public final String tr(String text, Object o1, Object o2, Object o3)
{
return tr(text, new Object[]{ o1, o2, o3 });
}
/**
* Convenience method that invokes {@link #tr(String, Object[])}.
*
* @since 0.9
*/
public final String tr(String text, Object o1, Object o2, Object o3, Object o4)
{
return tr(text, new Object[]{ o1, o2, o3, o4 });
}
/**
* Returns the plural form for n of the translation of
* text.
*
* @param text
* the key string to be translated.
* @param pluralText
* the plural form of text.
* @param n
* value that determines the plural form
* @return the translated text
* @since 0.9
*/
public final String trn(String text, String pluralText, long n)
{
try {
return trnInternal(bundle, text, pluralText, n);
}
catch (MissingResourceException e) {
return (n == 1) ? text : pluralText;
}
}
/**
* Returns the plural form for n of the translation of
* text.
*
* @param text
* the key string to be translated.
* @param pluralText
* the plural form of text.
* @param n
* value that determines the plural form
* @param objects
* object args to be formatted and substituted.
* @return the translated text
* @since 0.9
*/
public final String trn(String text, String pluralText, long n, Object[] objects)
{
return MessageFormat.format(trn(text, pluralText, n), objects);
}
/**
* Overloaded method that invokes
* {@link #trn(String, String, long, Object[])} passing Object
* arguments as an array.
*
* @since 0.9
*/
public final String trn(String text, String pluralText, long n, Object o1)
{
return trn(text, pluralText, n, new Object[]{ o1 });
}
/**
* Overloaded method that invokes
* {@link #trn(String, String, long, Object[])} passing Object
* arguments as an array.
*
* @since 0.9
*/
public final String trn(String text, String pluralText, long n, Object o1, Object o2)
{
return trn(text, pluralText, n, new Object[]{ o1, o2 });
}
/**
* Overloaded method that invokes
* {@link #trn(String, String, long, Object[])} passing Object
* arguments as an array.
*
* @since 0.9
*/
public final String trn(String text, String pluralText, long n, Object o1, Object o2, Object o3)
{
return trn(text, pluralText, n, new Object[]{ o1, o2, o3 });
}
/**
* Overloaded method that invokes
* {@link #trn(String, String, long, Object[])} passing Object
* arguments as an array.
*
* @since 0.9
*/
public final String trn(String text, String pluralText, long n, Object o1, Object o2, Object o3, Object o4)
{
return trn(text, pluralText, n, new Object[]{ o1, o2, o3, o4 });
}
/**
* Returns the plural form for n of the translation of ???
*
* Based on GettextResource.java that is part of GNU gettext for Java
* Copyright (C) 2001 Free Software Foundation, Inc.
*
* @param bundle a ResourceBundle
* @param text the key string to be translated, an ASCII string
* @param pluralText its English plural form
* @return the translation of text depending on n,
* or text or pluralText if none is found
*/
private static String trnInternal(ResourceBundle orgBundle, String text, String pluralText, long n)
{
ResourceBundle bundle = orgBundle;
do {
boolean isGetTextBundle = false;
boolean hasPluralHandling = false;
Method handleGetObjectMethod = null;
Method getParentMethod = null;
Method lookupMethod = null;
Method pluralEvalMethod = null;
try {
handleGetObjectMethod = bundle.getClass().getMethod("handleGetObject", new Class[]{ String.class });
getParentMethod = bundle.getClass().getMethod("getParent", new Class[0]);
isGetTextBundle = Modifier.isPublic(handleGetObjectMethod.getModifiers());
lookupMethod = bundle.getClass().getMethod("lookup", new Class[]{ String.class });
pluralEvalMethod = bundle.getClass().getMethod("pluralEval", new Class[]{ Long.TYPE });
hasPluralHandling = true;
}
catch (Exception e) {}
if (isGetTextBundle) {
// GNU gettext generated bundle
if (hasPluralHandling) {
// GNU gettext generated bundle w/ plural handling
try {
Object localValue = lookupMethod.invoke(bundle, new Object[]{ text });
if (localValue.getClass().isArray()) {
String[] pluralforms = (String[])localValue;
long index = 0;
try {
index = ((Long)pluralEvalMethod.invoke(bundle, new Object[]{ new Long(n) }))
.longValue();
if (!(index >= 0 && index < pluralforms.length)) {
index = 0;
}
}
catch (IllegalAccessException e) {}
return pluralforms[(int)index];
}
else {
// Found the value. It doesn't depend on n in this
// case.
return (String)localValue;
}
}
catch (Exception e) {}
}
else {
// GNU gettext generated bundle w/o plural handling
try {
Object localValue = handleGetObjectMethod.invoke(bundle, new Object[]{ text });
if (localValue != null) {
return (String)localValue;
}
}
catch (Exception e) {}
}
bundle = null;
try {
bundle = (ResourceBundle)getParentMethod.invoke(bundle, new Object[0]);
}
catch (Exception e) {}
}
else {
return bundle.getString(text);
}
}
while (bundle != null);
throw new MissingResourceException("Can not find resource for key " + text + " in bundle "
+ orgBundle.getClass().getName(), orgBundle.getClass().getName(), text);
}
/**
* Disambiguates translation keys.
*
* @param context
* the context of the text to be translated
* @param text
* the ambiguous key message in the source locale
* @return text if the locale of the underlying resource
* bundle equals the source code locale, the disambiguated
* translation of text otherwise
*
* @see #setSourceCodeLocale(Locale)
* @since 0.9
*/
public final String trc(String context, String text)
{
if (sourceCodeLocale.equals(getResources().getLocale())) {
return text;
} else {
String key = context + CONTEXT_GLUE + text;
String translated = tr(key);
// if no translation was found return text in source locale
return translated == key ? text : translated;
}
}
/**
* Returns the plural form for n of the translation of
* text.
*
* @param context
* the context of the message to disambiguate it when translating
* @param singularText
* the key string to be translated.
* @param pluralText
* the plural form of text.
* @param n
* value that determines the plural form
* @return the translated text
* @since 0.9.5
*/
public final String trnc(String context, String singularText, String pluralText, long n) {
try {
return trnInternal(bundle, context + CONTEXT_GLUE + singularText, pluralText, n);
}
catch (MissingResourceException e) {
return (n == 1) ? singularText : pluralText;
}
}
/**
* Returns the plural form for n of the translation of
* text.
*
* @param context
* the context of the message to disambiguate it when translating
* @param singularText
* the key string to be translated.
* @param pluralText
* the plural form of text.
* @param n
* value that determines the plural form
* @param objects
* object args to be formatted and substituted.
* @return the translated text
* @since 0.9
*/
public final String trnc(String context, String singularText, String pluralText, long n, Object[] objects) {
return MessageFormat.format(trnc(context, singularText, pluralText, n), objects);
}
/**
* Overloaded method that invokes
* {@link #trnc(String, String, String, long, Object[])} passing obj
* arguments as an array.
*
* @since 0.9.5
*/
public final String trnc(String comment, String singularText, String pluralText, long n, Object obj) {
return MessageFormat.format(trnc(comment, singularText, pluralText, n), new Object[] { obj });
}
/**
* Overloaded method that invokes
* {@link #trnc(String, String, String, long, Object[])} passing obj1 and obj2
* arguments as an array.
*
* @since 0.9.5
*/
public final String trnc(String comment, String singularText, String pluralText, long n, Object obj1, Object obj2) {
return MessageFormat.format(trnc(comment, singularText, pluralText, n), new Object[] { obj1, obj2 });
}
/**
* Overloaded method that invokes
* {@link #trnc(String, String, String, long, Object[])} passing obj1, obj2 and obj3
* arguments as an array.
*
* @since 0.9.5
*/
public final String trnc(String comment, String singularText, String pluralText, long n, Object obj1, Object obj2, Object obj3) {
return MessageFormat.format(trnc(comment, singularText, pluralText, n), new Object[] { obj1, obj2, obj3 });
}
/**
* Overloaded method that invokes
* {@link #trnc(String, String, String, long, Object[])} passing obj1, obj2, obj3 and obj4
* arguments as an array.
*
* @since 0.9.5
*/
public final String trnc(String comment, String singularText, String pluralText, long n, Object obj1, Object obj2, Object obj3, Object obj4) {
return MessageFormat.format(trnc(comment, singularText, pluralText, n), new Object[] { obj1, obj2, obj3, obj4 });
}
}
gettext-commons-gettext-commons-0_9_8/src/java/org/xnap/commons/i18n/I18nCache.java 0000664 0000000 0000000 00000005070 12243607320 0030170 0 ustar 00root root 0000000 0000000 /*
* Gettext Commons
*
* Copyright (C) 2005 Felix Berger
* Copyright (C) 2005 Steffen Pingel
*
* This library 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 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package org.xnap.commons.i18n;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
/**
* Stores a list of {@link I18n} objects by a String key.
*
* @author Steffen Pingel
*/
class I18nCache {
/**
* MapI18n objects to make sure no
* extraneous objects are created.
*
* @author Felix Berger
* @author Tammo van Lessen
* @author Steffen Pingel
* @since 0.9
*/
public class I18nFactory {
private static final String BASENAME_KEY = "basename";
/**
* Use the default configuration.
*
* @since 0.9.1
*/
public static final int DEFAULT = 0;
/**
* Fall back to a default resource bundle that returns the passed text if no
* resource bundle can be located.
*
* @since 0.9.1
*/
public static final int FALLBACK = 1 << 0;
/**
* Look for files named {@link #PROPS_FILENAME} to determine the basename.
*
* @since 0.9.1
*/
public static final int READ_PROPERTIES = 2 << 0;
/**
* Do not cache {@link I18n} instance.
*
* @since 0.9.1
*/
public static final int NO_CACHE = 4 << 0;
/**
* Default name for Message bundles, is "i18n.Messages".
*
* @since 0.9.1
*/
public static final String DEFAULT_BASE_NAME = "i18n.Messages";
/**
* Filename of the properties file that contains the i18n properties, is
* "i18n.properties".
*
* @since 0.9
*/
public static final String PROPS_FILENAME = "i18n.properties";
private static final I18nCache i18nCache = new I18nCache();
private I18nFactory()
{
}
/**
* Clears the cache of i18n objects. Used by the test classes.
*/
static void clearCache()
{
i18nCache.visit(new I18nCache.Visitor() {
public void visit(I18n i18n)
{
I18nManager.getInstance().remove(i18n);
}
});
i18nCache.clear();
}
/**
* Calls {@link #getI18n(Class, Locale) getI18n(clazz, Locale.getDefault())}.
*/
public static I18n getI18n(final Class clazz)
{
return getI18n(clazz, Locale.getDefault());
}
/**
* Calls {@link #getI18n(Class, Locale, int) getI18n(clazz, locale,
* READ_PROPERTIES)}.
*
* @since 0.9.1
*/
public static I18n getI18n(final Class clazz, final Locale locale)
{
return getI18n(clazz, locale, READ_PROPERTIES);
}
/**
* Returns the I18n instance responsible for translating messages in the
* package specified by clazz.
* i18n.properties file in the
* package. The properties file is queried for a key named
* basename whose value should be the fully qualified
* resource/class name of the resource bundle, e.g
* org.xnap.commons.i18n.Messages.
* baseName.
*
* @param clazz
* the package hierarchy of the clazz and its class loader are
* used for resolving and loading the resource bundle
* @param locale
* the locale of the underlying resource bundle
* @param flags
* a combination of these configuration flags: {@link #FALLBACK}
* @return created or cached I18n instance
* @throws MissingResourceException
* if no resource bundle was found
* @since 0.9.1
*/
public static I18n getI18n(final Class clazz, final Locale locale, final int flags)
{
ClassLoader classLoader = getClassLoader(clazz.getClassLoader());
String bundleName = null;
if (isReadPropertiesSet(flags)) {
String path = clazz.getName();
int index;
do {
index = path.lastIndexOf('.');
path = (index != -1) ? path.substring(0, index) : "";
bundleName = readFromPropertiesFile(path, locale, classLoader);
}
while (bundleName == null && index != -1);
}
if (bundleName == null) {
bundleName = DEFAULT_BASE_NAME;
}
return getI18n("", bundleName, classLoader, locale, flags);
}
/**
* Calls
* {@link #getI18n(Class, String, Locale) getI18n(clazz, bundleName, Locale.getDefault())}.
*
* @since 0.9
*/
public static I18n getI18n(final Class clazz, final String bundleName)
{
return getI18n(clazz, bundleName, Locale.getDefault());
}
/**
* Calls
* {@link #getI18n(Class, String, Locale, int) getI18n(clazz, bundleName, locale, DEFAULT)}.
*
* @since 0.9.1
*/
public static I18n getI18n(final Class clazz, final String bundleName, final Locale locale)
{
return getI18n(clazz, bundleName, locale, DEFAULT);
}
/**
* Calls
* {@link #getI18n(Class, String, Locale) getI18n(getPackageName(clazz), bundleName, clazz.getClassLoader(), locale, DEFAULT)}.
*
* @since 0.9.1
*/
public static I18n getI18n(final Class clazz, final String bundleName, final Locale locale, int flags)
{
return getI18n(clazz.getName(), bundleName, clazz.getClassLoader(), locale, flags);
}
/**
* @since 0.9.1
*/
public static I18n getI18n(final String path, final String bundleName, final ClassLoader classLoader, final Locale locale,
final int flags)
{
int index;
String prefix = path;
do {
// chop of last segment of path
index = prefix.lastIndexOf('.');
prefix = (index != -1) ? prefix.substring(0, index) : "";
String name = prefix.length() == 0 ? bundleName : prefix + "." + bundleName;
// check cache
I18n i18n = i18nCache.get(name, locale);
if (i18n != null) {
return i18n;
}
// look for resource bundle in class path
i18n = findByBaseName(name, locale, getClassLoader(classLoader), flags);
if (i18n != null) {
if ((flags & NO_CACHE) == 0) {
i18nCache.put(name, i18n);
}
return i18n;
}
}
while (index != -1);
// fallback to default bundle
if (isFallbackSet(flags)) {
I18n i18n = i18nCache.get("", locale);
if (i18n == null) {
i18n = new I18n(new EmptyResourceBundle(locale));
i18nCache.put("", i18n);
}
return i18n;
}
throw new MissingResourceException("Resource bundle not found", path, bundleName);
}
static ClassLoader getClassLoader(ClassLoader classLoader) {
return (classLoader != null) ? classLoader : ClassLoader.getSystemClassLoader();
}
/**
* Tries to create an I18n instance from a properties file.
*
* @param path
* @param loader
* @return null if no properties file was found
* @throws MissingResourceException
* if properties file was found but specified resource not
*/
static String readFromPropertiesFile(final String path, final Locale locale, final ClassLoader loader)
{
Properties props = new Properties();
String filename = path.length() == 0 ? PROPS_FILENAME : path.replace('.', '/') + "/" + PROPS_FILENAME;
InputStream in = loader.getResourceAsStream(filename);
if (in != null) {
try {
props.load(in);
}
catch (IOException e) {
// XXX now what?
}
finally {
try {
in.close();
}
catch (IOException e) {
// this exception is lost
}
}
return props.getProperty(BASENAME_KEY);
}
return null;
}
/**
* Uses the class loader to look for a messages properties file.
*
* @param baseName
* the base name of the resource bundle
* @param path
* the path that prefixes baseName
* @param loader
* the class loader used to look up the bundle
* @param flags
* @return the created instance
*/
static I18n findByBaseName(final String baseName, final Locale locale, final ClassLoader loader, int flags)
{
try {
return createI18n(baseName, locale, loader, flags);
}
catch (MissingResourceException e) {
return null;
}
}
/**
* Creates a new i18n instance and registers it with {@link I18nManager}.
*
* @param baseName
* the base name of the resource bundle
* @param locale
* the locale
* @param loader
* the class loader used to look up the bundle
* @return the created instance
*/
private static I18n createI18n(final String baseName, final Locale locale, final ClassLoader loader, final int flags)
{
I18n i18n = new I18n(baseName, locale, loader);
if (!isNoCacheSet(flags)) {
I18nManager.getInstance().add(i18n);
}
return i18n;
}
private static boolean isFallbackSet(final int flags)
{
return (flags & FALLBACK) != 0;
}
private static boolean isReadPropertiesSet(final int flags)
{
return (flags & READ_PROPERTIES) != 0;
}
private static boolean isNoCacheSet(final int flags)
{
return (flags & NO_CACHE) != 0;
}
}
gettext-commons-gettext-commons-0_9_8/src/java/org/xnap/commons/i18n/I18nManager.java 0000664 0000000 0000000 00000012734 12243607320 0030544 0 ustar 00root root 0000000 0000000 /*
* Gettext Commons
*
* Copyright (C) 2005 Felix Berger
* Copyright (C) 2005 Steffen Pingel
*
* This library 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 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package org.xnap.commons.i18n;
import java.lang.ref.WeakReference;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
/**
* Manager class that maintains a set of {@link org.xnap.commons.i18n.I18n}
* objects and {@link org.xnap.commons.i18n.LocaleChangeListener} objects.
* I18n objects can be changed by
* invoking {@link org.xnap.commons.i18n.I18nManager#setDefaultLocale(Locale)}.
*
* @author Felix Berger
* @author Steffen Pingel
* @since 0.9
*/
public class I18nManager {
private static I18nManager instance = new I18nManager();
/** List of managed {@link I18n} objects. */
List i18ns = Collections.synchronizedList(new ArrayList());
/** List of managed {@link LocaleChangeListener} objects. */
List localeChangeListeners = new ArrayList();
private I18nManager()
{
}
/**
* Returns the global I18Manger singleton.
*
* @return the I18Manger instance
* @since 0.9
*/
public static I18nManager getInstance()
{
return instance;
}
/**
* Adds i18n to the list of managed I18n
* objects.
*
* @param i18n
* the I18n instance
* @see #setDefaultLocale(Locale)
* @see #remove(I18n)
* @since 0.9
*/
public void add(I18n i18n)
{
i18ns.add(i18n);
}
/**
* Sets the locale for all I18n instances that were instantiated through the
* factory.
* i18n from the list of managed I18n
* objects.
*
* @param i18n
* the I18n instance
* @see #add(I18n)
* @since 0.9
*/
public void remove(I18n i18n)
{
i18ns.remove(i18n);
}
/**
* Removes listener from the list of objects that are
* notified when the locale has changed.
*
* @param listener
* the listener
* @since 0.9
*/
public void removeLocaleChangeListener(LocaleChangeListener listener)
{
synchronized (localeChangeListeners) {
localeChangeListeners.remove(listener);
}
}
/**
* Notifies listeners of a locale change.
*
* @param newLocale
* new locale
* @since 0.9
*/
protected void fireLocaleChangedEvent(Locale newLocale)
{
LocaleChangeListener[] listeners;
synchronized (localeChangeListeners) {
listeners = (LocaleChangeListener[])localeChangeListeners.toArray(new LocaleChangeListener[0]);
}
if (listeners.length > 0) {
LocaleChangeEvent event = new LocaleChangeEvent(I18nFactory.class, newLocale);
for (int i = listeners.length - 1; i >= 0; i--) {
listeners[i].localeChanged(event);
}
}
}
private static class WeakLocaleChangeListener implements LocaleChangeListener {
private WeakReference reference;
public WeakLocaleChangeListener(LocaleChangeListener listener)
{
reference = new WeakReference(listener);
}
public void localeChanged(LocaleChangeEvent event)
{
Object listener = reference.get();
if (listener != null) {
((LocaleChangeListener)listener).localeChanged(event);
}
else {
I18nManager.getInstance().removeLocaleChangeListener(this);
}
}
}
}
gettext-commons-gettext-commons-0_9_8/src/java/org/xnap/commons/i18n/LocaleChangeEvent.java 0000664 0000000 0000000 00000003011 12243607320 0032025 0 ustar 00root root 0000000 0000000 /*
* Gettext Commons
*
* Copyright (C) 2005 Steffen Pingel
*
* This library 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 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package org.xnap.commons.i18n;
import java.util.EventObject;
import java.util.Locale;
/**
* Provides information about a locale change.
*
* @author Steffen Pingel
* @since 0.9
*/
public class LocaleChangeEvent extends EventObject {
private static final long serialVersionUID = 7640942181212009222L;
private Locale newLocale;
/**
* Constructs the event.
* @param source the source of the event
* @param newLocale the new locale
* @since 0.9
*/
public LocaleChangeEvent(Object source, Locale newLocale)
{
super(source);
this.newLocale = newLocale;
}
/**
* Returns the new locale.
*
* @return the new locale
* @since 0.9
*/
public Locale getNewLocale()
{
return newLocale;
}
}
gettext-commons-gettext-commons-0_9_8/src/java/org/xnap/commons/i18n/LocaleChangeListener.java 0000664 0000000 0000000 00000002627 12243607320 0032545 0 ustar 00root root 0000000 0000000 /*
* Gettext Commons
*
* Copyright (C) 2005 Steffen Pingel
*
* This library 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 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package org.xnap.commons.i18n;
import java.util.Locale;
/**
* Defines the requirements for classes that get notified when the locale
* is changed.
*
* +%XN$>mPKM < PK .$4
styles.xml\]r6~)4o$;j9NOI$HPBL ^_O P$eҖld&aw
(a gj {'fe|ye|ҧ^ᘛ)q:8]*X(%2FN[DžR^ʩԈ|X_qɬKs|
ޚ,ZY2>C0W>
̀ ɞ!oWƖdiYnM)Xb$T+, b1Yj9S*x#Q_REkzC8jjp
,`~eju]w-bL2]ewFo;Dϧ_\HLŭSJKU
vksK}ָwwp4v BDFmc˗vG$m5v8 IoyZ"t{s-l"/&X0FwwyGWz2=qV}c#ƶa\q0O5 aelJ3
1$̄QI$We 1U(Lْ,x&-7w@^)tHX\3
C͈|]
},p|PDnd
S\ lI
Xf®YM>ݙrrR gXPQO(_xE#+ GB1"j
˱ś m`rYs۔(DP Wj bA͟/dBAi\
ڴtDc (N[++YZ,m*։Ԣ=Tl >bH`uG!@oshH|jE c Rp:M$o55& 0,-(GJM ӄ38C#)"B pAil5u|!
uSuC+0aq3$i'@[PuOQ`d#t>b~~ִ ^9K%; `1C4N5
_
%%"5Ȕ>)h9SM"4?"BWo!Noˣ!4{? >o4O_
Ӌ#"6c
+Qk
i18n.tr(), xgettext can be used to extract these
strings for localization.