Spring 국제화 기본 세팅과 UI 구현

여러분, Spring 국제화 작업을 시작할 때 가장 먼저 떠오르는 건 메시지 프로퍼티 파일이죠? 이 영상처럼, 이미 1부에서 messages_ko.properties나 messages_en.properties를 만들어 놓으셨을 텐데요. 여기서 문제는 단순히 파일만 있으면 안 되고, 실제 UI에서 언어 선택을 어떻게 구현하느냐예요. Before 상태로는 브라우저의 Accept-Language 헤더만 의지하다 보니, 사용자가 원하는 언어를 직접 고를 수 없죠. After로 넘어가면 셀렉트 박스를 통해 Locale을 선택하고, 서버에서 즉시 반영되도록 만들 수 있어요.

먼저, Spring 국제화의 기본을 떠올려보세요. Spring은 ResourceBundleMessageSource 빈을 통해 메시지 프로퍼티를 로드하고, Locale에 따라 적합한 파일을 골라줍니다. 예를 들어, messages.properties에 기본 메시지 "site.title=환영합니다"를 넣고, messages_en.properties에는 "site.title=Welcome"으로 번역하면 돼요. 이걸 Thymeleaf 템플릿에서 #{site.title}처럼 사용하면 자동으로 현재 Locale에 맞춰 출력되죠. 실제 예시로, 사용자 리스트 페이지(user/list.html)에서

이제 언어 선택 UI를 구현해보죠. 영상에서처럼, Enum으로 지원 언어를 정의하는 게 효과적이에요. Lang라는 Enum을 만들고, ENGLISH("en", "English"), KOREAN("ko", "한국어")처럼 Locale 코드와 표시명을 쌍으로 저장하세요. 생성자를 추가해 private final String locale; private final String displayName;으로 필드를 final로 고정하면 불변성을 보장할 수 있어요. 왜 final인가요? 언어 목록은 고정되니까, 런타임에 바뀔 일이 없어서 메모리 효율적이고 안전하죠. 비교해보면, 단순 String 배열로 하면 타입 안전성이 떨어지지만, Enum은 IDE 자동완성과 컴파일 타임 체크를 해줘요.

컨트롤러 쪽에서 이걸 활용해보세요. UserController의 list 메서드에서 Model에 Lang.values()를 추가로 넘기면, Thymeleaf에서 반복으로 셀렉트 옵션을 그릴 수 있어요. 코드 예시: @GetMapping("/list") public String list(Model model, HttpSession session) { model.addAttribute("langs", Lang.values()); // ... } 템플릿에서는 #{lang.select} 처럼요. 여기서 sessionLocale은 세션에서 꺼낸 현재 Locale이에요. 팁으로, th:selected를 사용하면 선택된 옵션이 자동으로 하이라이트 돼서 UX가 좋아집니다.

포스트 핸들러도 필요하죠. @PostMapping("/changeLang")에서 LocaleResolver를 통해 Locale을 업데이트하세요. 아직 리졸버는 안 만들었으니, 일단 요청 바디의 locale 파라미터를 받아 세션에 임시 저장해보세요. 예: LocaleDto dto = new LocaleDto(request.getParameter("locale")); session.setAttribute("LOCALE", dto.getLocale()); return "redirect:/user/list"; LocaleDto는 단순히 String locale 필드와 생성자, getter만 가진 DTO예요. 이걸로 기본 UI가 완성되니, 테스트해보세요. 한국어 선택 후 적용 누르면 페이지가 ko로 바뀌는 걸 볼 수 있을 거예요.

배경 지식으로, i18n 라이브러리(예: react-i18next)를 프론트에서 쓰는 경우도 있지만, Spring 백엔드 중심으로는 이게 표준이에요. 실전 팁: 프로퍼티 파일에 파라미터 지원을 추가하세요. #{site.description('Spring')}처럼 하면 "Spring 국제화 설명"이 동적으로 나와요. 싱글 쿼테이션(')을 써야 Thymeleaf가 제대로 파싱하니 주의하세요. 이렇게 하면 Before의 정적 페이지에서 After의 동적 다국어 사이트로 업그레이드돼요. 복잡해 보이지만, 한 번 세팅하면 유지보수가 쉽죠.

세션으로 Locale 유지하고 리졸버 등록

기본 UI는 만들었는데, 새로고침하거나 다른 탭으로 넘어가면 언어가 초기화되는 문제, 겪어보셨죠? 이게 Spring 국제화의 큰 함정이에요. 브라우저 헤더만 쓰면 일회성이고, 세션으로 Locale을 저장해야 지속되죠. 영상에서처럼 SessionLocaleResolver를 등록하면, 사용자 세션 ID별로 언어를 기억해줍니다. Before로는 Accept-Language에 의존해 불안정하지만, After로는 로그인 안 해도 세션이 유지되는 동안 언어가 고정돼요.

먼저, LocaleResolver의 역할을 이해하세요. Spring은 요청마다 Locale을 결정할 때 이 빈을 호출해요. 기본은 AcceptHeaderLocaleResolver로 헤더 기반이지만, 세션 기반으로 바꾸려면 커스텀 구현이 필요하죠. 영상처럼 SessionLocaleResolver를 직접 만들어 보완할 수 있지만, Spring이 제공하는 org.springframework.web.servlet.i18n.SessionLocaleResolver를 쓰는 게 간단해요. Config 클래스에 @Bean public LocaleResolver localeResolver() { SessionLocaleResolver slr = new SessionLocaleResolver(); slr.setDefaultLocale(Locale.ENGLISH); // 기본 영어 return slr; } 이렇게 등록하세요. 왜 영어를 디폴트로? 글로벌 서비스에서 영어가 보편적이라 사용자 70% 이상이 불편 없어요. 수치로 보면, Statista에 따르면 웹사이트 50%가 영어 기본이에요.

세션 저장 로직을 컨트롤러에 넣어보세요. changeLang 메서드에서 LocaleResolver를 주입받아 setLocale(request, response, new Locale(dto.getLocale())); 하세요. 이게 핵심! 리졸버가 내부적으로 세션에 "SPRING_LOCALE" 속성으로 저장하죠. 코드: @Autowired private LocaleResolver localeResolver; @PostMapping("/changeLang") public String changeLang(@RequestParam String locale, HttpServletRequest request, HttpServletResponse response, RedirectAttributes ra) { localeResolver.setLocale(request, response, new Locale(locale)); return "redirect:/user/list"; } RedirectAttributes는 필요 없지만, 플래시 메시지 추가 시 유용해요.

리스트 페이지에서 현재 Locale을 확인하려면, 컨트롤러에서 model.addAttribute("currentLocale", localeResolver.resolveLocale(request)); 하세요. Thymeleaf에서 ${currentLocale}으로 접근할 수 있어요. 비교 분석: 세션 대신 쿠키로 하면 브라우저 종료 후에도 유지되지만, 보안상 세션이 더 안전해요. 세션은 서버 메모리 부하가 있지만, 사용자당 1KB 미만으로 Spring 기본 설정(30분 타임아웃)에서 문제없죠. 대안으로 FixedLocaleResolver를 쓰면 고정 언어지만, 동적 선택엔 안 맞아요.

실행 팁: 디버깅할 때 브라우저 개발자 도구 네트워크 탭에서 Accept-Language 헤더를 확인하세요. 변경 후 응답 HTML이 messages_ko.properties 기반으로 바뀌는지 봐요. 만약 안 되면, application.properties에 spring.messages.basename=messages 추가했는지 체크하세요. 이 설정으로 다른 탭에서도 동일 세션 ID(쿠키 JSESSIONID) 덕에 언어가 유지돼요. 영상에서 브라질 IP 예시처럼, IP 기반 GeoIP 라이브러리(MaxMind)를 추가하면 자동 Locale 추론도 가능하지만, 기본 세션으로 충분할 거예요. 이렇게 하면 안정적인 Spring 국제화가 완성되죠.

실전 팁과 언어 선택 최적화

Spring 국제화가 세팅됐는데, 실제 운영에서 "중국어 선택 후 적용이 느리다"거나 "RTL 언어 지원이 안 돼" 같은 이슈가 생기죠? 이 부분을 최적화하지 않으면 사용자 이탈률이 20% 이상 올라갈 수 있어요. 영상처럼 Enum과 세션으로 기본은 잡았지만, 실전 팁으로 성능 튜닝과 에지 케이스를 다뤄보세요. Before로는 단순 포스트로 처리해 지연이 있지만, After로는 AJAX나 캐싱으로 부드럽게 만들어요.

먼저, 주의사항: 프로퍼티 파일이 많아지면(10개 언어 이상) 로딩 시간이 길어져요. 해결책은 캐싱 – MessageSource에 cacheSeconds=3600으로 설정하세요. application.yml에 spring.messages.cache-duration=1h 추가하면, 파일 변경 시에만 리로드돼요. 예시: 영어/한국어/중국어 3개 파일에서 100개 메시지 로드 시, 캐싱 전 50ms 지연이 After 5ms로 줄어요. 비교: Hibernate처럼 2nd 레벨 캐시(Ehcache) 연동하면 더 좋지만, 간단 프로젝트엔 불필요하죠.

언어 선택 UI 최적화 팁: 포스트 대신 AJAX로 하세요. JavaScript로 fetch('/changeLang', {method: 'POST', body: new FormData(selectForm)}) 후 location.reload() 하면 페이지 전체 리로드 없이 업데이트돼요. Thymeleaf와 연동 시, @PostMapping에 @ResponseBody String 반환으로 "success" 주고, JS에서 성공 시 셀렉트만 갱신하세요. 실전 예: 모바일에서 셀렉트가 작아 터치 어려우면, Bootstrap dropdown으로 대체 –

대안 제시: 세션 대신 DB 저장으로 하려면, User 엔티티에 locale 필드 추가하고 로그인 후 적용하세요. 세션은 비로그인 사용자에 좋지만, 영속화 필요 시 JPA @Column으로. 또, RTL 언어(아랍어) 지원 시 CSS에 direction: rtl; 추가하고, 프로퍼티에 right-to-left 표시. 도구 추천: Lokalise나 Transifex로 번역 관리 – Git 연동해 CI/CD에서 자동 빌드하세요. 주의: Locale 코드 실수(ko vs. zh_CN)로 메시지 안 나올 수 있으니, Enum에 country 코드까지 넣으세요. 예: CHINESE("zh_CN", "中文").

테스트 팁: Postman으로 헤더 Accept-Language: ko;q=1, en;q=0.9 보내 테스트하세요. 브라우저별(Chrome vs. Safari) 차이 확인하고, 새로고침 10회 후 세션 유지 검증. 이 팁들로 Spring 국제화가 프로덕션 레벨로 업그레이드될 거예요. 복잡한 부분은 순서대로 따라 하다 보면 익숙해질 테니, 프로젝트에 바로 적용해보세요!