22/03/2021, 08:41

Đa ngôn ngữ ứng dụng Spring Web MVC

Bài viết được sự cho phép của tác giả Trần Thị Thu Hà SmarJob xin chia sẻ với các bạn kỹ thuật đa ngôn ngữ ứng dụng web dựng trên nền Spring Web MVC. Chúng ta đang sống trong môi trường toàn cầu hóa, ứng dụng muốn tiến xa cần tiếp cận lượng người dùng đông đảo, thuộc nhiều quốc gia khác nhau. ...

Bài viết được sự cho phép của tác giả Trần Thị Thu Hà

SmarJob xin chia sẻ với các bạn kỹ thuật đa ngôn ngữ ứng dụng web dựng trên nền Spring Web MVC. Chúng ta đang sống trong môi trường toàn cầu hóa, ứng dụng muốn tiến xa cần tiếp cận lượng người dùng đông đảo, thuộc nhiều quốc gia khác nhau. Khi đó phát sinh rào cản là ngôn ngữ. Phá vỡ được rào cản ngôn ngữ, ứng dụng bạn tạo ra sẽ nhiều người dùng hơn, doanh thu cao hơn.

Giải thích mô hình MVC thông qua … cốc trà đá

Google AMP là gì ? Cài đặt AMP cho website asp.net mvc

Bạn chuẩn bị các công nghệ, công cụ sau:

JDK (1.8 update 92)
Apache Maven (3.3.9)
IntelliJ IDEA (2016.1.3)
Apache Tomcat (8.0.35)

Khởi tạo project bằng Maven Archetype maven-archetype-webapp

spring_multilanguage_01

Chọn kiểu project là Maven, Sử dụng Java 8, Archetype là maven-archetype-webapp

spring_multilanguage_02

Khai báo 3 thông số GAV (GroupId – ArtifactId – Version)cho ứng dụng sắp tạo ra:

G: vn.smartjob.demo_spring
A: multilanguage
V: 1.0.0–SNAPSHOT (hậu tố –SNAPSHOT được khuyến khích sử dụng)

spring_multilanguage_03

Màn hình xác nhận ứng dụng Maven sẽ sử dụng, cũng như thông số cấu hình để quản lý dependencies cho project. Nếu bạn nhập sai thông tin, có thể bấm nút Previous để quay lại và sửa.

spring_multilanguage_04

Đặt tên và chọn vị trí lưu mã nguồn project:

spring_multilanguage_05

Xem thêm: Học lập trình cơ bản với java

Bạn cần tạo thêm các thư mục và tập tin để cấu trúc cây như sau:

spring_multilanguage_folder_structure

Là project sử dụng Maven build tool, nên việc đầu tiên bạn cần quan tâm là file pom.xml:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>vn.smartjob.demo_spring</groupId>
<artifactId>multilanguage</artifactId>
<packaging>war</packaging>
<version>1.0.0-SNAPSHOT</version>
<name>multilanguage Maven Webapp</name>
<url>https://smartjob.vn</url>

<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
</dependencies>

<build>
<finalName>multilanguage</finalName>
</build>

</project>

Là một ứng dụng web, bạn cần quan tâm đến web.xml (deploy descriptor: trình mô tả triển khai):

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">

<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>*.mvc</url-pattern>
</servlet-mapping>

</web-app>

Cấu hình beans là phần thiết yếu trong ứng dụng sử dụng Spring framework

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.0.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
<context:component-scan base-package="vn.smartjob.demo_spring.multilanguage"/>
<context:annotation-config/>
<mvc:annotation-driven/>

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/pages/"/>
<property name="suffix" value=".jsp"/>
</bean>

<bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver"/>

<bean id="messageSource"
class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
<property name="basename" value="classpath:messages"/>
<property name="defaultEncoding" value="UTF-8"/>
</bean>

<mvc:interceptors>
<bean id="localeChangeInterceptor"
class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">
<property name="paramName" value="lang"/>
</bean>
</mvc:interceptors>

</beans>

Tập tin giao diện hiển thị welcome.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="spring" uri="http://www.springframework.org/tags" %>
<html>
<head>
<title>Đa ngôn ngữ ứng dụng Spring Web MVC</title>
</head>

<body>
Language: <a href="?lang=en_US">English</a> - <a href="?lang=vi_VN">Viet Nam</a> - <a href="?lang=ja_JP">日本語</a>
<h2>
<spring:message code="hello"/>
</h2>
Locale: ${pageContext.response.locale}
</body>

</html>

Trang chủ index.jsp sẽ trỏ (redirect: chuyển hướng) về trang welcome.jsp đã tạo ra ở trên:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<% response.sendRedirect("welcome.mvc"); %>

Controller điều hướng luồng đi trong ứng dụng Spring Web MVC:

package vn.smartjob.demo_spring.multilanguage;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class WelcomeController {

@RequestMapping(value = "/welcome")
public ModelAndView user() {
return new ModelAndView("welcome");
}

}

Để minh họa, chúng ta hỗ trợ 3 ngôn ngữ: Tiếng Anh, Tiếng Việt, Tiếng Nhật. Bạn có thể hỗ trợ thêm số ngôn ngữ không giới hạn. Điều này khiến lượng khách hàng/lượng người dùng đa quốc gia tăng lên mạnh mẽ:

File messages_en_US.properties

File messages_vi_VN.properties

File messages_ja_JP.properties

Mẹo: Để đảm bảo font chữ hiển thị đúng, sử dụng Notepad++ biên soạn nội dung đa ngôn ngữ, để chế độ mã hóa (encoding) là UTF-8

success2