apache - bnd 如何决定适用于导入包的版本范围？

Question

我有一个问题，我正在使用 Maven war 插件构建 war 并使用 bnd 插件覆盖它，如 Adding OSGi metadata to existing projects without changing the packaging type. 中所述。该项目定义了以下依赖项:

    <dependency>
        <groupId>com.sun.jersey</groupId>
        <artifactId>jersey-server</artifactId>
        <version>1.12</version>
    </dependency>

当我运行构建时，它会在 MANIFEST.MF 中生成以下条目

Import-Package: .., javax.ws.rs.core,  ..

一旦我将版本更改为 1.13 或更高版本，Import-Package 条目就会变为:

Import-Package: .., javax.ws.rs;version="[1.1,2)", ..

这对我来说是一个真正的问题，因为我的目标中有 javax.ws.rs.javax.ws.rs-api_2.0.0.m16。这将解决无版本要求情况下的导入问题，但会在存在范围限制时停止这样做。

所以，我的一般问题是:bnd 如何决定版本范围？两个次要版本之间发生了一些变化，使其从无版本限制变为特定范围，因此我认为了解 bnd 如何做出该决定将帮助我发现这个特定问题是什么。

Answer 1

Bnd 使用 OSGi 语义版本控制——请阅读 whitepaper (PDF 链接)。

首先，bnd 计算出在构建时使用了哪个版本的包。您在构建路径上的 JSR311 API Jar 必须包含版本化的 Export-Package 语句，这很好，而且该版本必须是 1.1。因此，您的包可以使用的最低版本是 1.1。

语义版本控制表示主要(即第一个)段递增以指示所有用户的重大更改。因此，您的包将与 javax.ws.rs 包的版本 2.* 不兼容。因此 bnd 生成的范围最大但不包括 2...即 [1.1,2)。

我不明白为什么这会给您带来麻烦。您声明要将名为 javax.ws.rs.javax.ws.rs-api_2.0.0.m16 的包部署到您的目标中，但这看起来只是一个文件名。您是否检查过包内的包 javax.ws.rs 是否是版本 2？如果它仍然是版本 1.* 那么您可以使用它...如果它是版本 2.* 那么这意味着该包包含重大更改，因此您不应该使用它。最后，如果包的版本是 2.* 但它并不是真正的重大更改，那么创建该包的人就搞砸了，他们需要返回并阅读我链接到的 PDF。