Servlet Internationalisation
Avant de commencer, examinons trois termes importants :
- Internationalisation (i18n) :Cela signifie qu'un site web fournit différentes versions du contenu traduites dans la langue ou la nationalité du visiteur.
- Localisation (l10n) :Cela signifie ajouter des ressources à un site web pour l'adapter à une région géographique ou culturelle spécifique, par exemple, traduire le site web en hindi.
- Locale :Il s'agit d'une région culturelle ou géographique spécifique. Elle est généralement représentée par un symbole de langue suivi d'un trait de soulignement et d'un symbole de pays. Par exemple, "en_US" représente la locale anglaise pour les États-Unis.
Il y a certaines considérations à prendre en compte lors de la création d'un site web mondial. Ce tutoriel ne couvrira pas tous les détails de ces considérations, mais il démontrera à travers un bon exemple comment faire en sorte que les pages web s'affichent dans différentes langues grâce à un positionnement différencié (c'est-à-dire la locale).
Un servlet peut choisir la version appropriée du site web en fonction de la locale du demandeur, et fournir la version correspondante du site web selon la langue, la culture et les besoins locaux. Voici les méthodes de l'objet request qui renvoient des objets Locale.
java.util.Locale request.getLocale()
Détection de la locale
Voici une liste de méthodes importantes relatives à la locale que vous pouvez utiliser pour détecter l'emplacement géographique, la langue et la locale du demandeur. Toutes les méthodes suivantes affichent le nom du pays et le nom de la langue définis dans le navigateur du demandeur.
| Séq. | Metode & Deskripsi |
|---|---|
| 1 | String getCountry() Cette méthode renvoie le code de pays/région des paramètres régionaux au format ISO 3166 avec 2 lettres majuscules. |
| 2 | String getDisplayCountry() Cette méthode renvoie le nom du pays des paramètres régionaux adapté à l'affichage à l'utilisateur. |
| 3 | String getLanguage() Cette méthode renvoie le code de langue des paramètres régionaux au format ISO 639 avec des lettres minuscules. |
| 4 | String getDisplayLanguage() Cette méthode renvoie le nom de la langue des paramètres régionaux adapté à l'affichage à l'utilisateur. |
| 5 | String getISO3Country() Cette méthode renvoie l'abréviation à trois lettres du pays des paramètres régionaux. |
| 6 | String getISO3Language() Cette méthode renvoie l'abréviation à trois lettres de la langue des paramètres régionaux. |
Exemple
Cet exemple montre comment afficher la langue et le pays associé d'une requête :
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.Locale;
public class GetLocale extends HttpServlet{
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 获取客户端的区域设置
Locale locale = request.getLocale();
String language = locale.getLanguage();
String country = locale.getCountry();
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
String title = "检测区域设置";
String docType = "<!DOCTYPE html> \n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n" +
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1 align=\"center\">" + language + "</h1>\n" +
"<h2 align=\"center\">" + country + "</h2>\n" +
"</body></html>");
}
}
Paramètres de langue
Un Servlet peut générer des pages écrites dans des langues d'Europe occidentale (telles que l'anglais, l'espagnol, l'allemand, le français, l'italien, le néerlandais, etc.). Ici, pour afficher correctement tous les caractères, il est très important de définir l'en-tête Content-Language.
Le deuxième point consiste à utiliser des entités HTML pour afficher tous les caractères spéciaux, par exemple, "ñ" représente "ñ", "¡" représente "¡", comme indiqué ci-dessous :
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.Locale;
public class DisplaySpanish extends HttpServlet{
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
// 设置西班牙语言代码
response.setHeader("Content-Language", "es");
String title = "En Español";
String docType = "<!DOCTYPE html> \n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n" +
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1>" + "En Español:" + "</h1>\n" +
"<h1>" + "¡Hola Mundo!" + "</h1>\n" +
"</body></html>");
}
}
Dates spécifiques à la locale
Vous pouvez utiliser la classe java.text.DateFormat et sa méthode statique getDateTimeInstance() pour formater des dates et des heures propres à des paramètres régionaux. L'exemple suivant montre comment formater des dates propres à des paramètres régionaux donnés :
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.Locale;
import java.text.DateFormat;
import java.util.Date;
public class DateLocale extends HttpServlet{
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
// 获取客户端的区域设置
Locale locale = request.getLocale( );
String date = DateFormat.getDateTimeInstance(
DateFormat.FULL,
DateFormat.SHORT,
locale).format(new Date( ));
String title = "特定于区域设置的日期";
String docType = "<!DOCTYPE html> \n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n" +
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1 align=\"center\">" + date + "</h1>\n" +
"</body></html>");
}
}
Devise spécifique à la locale
Vous pouvez utiliser la classe java.text.NumberFormat et sa méthode statique getCurrencyInstance() pour formater des nombres (comme les types long ou double) en devise propre à des paramètres régionaux. L'exemple suivant montre comment formater une devise propre à des paramètres régionaux donnés :
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.Locale;
import java.text.NumberFormat;
import java.util.Date;
public class CurrencyLocale extends HttpServlet{
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
// 获取客户端的区域设置
Locale locale = request.getLocale( );
NumberFormat nft = NumberFormat.getCurrencyInstance(locale);
String formattedCurr = nft.format(1000000);
String title = "特定于区域设置的货币";
String docType = "<!DOCTYPE html> \n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n" +
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1 align=\"center\">" + formattedCurr + "</h1>\n" +
"</body></html>");
}
}
Pourcentages spécifiques à la locale
Vous pouvez utiliser la classe java.text.NumberFormat et sa méthode statique getPercentInstance() pour formater des pourcentages propres à des paramètres régionaux. L'exemple suivant montre comment formater des pourcentages propres à des paramètres régionaux donnés :
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.Locale;
import java.text.NumberFormat;
import java.util.Date;
public class PercentageLocale extends HttpServlet{
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
// 获取客户端的区域设置
Locale locale = request.getLocale( );
NumberFormat nft = NumberFormat.getPercentInstance(locale);
String formattedPerc = nft.format(0.51);
String title = "特定于区域设置的百分比";
String docType = "<!DOCTYPE html> \n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n" +
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1 align=\"center\">" + formattedPerc + "</h1>\n" +
"</body></html>");
}
}
Autres extensions