4.5.4. 本地化国际化日志记录器、消息和例外

4.5.4.1. 使用 Maven 生成新转换属性文件

使用 Maven 构建的项目可以为每个 MessageLogger 和 Message Bundle 生成空的转换属性文件。这些文件随后可用作新的转换属性文件。

以下步骤演示了如何配置 Maven 项目以生成新的转换属性文件。

先决条件

  • 您必须已有一个正常工作的 Maven 项目。
  • 必须已为 JBoss Logging 工具配置该项目。
  • 该项目必须包含一个或多个定义国际化日志消息或异常的接口。

生成转换属性文件

  1. 通过将 -AgenereatedTranslationFilePath 编译器参数添加到 Maven 编译器插件配置来添加 Maven 配置,并为它分配创建新文件的路径。

    此配置会在 Maven 项目的 target/generated-translation-files 目录中创建新文件。

    示例:定义转换文件路径

    <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-compiler-plugin</artifactId>
       <version>2.3.2</version>
       <configuration>
          <source>1.6</source>
          <target>1.6</target>
          <compilerArgument>
          -AgeneratedTranslationFilesPath=${project.basedir}/target/generated-translation-files
          </compilerArgument>
          <showDeprecation>true</showDeprecation>
       </configuration>
    </plugin>

  2. 使用 Maven 构建项目:

    $ mvn compile

    为标有 @MessageBundle 或 @Message Logger 的每个接口创建了一个属性文件。

    • 新文件创建在与声明每个接口的 Java 软件包对应的子目录中。
    • 每一新文件采用以下模式命名,其中 INTERFACE_NAME 是用于生成文件的接口的名称。

      INTERFACE_NAME.i18n_locale_COUNTRY_VARIANT.properties

现在可将生成的文件复制到您的项目中,作为新翻译的基础。

注意

请参阅 JBoss EAP 附带的 logging-tools quickstart,以获取完整的工作示例。