Spring Migration Analyzer：从 Java EE 到 Spring 转换的工具

SpringSource 已经发布了第一个里程碑版本的 Spring Migration Analyzer 。这是一个辅助类的应用程序，它会扫描 JavaEE 构件并生成一个简要的报表，在这个报表中包含了如果这个应用程序要迁移到 Spring 时要特别注意的 API 和类。这个报表有助于做出迁移评估，因为它可以作为估计迁移难度的工具。

Spring Migration Analyzer 是作为命令行工具提供的，它可以运行在安装了 JVM 的操作系统之上（它只会使用 Java）。它以已存应用程序的二进制部署文件（如 war 或 ear）作为输入并产生一个 HTML 的输出报表（在单独的目录中）。这个报表包含了探查到的 JavaEE 技术列表以及将其迁移到 Spring/Tomcat 所需工作的建议。页面上会有一个整体概览区域，你可以点进去查看每个类会如何影响迁移工作（如果他们使用了特定的 JavaEE API 的话）。会考虑到的技术包括：

• EJB
• JCA
• JMS
• JNDI
• JTA
• JPA
• 特定供应商 JBoss 、 WebLogic 以及 WebSphere 的 API

以下是一个示例报表：（点击放大）

Spring Migration Analyzer 也会探测到一些其他的特性如 EJB 的类型（如 Session 还是 Entity）、Spring 库、供应商特定的部署描述符甚至编码中使用的事务。对于探测到的每一项技术都会有文字来描述在进行 Spring 迁移时要怎么做。报表还包含了应用程序中每个类的结构如域、方法、java 导入以及抛出的异常等。

但需要注意的是，如果按照默认配置运行 Analyzer 的话，你会得到很多错误的结果。这主要是因为它处理的是二进制构件而不是源码，它不会区分应用程序的实际代码和外部类库的代码。理想情况下，报表中要排除外部类库而只关心开发人员创建的源码（就像其他的软件报表工具所处理的代码一样，这样的工具如单元测试、代码覆盖率以及质量检查等）。

例如，一个使用 Logback 来记录日志的应用程序会报告它使用了 JMS：

但源码中并没有 JMS 的代码，这只是因为 logback 二进制包中导入了 JMS，因为它支持将 JMS 作为日志目标。因此为了得到更为有意义的结果，你要使用“exclude”命令行分支来忽略外部类库（如 /WEB-INF/lib 目录）。并且输出目录不能与输入目录相同。

因此，尽管在理论上工具的这个命令行分支是可选的，但实际上它是必需的。总之，以目前的状态Spring Migration Analyzer 是一个有用的主意，但是为了避免向用户产生错误的报表还需要一些调整。

想得到更多信息的话，可以查看文档以及当前的缺陷列表。它的源码托管在 GitHub 上。