15.5. war URL 处理程序

如果您需要在 OSGi 容器中部署 WAR 文件，您可以通过为 war 前缀的 WAR URL 自动将必要的清单标头添加到 WAR 文件中，如下所述。

使用以下语法之一指定 War URL：

war:warURL
warref:instructionsURL

war:warURL
warref:instructionsURL

第一个语法（使用 war 方案）指定一个 WAR 文件，该文件使用默认指令转换为捆绑包中。warURL 可以是找到 WAR 文件的任何 URL。

第二个语法使用 warref 方案，指定第二属性文件 instructionsURL，其中包含转换指令（包括特定于此处理程序的一些指令）。在这个语法中，引用 WAR 文件的位置 不会在 URL 中明确显示。WAR 文件由属性文件中的（必需） WAR-URL 属性指定。

.bnd 指令文件中的一些属性特定于 War URL 处理程序，如下所示：

默认情况下，War URL 处理程序将清单标头添加到 WAR 的 META-INF/Manifest.mf 文件中，如 表 15.2 “用于编写 WAR 文件的默认说明” 所示。

以下 War URL 在 Maven 存储库中找到 wicket-examples WAR 的 1.4.7 版本，并使用默认说明将其转换为 OSGi 捆绑包：

war:mvn:org.apache.wicket/wicket-examples/1.4.7/war

war:mvn:org.apache.wicket/wicket-examples/1.4.7/war

以下 Wrap URL 明确指定 Web-ContextPath ：

war:mvn:org.apache.wicket/wicket-examples/1.4.7/war?Web-ContextPath=wicket

war:mvn:org.apache.wicket/wicket-examples/1.4.7/war?Web-ContextPath=wicket

以下 War URL 会将 WAR-URL 属性引用的 WAR 文件转换为 wicket-examples-1.4.7.bnd 文件中的 WAR 文件，然后使用 .bnd 文件中的其他指令将 WAR 转换为 OSGi 捆绑包：

warref:file:E:/Data/Examples/wicket-examples-1.4.7.bnd

warref:file:E:/Data/Examples/wicket-examples-1.4.7.bnd

有关 war URL 语法的详情，请查看原始 Pax URL 封装 协议 文档。