En el caso de una aplicación web JSP / Servlet básica, el enfoque básico sería utilizar JSTL fmttaglib en combinación con paquetes de recursos . Los paquetes de recursos contienen pares clave-valor donde la clave es una constante que es la misma para todos los idiomas y el valor varía según el idioma. Los paquetes de recursos suelen ser archivos de propiedades que se cargan mediante ResourceBundleAPI. Sin embargo, esto se puede personalizar para que pueda cargar los pares clave-valor desde, por ejemplo, una base de datos.
A continuación, se muestra un ejemplo de cómo internacionalizar el formulario de inicio de sesión de su aplicación web con paquetes de recursos basados en archivos de propiedades.
Cree los siguientes archivos y colóquelos en algún paquete, por ejemplo com.example.i18n(en el caso de Maven, colóquelos en la estructura del paquete src/main/resources).
text.properties (contiene pares clave-valor en el idioma predeterminado, generalmente inglés)
login.label.username = Nombre de usuario
login.label.password = Contraseña
login.button.submit = Iniciar sesión
text_nl.properties(contiene nlpares clave-valor holandés ( ))
login.label.username = Gebruikersnaam
login.label.password = Wachtwoord
login.button.submit = Inloggen
text_es.properties(contiene espares clave-valor en español ( ))
login.label.username = Nombre de usuario
login.label.password = Contraseña
login.button.submit = Acceder
El nombre de archivo del paquete de recursos debe seguir el siguiente patrón name_ll_CC.properties. La _llparte debe ser el código de idioma ISO 693-1 en minúsculas . Es opcional y solo se requiere cuando la _CCpieza está presente. La _CCparte debe ser el código de país ISO 3166-1 Alpha-2 en mayúsculas . Es opcional y, a menudo, solo se usa para distinguir entre dialectos de idiomas específicos de un país, como el inglés americano ( _en_US) y el inglés británico ( _en_GB).
Si aún no lo ha hecho, instale JSTL. Si está ejecutando en un contenedor Servlet 2.5 o más reciente (Tomcat 6.0 y así sucesivamente) y web.xmlse declara que cumple con la especificación Servlet 2.5, simplemente coloque jstl-1.2.jar en la /WEB-INF/libcarpeta de la aplicación web .
Cree el siguiente archivo JSP de ejemplo y colóquelo en la carpeta de contenido web.
login.jsp
<%@ page pageEncoding="UTF-8" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<c:set var="language" value="${not empty param.language ? param.language : not empty language ? language : pageContext.request.locale}" scope="session" />
<fmt:setLocale value="${language}" />
<fmt:setBundle basename="com.example.i18n.text" />
<!DOCTYPE html>
<html lang="${language}">
<head>
<title>JSP/JSTL i18n demo</title>
</head>
<body>
<form>
<select id="language" name="language" onchange="submit()">
<option value="en" ${language == 'en' ? 'selected' : ''}>English</option>
<option value="nl" ${language == 'nl' ? 'selected' : ''}>Nederlands</option>
<option value="es" ${language == 'es' ? 'selected' : ''}>Español</option>
</select>
</form>
<form method="post">
<label for="username"><fmt:message key="login.label.username" />:</label>
<input type="text" id="username" name="username">
<br>
<label for="password"><fmt:message key="login.label.password" />:</label>
<input type="password" id="password" name="password">
<br>
<fmt:message key="login.button.submit" var="buttonValue" />
<input type="submit" name="submit" value="${buttonValue}">
</form>
</body>
</html>
El <c:set var="language">maneja el idioma actual. Si el idioma se proporcionó como parámetro de solicitud (mediante el menú desplegable de idiomas), se establecerá. De lo contrario, si el idioma ya se estableció previamente en la sesión, apéguese a él. De lo contrario, utilice la configuración regional proporcionada por el usuario en el encabezado de la solicitud.
El <fmt:setLocale>establece la configuración regional para paquete de recursos. Es importante que esta línea esté antes del <fmt:setBundle>.
El <fmt:setBundle>inicializa el paquete de recursos por su nombre de base (es decir, el nombre completo paquete calificado hasta con el único nombre sin el _ll_CCespecificador).
Las <fmt:message>recupera el valor de la tecla de mensajes lote especificado.
Los <html lang="${language}">informa al searchbots qué idioma se encuentra en la página de modo que no se marcará como contenido duplicado (por lo tanto, bueno para SEO).
El menú desplegable de idiomas se enviará inmediatamente por JavaScript cuando se elija otro idioma y la página se actualizará con el idioma recién elegido.
Sin embargo, debe tener en cuenta que los archivos de propiedades se leen de forma predeterminada con la codificación de caracteres ISO-8859-1. Debería escapar de ellos mediante escapes Unicode. Esto se puede hacer utilizando la native2ascii.exeherramienta suministrada por JDK . Consulte también la sección de este artículo para obtener más detalles.
Una alternativa teórica sería proporcionar un paquete con una costumbre Controlpara cargar esos archivos como UTF-8, pero desafortunadamente no es compatible con el fmttaglib básico de JSTL . Debería gestionarlo todo usted mismo con la ayuda de a Filter. Hay marcos (MVC) que pueden manejar esto de una manera más transparente, como JSF, consulte también este artículo .