Сервер серии SpringBoot анализирует запрос интернационализации клиента

Spring

план интернационализации

Для схемы интернационализации, разделяющей фронт и бэкенд, если каждый интерфейс будет добавлять параметры, объем кода и тестирования будет большим.Лучше всего добавлять языковые переменные в заголовок запроса и парсить его через перехватчик.

i18n

Конкретный процесс выглядит следующим образом:

  1. Клиент добавляет заголовок запроса Accept-Language;
  2. Сервер добавляет перехватчик, анализирует значение языка в заголовке запроса Accept-Language и устанавливает его в языковой стандарт текущего потока через LanguageUtil;
  3. Если серверу необходимо вернуть многоязычные результаты, получите язык запрошенного в данный момент клиента с помощью LanguageUtil.

В дополнение к заголовкам запросов также могут использоваться файлы cookie, но некоторые клиенты не поддерживают файлы cookie, а файлы cookie могут быть подделаны, поэтому рекомендуется использовать стандартные заголовки запросов.

код реализации

через SpringMVCRequestContextUtilsа такжеjava.util.Local, который может легко проанализировать идентификатор языка в заголовке запроса.

SpringMVC предоставляет множество реализаций интернационализации.

i18n3

Реализация кода шаг за шагом объясняется ниже.

pom.xml

Используйте SpringBoot для сборки проекта и представьте Lombok для упрощения JavaBeans.

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.1.3.RELEASE</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>net.ijiangtao.tech.framework.spring.ispringboot.demo</groupId>
	<artifactId>demo-i18n</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<name>demo-i18n</name>
	<description>Demo  Spring Boot  project for i18n</description>

	<properties>
		<java.version>1.8</java.version>
	</properties>

	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
			<optional>true</optional>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

application.properties

Настройте порт для текущей службы.

server.port=8303

LanguageUtil.java

Используйте ThreadLocal, чтобы сохранить внешний язык текущего потока.

/**
 * @author ijiangtao.net
 */
public class LanguageUtil {

    public static final String ZH_CN = "zh_CN";

    public static final String EN_US = "en_US";

    public static final String DEFAULT_LANGUAGE = ZH_CN;

    private String lang;

    private static final ThreadLocal<LanguageUtil> context = new ThreadLocal<LanguageUtil>() {
        @Override
        protected LanguageUtil initialValue() {
            return new LanguageUtil();
        }
    };

    public LanguageUtil() {
        lang = DEFAULT_LANGUAGE;
    }

    public static LanguageUtil getCurrentContext() {
        return (LanguageUtil) context.get();
    }

    public static String getCurrentLang() {
        return getCurrentContext().lang;
    }

    public static void setCurrentLang(String lang) {
        getCurrentContext().lang = lang;
    }

    public static void remove() {
        context.remove();
    }
}

LanguageInterceptor.java

выполнитьHandlerInterceptorИнтерфейс, перехватите и проанализируйте язык окружения в заголовке запроса и установите для него значение LanguageUtil.

import lombok.extern.slf4j.Slf4j;
import net.ijiangtao.tech.framework.spring.ispringboot.demo.i18n.util.LanguageUtil;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.support.RequestContextUtils;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;

@Slf4j
public class LanguageInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
            throws Exception {
        log.info("preHandle:请求前调用");

        //请求头 当前语言
        // Accept-Language: zh-CN
        // Accept-Language: en-US
        LocaleResolver localeResolver = RequestContextUtils.getLocaleResolver(request);
        Locale local= localeResolver.resolveLocale(request);

        log.info("local={} , localDisplayName={}",local.toString(),local.getDisplayName());

        LanguageUtil.setCurrentLang(local.toString());
        log.info("LanguageUtil.getCurrentLang() = {}",LanguageUtil.getCurrentLang());

        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
                           ModelAndView modelAndView) throws Exception {
        log.info("postHandle:请求后调用");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
            throws Exception {
        log.info("afterCompletion:请求调用完成后回调方法,即在视图渲染完成后回调");
    }

}

InterceptorConfig.java

Настройте перехватчик и сделайте его эффективным.


import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;

@Configuration
public class InterceptorConfig extends WebMvcConfigurationSupport {

    @Override
    public void addInterceptors(InterceptorRegistry registry){
        registry.addInterceptor(new LanguageInterceptor())
                .addPathPatterns("/**")
                .excludePathPatterns("/noi18n")
                .excludePathPatterns("/onelang");
    }

}

LanguageController.java

Получите язык среды, установленный текущим потоком, из LanguageController, чтобы проверить эффект.


import net.ijiangtao.tech.framework.spring.ispringboot.demo.i18n.util.LanguageUtil;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 *
 * @author ijiangtao.net
 */
@Controller
public class LanguageController {

    @GetMapping("/lang/current")
    @ResponseBody
    public String currentLanguage(){
        return LanguageUtil.getCurrentLang();
    }
}

тестовое задание

Используйте Rest Client IDEA, чтобы инициировать запрос

使用IDEA的Rest Client发起请求

Проверить ответ на запрос

en_US

Суммировать

В этом руководстве показано, как установить локаль сервера через заголовок запроса клиента, чтобы реализовать интернационализацию содержимого ответа сервера.

Надеюсь, это поможет вам.

Links