Struts2 - การแปลเป็นภาษาท้องถิ่นสากล (i18n)

Internationalization (i18n) เป็นกระบวนการในการวางแผนและการนำผลิตภัณฑ์และบริการไปใช้เพื่อให้สามารถปรับให้เข้ากับภาษาและวัฒนธรรมเฉพาะท้องถิ่นได้อย่างง่ายดายซึ่งเป็นกระบวนการที่เรียกว่า localization กระบวนการทำให้เป็นสากลเรียกว่าการเปิดใช้งานการแปลหรือการแปล

Internationalization เป็นคำย่อ i18n เพราะคำเริ่มต้นด้วยตัวอักษร “i” และลงท้ายด้วย “n”และมี 18 อักขระระหว่าง i ตัวแรกและ n ตัวสุดท้าย

Struts2 ให้การแปลเป็นภาษาท้องถิ่นเช่นการสนับสนุนสากล (i18n) ผ่านบันเดิลทรัพยากรตัวสกัดกั้นและไลบรารีแท็กในตำแหน่งต่อไปนี้ -

แท็ก UI
ข้อความและข้อผิดพลาด
ภายในคลาสแอ็กชัน

กลุ่มทรัพยากร

Struts2 ใช้รีซอร์สบันเดิลเพื่อจัดเตรียมตัวเลือกภาษาและโลแคลหลายภาษาให้กับผู้ใช้เว็บแอ็พพลิเคชัน คุณไม่จำเป็นต้องกังวลเกี่ยวกับการเขียนเพจในภาษาต่างๆ สิ่งที่คุณต้องทำคือสร้างชุดทรัพยากรสำหรับแต่ละภาษาที่คุณต้องการ ชุดทรัพยากรจะประกอบด้วยชื่อเรื่องข้อความและข้อความอื่น ๆ ในภาษาของผู้ใช้ของคุณ บันเดิลทรัพยากรคือไฟล์ที่มีคู่คีย์ / ค่าสำหรับภาษาเริ่มต้นของแอปพลิเคชันของคุณ

รูปแบบการตั้งชื่อที่ง่ายที่สุดสำหรับไฟล์ทรัพยากรคือ -

bundlename_language_country.properties

ที่นี่ bundlenameอาจเป็น ActionClass, Interface, SuperClass, Model, Package, Global resource properties ส่วนถัดไปlanguage_country แสดงถึงภาษาของประเทศเช่นภาษาสเปน (สเปน) แสดงด้วย es_ES และภาษาอังกฤษ (สหรัฐอเมริกา) แสดงด้วย en_US เป็นต้นซึ่งคุณสามารถข้ามส่วนของประเทศซึ่งเป็นทางเลือกได้

เมื่อคุณอ้างอิงองค์ประกอบข้อความตามคีย์ Struts framework จะค้นหาบันเดิลข้อความที่เกี่ยวข้องตามลำดับต่อไปนี้ -

ActionClass.properties
Interface.properties
SuperClass.properties
model.properties
package.properties
struts.properties
global.properties

ในการพัฒนาแอปพลิเคชันของคุณในหลายภาษาคุณควรรักษาไฟล์คุณสมบัติหลายไฟล์ที่สอดคล้องกับภาษา / สถานที่เหล่านั้นและกำหนดเนื้อหาทั้งหมดในรูปแบบของคู่คีย์ / ค่า

ตัวอย่างเช่นหากคุณกำลังจะพัฒนาแอปพลิเคชันของคุณสำหรับภาษาอังกฤษแบบสหรัฐอเมริกา (ค่าเริ่มต้น) สเปนและฝรั่งเศสคุณจะต้องสร้างไฟล์คุณสมบัติสามไฟล์ ที่นี่ฉันจะใช้global.properties ไฟล์เท่านั้นคุณยังสามารถใช้ไฟล์คุณสมบัติต่างๆเพื่อแยกข้อความประเภทต่างๆ

global.properties - โดยค่าเริ่มต้นจะใช้ภาษาอังกฤษ (สหรัฐอเมริกา)
global_fr.properties - จะใช้สำหรับ Franch locale
global_es.properties - จะใช้สำหรับภาษาสเปน

เข้าถึงข้อความ

มีหลายวิธีในการเข้าถึงทรัพยากรข้อความ ได้แก่ getText แท็กข้อความแอตทริบิวต์คีย์ของแท็ก UI และแท็ก i18n ให้เราดูโดยสังเขป -

เพื่อแสดง i18n ข้อความใช้โทรไปที่ getText ในแท็กคุณสมบัติหรือแท็กอื่น ๆ เช่นแท็ก UI ดังนี้ -

<s:property value = "getText('some.key')" />

text tag ดึงข้อความจากบันเดิลรีซอร์สดีฟอลต์เช่น struts.properties

<s:text name = "some.key" />

i18n tagผลักดันบันเดิลทรัพยากรโดยพลการไปยังกองค่า แท็กอื่น ๆ ภายในขอบเขตของแท็ก i18n สามารถแสดงข้อความจากบันเดิลทรัพยากรนั้น

<s:i18n name = "some.package.bundle">
   <s:text name = "some.key" />
</s:i18n>

key แอตทริบิวต์ของแท็ก UI ส่วนใหญ่สามารถใช้เพื่อสร้างข้อความจากชุดทรัพยากร -

<s:textfield key = "some.key" name = "textfieldName"/>

ตัวอย่างการแปล

ให้เรากำหนดเป้าหมายเพื่อสร้าง index.jspจากบทก่อนหน้าในหลายภาษา ไฟล์เดียวกันจะถูกเขียนดังนี้ -

<%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
   pageEncoding = "ISO-8859-1"%>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd">

<html>
   <head>
      <title>Employee Form with Multilingual Support</title>
   </head>

   <body>
      <h1><s:text name = "global.heading"/></h1>

      <s:url id = "indexEN" namespace="/" action = "locale" >
         <s:param name = "request_locale" >en</s:param>
      </s:url>
      
      <s:url id = "indexES" namespace="/" action = "locale" >
         <s:param name = "request_locale" >es</s:param>
      </s:url>
      
      <s:url id = "indexFR" namespace="/" action = "locale" >
         <s:param name = "request_locale" >fr</s:param>
      </s:url>

      <s:a href="%{indexEN}" >English</s:a>
      <s:a href="%{indexES}" >Spanish</s:a>
      <s:a href="%{indexFR}" >France</s:a>

      <s:form action = "empinfo" method = "post" namespace = "/">
         <s:textfield name = "name" key = "global.name" size = "20" />
         <s:textfield name = "age" key = "global.age" size = "20" />
         <s:submit name = "submit" key = "global.submit" />
      </s:form>

   </body>
</html>

เราจะสร้าง success.jsp ซึ่งจะถูกเรียกใช้ในกรณีที่กำหนดการดำเนินการส่งคืน SUCCESS.

<%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
	pageEncoding = "ISO-8859-1"%>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
   "http://www.w3.org/TR/html4/loose.dtd">

<html>
   <head>
      <title>Success</title>
   </head>
   
   <body>
      <s:property value = "getText('global.success')" />
   </body>
</html>

ที่นี่เราจะต้องสร้างสองการกระทำต่อไปนี้ (a) ขั้นแรกดำเนินการ a เพื่อดูแล Locale และแสดงไฟล์ index.jsp เดียวกันด้วยภาษาที่แตกต่างกัน (b) การดำเนินการอีกอย่างหนึ่งคือดูแลการส่งแบบฟอร์มเอง การดำเนินการทั้งสองจะส่งคืนความสำเร็จ แต่เราจะดำเนินการที่แตกต่างกันตามค่าที่ส่งคืนเนื่องจากวัตถุประสงค์ของเราแตกต่างกันสำหรับทั้งการกระทำ

การดำเนินการเพื่อดูแล Locale

package com.tutorialspoint.struts2;

import com.opensymphony.xwork2.ActionSupport;

public class Locale extends ActionSupport {
   public String execute() {
       return SUCCESS;
   }
}

การดำเนินการในการส่งแบบฟอร์ม

package com.tutorialspoint.struts2;

import com.opensymphony.xwork2.ActionSupport;

public class Employee extends ActionSupport{
   private String name;
   private int age;
   
   public String execute() {
      return SUCCESS;
   }
   
   public String getName() {
      return name;
   }
   
   public void setName(String name) {
      this.name = name;
   }
   
   public int getAge() {
      return age;
   }
   
   public void setAge(int age) {
      this.age = age;
   }
}

ตอนนี้ให้เราสร้างสามต่อไปนี้ global.properties ไฟล์และใส่ไฟล์ CLASSPATH -

global.properties

global.name = Name
global.age = Age
global.submit = Submit
global.heading = Select Locale
global.success = Successfully authenticated

global_fr.properties

global.name = Nom d'utilisateur 
global.age = l'âge
global.submit = Soumettre des
global.heading = Sé lectionnez Local
global.success = Authentifi	é  avec succès

global_es.properties

global.name = Nombre de usuario
global.age = Edad
global.submit = Presentar
global.heading = seleccionar la configuracion regional
global.success = Autenticado correctamente

เราจะสร้างไฟล์ struts.xml โดยมีสองการกระทำดังนี้ -

<?xml version = "1.0" Encoding = "UTF-8"?>
<!DOCTYPE struts PUBLIC
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
   "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
   <constant name = "struts.devMode" value = "true" />
   <constant name = "struts.custom.i18n.resources" value = "global" />
   <package name = "helloworld" extends = "struts-default" namespace="/">
      <action name = "empinfo" 
         class = "com.tutorialspoint.struts2.Employee"
         method = "execute">
         <result name = "input">/index.jsp</result>
         <result name = "success">/success.jsp</result>
      </action>
      
      <action name = "locale" 
         class = "com.tutorialspoint.struts2.Locale"
         method = "execute">
         <result name = "success">/index.jsp</result>
      </action>
   </package>

</struts>

ต่อไปนี้เป็นเนื้อหาของ web.xml ไฟล์ -

<?xml version = "1.0" Encoding = "UTF-8"?>
<web-app xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xmlns = "http://java.sun.com/xml/ns/javaee"
   xmlns:web = "http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee
   http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
   id = "WebApp_ID" version = "3.0">

   <display-name>Struts 2</display-name>
   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>

   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.FilterDispatcher
      </filter-class>
   </filter>

   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>
</web-app>

ตอนนี้คลิกขวาที่ชื่อโครงการแล้วคลิก Export > WAR Fileเพื่อสร้างไฟล์ War จากนั้นปรับใช้ WAR นี้ในไดเร็กทอรี webapps ของ Tomcat สุดท้ายเริ่มเซิร์ฟเวอร์ Tomcat และพยายามเข้าถึง URLhttp://localhost:8080/HelloWorldStruts2/index.jsp. สิ่งนี้จะสร้างหน้าจอต่อไปนี้ -