引言

这是该系列中唯一一篇实际使用了 Spring Framework 的博客。Spring 用于配置 Spring Dynamic Modules 以及发布和消费 OSGi 服务。它还展示了一种连接 Spring 管理的 bean 与 GWT 远程处理的方式。然而，我很清楚 Spring/GWT 集成本身就是一个重要主题，所以我在此有意只提供一个简单的解决方案。

关于 GWT StockWatcher 示例及其我正在使用的软件的背景信息，请参阅第 1 部分。

另请注意，您可以跳过所有这些繁琐的说明，直接查看底部的下载汇总。

快速回顾

在第 2 部分中，我们从 WAR 文件中移除了 GWT 依赖项，并将它们转换为一个 OSGi 包，该包被安装到 dm Server 的仓库中。完成此操作后，我们就可以部署任意数量使用 GWT 远程处理的应用，而无需在 WAR 中包含任何 GWT 依赖项。

在本最终部分中，我们将使用 Spring Dynamic Modules 进一步模块化应用。您可能会问一个问题……为什么？这不是一个坏问题——没有人愿意为了模块化而使代码不必要地复杂化。在决定共享服务方法是否有帮助时，可以将其归结为几个简单的问题：

- 应用的任何部分是否可能需要被其他应用使用？ - 应用中的不同组件是否会以不同的速度演变？ - 是否可能需要维护同一组件的多个并发版本？ - 是否希望能够在应用运行时部署组件的更改？

看看我们的 Stockwatcher 应用，它目前仅限于一个股市。我们知道世界各地有许多不同的市场，为了使其更灵活，使其能够访问不同的市场肯定是有意义的，所以这就是我们要做的——将我们的股市转换为共享服务。一个包将包含一个共享 API，该 API 定义了市场可以做什么。其他包可以是该 API 的实现——也许一个是伦敦市场，一个是纽约市场。然后我们将能够部署我们想要的市场，启动、停止、取消部署和替换它——所有这些都在运行时进行。

我意识到将单个 WAR 文件转换为共享服务的过程可能比从零开始以模块化方式设计更为常见，因此本博客将进一步基于我们在第 2 部分中完成的工作，而不是从头开始。您可以在此处下载第 2 部分的 Eclipse 项目，在此处下载第 3 部分所有工作完成后的项目（如果下载，需要定义 GWT_ROOT_INSTALL classpath 变量）。希望我在早期博客中关于划分源代码的一些建议最终会变得有意义！

步骤 1：创建 StockService API 包

要在 Eclipse 中创建一个简单的包项目，右键单击并选择 New->Other->SpringSource dm Server->Bundle Project。这将为您创建一个骨架MANIFEST.MF以便开始使用。我们无需将其设为 Spring Dynamic Module，因为它唯一的目的是提供 API，并且不会包含自己的任何 bean 实例，因此普通包即可。

- 将项目名称指定为 StockWatcherServiceAPI - 如果您愿意，可以通过单击 Project Layout 中的 Configure Default... 链接来配置源目录。为保持一致性，我将其设置为src/main/java- 将包名称和符号名称设置为com.google.gwt.sample.stockwatcher.client.api版本保留为1.0.0- 模块类型应为None目标运行时应为您的 dm Server 实例。如果无法选择此选项，需要单击新建并创建一个。 - 现在可以单击完成，应该会看到新的包项目以及生成的MANIFEST.MF.

下一步是移动 API 代码到新项目中。将整个com.google.gwt.sample.stockwatcher.client.api包从 StockWatcherWar 项目拖放到新的包项目中。这是客户端和服务器共享的所有代码。它应该包含StockPriceService接口以及StockPrice和DelistedException类。如果成功，几乎所有东西都会损坏！

接下来，考虑一下我们需要从新包中导出什么。在这种情况下很简单——一个包中的 API。在MANIFEST.MF编辑器的 Runtime 选项卡中，将该包添加到 Exported Packages 列表中并保存。

现在需要考虑 API 代码需要哪些依赖项，换句话说，为什么它不再构建了。显然，我们在第 2 部分中创建的 GWT 包是一个好的开始。在 Dependencies 选项卡中，将 com.google.gwt 包添加到 Import Bundle 列表中（如果未列出，可能不在 dm Server 仓库中，这在第 2 部分中解释了）并保存。这应该会修复新项目中的所有构建问题，但其他项目应该仍然损坏。暂时忽略这一点，因为还有更多重构工作要做。

此时，StockWatcherServiceAPI 项目应该看起来像这样

它的MANIFEST.MF应该看起来像这样

步骤 2：创建 StockPriceService 服务包

使用步骤 1 中的说明创建一个新的包项目，命名为 "StockWatcherServiceLondon"，并给它一个包名称 com.google.gwt.sample.stockwatcher.service.london。

所以我们来考虑一下这个包需要什么。它需要实现伦敦股市服务的代码，以及一种将该服务导出到 OSGi 注册中心作为共享服务的方式。第一部分是一个简单的重构工作，因为我们已经有一些可以重用的服务代码。对于第二部分，将包设为 Spring Dynamic Module 将是最简单的方法，因为它使得使用 Spring bean 发布和消费 OSGi 服务非常简单。

首先。回头看看StockPriceServiceImpl.java中的服务实现。会看到StockPriceService代码与RemoteServiceServlet绑定。servlet 需要保留才能使远程处理工作，但我们需要提取实现代码并用它来创建共享服务。在第 4 部分中，需要调整 servlet 来消费我们创建的服务。

所以，复制com.google.gwt.sample.stockwatcher.server包从 StockWatcherWar 项目，并粘贴到 StockWatcherServiceLondon 的src/main/java中。现在应该有一个StockPriceServiceImpl.java的副本，可以进行重构。

删除extends RemoteServiceServlet、RemoteServiceServletimport和SerialVersionUID

字段，因为这些现在都不再需要了。保存更改时，会看到需要导入一些依赖项，特别是步骤 1 中创建的 API 包。MANIFEST.MF编辑com.google.gwt.sample.stockwatcher.client.api以添加 Import Package 来导入MANIFEST.MF。保存时，应该会看到清单文件中出现错误，说无法解析该包。我们做错了什么？！问题在于，当 Eclipse 中的包项目之间存在导入和导出时，需要告诉工具允许项目共享引用。右键单击 StockWatcherServiceLondon，选择 Properties->Project References。勾选 StockWatcherServiceAPI 的复选框，然后单击 OK。然后需要假编辑

以使更改生效。现在应该看到 StockWatcherServiceAPI 列为 Bundle Dependency。让我澄清一点，一旦包从 Eclipse 导出，就无需执行此额外步骤——仅当需要在它们只是项目时创建包之间的依赖项时才需要这样做。MANIFEST.MF应该还有一个问题需要解决。虽然 com..client.api 包导入了 com.google.gwt 包，但该导入对于该包是私有的。任何导入 com..client.api 包的包都不继承此依赖项——必须明确指定。因此，在中，为 com.google.gwt 包添加一个Import-BundleStockPriceServiceImpl.java并保存。如果仍然在

中看到问题，可能需要尝试对其进行假编辑，否则您就做错了什么。

太棒了！现在我们已经完成了一半的共享服务创建工作。它目前应该看起来像这样下一步是将 StockPriceServiceLondon 转换为 OSGi 服务。我们将使用 Spring Dynamic Modules 来完成。Spring Dynamic Module 的原理很简单——在/META-INF/spring

文件夹中提供 Spring 配置文件，部署包时会为您创建一个 ApplicationContext。这是一种极好且非常简单的方式，可以将 Spring 管理的 bean 导出为 OSGi 服务。因此，在/META-INF中创建/spring中创建文件夹（右键单击因此，在并选择 新建 -> 文件夹）。然后右键单击新的文件夹，选择 新建 -> Spring Bean Definition。可以随意命名，但在我的示例中命名为serviceLondon-config.xml。输入名称并单击完成。现在需要将StockPriceServiceImpl

    <bean id="stockPrices"
        class="com.google.gwt.sample.stockwatcher.server.StockPriceServiceImpl"/>

定义为 Spring bean，以便在部署包时创建它的一个实例。如果熟悉 Spring，这应该很容易。如果不熟悉，需要插入以下 XML

    <osgi:service
        interface="com.google.gwt.sample.stockwatcher.client.api.StockPriceService"
        ref="stockPrices"/>

最后，需要将此 bean 导出为 OSGi 服务。可以在同一个配置文件中完成，但将 OSGi 依赖项分开是良好的实践。因此创建另一个 Spring Bean Definition，命名为 osgi-config.xml，这次单击下一步并勾选 osgi 命名空间复选框，然后单击完成。要将 bean 导出为 OSGi 服务，请插入以下 XML

就是这样！现在我们有一个创建共享服务的包。在继续之前，测试一下是个明智的主意，以确保它按预期运行。

我将在此描述两种测试方法：快速而粗糙的方法和完善文档的自动化 JUnit 方法。有人可能会说这应该是一篇单独的博客文章，但我认为这是一个足够重要的话题，因此在此详细介绍。

快速而粗糙的方法是临时创建一个另一个 Spring Dynamic Module，它将消费该服务，将其注入到测试类中，然后只记录输出。这是确保服务工作正常的好方法，但显然它没有断言任何内容，也无法在测试框架中运行。下一步是将 StockPriceServiceLondon 转换为 OSGi 服务。我们将使用 Spring Dynamic Modules 来完成。Spring Dynamic Module 的原理很简单——在我们已经构建了一个 Spring Dynamic Module，因此对于这个新的 TestConsumer 模块，我只强调差异。模块需要导入 com.google.gwt.sample.stockwatcher.client.api 包（或 package），并且需要一些 Java 代码来调用服务客户端。在

文件夹中需要 2 个 spring 配置文件一个用于测试 bean（例如)

    <bean id="consumer" class="com.ben.consumer.Consumer">
        <constructor-arg ref="priceService"/>
    </bean>

testConsumer-config.xml），一个用于消费服务的<osgi:reference（例如)

    <osgi:reference id="priceService"
        interface="com.google.gwt.sample.stockwatcher.client.api.StockPriceService"/>

osgi-config.xml在 Java 代码中，只需调用service.getPrices(new String{"foo", "bar"})StockPrice并传入一些任意字符串，应该返回一个StockPrice对象的数组。如果想将输出记录到System.err.

，这会出现在 dm Server 的跟踪目录中<dm server install directory>/servicability/trace/<name of your test bundle>/trace.log要在 STS 中运行快速而粗糙的测试，需要启动 dm Server。然后，将整个 StockWatcherServiceAPI 项目拖放到服务器上。项目成功部署后，应该会收到类似如下的控制台消息

Deployment of 'com.google.gwt.sample.stockwatcher.client.api' version '1' completed。接下来，将整个 StockPriceServiceLondon 项目拖放到服务器上，并等待部署消息。如果这一切都初始化成功，将您的测试项目放到服务器上。如果您想让服务器每次都干净启动（清除旧的跟踪输出等），请在启动配置中添加

-Dcom.springsource.server.clean=true

VM 参数，可以通过双击服务器实例，选择 Open Launch Configuration 并单击 Arguments 选项卡来找到。

因此，开箱即用时，测试期望从本地 Maven 仓库获取其所有依赖项。可以配置测试使用其他类型的依赖管理，但为了简单起见（嘿！），我正在使用 Maven。首先，我安装了 m2eclipse，它通过添加http://m2eclipse.sonatype.org/update/作为更新站点（Help->Software Updates->Available Sites->Add Site）获得。建议取消选择可选的 Maven POM Editor，否则会收到一堆未满足的依赖项警告，并且无法安装。

创建一个新的 Java 项目，命名为 StockWatcherServiceTest（以src/main/javasrc作为源文件夹）。右键单击项目，选择 Maven->Enable Dependency Management 使项目支持 Maven。接下来，创建一个新包（在我的例子中是com.ben），并将 Spring DM 参考指南中的SimpleOSGiTest

代码复制到该包中的测试类（请注意，测试框架不允许使用默认包）。这个测试类将帮助我们进行健全性检查，确认依赖项都已正确设置。会注意到测试尚无法编译，因为我们尚未拥有它所需的依赖项。需要在pom.xml会注意到测试尚无法编译，因为我们尚未拥有它所需的依赖项。需要在文件中指定正确的依赖项。为了节省您数小时的捶胸顿足和诅咒，您可以在此处查看我的

pom.xml文件（包含在完整的工作空间下载中）。一旦依赖项工作正常，看看能否找出示例代码中的拼写错误，添加 Java import，现在应该有一个可以编译的测试类了。尝试运行测试：右键单击 -> 运行方式 -> JUnit Test。如果收到ClassNotFoundException，是因为测试在错误的位置查找.class文件。解决此问题的最简单方法是覆盖getRootPath()并返回

"file:./target/classes"

或 .class 文件生成的任何其他路径。希望现在会看到绿条，这至少证明了测试用例启动了 Equinox 框架并成功创建了即时包。现在可以为 StockWatcherServiceLondon 包创建合适的单元测试了。下一步是使测试依赖包正确加载和解析。为此，必需的包需要安装到本地 maven 仓库，并在测试用例中的

getTestBundlesNames()会注意到测试尚无法编译，因为我们尚未拥有它所需的依赖项。需要在方法中指定。会注意到测试尚无法编译，因为我们尚未拥有它所需的依赖项。需要在先处理 Maven：之前创建的MANIFEST.MFpom.xml文件应该已经下载了外部依赖项，但我们需要手动将 com..client.api、com..service.london 和 com.google.gwt 包添加到 maven 仓库。我通过对工作空间中的项目进行 Maven 化并为每个项目创建一个pom.xml会注意到测试尚无法编译，因为我们尚未拥有它所需的依赖项。需要在文件来完成此操作。这里有几个陷阱。首先，要让 Maven 识别会注意到测试尚无法编译，因为我们尚未拥有它所需的依赖项。需要在 manifest中，为 com.google.gwt 包添加一个文件，必须在pom.xml中配置maven-jar-plugin并指向文件位置。在此处查看我的pom.xml。其次，我发现 Spring dm Server 专有的

manifest希望现在会看到绿条，这至少证明了测试用例启动了 Equinox 框架并成功创建了即时包。现在可以为 StockWatcherServiceLondon 包创建合适的单元测试了。条目不起作用，所以我必须修改两个项目，转而使用多个

Import-Package文件（包含在完整的工作空间下载中）。一旦依赖项工作正常，看看能否找出示例代码中的拼写错误，添加 Java import，现在应该有一个可以编译的测试类了。条目。进行这些更改后，打开命令提示符，切换到项目目录并输入mvn install。这将构建插件并安装到本地 maven 仓库。要安装我们在第 2 部分构建的 gwt 插件，我使用了以下命令行mvn install:install-file -DgroupId=com.google.gwt -DartifactId=com.google.gwt -Dversion=1.5.3 -Dpackaging=maven-plugin -Dfile=<location of jar file>.

。此时值得检查一下插件是否正确构建，可以通过解压仓库中的 jar 文件并检查清单文件是否正常来完成。），一个用于消费服务的一旦所有测试包构建并安装到仓库中，需要在测试用例的（例如method中指定它们。语法在参考文档中描述，我指定了 4 个包：com..client.api、com..service.london、com.google.gwt 和 javax.servlet。希望此时，您将能够在没有任何实际断言的情况下运行测试，并且应该能够成功地安装和启动所有测试包而没有问题。如果不起作用，一个有用的调试工具是启用 Equinox telnet 控制台，并用它来检查预期的导入和导出看起来是否都正确。如果收到因此，在UnsatisfiedLinkError

，它们可能不正确。启用控制台的方法是覆盖createPlatform()并调用

System.setProperty("osgi.console", "9000")

一旦所有包都正确解析和启动，您终于可以编写断言了！我们需要消费由 com..service.london 包导出的服务。将上面快速而粗糙示例中的

    <context-param>
        <param-name>contextClass</param-name>
        <param-value>com.springsource.server.web.dm.ServerOsgiBundleXmlWebApplicationContext</param-value>
    </context-param>

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/META-INF/*.xml</param-value>
    </context-param>

    <bean id="myFilter" class="com.google.gwt.sample.stockwatcher.server.StockPriceServiceFilter">
        <constructor-arg ref="priceService"/>
    </bean>

    <filter>
        <filter-name>myFilter</filter-name>
        <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
        <init-param>
            <param-name>targetFilterLifecycle</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>

    <filter-mapping>
        <filter-name>myFilter</filter-name>
        <servlet-name>StockService</servlet-name>
    </filter-mapping>