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

827

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

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

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)

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.

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

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:

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

hello=Hello

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

Kết quả

Tải về source code từ server SmartJob: multilanguge hoặc clone/fork từ server GitHub: https://github.com/SmartJobVN/spring_mvc_multi_language

Bài viết gốc của Đỗ Như Vý được đăng tải tại smartjob.vn

Có thể bạn quan tâm:

Xem thêm IT Jobs hấp dẫn trên TopDev

RELATED ARTICLESMORE FROM AUTHOR

Kiểm tra tính hợp lệ của dữ liệu đầu vào form Spring Web MVC bởi Hibernate Validator

Cho phép tùy chọn Giao diện trong Spring Web MVC framework

Hỗ trợ đa ngôn ngữ trong Flutter

RELATED ARTICLES MORE FROM AUTHOR