A.2. 设置红帽 Fuse OSGi 项目

概述

用于构建 OSGi 捆绑包的 Maven 项目可以是一个简单级别的项目。它不需要任何子项目。但是,它需要您执行以下操作:

  1. 捆绑包插件添加到您的 POM。
  2. 指示 Maven 将结果打包为 OSGi 捆绑包。
注意

您可以使用几个 Maven archetypes 来设置项目及适当的设置。

目录结构

创建 OSGi 捆绑包的项目可以是单一级别的项目。它只需要有一个顶层 POM 文件和一个 src 文件夹。与所有 Maven 项目中一样,您要将所有 Java 源代码放在 src/java 文件夹中,并且您将任何非 Java 资源放到 src/resources 文件夹中。

非 Java 资源包括 Spring 配置文件、JBI 端点配置文件和 WSDL 合同。

注意

使用 Apache CXF、Apache Camel 或其他 Spring 配置的红帽 Fuse OSGi 项目还包括一个 Bean,它还包含 src/resources/META-INF/spring 文件夹中的 Bean.xml 文件。

添加 bundle 插件

在使用捆绑插件前,您必须添加对 Apache Felix 的依赖。添加依赖项后,您可以将捆绑包插件添加到 POM 的插件部分。

例 A.1 “将 OSGi 捆绑包插件添加到 POM” 显示将捆绑包插件添加到您的项目所需的 POM 条目。

例 A.1. 将 OSGi 捆绑包插件添加到 POM

...
<dependencies>
  <dependency>
    <groupId>org.apache.felix</groupId>
    <artifactId>org.osgi.core</artifactId>
    <version>1.0.0</version>
  </dependency>
...
</dependencies>
...
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.felix</groupId>
      <artifactId>maven-bundle-plugin</artifactId>
      <configuration>
        <instructions>
          <Bundle-SymbolicName>${pom.artifactId}</Bundle-SymbolicName>
          <Import-Package>*,org.apache.camel.osgi</Import-Package>
          <Private-Package>org.apache.servicemix.examples.camel</Private-Package>
        </instructions>
      </configuration>
    </plugin>
  </plugins>
</build>
...

例 A.1 “将 OSGi 捆绑包插件添加到 POM” 中的条目执行以下操作:

添加 Apache Felix 的依赖

将 bundle 插件添加到项目中

配置插件以使用项目的工件 ID 作为捆绑包的符号链接

配置插件以包含捆绑类导入的所有 Java 软件包;还可导入 org.apache.camel.osgi 软件包

配置插件以捆绑列出的类,但不将其包含在导出软件包列表中

注意

编辑配置以满足您的项目要求。

有关配置捆绑插件的详情请参考 第 A.3 节 “配置捆绑插件”

激活捆绑包插件

要让 Maven 使用 bundle 插件,请指示它将项目的结果打包为捆绑包。通过将 POM 文件的 打包 元素设置为 bundle 来完成此操作。

有用的 Maven archetypes

有几种 Maven archetypes 可以生成预配置的项目来使用 bundle 插件:

Spring OSGi archetype

Spring OSGi archetype 创建通用项目以使用 Spring DM 构建 OSGi 项目,如下所示:

org.springframework.osgi/spring-bundle-osgi-archetype/1.1.2

您可以使用以下命令调用 archetype:

mvn archetype:generate -DarchetypeGroupId=org.springframework.osgi -DarchetypeArtifactId=spring-osgi-bundle-archetype -DarchetypeVersion=1.1.2 -DgroupId=groupId -DartifactId=artifactId -Dversion=version

Apache CXF code-first archetype

Apache CXF code-first archetype 创建一个项目,用于从 Java 构建服务,如下所示:

org.apache.servicemix.tooling/servicemix-osgi-cxf-code-first-archetype/2010.02.0-fuse-02-00

您可以使用以下命令调用 archetype:

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-osgi-cxf-code-first-archetype -DarchetypeVersion=2010.02.0-fuse-02-00 -DgroupId=groupId -DartifactId=artifactId -Dversion=version

Apache CXF wsdl-first archetype

Apache CXF wsdl-first archetype 创建一个项目,用于从 WSDL 创建服务,如下所示:

org.apache.servicemix.tooling/servicemix-osgi-cxf-wsdl-first-archetype/2010.02.0-fuse-02-00

您可以使用以下命令调用 archetype:

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-osgi-cxf-wsdl-first-archetype -DarchetypeVersion=2010.02.0-fuse-02-00 -DgroupId=groupId -DartifactId=artifactId -Dversion=version

Apache Camel archetype

Apache Camel archetype 创建了一个项目,用于构建部署到 Red Hat Fuse 中的路由,如下所示:

org.apache.servicemix.tooling/servicemix-osgi-camel-archetype/2010.02.0-fuse-02-00

您可以使用以下命令调用 archetype:

mvn archetype:generate -DarchetypeGroupId=org.apache.servicemix.tooling -DarchetypeArtifactId=servicemix-osgi-camel-archetype -DarchetypeVersion=2010.02.0-fuse-02-00 -DgroupId=groupId -DartifactId=artifactId -Dversion=version