Struts2 - Localização, internacionalização (i18n)

Internacionalização (i18n) é o processo de planejamento e implementação de produtos e serviços para que possam ser facilmente adaptados a idiomas e culturas locais específicas, um processo denominado localização. O processo de internacionalização é chamado de capacitação de tradução ou localização.

Internacionalização é abreviada i18n porque a palavra começa com a letra “i” e termina com “n”, e há 18 caracteres entre o primeiro i e o último n.

Struts2 fornece localização, ou seja, suporte de internacionalização (i18n) através de pacotes de recursos, interceptores e bibliotecas de tags nos seguintes locais -

  • As Tags da IU

  • Mensagens e erros.

  • Dentro das classes de ação.

Pacotes de Recursos

Struts2 usa pacotes de recursos para fornecer várias opções de idioma e local aos usuários do aplicativo da web. Você não precisa se preocupar em escrever páginas em diferentes idiomas. Tudo que você precisa fazer é criar um pacote de recursos para cada idioma que você deseja. Os pacotes de recursos conterão títulos, mensagens e outros textos no idioma do seu usuário. Pacotes de recursos são o arquivo que contém os pares de chave / valor para o idioma padrão de seu aplicativo.

O formato de nomenclatura mais simples para um arquivo de recurso é -

bundlename_language_country.properties

Aqui, bundlenamepoderia ser ActionClass, Interface, SuperClass, Model, Package, Global resource properties. Próxima partelanguage_country representa a localidade do país, por exemplo, a localidade do espanhol (Espanha) é representada por es_ES e a localidade do inglês (Estados Unidos) é representada por en_US etc. onde você pode ignorar a parte do país que é opcional.

Quando você faz referência a um elemento de mensagem por sua chave, a estrutura do Struts procura por um pacote de mensagens correspondente na seguinte ordem -

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

Para desenvolver seu aplicativo em vários idiomas, você deve manter vários arquivos de propriedades correspondentes a esses idiomas / localidade e definir todo o conteúdo em termos de pares de chave / valor.

Por exemplo, se você for desenvolver seu aplicativo para inglês dos Estados Unidos (padrão), espanhol e francês, terá que criar três arquivos de propriedades. Aqui vou usarglobal.properties arquivo apenas, você também pode fazer uso de diferentes arquivos de propriedades para separar diferentes tipos de mensagens.

  • global.properties - Por padrão, o inglês (Estados Unidos) será aplicado

  • global_fr.properties - Isso será usado para a localidade de Franquia.

  • global_es.properties - Isso será usado para o idioma espanhol.

Acesse as mensagens

Existem várias maneiras de acessar os recursos da mensagem, incluindo getText, a tag de texto, o atributo-chave das tags da IU e a tag i18n. Vamos vê-los em breve -

Mostrar i18n texto, use uma chamada para getText na tag de propriedade ou qualquer outra tag, como as tags da IU da seguinte maneira -

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

o text tag recupera uma mensagem do pacote de recursos padrão, ou seja, struts.properties

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

o i18n tagempurra um pacote de recursos arbitrário para a pilha de valor. Outras tags dentro do escopo da tag i18n podem exibir mensagens desse pacote de recursos -

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

o key atributo da maioria das tags de IU pode ser usado para gerar uma mensagem de um pacote de recursos -

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

Exemplo de localização

Vamos direcionar para criar index.jspdo capítulo anterior em vários idiomas. O mesmo arquivo seria escrito da seguinte maneira -

<%@ 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>

Vamos criar success.jsp arquivo que será invocado caso a ação definida retorne 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>

Aqui, precisaríamos criar as duas ações a seguir. (a) Primeira ação a para cuidar do Locale e exibir o mesmo arquivo index.jsp com idioma diferente (b) Outra ação é cuidar do próprio envio do formulário. Ambas as ações retornarão SUCCESS, mas tomaremos ações diferentes com base nos valores de retorno porque nosso propósito é diferente para ambas as ações

Ação para cuidar do Locale

package com.tutorialspoint.struts2;

import com.opensymphony.xwork2.ActionSupport;

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

Ação para enviar o formulário

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;
   }
}

Agora vamos criar os três seguintes global.properties arquivos e colocá-los em 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

Vamos criar o nosso struts.xml com duas ações da seguinte forma -

<?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>

A seguir está o conteúdo de web.xml arquivo -

<?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>

Agora, clique com o botão direito no nome do projeto e clique em Export > WAR Filepara criar um arquivo War. Em seguida, implante esse WAR no diretório webapps do Tomcat. Finalmente, inicie o servidor Tomcat e tente acessar o URLhttp://localhost:8080/HelloWorldStruts2/index.jsp. Isso produzirá a seguinte tela -

Agora selecione qualquer um dos idiomas, digamos que selecionamos Spanish, ele exibiria o seguinte resultado -

Você também pode tentar a língua francesa. Finalmente, vamos tentar clicarSubmit botão quando estamos na localidade espanhola, ele exibirá a seguinte tela -

Parabéns, agora você tem uma página multilíngue e pode lançar seu site globalmente.