Aplicación multilenguaje con Java y Properties

El archivo Properties visto en un post anterior (Crear y Leer archivos Properties), puede servirnos tambien para crear aplicaciones multilenguaje, por ejemplo guardar en cada archivo la estructura del idioma que utilizamos y en otros archivos el lenguaje al que deseamos traducir nuestra aplicacion, osea:

Creamos una interfaz en Netbeans e identificamos todos los objetos a los cuales cambiaremos la propiedad TEXT, marcados con un punto rojo.

Creamos los archivos .Properties para cada lenguaje.


Para el idioma español podemos tener:

# Idioma español
#
# @web http://jc-mouse.blogspot.com/
# @author Mouse
#

#titulo aplicacion
titulo=Aplicación Multilenguaje

!Datos personales
titulo_datos=Datos Personales
nombre=Nombre:
Apellidos=Apellidos:
mail=Correo Electronico:
dir=Dirección:
fono=Telefono:

#salir
salir=Salir

! menu
archivo=Archivo
nuevo=Nuevo
abrir=Abrir...
guardar=Guardar como...
!Salir

herramientas=Herramientas
es=Español
en=Ingles

ayuda=Ayuda
enlinea=Ayuda en linea...
acerca=Acerca de...

Y para el ingles:

# Idioma Ingles
#
# @web http://jc-mouse.blogspot.com/
# @author Mouse
#

#titulo aplicacion
titulo=Multilingual Application

!Datos personales
titulo_datos=Personal Data
nombre=First Name:
Apellidos=Last Name:
mail=Your Email:
dir=Address:
fono=Phone:

#salir
salir=Exit

! menu
archivo=File
nuevo=New
abrir=Open...
guardar=Save as...
!Salir

herramientas=Tools
es=Spanish
en=English

ayuda=Help
enlinea=Online Help...
acerca=About..

Como puede verse, la cantidad de elementos en ambos archivos propeties, es la misma, asi tambien el KEY para cada parametro tambien es la misma, solo cambia el contenido de estos, uno en español y otro en ingles.

Nos creamos una clase para cargar estos archivos:

import java.io.IOException;
import java.util.Properties;
/**
 * @web http://jc-mouse.blogspot.com/
 * @author Mouse
 */
public class jcProperties extends Properties{

    public jcProperties(String idioma){
        if(idioma.equals("ES")){//español
            getProperties("_ES.properties");
        }else if(idioma.equals("EN")){//Ingles
            getProperties("_EN.properties");
        }else{//sino por default idioma español
            getProperties("ES");
        }
    }

    /* se leen las propiedades */
     private void getProperties(String idioma) {
        try {                
            this.load( getClass().getResourceAsStream(idioma) );
        } catch (IOException ex) {            
        }
   }

}

y solo resta utilizar esta clase en el JFrame

Codigo fuente del proyecto en Netbeans 6.9

continue reading

Crear y leer archivos .Properties en Netbeans

Los archivos .Properties son utilizados en java generalmente para almacenar parametros configurables de una aplicación como traducciones, valores, direcciones web, etc.

PROYECTO NETBEANS
1. Crear un nuevo proyecto en Netbeans, llamaño por ejemplo: jcProperties_Sample.

2. Para crear un nuevo archivo .Properties en el proyecto, clic derecho sobre el paquete en donde se creara el archivo, escoger NUEVO - > OTRO.

3. En la ventana que aparece escoger la opcion OTRO y despues buscar "Archivo de Propiedades", seleccionarlo y presionar siguiente.

4. En esta ventana se debe dar un nombre unico al archivo, para nuestro ejemplo, lo llamaremos "datos", presione TERMINAR para crear el archivo

5. El proyecto debe tener la siquiente forma:

6.  Netbeans nos crea un archivo ,Properties vacio, debemos colocar algunos datos para continuar, por ejemplo, coloca los siguientes datos.

Cada parametro de un archivo .Properties, se almacena en dos partes, la primera la KEY (clave) y el segundo el valor del parametro , la primera nos sirve para identificar nuestro parametro en Java y el segundo es el  valor almacenado en ese parametro. Para los comentarios se utiliza el simbolo "#", tambien se puede utilizar el simbolo de exclamación "!", si se desea escribir mas de una linea, se utiliza el simbolo "\" al final de cada linea.

7. Si llegaste hasta aqui podras ver en el menu de Proyectos, como esta distribuido el archivo .Properties en la aplicación, creamos cuatro parametros en el paso 6 y estos pueden verse distribuidos en el archivo de propieades.

Hasta el momento ya tenemos creado y llenado el archivo de propiedades, ahora veremos como utilizarlo.

8. Crea una nueva clase, llamala jcProperties.java

El codigo para la clase es:

package jcproperties_sample;

import java.io.IOException;
import java.util.Properties;
/**
 * @web http://jc-mouse.blogspot.com/
 * @author Mouse
 */
public class jcProperties {

  public Properties getProperties() {
        try {
            //se crea una instancia a la clase Properties
            Properties propiedades = new Properties();
            //se leen el archivo .properties
            propiedades.load( getClass().getResourceAsStream("datos.properties") );
            //si el archivo de propiedades NO esta vacio retornan las propiedes leidas
            if (!propiedades.isEmpty()) {                
                return propiedades;
            } else {//sino  retornara NULL
                return null;
            }
        } catch (IOException ex) {
            return null;
        }
   }
}

Esta clase, te permite leer el archivo .Properties que esta contenido dentro del JAR de la aplicación, tambien puede utilizarse archivos externos sin ningun problema.

9. Para implementar este clase, por el momento solo desde consola, el codigo para la clase MAIN es:

package jcproperties_sample;

import java.util.Properties;

/**
*  @web http://jc-mouse.blogspot.com/
 * @author Mouse
 */
public class Main {

    public static void main(String[] args) {
        //se crea una instancia a nuestra clase
        Properties mispropiedades = new jcProperties().getProperties();
        //se leen las propiedades indicando el KEY (identificador) y se imprime
        System.out.println(mispropiedades.getProperty("Description"));
        System.out.println(mispropiedades.getProperty("Question"));
        System.out.println(mispropiedades.getProperty("Warning"));
        System.out.println(mispropiedades.getProperty("Important"));
        //si no existe la KEY que indicamos, este devolvera NULL
        System.out.println();
        System.out.println("Key no existe devuelve: " + mispropiedades.getProperty("keynoexiste"));
    }

}

10. Ejecuta el proyecto, si hiciste todo bien, podras ver el siguiente resultado

El codigo fuente del proyecto

continue reading