W przypadku podstawowej aplikacji sieciowej JSP / Servlet, podstawowym podejściem byłoby użycie biblioteki fmt
taglib JSTL w połączeniu z pakunkami zasobów . Pakiety zasobów zawierają pary klucz-wartość, w których klucz jest stałą, która jest taka sama dla wszystkich języków, a wartość różni się w zależności od języka. Pakiety zasobów są zwykle plikami właściwości ładowanymi przez ResourceBundle
interfejs API. Można to jednak dostosować, aby można było załadować pary klucz-wartość na przykład z bazy danych.
Oto przykład, jak umiędzynarodowić formularz logowania do aplikacji internetowej za pomocą pakietów zasobów opartych na plikach właściwości.
Utwórz następujące pliki i umieść je w jakimś pakiecie, np. com.example.i18n
(W przypadku Mavena, umieść je w strukturze pakietu w środku src/main/resources
).
text.properties
(zawiera pary klucz-wartość w domyślnym języku, zwykle angielskim)
login.label.username = nazwa użytkownika
login.label.password = Hasło
login.button.submit = Zaloguj się
text_nl.properties
(zawiera nl
pary klucz-wartość w języku holenderskim ( ))
login.label.username = Gebruikersnaam
login.label.password = Wachtwoord
login.button.submit = Inloggen
text_es.properties
(zawiera es
pary klucz-wartość w języku hiszpańskim ( ))
login.label.username = Nombre de usuario
login.label.password = Contraseña
login.button.submit = Acceder
Nazwa pliku pakietu zasobów powinna być zgodna z następującym wzorcem name_ll_CC.properties
. _ll
Część powinna być małe litery ISO 693-1 kod języka. Jest to opcjonalne i wymagane tylko wtedy, gdy _CC
część jest obecna. _CC
Część powinna być wielka ISO 3166-1 alfa-2 kod kraju. Jest opcjonalny i często używany tylko do rozróżniania dialektów języka specyficznego dla danego kraju, takich jak amerykański angielski ( _en_US
) i brytyjski angielski ( _en_GB
).
Jeśli jeszcze tego nie zrobiłeś, zainstaluj JSTL. Jeśli korzystasz z kontenera Servlet 2.5 lub nowszego (Tomcat 6.0 i tak dalej) i web.xml
deklarujesz zgodność ze specyfikacją Servlet 2.5, po prostu umieść jstl-1.2.jar w /WEB-INF/lib
folderze webapp .
Utwórz następujący przykładowy plik JSP i umieść go w folderze treści WWW.
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>
<c:set var="language">
Zarządza bieżący język. Jeśli język został podany jako parametr żądania (z listy rozwijanej języka), zostanie ustawiony. W przeciwnym razie, jeśli język był już ustawiony w sesji, zamiast tego trzymaj się go. W przeciwnym razie użyj ustawień regionalnych podanych przez użytkownika w nagłówku żądania.
<fmt:setLocale>
Ustawia locale dla pakunku zasobów. To ważne, że ta linia jest przed<fmt:setBundle>
.
<fmt:setBundle>
Inicjuje pakunek zasobów przez jego nazwy bazowej (czyli pełna kwalifikowana nazwa pakietu aż wyłącznie w imieniu bez _ll_CC
specyfikacją).
W <fmt:message>
Pobiera wartość wiadomość przez określonego klucza wiązki.
Na <html lang="${language}">
informuje searchbots co język strona jest w tak, że nie będą oznaczone jako duplikaty (co za tym idzie, dobre dla SEO).
Menu rozwijane języka zostanie natychmiast przesłane przez JavaScript po wybraniu innego języka, a strona zostanie odświeżona w nowo wybranym języku.
Należy jednak pamiętać, że pliki właściwości są domyślnie odczytywane przy użyciu kodowania znaków ISO-8859-1. Musiałbyś uciec przed nimi przez ucieczki unicode. Można to zrobić za pomocą native2ascii.exe
narzędzia dostarczonego przez JDK . Więcej szczegółów można znaleźć w tej sekcji artykułu .
Teoretyczną alternatywą byłoby dostarczenie pakietu z niestandardowym Control
ładowaniem tych plików jako UTF-8, ale niestety nie jest to obsługiwane przez podstawową bibliotekę fmt
taglib JSTL . Musiałbyś zarządzać tym wszystkim samodzielnie za pomocą pliku Filter
. Istnieją struktury (MVC), które mogą sobie z tym poradzić w bardziej przejrzysty sposób, jak JSF, zobacz także ten artykuł .