Internacionalización (i18n) con Visual JSF

(Versión Wiki: http://wiki.netbeans.org/TaT_I18nVisualJSF)

Todos sabemos que escribir un texto rígido (hard-code) en nuestras aplicaciones no es una buena práctica. Esto cubre también a los textos de los formularios. Todo debemos pasarlo a variables, y si modificamos el contenido de la variable, toda la aplicación donde usa esa variable, se actualizarán automáticamente. Bueno, eso lo sabemos todo.

Los mensajes de la interfaz de usuario - ya sea web o desktop - deben estar almacenados en un archivo de recurso llamado .properties. Además, estos tipos de archivos permiten la internacionalización (i18n)

En la web de Sun existe un tutorial sobre la i18n, y esta es Trail: Internationalization

Aquí veremos como usar el archivo .properties para Visual JSF.

Para comenzar, diseñaremos un formulario simple como este:

Ahora, en el panel del proyecto, dentro del paquete del código fuente, buscamos el archivo Bundle.properties.

Editamos este archivo de tal manera que tengan los textos necesarios para nuestro formulario. Si es necesario, también usamos su texto localizado.

Bundle.properties:

app_upload_title=Load files package
app_upload_file=Select package
app_upload_submit=Submit

Bundle_es.properties:

app_upload_title=Cargar paquete de archivos
app_upload_file=Indique paquete de archivos
app_upload_submit=Cargar

Regresamos al editor visual de nuestra aplicación. De la paleta de componentes, en la categoría Advanced buscamos el elemento Load Bundle

Lo seleccionamos, lo arrastramos y lo soltamos sobre la ventana de editor visual. No pasará nada visual, pero si vemos en el panel Navegador veremos que existe el elemento loadBundle

Ahora, volvemos a enfocarnos en el editor visual. Seleccionamos un elemento, por ejemplo el Static text que está en la parte superior. a este elemento escribimos en la propiedad text lo siguiente: #{messages1.app_upload_title}, para el componente label colocamos: #{messages1.app_upload_file}, y para el botton colocamos: #{messages1.app_upload_submit}

Al final del diseño, el editor mostrará lo siguiente

Ahora, cuando desplegamos la aplicación, veremos que lucirá así:

Ahora, en adelante, si necesitamos modificar un texto, solo modificamos el archivo Bundle.properties