Traducir una página JSF con Java

oblancarte — Thu, 15 Dec 2016 09:00:27 +0000

Con la penetración que está teniendo el Internet en todo el mundo, cada vez es más importante traducir nuestras páginas web, debido a que los visitantes ya pueden venir de cualquier parte del mundo, es por eso que los sitios más importantes o que buscan captar visitantes de otras regiones, permitan a sus usuarios cambiar de idioma.

Pueda que de entrada parezca algo muy complicado o laborioso de hacer, sin embargo, es mucho más simple de lo que te puedas imaginar.

Para explicar cómo funciona la Internacionalización (I18N), lo explicaremos mediante un ejemplo simple pero eficaz, implementaremos una página de Login, la cual se verá de la siguiente manera:

El código completo lo puedes descargar de GitHub (https://github.com/oscarjb1/Blog-TranslateApp.git).

Básicamente, esta página nos permitirá cambiar entre inglés y español, seleccionando el idioma deseado en la parte superior derecha de la pantalla. Tras seleccionar el nuevo idioma, la página de recargara con el nuevo idioma.

Veamos cómo es que esto es posible. Primero que nada, será necesario crear un archivo properties por cada idioma que soportará nuestra aplicación. Para nuestro ejemplo, solo requerimos de dos archivos como se ven a continuación:

messages.properties:

Contiene las traducciones por default, en este caso Ingles.

areYou = ¿Are you Oscar?
changeUsr = change user
userName = Username
userNamePlaceholder = oscar@gmail.com
password = Password
passwordPlaceholder = Your password
remember = Remember
login = login

message_es_ES.properties:

Contiene las traducciones en español. Prestemos atención en el nombre, pues es sumamente importante, la primera parte “message” podría tener cualquier valor, pero todos los idiomas soportados deberán iniciar con el mismo nombre., sin embargo, lo que viene a continuación es sumamente importante para identificar el idioma, la segunda sección “es” indica el idioma (español) y la tercera parte “ES” el país (España).

Podemos observar que las traducciones en inglés, no requieren país ni idioma, pues los hemos configurado como el idioma default, esto quiere decir que este idioma se utilizara en caso de no tener una coincidencia para el idioma del usuario.

Para configurar el idioma default, es necesario definirlo en el archivo faces-config.xml y deberá quedar de la siguiente manera:

areYou = ¿No eres Oscar?
changeUsr = cambia de usuario
userName = Usuario
userNamePlaceholder = oscar@gmail.com
password = Contraseña
passwordPlaceholder = Tu contraseña
remember = Recordarme
login = Entrar

Básicamente definiremos el idioma default ( ) y los idiomas soportados (). La sección debe de coincidir con el paquete en el que están los archivos de traducción, junto con la primera sección del nombre (messages). De esta forma JSF sabe, basado en este path + el idioma y el país, es posible determinar el archivo exacto a utilizar. Finalmente, le indicamos que las traducciones las pase a una variable ( ) llamada msg.

Por otra parte, tenemos el archivo JSF donde creamos la presentación:




    
        Facelet Title

    
    
        
        
             

                
                    
                        
                            
                            
                        
                    

                

                
                    
                    #{msg['areYou']} #{msg['changeUsr']}

Observemos que todos los valores traducibles están con la sintaxis #{msg[‘property’]} , donde property es el nombre de la propiedad a traducir de los archivos de traducción.

La traducción se dispara cuando cambiamos el idioma en el componte, selectOneMenu el cual dispara un evento que es escuchado por el Bean LoginBean , el cual vemos a continuación:

package com.osb.translateapp.beans;

import java.io.Serializable;
import java.util.Locale;
import java.util.logging.Logger;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
import javax.faces.component.UIViewRoot;
import javax.faces.context.FacesContext;
import javax.faces.event.ValueChangeEvent;

/**
 * @author Oscar Blancarte
 */
@ManagedBean
@SessionScoped
public class LoginBean implements Serializable{

    private String lang;
    private String username;
    private String password;
    private boolean remember;
    
    public String getLang() {
        return lang;
    }

    public void setLang(String lang) {
        this.lang = lang;
    }

    public boolean isRemember() {
        return remember;
    }

    public void setRemember(boolean remember) {
        this.remember = remember;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public void changeLang(ValueChangeEvent e) {
        Object newValue = e.getNewValue();
        this.lang = newValue.toString();
        Logger.getAnonymousLogger().severe("new lang ==> " + newValue.toString());
        UIViewRoot viewRoot = FacesContext.getCurrentInstance().getViewRoot();
        viewRoot.setLocale(new Locale(newValue.toString()));
    }

    public void login() {
    }
}

Cuando un nuevo idioma es seleccionado el método changeLang es ejecutado y el nuevo idioma es establecido mediante la línea:

viewRoot.setLocale(new Locale(newValue.toString()));

Después de esto, la pantalla es recargada con el nuevo idioma. Es tan simple como eso.

NOTA: Los estilos para que la página se vea tal cuan aparece en la imagen, los puedes descargar del repositorio de GitHub que menciona anteriormente.

The post Traducir una página JSF con Java appeared first on Oscar Blancarte - Software Architecture.

I18N – Oscar Blancarte – Software Architecture

Traducir una página JSF con Java