替换 GWT UIBinder XML 文件中的版本号变量

Question

帮助我找到替换 ui.xml 中版本变量的最佳方法

<gwt:HTML>
    <span>Current version: ${version}</span>
</gwt:HTML>

我可以使用 Maven 资源插件吗？像这样：

        <resource>
            <directory>src/main/java</directory>
            <filtering>true</filtering>
            <includes>
                <include>**/*.ui.xml</include>
            </includes>
        </resource>

我认为 UIBinder 是 GWT 客户端代码的一部分，它由 gwt 插件编译。该插件找不到我的 ${version} 变量，也不会替换它。

Answer 1

你是对的，UIBinder 模板是 GWT 客户端代码的一部分，并被编译为 JavaScript。

我能想到的公开您的应用程序正在运行的版本的唯一方法是：

1. 在客户端代码中的某个位置（例如，在您的 EntryPoint 类中）将其硬编码为静态最终常量。
2. 通过托管页面从服务器端代码公开它，并通过执行类似 本文建议。
3. 编写一个简单的 GWT 生成器 来创建一个 UI 小部件，生成其代码以显示当前版本。本文是对生成器的一般介绍。

可能还有其他的，但这些是我首先想到的，按照所涉及的努力从最少到最多的顺序排列。

Answer 2

因为您的 Java 文件将在您有机会更改变量之前被编译，所以您尝试的普通过滤器将不起作用。但是，我能够使用 maven-replacer-plugin 它只是替换文件中的字符串。对我来说，采用像您建议的那样的设置要干净得多，其中 ${my_variable} 格式的变量可以一致地替换为某个当前版本。

然而，使用 maven-replacer-plugin，您就没有那么奢侈了，因为它实际上是在修改原始源文件本身。因此，如果您告诉它在某个时间点用 ${my_variable} 替换 Version 1.2.3，该文件将不再包含文本 "${ my_variable}" 因为它已经被替换了。所以你必须重新考虑你的替代策略。这就是我的设置...

我添加了一个名为“VersionManager”的共享类，它只有以下代码：

public class VersionManager {
  private static String version="empty";

  public static String getVersion(){
    return version;
  }
}

在 中，我添加了以下行（可选）：

<display_version>v${project.version} #${BUILD_ID}</display_version>

然后包含 maven-replacer-plugin 并按如下方式配置它：

     <plugin>
       <groupId>com.google.code.maven-replacer-plugin</groupId>
       <artifactId>replacer</artifactId>
       <version>1.5.0</version>
       <executions>
           <execution>
               <phase>validate</phase>
               <goals>
                   <goal>replace</goal>
               </goals>
           </execution>
       </executions>
       <configuration>
           <file>--yourDirectoryPaths--/shared/VersionManager.java</file>
           <replacements>
               <replacement>
                   <token>private static String version=\".*\";</token>
                   <value>private static String version="${display_version}";</value>
               </replacement>
           </replacements>
       </configuration>
   </plugin>

如您所见，我告诉插件将包含 private static String version="*"; 的行替换为新行，包含大部分相同的文本，但在引号内包含所需的版本号。

您可以通过运行 mvn validate 来测试这一点，而无需编译整个项目，这将运行替换并应出现在源文件中。

然后你的服务器和客户端都知道它们在构建时运行的是什么版本。

Answer 3

另一种不使用替换插件的解决方案是替换 html 主机页面中包含的 div 中的值：

<div id="versionInfo" style="display: none;">${project.version}</div>

将 webapp 文件夹添加到 maven 配置中的 Web 资源（启用过滤）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    [...]
    <configuration>
        [...]
        <webResources>
            <resource>
            <directory>src/main/webapp</directory>
            <filtering>true</filtering>
                <includes>
                    <include>**/*.html</include>
                </includes>
            </resource>
        </webResources>
    </configuration>
</plugin>

现在在您的 GWT 中通过代码您可以轻松获取版本值：

RootPanel panel = RootPanel.get("versionInfo");
String version = panel.getElement().getInnerText();
RootPanel.getBodyElement().removeChild(panel.getElement());

如果您使用 GIN 注入，一个好的做法是拥有版本提供程序：

@Provides
@Singleton
@Named("version")
protected String getVersion()
{
    RootPanel panel = RootPanel.get("versionInfo");
    if(panel == null)
    {
        return "unknow";
    }
    else
    {
        String version = panel.getElement().getInnerText();
        RootPanel.getBodyElement().removeChild(panel.getElement()); 
        return version;
    }
}

最后将版本注入您的小部件中：

[...]

@UiField(provided = true)
protected Label     versionLabel;

public MyWidget(@Named("version") String version)
{
    this.versionLabel = new Label(version);
    this.initWidget(uiBinder.createAndBindUi(this));
    [...]
}