Aplicaciones Internacionalizadas en Java
Cuando diseñamos una aplicación Java, tenemos que tener en cuenta tanto las necesidades actuales como futuras de nuestra aplicación.
Es posible que pensemos que nuestro programa solo necesita mostrar mensajes en nuestro idioma local (en este caso castellano) pero, con mucha probabilidad, en un futuro cercano deba funcionar en otros ….. pongase Ingles, Catalán, etc
Una vez completada una aplicación, sin tener este factor en cuenta, el coste
de internacionalizarla y realizar las prubas de regresión puede ser muy elevado
o incluso …. puede ser necesario un rediseño completo.
Java, propociona un conjunto de clases para facilitarnos esta labor…
Locale
Un Locale representa una región concreta … podemos ver la seleccionada
actualmente.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 |
package roberto; /* * primerPrograma.java * * Created on July 16, 2003, 3:53 AM */ import java.text.*; import java.util.*; /** * * @author Administrator */ public class <b>primerPrograma</b> { /** Constructor por defecto de la clase */ public primerPrograma() { } /** * Punto de entrada estático de la aplicación * @param args recibe los parámetros de linea de comando */ public static void main(String[] args) { primerPrograma oInstanciaLocal = new primerPrograma(); oInstanciaLocal.ejecutaProceso(); } /** * Ejecutamos el proceso como un instancia local */ private void <b>ejecutaProceso</b>() { <font color="#FF0000"><b> Locale lDefecto = Locale.getDefault(); muestraDatosLocale(lDefecto);</b></font> <font color="#0000FF"><b>Locale[] listaLocales = Locale.getAvailableLocales(); for(int i=0 ; i < listaLocales.length ; i++) { muestraDatosLocaleTab(listaLocales[i]); }</b></font> } void muestraDatosLocale(Locale lActual) { <font color="#FF0000"> depura("El pais mostrado es: " +lActual.getDisplayCountry()); depura("El pais es: " +lActual.getCountry()); depura("El lenguaje actual es: " + lActual.getLanguage()); depura("La varidedad del lenguaje es: " + lActual.getDisplayVariant()); depura("El pais actual es: " +lActual.getLanguage()); depura("El nobre actual es: " +lActual.getDisplayName()); try { depura("El pais ISO actual es: " +lActual.getISO3Country()); depura("El lenguaje ISO actual es: " +lActual.getISO3Language()); depura(""); } catch (Exception e) { }</font> } void muestraDatosLocaleTab(Locale lActual) { <font color="#0000FF"> muestraSimple(lActual.getDisplayCountry()); muestraSimple(lActual.getCountry()); muestraSimple(lActual.getLanguage()); muestraSimple(lActual.getDisplayVariant()); muestraSimple(lActual.getLanguage()); muestraSimple(lActual.getDisplayName()); try { muestraSimple(lActual.getISO3Country()); muestraSimple(lActual.getISO3Language()); depura(""); } catch (Exception e) { }</font> } void muestraSimple(String pCadena) { System.out.print(pCadena + "\t"); } void depura(String pCadena) { System.out.println(pCadena); } } |
|
La salida actual es:
Y todas las actualmente definidas (las hemos importado en excel)
Crear una nueva localización
Vamos a crear una localización que represente España
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
package roberto; /* * primerPrograma.java * * Created on July 16, 2003, 3:53 AM */ import java.text.*; import java.util.*; /** * * @author Administrator */ public class <b>primerPrograma</b> { /** Constructor por defecto de la clase */ public primerPrograma() { } /** * Punto de entrada estático de la aplicación * @param args recibe los parámetros de linea de comando */ public static void main(String[] args) { primerPrograma oInstanciaLocal = new primerPrograma(); oInstanciaLocal.ejecutaProceso(); } /** * Ejecutamos el proceso como un instancia local */ private void <b>ejecutaProceso</b>() { <font color="#0000FF"> Locale lDefecto = Locale.getDefault(); muestraDatosLocale(lDefecto); </font><font color="#FF0000"> Locale lCastellano = new Locale("ES","es"); muestraDatosLocale(lCastellano);</font><font color="#0000FF"> </font> } void <b>muestraDatosLocale</b>(Locale lActual) { depura("El pais mostrado es: " +lActual.getDisplayCountry()); depura("El pais es: " +lActual.getCountry()); depura("El lenguaje actual es: " + lActual.getLanguage()); depura("La varidedad del lenguaje es: " + lActual.getDisplayVariant()); depura("El pais actual es: " +lActual.getLanguage()); depura("El nobre actual es: " +lActual.getDisplayName()); try { depura("El pais ISO actual es: " +lActual.getISO3Country()); depura("El lenguaje ISO actual es: " +lActual.getISO3Language()); depura(""); } catch (Exception e) { } } void <b>depura</b>(String pCadena) { System.out.println(pCadena); } } |
|
La salida del programa es
|
|
<font color="#0000FF">El pais mostrado es: United States El pais es: US El lenguaje actual es: en La varidedad del lenguaje es: El pais actual es: en El nobre actual es: English (United States) El pais ISO actual es: USA El lenguaje ISO actual es: eng</font> <font color="#FF0000">El pais mostrado es: Spain El pais es: ES El lenguaje actual es: es La varidedad del lenguaje es: El pais actual es: es El nobre actual es: Spanish (Spain) El pais ISO actual es: ESP El lenguaje ISO actual es: spa</font> |
|
Ficheros de recursos para cada idioma
En siguiente paso sería crear una mecanismo para que en función del idioma,
se utilice un juego particular.
Podemos crear un fichero de propiedades, que tengan la misma clave y un valor
distinto para cada idioma. Solo tenemos que tener la precaucion de saber como
nombrarlos….
Recurrimos a la ayuda Java
Nos ayudamos de NetBeans para crear el fichero de propiedades
Seleccionamos el nombre
Añadimos una versión «localizada»
Seleccionamos Español de España
Comprobamos que se ha creado y pulsamos el botón de nueva
propiedad
Creamos una nueva propiedad (ver que tenemos seleccionado
la versión local españona)
Podemos editar la tabla para cambiar el texto en la inglesa
Realmente se han creado dos ficheros en el sistema
Si vemos el Ingles tiene este aspecto
| # Sample ResourceBundle properties file
#Este es el saludo de bienvenida
SALUDO=Hello Word |
Y el castellano
| # Sample ResourceBundle properties file
#Este es el saludo de bienvenida
SALUDO=Hola compa\u00F1eros |
Si ejecutamos nuestro programa
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 |
package roberto; /* * primerPrograma.java * * Created on July 16, 2003, 3:53 AM */ import java.text.*; import java.util.*; /** * * @author Administrator */ public class <b>primerPrograma</b> { /** Constructor por defecto de la clase */ public <b>primerPrograma</b>() { } /** * Punto de entrada estático de la aplicación * @param args recibe los parámetros de linea de comando */ public static void main(String[] args) { primerPrograma oInstanciaLocal = new primerPrograma(); oInstanciaLocal.ejecutaProceso(); } /** * Ejecutamos el proceso como un instancia local */ private void <b>ejecutaProceso</b>() { <font color="#0000FF"> Locale </font><font color="#FF0000">lDefecto</font><font color="#0000FF"> = Locale.getDefault(); muestraDatosLocale(lDefecto); ResourceBundle </font><b><font color="#FF0000">recursos</font></b><font color="#0000FF"> = ResourceBundle.getBundle("CRecursosApp",</font><font color="#FF0000">lDefecto</font><font color="#0000FF">); depura("El saludo en Ingles es: " + </font><b><font color="#FF0000">recursos.getString("SALUDO")</font></b><font color="#0000FF">); Locale <b>lCastellano</b> = new <b>Locale("ES","es");</b> muestraDatosLocale(lCastellano); <b>recursos</b> = ResourceBundle.<b>getBundle</b>("CRecursosApp",<b>lCastellano</b>); depura("El saludo en Castellano es: " + <b>recursos.getString("SALUDO")</b>);</font> } void <b>muestraDatosLocale</b>(Locale lActual) { depura("El pais mostrado es: " +lActual.getDisplayCountry()); depura("El pais es: " +lActual.getCountry()); depura("El lenguaje actual es: " + lActual.getLanguage()); depura("La varidedad del lenguaje es: " + lActual.getDisplayVariant()); depura("El pais actual es: " +lActual.getLanguage()); depura("El nobre actual es: " +lActual.getDisplayName()); try { depura("El pais ISO actual es: " +lActual.getISO3Country()); depura("El lenguaje ISO actual es: " +lActual.getISO3Language()); depura(""); } catch (Exception e) { } } void <b>depura</b>(String pCadena) { System.out.println(pCadena); } } |
|
La salida es
|
|
El pais mostrado es: United States El pais es: US El lenguaje actual es: en La varidedad del lenguaje es: El pais actual es: en El nobre actual es: English (United States) El pais ISO actual es: USA El lenguaje ISO actual es: eng <font color="#FF0000"><b>El saludo en Ingles es: Hello Word</b></font> |
|
|
El pais mostrado es: Spain El pais es: ES El lenguaje actual es: es La varidedad del lenguaje es: El pais actual es: es El nobre actual es: Spanish (Spain) El pais ISO actual es: ESP El lenguaje ISO actual es: spa <b><font color="#0000FF">El saludo en Castellano es: Hola compañeros</font></b> |
|
Normalmente los mensajes no son solo texto sino que hay que intercalar
variables dentro del mensaje.
Todo esto ya esta pensado ….
Podemos definir en nuestra cadena de caracteres … por indice basado en 0
…
Es decir … del tipo
| Hello Word, user number {0} of today, day {1} |
Modificamos nuestro código … podemos recuperar la cadena y crear un
formateador
MessageFormat
fCadenaFormatear = new MessageFormat(recursos.getString(«SALUDO»));
Creamos un array
Object
aoParametros[] = {«1»,new Date()};
Y decimos que se combinen ambos
fCadenaFormatear.format(aoParametros)
En el caso de la cadena en castellano, podemos decir que los objetos se
formatéen, usando los parámetros locales
fCadenaFormatear.setLocale(lCastellano);
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 |
package roberto; /* * primerPrograma.java * * Created on July 16, 2003, 3:53 AM */ import java.text.*; import java.util.*; /** * * @author Administrator */ public class <b>primerPrograma</b> { /** Constructor por defecto de la clase */ public <b>primerPrograma</b>() { } /** * Punto de entrada estático de la aplicación * @param args recibe los parámetros de linea de comando */ public static void main(String[] args) { primerPrograma oInstanciaLocal = new primerPrograma(); oInstanciaLocal.ejecutaProceso(); } /** * Ejecutamos el proceso como un instancia local */ private void <b>ejecutaProceso</b>() { <font color="#FF0000"> Locale lDefecto = Locale.getDefault(); ResourceBundle recursos = ResourceBundle.getBundle("CRecursosApp",lDefecto); MessageFormat fCadenaFormatear = new MessageFormat(recursos.getString("SALUDO")); Object aoParametros[] = {"1",new Date()}; depura("Cadena Formateada en Ingles " + fCadenaFormatear.format(aoParametros)); </font> // ahora en castellano <font color="#0000FF"> Locale lCastellano = new Locale("ES","es"); recursos = ResourceBundle.getBundle("CRecursosApp",lCastellano); fCadenaFormatear = new MessageFormat(recursos.getString("SALUDO")); <b>fCadenaFormatear.setLocale(lCastellano);</b> depura("Cadena Formateada en Castellano es " + fCadenaFormatear.format(aoParametros)); </font> } void depura(String pCadena) { System.out.println(pCadena); } } |
|
La salida, podemos ver que aparece tal y como deseamos.
Cadena Formateada en Ingles Hello Word, user number 1 of today, day 7/18/03 8:57 AM
Cadena Formateada en Castellano es Hola eres el usuario 1 de hoy, dia
18/07/03 8:57 |
Podemos especificar el formato con más detalle
Modificando la cadena, sin modificar el programa
Hello Word, user number {0,number,
#,000.##} of today, day {1,date,short} |
La salida es:
Cadena Formateada en Ingles Hello Word, user number 001 of today, day
7/18/03
Cadena Formateada en Castellano es Hola eres el usuario 1 de hoy, dia 18/07/03 9:29 |
Sobre el
Autor ..
