跳到主要内容

使用Maven构建JMS项目

Apache Maven 是一种软件管理工具,可用于构建、安装和分发基于 Java 的项目。借助 Apache Maven,您可以:

  • 从 Maven Central 获取 PubSub+ 消息 API for JMS 组件。
  • 将 PubSub+ 消息 API for JMS 组件安装到本地企业 Maven 仓库中。
  • 将 PubSub+ 消息 API for JMS 组件部署到远程仓库中。

要使用 Maven 构建项目,PubSub+ 消息 API for JMS 需要以下组件:

  • sol-jms-10.x.x.jar:PubSub+ 消息 API for JMS 库。
  • sol-jcsmp-10.x.x.jar:PubSub+ 消息 API for Java 库。
  • solsuite-10.x.x.pom:Solace API 项目配置文件。
  • sol-common-10.x.x.jar:PubSub+ 消息 API for Java 实用工具。

从Maven Central获取组件

要从 Maven Central Repository 获取项目所需的 Solace JMS 组件,您必须在 pom.xml 文件中声明以下依赖项:

<dependency>
 <groupId>com.solacesystems</groupId>
 <artifactId>sol-jms</artifactId>
 <version>10.27.x</version>
</dependency>

使用 PubSub+ JMS API 与 JMS 1.1

某些应用程序可能需要继续使用 Geronimo 1.1 规范,因为它们有依赖于 JMS 规范 1.1 版本的组件。对于 10.20 及更高版本的 PubSub+ 消息 API for JMS,您需要使用兼容层,以便与具有 Geronimo JMS 1.1 依赖项(geronimo-jms_1.1_spec)的应用程序实现向后兼容。您还需要排除 Geronimo JMS 2.0 规范,以避免冲突。为此,请将以下内容添加到您的 pom.xml 文件中:

<dependency>
<groupId>com.solacesystems</groupId>
<artifactId>sol-jms</artifactId>
<version>10.20.x</version>
<exclusion>
<groupId>org.apache.geronimo.specs</groupId>
<artifactId>geronimo-jms_2.0_spec</artifactId>
</exclusion>
</dependency>

<dependency>
<groupId>com.solacesystems</groupId>
<artifactId>sol-jms-compat-1.1</artifactId>
<version>1.0.0</version>
</dependency>

在本地安装组件

要将 PubSub+ 消息 API for JMS 组件用作 Maven 依赖项,您必须将 PubSub+ JMS jar 文件和 pom.xml 文件安装到您的本地仓库中。

要在本地安装 jar 文件或 pom.xml 文件,请在终端窗口中输入以下命令:

mvn install:install-file -Dfile=<文件路径> -DpomFile=<pom文件路径> -Dmaven.repo.local=<本地仓库路径>

安装 .jar 文件的示例:

$ mvn install:install-file
  -Dfile=/downloads/sol-jms/lib/sol-jms-10.x.x.jar
  -DpomFile=/downloads/sol-jms/lib/sol-jms-10.x.x.pom
  -Dmaven.repo.local=./.repository
$ ls /tmp/.repository/com/solace/sol-jms/10.x.x/
_remote.repositories sol-jms-10.x.x.jar sol-jms-10.x.x.pom

安装 pom.xml 文件的示例:

$ mvn install:install-file -Dfile=/downloads/sol-jms/lib/solsuite-10.x.x.pom
  -DpomFile=/downloads/sol-jms/lib/solsuite-10.x.x.pom
  -Dmaven.repo.local=./.repository

将组件部署到远程仓库

要将 PubSub+ 消息 API for JMS 组件用作 Maven 依赖项,您必须将 jar 文件和 pom.xml 文件部署到项目的远程 Maven 仓库中。

要将 jar 文件或 pom.xml 文件部署到 Maven 远程仓库,请在终端窗口中输入以下命令:

mvn deploy:deploy-file
  -Dfile=<文件路径>
  -DpomFile=<pom文件路径>
  -DrepositoryId=release
  -Durl=<仓库URL>