Locale provides translations and format dates and currencies depending on the chosen localization.
* *Copyright Enough Software 2004, 2005, 2006, 2007 - 2009
** history * 09-Sep-2004 - rob creation ** @author Robert Virkus, j2mepolish@enough.de */ public final class Locale { private static short[][] multipleParameterOrders; private static String[][] multipleParameterTranslations; //#if polish.i18n.useDynamicTranslations || polish.LibraryBuild private static String[] plainTranslations; private static String[] singleParameterTranslationsStart; private static String[] singleParameterTranslationsEnd; private static boolean isLoaded; private static boolean isLoadError; /* static { try { //#if polish.locale:defined //#= loadTranslations( "/${polish.locale}.loc" ); //#else loadTranslations( "/default.loc" ); //#endif } catch (IOException e ) { //#if polish.locale:defined //#= String fileName = "/${polish.locale}.loc"; //#else String fileName = "/default.loc"; //#endif } } */ //#endif // do not change the following line! //$$IncludeLocaleDefinitionHere$$// //#ifdef polish.LibraryBuild /** The ISO language code, * e.g. "en" for English. */ public static String LANGUAGE = "en"; /** * The ISO country code, * e.g. "US" for USA * This is null when no country is defined in the current locale. */ public static String COUNTRY = "US"; /** The localized language name, * e.g. "English" or "Deutsch" */ public static String DISPLAY_LANGUAGE = "English"; /** * The localized country name, * e.g. "United States" or "Deutschland". * This is null when no country is defined in the current locale. */ public static String DISPLAY_COUNTRY = "United States"; /** * The symbol of the currency, * e.g. "$" or "€". * This is null when no country is defined in the current locale. */ public static String CURRENCY_SYMBOL = "$"; /** * The international three letter code of the currency, * e.g. "USD" or "EUR". * This is null when no country is defined in the current locale. */ public static String CURRENCY_CODE = "USD"; /** * The character used for decimal sign. * This is a '-' by default. */ public static char MINUS_SIGN = '-'; /** * The character used for zero. * This is a '0' by default. */ public static char ZERO_DIGIT = '0'; /** * The character used for decimal sign. * This is a dot by default. */ public static char DECIMAL_SEPARATOR = '.'; /** * The monetary decimal separator. * This is a dot by default. */ public static char MONETARY_DECIMAL_SEPARATOR = '.'; /** * The character used for thousands separator. * This is a comma by default. */ public static char GROUPING_SEPARATOR = ','; /** * The character used to represent a percent value. */ public static char PERCENT = '%'; /** * The character used to represent a permill value. */ public static char PERMILL = '\u2030'; /** * The string used to represent infinity. */ public static String INFINITY = "\u221e"; private Locale() { // no instantiation allowed } //#endif //#if polish.i18n.useDynamicTranslations || polish.LibraryBuild private static void initialize() { //#if polish.Locale.initializeMethod:defined //#include ${polish.Locale.initializeMethod} //#else //#if polish.i18n.useExternalTranslations && (polish.midp || polish.usePolishGui) RecordStore store = null; try { store = RecordStore.openRecordStore("_translations", false); RecordEnumeration enumeration = store.enumerateRecords(null, null, false); if (enumeration.hasNextElement()) { // store does already exist: byte[] data = enumeration.nextRecord(); loadTranslations( new DataInputStream( new ByteArrayInputStream( data ) ) ); isLoaded = true; isLoadError = false; return; } } catch (Exception e) { } finally { if (store != null) { try { store.closeRecordStore(); } catch (Exception e) { // ignore } } } //#endif try { String loc = null; InputStream in = null; String meLocale = System.getProperty("microedition.locale"); if (meLocale != null) { loc = "/" + meLocale + ".loc"; in = loc.getClass().getResourceAsStream(loc); if (in == null && meLocale.length() > 2) { // try to load just the language: loc = "/" + meLocale.substring(0, 2) + ".loc"; in = loc.getClass().getResourceAsStream(loc); } } if (in == null) { //#if polish.locale:defined //#= loc = "/${polish.locale}.loc"; //#else loc = "/default.loc"; //#endif in = loc.getClass().getResourceAsStream(loc); } if (in != null) { loadTranslations( new DataInputStream( in ) ); isLoaded = true; isLoadError = false; } else { isLoadError = true; } } catch (Exception e) { isLoadError = true; } //#endif } //#endif //#if polish.i18n.useDynamicTranslations || polish.LibraryBuild /** * Retrieves the translation for the specified key. * * @param key the key, e.g. "labels.StartGame" * @return the translation, e.g. "Start Game" or "Spiel starten", null when the key was not found */ //#if polish.LibraryBuild public static final String get( String key ) { int keyId = 0; //#else //# public static final String get( int keyId ) { //#endif if ( !isLoaded ) { initialize(); if (isLoadError) { return ""; } } // all simple translations are usually directly embedded into the source-code, // so this method does only need to be implemenented when dynamic translations are used: //#if polish.debug.error try { //#endif return plainTranslations[ keyId ]; //#if polish.debug.error } catch (Exception e) { return "
* String[] params = new String[]{ "Peter", "Jordan" };
* String translation = Locale . get( "titles.boxing", params );
*
*
* @return the translation, e.g. "Peter vs Jordan" or "Peter gegen Jordan"
* @throws NullPointerException when the given parameters are null or if one of the given parameters is null.
*/
//#ifdef polish.LibraryBuild
public static final String get( String key, String[] parameters ) {
//#else
//# public static final String get( int keyId, String[] parameters ) {
//#endif
//#ifdef polish.LibraryBuild
short keyId = 0;
//#endif
//#ifdef polish.i18n.useDynamicTranslations
if ( !isLoaded ) {
initialize();
if (isLoadError) {
return "";
}
}
//#endif
// Reshuffle the parameters:
// CHECK: There could be more or less parameters than expected, e.g.
// "hello {2}, you are a {0}"???
// --> some parameters can be ignored
final short[] reorder = multipleParameterOrders[ keyId ];
final String[] reorderedParameters;
if (reorder != null) {
reorderedParameters = new String[ reorder.length ];
for (int i = 0; i < reorderedParameters.length; i++) {
reorderedParameters[i] = parameters[ reorder[i] ];
}
} else {
reorderedParameters = parameters;
}
// Now merge the value with the reordered parameters:
final String[] valueChunks = multipleParameterTranslations[ keyId ];
final StringBuffer result = new StringBuffer();
for (int i = 0; i < reorderedParameters.length; i++) {
String value = valueChunks[i];
result.append( value )
.append( reorderedParameters[ i ]);
}
for (int i = reorderedParameters.length; i < valueChunks.length; i++) {
result.append( valueChunks[i] );
}
// return result:
return result.toString();
}
/**
* Formats the given date to the current locale's format.
* This method just calls the formatDate-method with a new Date instance.
*
* @param time the time in milliseconds after 1.1.1970 GMT.
* @return the locale specific date representation.
* @throws NullPointerException when the date is null
* @see #formatDate(Date)
*/
public static String formatDate( long time ) {
return formatDate( new Date( time ) );
}
/**
* Formats the given date to the current locale's format.
* This method just calls the formatDate-method with a new Calendar instance.
*
* @param date the date
* @return the locale specific date representation.
* @throws NullPointerException when the date is null
* @see #formatDate(Calendar)
*/
public static String formatDate( Date date ) {
Calendar calendar = Calendar.getInstance();
calendar.setTime(date);
return formatDate( calendar );
}
/**
* Formats the given calendar to the current locale's format.
*
* @param calendar the calendar which holds the date
* @return the locale specific date representation.
* @throws NullPointerException when the calendar is null
*/
public static String formatDate( Calendar calendar ) {
StringBuffer buffer = new StringBuffer(10);
formatDate( calendar, buffer );
return buffer.toString();
}
/**
* Formats the given calendar to the current locale's format.
* Use this method for best efficiency.
*
* @param calendar the calendar which holds the date
* @param buffer a StringBuffer, should be at least 10 characters big
* @throws NullPointerException when the calendar is null
*/
public static void formatDate( Calendar calendar, StringBuffer buffer ) {
int year = calendar.get(Calendar.YEAR);
int month = calendar.get( Calendar.MONTH );
int day = calendar.get( Calendar.DAY_OF_MONTH );
//#if polish.DateFormat == mdy
if (month < 9) {
buffer.append('0');
}
buffer.append( ++month )
//#if polish.DateFormatSeparator:defined
//#= .append("${polish.DateFormatSeparator}");
//#else
.append("-");
//#endif
if (day < 10) {
buffer.append( '0' );
}
buffer.append( day )
//#if polish.DateFormatSeparator:defined
//#= .append("${polish.DateFormatSeparator}");
//#else
.append("-");
//#endif
buffer.append( year );
//#elif polish.DateFormat == dmy
if (day < 10) {
buffer.append( '0' );
}
buffer.append( day )
//#if polish.DateFormatSeparator:defined
//#= .append("${polish.DateFormatSeparator}");
//#else
.append("-");
//#endif
if (month < 9) {
buffer.append('0');
}
buffer.append( ++month )
//#if polish.DateFormatSeparator:defined
//#= .append("${polish.DateFormatSeparator}");
//#else
.append("-");
//#endif
buffer.append( year );
//#else
// default to YMD
buffer.append( year )
//#if polish.DateFormatSeparator:defined
//#= .append("${polish.DateFormatSeparator}");
//#else
.append("-");
//#endif
if (month < 9) {
buffer.append('0');
}
buffer.append( ++month )
//#if polish.DateFormatSeparator:defined
//#= .append("${polish.DateFormatSeparator}");
//#else
.append("-");
//#endif
if (day < 10) {
buffer.append( '0' );
}
buffer.append( day );
//#endif
}
/**
* Formats the given time as a time string, e.g. '13:45' or '1:45 PM'
* @param time the time in milliseconds since 1.1.1970
* @return the formatted time
*/
public static String formatTime(long time)
{
return formatTime( new Date(time) );
}
/**
* Formats the given time as a time string, e.g. '13:45' or '1:45 PM'
* @param time the date
* @return the formatted time
*/
public static String formatTime(Date time)
{
Calendar calendar = Calendar.getInstance();
calendar.setTime(time);
return formatTime( calendar );
}
/**
* Formats the given time as a time string, e.g. '13:45' or '1:45 PM'
* @param time the date
* @return the formatted time
*/
public static String formatTime(Calendar time)
{
StringBuffer buffer = new StringBuffer();
formatTime( time, buffer );
return buffer.toString();
}
/**
* Formats the given time as a time string, e.g. '13:45' or '1:45 PM'
* @param time the date
* @param buffer the buffer to which the time should be added
*/
public static void formatTime(Calendar time, StringBuffer buffer)
{
//TODO right now only 24 hour system is supported
int hours = time.get(Calendar.HOUR_OF_DAY);
buffer.append( hours ).append(':');
int minutes = time.get( Calendar.MINUTE );
if (minutes < 10) {
buffer.append('0');
}
buffer.append( minutes );
}
//#if polish.i18n.useDynamicTranslations || polish.LibraryBuild
/**
* Loads translations from the specified file which is embedded in the JAR file.
* Attention: only when the preprocessing symbol "polish.i18n.useExternalTranslations" is defined,
* J2ME Polish will automatically load the stored translations at the next startup of the application.
* In other cases you need to manually check if the "_translations" recordstore exists and load the data
* from the first recordset using Locale.loadTranslations( DataIn ).
*
* @param in the data input stream
* @throws IOException when there was an error reading the translations
*/
public static void loadAndStoreTranslations( InputStream in )
throws IOException
{
}
//#endif
//#if polish.i18n.useDynamicTranslations || polish.LibraryBuild
/**
* Loads translations from the specified file which is embedded in the JAR file.
*
* @param url the URL of the file, e.g. "/en.loc" or "/es.loc" - do not forget the required forward slash at the beginning of the URL
* @throws IOException when there was an error reading the translations
*/
public static void loadTranslations( String url )
throws IOException
{
InputStream is = url.getClass().getResourceAsStream( url );
if (is == null) {
//System.out.println("!!!!!Cannot find: " + url );
throw new IOException();
}
loadTranslations( new DataInputStream( is ) );
}
//#endif
//#if polish.i18n.useDynamicTranslations || polish.LibraryBuild
/**
* Loads translations from the specified input stream.
*
* @param in the data input stream
* @throws IOException when there was an error reading the translations
*/
public static void loadTranslations( DataInput in )
throws IOException
{
try {
// read plain translations without any parameters:
int numberOfPlainTranslations = in.readInt();
String[] plainTs = new String[ numberOfPlainTranslations ];
//System.out.println("Loading " + numberOfPlainTranslations + " translations...");
for (int i = 0; i < numberOfPlainTranslations; i++) {
plainTs[i] = in.readUTF();
//System.out.println(i + "=" + plainTs[i]);
}
plainTranslations = plainTs;
// read single parameter translations:
int numberOfSingleParameterTranslations = in.readInt();
String[] singleParamsTsStart = new String[ numberOfSingleParameterTranslations ];
String[] singleParamsTsEnd = new String[ numberOfSingleParameterTranslations ];
for (int i = 0; i < numberOfSingleParameterTranslations; i++) {
singleParamsTsStart[i] = in.readUTF();
singleParamsTsEnd[i] = in.readUTF();
}
singleParameterTranslationsStart = singleParamsTsStart;
singleParameterTranslationsEnd = singleParamsTsEnd;
// read translations with several parameters:
int numberOfMultipleParametersTranslations = in.readInt();
String[][] translationChunks = new String[ numberOfMultipleParametersTranslations ][];
short[][] orders = new short[ numberOfMultipleParametersTranslations ][];
for (int i = 0; i < numberOfMultipleParametersTranslations; i++) {
int numberOfChunks = in.readUnsignedByte();
String[] chunkValues = new String[ numberOfChunks ];
for (int j = 0; j < numberOfChunks; j++) {
chunkValues[j] = in.readUTF();
}
short[] chunkOrders = new short[ numberOfChunks - 1 ];
for (int j = 0; j < numberOfChunks-1; j++) {
chunkOrders[j] = (short) in.readUnsignedByte();
}
translationChunks[i] = chunkValues;
orders[i] = chunkOrders;
}
multipleParameterOrders = orders;
multipleParameterTranslations = translationChunks;
// now load language name etc:
LANGUAGE = in.readUTF();
DISPLAY_LANGUAGE = in.readUTF();
MINUS_SIGN = in.readChar();
ZERO_DIGIT = in.readChar();
DECIMAL_SEPARATOR = in.readChar();
MONETARY_DECIMAL_SEPARATOR = in.readChar();
GROUPING_SEPARATOR = in.readChar();
PERCENT = in.readChar();
PERMILL = in.readChar();
INFINITY = in.readUTF();
String country = in.readUTF();
if (country.length() > 0) {
COUNTRY = country;
DISPLAY_COUNTRY = in.readUTF();
CURRENCY_SYMBOL = in.readUTF();
CURRENCY_CODE = in.readUTF();
} else {
COUNTRY = null;
DISPLAY_COUNTRY = null;
CURRENCY_SYMBOL = null;
CURRENCY_CODE = null;
}
isLoaded = true;
isLoadError = false;
} catch (IOException e) {
throw e;
} catch (Exception e) {
throw new IOException( e.toString() );
}
}
//#endif
}