JAR清单文件 - 规范和实现之间的差异

Question

我想在我创建的库的jar中添加版本信息(可能还有一些关于jar的其他元数据).但是,我不确定使用什么属性.我发现规范以及文档说明可以有a Specification-Version和an Implementation-Version(以及两者的标题和供应商).但是没有正确解释规范和实现之间的区别.

我也看了不同的例子.

• 文档中的一个使用了Specification-Title的可读名称和Implementation-Title的包​​名.点分隔版本号用于规范版本,而简单版本号用于实现版本.
• gradle教程似乎只是使用Implementation-Version和一个人类可读的字符串来实现Implementation-Title
• 在另一个问题中,我找到了一个示例,其中有不同包的几个实现版本.

这里的规范和实现元数据究竟有什么区别？应该如何使用这些不同的属性(尤其是版本号)？规范和实现的供应商是如何有所不同的？

它甚至扮演了我放在那里的角色吗？

Answer 1

每个的含义都在java.lang.Package的文档中解释.

的部分规格版本必须由ASCII数字,由ASCII句点分隔的序列.不允许使用其他字符,句点不能位于值的开头或结尾,并且不允许连续句点.

该实施-版本是无格式的字符串.它可以有任何格式.

规范 - 版本始终与包相关联.如果为整个清单而不是特定包指定它,则它将应用于.jar文件中的所有包.

许多Java技术使用Specification-Version作为解决依赖关系的手段.如果某个程序说它需要,比如版本2.1或更高版本的JMF库,一些Java环境将使用匹配的Specification-Title分析每个清单的Specification-Version中的数字,并确保正确的版本(和没有其他版本)在运行时在类路径中可用.

实际上,Package.isCompatibleWith方法可以检查.您甚至可以使用它来检查最低Java版本:

if (System.class.getPackage().isCompatibleWith("1.6")) {
    System.out.println("Running in Java 1.6 or later.");
}

更新

以上内容在Java 9模块化应用程序中不起作用.从java.lang.Package的文档:

为命名模块中的类自动定义的包具有以下属性:
...
•未指定规范和实现标题,版本和供应商.

为未命名模块中的类自动定义的包具有以下属性:
...
•未指定规范和实现标题,版本和供应商.

作为模块运行的Java 9程序应该使用ModuleDescriptor.version().请注意,ModuleDescriptor.Version类是Comparable:

Module libraryModule = SomeLibraryClass.class.getModule();
Optional<ModuleDescriptor.Version> libraryVersion =
    libraryModule.getDescriptor().version();

ModuleDescriptor.Version minimumRequiredVersion =
    ModuleDescriptor.Version.parse("2.0");

if (libraryVersion.isPresent() &&
    minimumRequiredVersion.compareTo(libraryVersion.get()) >= 0) {

    System.out.println(libraryModule + " is version " +
        minimumRequiredVersion + " or later.");
}

Answer 2

那么,规范就是你的合同,例如:

• 标准,如JAXB,JDBC或各种Java EE标准之一(例如EJB 2.x,EJB 3.0,EJB 3.1)
• 您的库,框架或服务的API

实现是该规范的实现.

虽然规范的API(以及规范版本)可能不会改变,但实施版本可能会随着您修复错误等而改变.