Java 的国际化

php中文网 2024-10-15 11:30:04

国际化（通常缩写为 i18n）是指设计和准备软件以轻松适应各种语言、地区和文化，而不需要对代码进行工程更改。接下来通常是本地化（通常缩写为 l10n），其中涉及使国际化软件适应特定的语言环境，包括翻译文本、调整本地约定以及修改其他特定于语言环境的元素。

我们的目标是通过将核心逻辑与特定于语言环境的元素（如语言和文化约定）分离，使软件足够灵活以支持多种语言环境。

资源包

使用编程语言提供的 resourcebundle 类在普通 java 程序中本地化文本消息有点简单。 resourcebundle 类可以轻松加载属性文件中定义的特定于区域设置的键值属性。这些属性文件称为资源包.

resourcebundle resources = 
        resourcebundle.getbundle("messages", locale.france);
string greeting = resources.getstring("greeting.hello");
assertequals("bonjour le monde", greeting);

string greetingusername = 
        messageformat.format(resources.getstring("greeting.username"), "ayo");
assertequals("bonjour ayo", greetingusername);

使用 i8n 资源包

在 java 程序中本地化文本消息的另一种方法是使用第三方库。 i18n-resource-bundle 就是此类库之一。该库是前面讨论的 resourcebundle 的实现。

依赖性

如果您使用 maven，请在 pom.xml 中添加以下依赖项

<dependency><groupid>io.github.jelilio</groupid><artifactid>i18n-resource-bundle</artifactid><version>0.0.2</version></dependency>

如果您更喜欢 gradle，请使用它；

implementation 'io.github.jelilio:i18n-resource-bundle:0.0.2'

消息源

i8n-resource-bundle 提供了 messagesource 接口，定义了多种解析消息的方法。它有两个实现，resourcebundlemessagesource和reloadableresourcebundlemessagesource。两种实现都使用类似于 java resourcebundle 的指定基本名称来访问资源包。 resourcebundlemessagesource 依靠 java 的 resourcebundle 实现结合 messageformat 进行消息解析，将消息解析为不同语言环境的资源包。

resourcebundlemessagesource messagesource = 
        new resourcebundlemessagesource();
messagesource.setbasenames("messages");

string greeting = messagesource
        .getmessage("greeting.hello", null, locale.france);
assertequals("bonjour le monde", greeting);

string greetingusername = messagesource
        .getmessage("greeting.username", new string[]{"ayo"}, locale.france);
assertequals("bonjour ayo", greetingusername);

reloadableresourcebundlemessagesource

与 resourcebundlemessagesource 不同，reloadableresourcebundlemessagesource 使用 java 的 properties 实例作为消息的自定义数据结构，使用不同的策略加载它们，允许根据时间戳更改和特定字符编码重新加载属性文件，而无需重新启动应用程序。

ReloadableResourceBundleMessageSource messageSource = 
        new ReloadableResourceBundleMessageSource();
messageSource.setBasenames("messages");

String greeting = messageSource
        .getMessage("greeting.hello", null, Locale.FRANCE);
assertEquals("Bonjour le monde", greeting);

String greetingUsername = messageSource
        .getMessage("greeting.username", new String[]{"Ayo"}, Locale.US);
assertEquals("Bonjour Ayo", greetingUsername);