4.5.4.2. 转换国际化的日志记录器、例外或消息
属性文件可用于使用 JBoss 日志工具为接口中定义的日志和异常消息提供翻译。
以下步骤演示了如何创建和使用转换属性文件,并且假定您已拥有为国际化异常或日志消息定义的一个或多个接口的项目。
先决条件
- 您必须已有一个正常工作的 Maven 项目。
- 必须已为 JBoss Logging 工具配置该项目。
- 该项目必须包含一个或多个定义国际化日志消息或异常的接口。
- 项目必须配置为生成模板转换属性文件。
转换国际化的日志记录器、例外或消息
运行以下命令来创建模板转换属性文件:
$ mvn compile
-
将您要从创建它们的目录中转换的接口模板复制到项目的
src/main/resources
目录中。属性文件必须与要转出的接口位于同一个软件包中。 -
重命名复制的模板文件,以指明它将包含的语言。例如:
GreeterLogger.i18n_fr_FR.properties
。 编辑新转换属性文件的内容,使其包含适当的翻译:
# Level: Logger.Level.INFO # Message: Hello message sent. logHelloMessageSent=Bonjour message envoyé.
- 重复复制模板的过程,并根据捆绑包中的每个转换进行修改。
该项目现在包含一个或多个消息或日志记录器捆绑包的转换。构建项目会生成适当的类,以使用提供的转换记录日志消息。无需显式调用特定语言的方法或提供参数,JBoss 日志工具会自动将正确的类用于应用服务器的当前区域设置。
生成类的源代码可以在 target/generated-sources/annotations/
下查看。