Solon

十二、国际化

1、添加国际化配置

resources/i18n/messages.properties

login.title=登录
login.name=世界

resources/i18n/messages_en_US.properties

login.title=Login
login.name=world

2、 使用 solon.i18n 插件

  • 使用国际化工具类,获取默认消息
@Controller
public class DemoController {
    @Mapping("/demo/")
    public String demo(Locale locale) {
        return I18nUtil.getMessage(locale, "login.title");
    }
}
  • 使用国际化服务类,获取特定语言包
@Controller
public class LoginController {
    I18nService i18nService = new I18nService("i18n.login");

    @Mapping("/demo/")
    public String demo(Locale locale) {
        return i18nService.get(locale, "login.title");
    }
}
  • 使用国际化注解,为视图模板提供支持
@I18n("i18n.login") //可以指定语言包
//@I18n //或不指定(默认消息)
@Controller
public class LoginController {
    @Mapping("/login/")
    public ModelAndView login() {
        return new ModelAndView("login.ftl");
    }
}

在各种模板里的使用方式:

beetl::

i18n::${i18n["login.title"]}
i18n::${@i18n.get("login.title")}
i18n::${@i18n.getAndFormat("login.title",12,"a")}

enjoy::

i18n::#(i18n.get("login.title"))
i18n::#(i18n.getAndFormat("login.title",12,"a"))

freemarker::

i18n::${i18n["login.title"]}
i18n::${i18n.get("login.title")}
i18n::${i18n.getAndFormat("login.title",12,"a")}

thymeleaf::

i18n::<span th:text='${i18n.get("login.title")}'></span>
i18n::<span th:text='${i18n.getAndFormat("login.title",12,"a")}'></span>

velocity::

i18n::${i18n["login.title"]}
i18n::${i18n.get("login.title")}
i18n::${i18n.getAndFormat("login.title",12,"a")}

3、 也支持分布式国际化本置

这个方式,适合对接企业内部的国际化配置中台。

//实现一个国际化内容块的工帮
public class I18nBundleFactoryImpl implements I18nBundleFactory {
    @Override
    public I18nBundle create(String bundleName, Locale locale) {
        if (I18nUtil.getMessageBundleName().equals(bundleName)) {
            bundleName = Solon.cfg().appName();
        }

        return new I18nBundleImpl(I18nContextManager.getMessageContext(bundleName), locale);
    }
}

//然后注册到Bean容器
Solon.context().wrapAndPut(I18nBundleFactory.class, new I18nBundleFactoryImpl());

4、三个语种分析器

分析器说明
LocaleResolverHeader默认会从 Content-Language 或 Accept-Language 获取语言信息(或者通过 setHeaderName(name) 自定义 )
LocaleResolverCookie默认从 SOLON.LOCALE 获取语言信息(或者通过 setCookieName(name) 自定义)
LocaleResolverSession默认从 SOLON.LOCALE 获取语言信息(或者通过 setAttrName(name) 自定义)

5、 如何切换语言?

框架默认使用 LocaleResolverHeader 分析器,即默认会通过 header[Content-Language] 或 header[Accept-Language] 自动切换。

需要换个分析器?

@Configuration
public class DemoConfig{
    @Bean
    public LocaleResolver localInit(){
        return new LocaleResolverCookie();
    }
}

如果需要完全自定义?

@Component
public class LocaleResolverImpl implements LocaleResolver{
    //....
}