Servlet 國際化

在我們開始之前，先來看看三個重要術語：

國際化（i18n）：這意味著一個網站提供了不同版本的翻譯成訪客的語言或國籍的內容。
在地化（l10n）：這意味著在網站上添加資源，以使其適應特定的地理或文化區域，例如網站翻譯成印地文（Hindi）。
區域設定（locale）：這是一個特殊的文化或地理區域。它通常指語言符號後面跟著一個底線和一個國家符號。例如 "en_US" 表示針對 US 的英語區域設定。

當建立一個全球性的網站時有一些注意事項。本教學不會講解這些注意事項的完整細節，但它會透過一個很好的實例向您示範如何透過差異化定位（即區域設定）來讓網頁以不同語言呈現。

Servlet 可以根據請求者的區域設定拾取相應版本的網站，並根據當地的語言、文化和需求提供相應的網站版本。以下是 request 物件中傳回 Locale 物件的方法。

java.util.Locale request.getLocale()

偵測區域設定

下面列出了重要的區域設定方法，您可以使用它們來偵測請求者的地理位置、語言和區域設定。下面所有的方法都顯示了請求者瀏覽器中設定的國家名稱和語言名稱。

序號	#方法& 描述
#1	String getCountry( ) 此方法以2 個大寫字母形式的ISO 3166 格式傳回該區域設定的國家代碼。
2	String getDisplayCountry() 此方法傳回適合向使用者顯示的區域設定的國家的名稱。
3	String getLanguage() 該方法以小寫字母形式的 ISO 639 格式傳回該區域設定的語言代碼。
4	String getDisplayLanguage() 該方法傳回適合向使用者顯示的區域設定的語言的名稱。
5	String getISO3Country() 此方法傳回該區域設定的國家的三個字母縮寫。
6	String getISO3Language() 此方法傳回該區域設定的語言的三個字母的縮寫。

實例

本實例示範如何顯示某個請求的語言和相關的國家：

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");
      PrintWriter out = response.getWriter();

      String title = "检测区域设置";
      String docType =
      "<!doctype html public \"-//w3c//dtd html 4.0 " +
      "transitional//en\">\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>");
  }
}

語言設定

Servlet 可以輸出以西歐語言（如英語、西班牙語、德語、法語、義大利語、荷蘭語等）所寫的頁面。在這裡，為了能正確顯示所有的字符，設定 Content-Language 頭是非常重要的。

第二點是使用HTML 實體顯示所有的特殊字符，例如，"ñ" 表示"ñ"，"¡" 表示"¡"，如下所示：

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");
    PrintWriter out = response.getWriter();
    // 设置西班牙语言代码
    response.setHeader("Content-Language", "es");

    String title = "En Espa&ntilde;ol";
    String docType =
     "<!doctype html public \"-//w3c//dtd html 4.0 " +
     "transitional//en\">\n";
     out.println(docType +
     "<html>\n" +
     "<head><title>" + title + "</title></head>\n" +
     "<body bgcolor=\"#f0f0f0\">\n" +
     "<h1>" + "En Espa&ntilde;ol:" + "</h1>\n" +
     "<h1>" + "&iexcl;Hola Mundo!" + "</h1>\n" +
     "</body></html>");
  }
}

特定於區域設定的日期

您可以使用java.text.DateFormat 類別及其靜態方法getDateTimeInstance() 來格式化特定於區域設定的日期和時間。下面的實例示範如何格式化特定於某個給定的區域設定的日期：

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");
    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 public \"-//w3c//dtd html 4.0 " +
      "transitional//en\">\n";
      out.println(docType +
      "<html>\n" +
      "<head><title>" + title + "</title></head>\n" +
      "<body bgcolor=\"#f0f0f0\">\n" +
      "<h1 align=\"center\">" + date + "</h1>\n" +
      "</body></html>");
  }
}

特定於區域設定的貨幣

您可以使用java.text.NumberFormat 類別及其靜態方法getCurrencyInstance() 來格式化數字（例如long 類型或double 類型）為特定於區域設定的貨幣。下面的實例示範如何格式化特定於某個給定的區域設定的貨幣：

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");
    PrintWriter out = response.getWriter();
    // 获取客户端的区域设置
    Locale locale = request.getLocale( );
    NumberFormat nft = NumberFormat.getCurrencyInstance(locale);
    String formattedCurr = nft.format(1000000);

    String title = "特定于区域设置的货币";
    String docType =
      "<!doctype html public \"-//w3c//dtd html 4.0 " +
      "transitional//en\">\n";
      out.println(docType +
      "<html>\n" +
      "<head><title>" + title + "</title></head>\n" +
      "<body bgcolor=\"#f0f0f0\">\n" +
      "<h1 align=\"center\">" + formattedCurr + "</h1>\n" +
      "</body></html>");
  }
}

特定於區域設定的百分比

您可以使用java.text.NumberFormat 類別及其靜態方法getPercentInstance() 來格式化特定於區域設定的百分比。下面的實例示範如何格式化特定於某個給定的區域設定的百分比：

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");
    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 public \"-//w3c//dtd html 4.0 " +
      "transitional//en\">\n";
      out.println(docType +
      "<html>\n" +
      "<head><title>" + title + "</title></head>\n" +
      "<body bgcolor=\"#f0f0f0\">\n" +
      "<h1 align=\"center\">" + formattedPerc + "</h1>\n" +
      "</body></html>");
  }
}