* 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 I18n 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.
*
* 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 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.
*
* If after the first iteration no I18n instance has been found, a second
* search begins by looking for resource bundles having the name
* baseName.
*
* @param clazz
* the package hierarchy of the clazz and its class loader are
* used for resolving and loading the resource bundle
* @param baseName
* the name of the underlying 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;
}
}
libgettext-commons-java-0.9.6/src/java/org/xnap/commons/i18n/I18nManager.java 0000644 0001750 0001750 00000012734 11137433153 027063 0 ustar giovanni giovanni /*
* 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.
*
* The locale of all managed 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.
*
* 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 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);
}
}
}
}
libgettext-commons-java-0.9.6/src/java/org/xnap/commons/i18n/LocaleChangeListener.java 0000644 0001750 0001750 00000002627 10765242507 031073 0 ustar giovanni giovanni /*
* 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.
*
*
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);
}
libgettext-commons-java-0.9.6/src/java/org/xnap/commons/i18n/I18nCache.java 0000644 0001750 0001750 00000005070 11137433153 026507 0 ustar giovanni giovanni /*
* 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 {
/**
* Map
* To learn how message strings wrapped in one of the
* 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
* 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
* 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
* Occurrences of {number} placeholders in text are replaced by
*
* Invokes
* {@link MessageFormat#format(java.lang.String, java.lang.Object[])}.
*
* @param text
* text to translate
* @param objects
* arguments to Provides classes for internationalization (i18n). To learn how to make use of the Gettext Commons internationalization,
please have a look at this tutorial.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.
* 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.
* 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.
* 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.
* objects.
* 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 translation of
* comment 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 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.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 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 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 });
}
}
libgettext-commons-java-0.9.6/src/java/org/xnap/commons/i18n/LocaleChangeEvent.java 0000644 0001750 0001750 00000003011 11137433336 030347 0 ustar giovanni giovanni /*
* 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;
}
}
libgettext-commons-java-0.9.6/src/java/org/xnap/commons/i18n/package.html 0000644 0001750 0001750 00000000532 10765242507 026467 0 ustar giovanni giovanni
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");
}
}
} libgettext-commons-java-0.9.6/src/examples/ 0000755 0001750 0001750 00000000000 11271112344 021100 5 ustar giovanni giovanni libgettext-commons-java-0.9.6/src/examples/en.properties 0000644 0001750 0001750 00000001655 10765242510 023635 0 ustar giovanni giovanni # SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR