REST API 국제화

Soo·2024년 3월 25일

Spring boot 스프링부트

Spring Boot로 간단한 애플리케이션 만들기

목록 보기

44/55

만약 여러분의 제품을 전세계 사람들이 사용한다고 했을 때 서로 다른 언어를 사용하는 사용자들에게 맞는 언어를 제공하기 위해서 어떻게 할까요?

이때, Internationalization(i18n) = 국제화를 사용해야 합니다.

국제화를 처리할 때마다 Accept-Language라는 HTTP Request Header를 사용합니다.

Accept-Language

자연어와 소비자가 선호하는 로케일을 나타냅니다.

사용법

Accept-Language: en-US,en;q=0.9,ko;q=0.8

원하는 나라의 언어를 선택합니다.
각 언어의 뒤의 “q” 매개변수는 해당 언어의 상대적인 우선순위를 나타내며, 더 높은 “q” 값은 해당 언어를 더 선호한다는 것을 의미합니다.

HelloWorldController를 통해 사용해보겠습니다.

HelloWorldController

helloWorldInternationalized() 생성

package study.rest.webservices.restfulwebservices.helloworld;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloWorldController {

    @GetMapping("/hello-world")
    public String helloWorld() {
        return "Hello World";
    }

    @GetMapping("/hello-world-bean")
    public HelloWorldBean helloWorldBean() {
        return new HelloWorldBean("Hello World");
    }

    @GetMapping("/hello-world/path-variable/{name}")
    public HelloWorldBean helloWorldBeanPathVariable(@PathVariable String name){
        return new HelloWorldBean(String.format("Hello World, %s", name));
    }

    @GetMapping("/hello-world-internationalized")
    public String helloWorldInternationalized() {
        return "Hello World V2";
    }
}

본격적으로 국제화 기능을 구현해보겠습니다.

먼저 해당 국가의 언어를 저장하고 있는 파일이 있어야합니다.

주의

application.properties와 같은 resources 패키지에 만들어야합니다.
messages.properties라는 이름으로 만들어야 합니다.

messages.properties

기본적인 작동이 제대로 하는지 확인하겠습니다.

good.morning.message=Good Morning

메세지를 저장했으니 사용할 수 있어야겠죠?

HelloWorldController

MessageSource를 사용해서 사용하겠습니다.
의존성은 생성자를 통해서 받습니다.

package study.rest.webservices.restfulwebservices.helloworld;

import org.springframework.context.MessageSource;
import org.springframework.context.i18n.LocaleContextHolder;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

import java.util.Locale;

@RestController
public class HelloWorldController {

    private MessageSource messageSource;

    public HelloWorldController(MessageSource messageSource) {
        this.messageSource = messageSource;
    }

    @GetMapping("/hello-world")
    public String helloWorld() {
        return "Hello World";
    }

    @GetMapping("/hello-world-bean")
    public HelloWorldBean helloWorldBean() {
        return new HelloWorldBean("Hello World");
    }

    @GetMapping("/hello-world/path-variable/{name}")
    public HelloWorldBean helloWorldBeanPathVariable(@PathVariable String name){
        return new HelloWorldBean(String.format("Hello World, %s", name));
    }

    @GetMapping("/hello-world-internationalized")
    public String helloWorldInternationalized() {

        Locale locale = LocaleContextHolder.getLocale();
        return messageSource.getMessage("good.morning.message", null, "Default Message", locale);
    }
}