Solon 国际化插件使用说明（此插件不会有中文问题）

一、引入插件包

<dependencies>
    <dependency>
        <groupId>org.noear</groupId>
        <artifactId>solon.i18n</artifactId>
    </dependency>
</dependencies>

二、配置国际化内容包

//默认国际化消息包配置（此为约定，不能改）
resources/i18n/messages.properties
resources/i18n/messages_en.properties
resources/i18n/messages_zh_CN.properties

//或其它国际包内容包，例：
resources/i18n/login.properties
resources/i18n/login_en.properties
resources/i18n/login_zh_CN.properties

三、配置 LocaleResolver bean

@Configuration
public class Config {
    @Bean
    public LocaleResolver localeResolver() {
        //或者自己定义一个
        return new LocaleResolverHeader();
    }
}

四、使用国际化配置

（一）基于工具接口在代码里使用

@Controller
public class DemoController {
    @Mapping("/demo/")
    public String demo(Context ctx) {
        return I18nUtil.getMessage(ctx, "login.title");
    }
}

（二）基于@I18n注解在模板里使用，不同控制器使用不同的国际化内容包

1. 添加国际化配置

resources/i18n/login.properties
resources/i18n/login_en.properties
resources/i18n/login_zh_CN.properties

2. 使用注解注入

@I18n("i18n.login")
@Controller
public class LoginController {
    @Mapping("/login/")
    public ModelAndView login() {
        return new ModelAndView("login.ftl");
    }
}

（三）基于@I18n注解在模板里使用，所有控制器使用统一的国际化内容包

1. 添加国际化配置

resources/i18n/messages.properties
resources/i18n/messages_en.properties
resources/i18n/messages_zh_CN.properties

2. 定制控制器基类，并添加@I18n注解

//此处使用默认的国际化内容包（即："i18n.messages"）。也可换成其它，如：@I18n("i18n.strings")
@I18n
public class ControllerBase{
    
}

3. 基于控制器基类，扩展其它控制器

@Controller
public class LoginController extends ControllerBase{
    @Mapping("/login/")
    public ModelAndView login() {
        return new ModelAndView("login.ftl");
    }
}

@Controller
public class UserController extends ControllerBase{
    @Mapping("/user/")
    public ModelAndView user() {
        return new ModelAndView("user.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")}