15.5. War URL ハンドラー
15.5.1. 概要
OSGi コンテナーに WAR ファイルをデプロイする必要がある場合は、ここで説明するように war: を WAR URL の先頭に追加し、必要なマニフェストヘッダーを WAR ファイルに自動的に追加できます。
15.5.2. 構文
War URL は、以下の構文のいずれかを使用して指定されます。
war:warURL warref:instructionsURL
war スキームを使用する最初の構文は、デフォルトの命令を使用してバンドルに変換される WAR ファイルを指定します。warURL には、WAR ファイルを特定する URL を指定できます。
warref スキームを使用する 2 番目の構文は、変換命令 (このハンドラーに固有の命令を含む) が含まれる Bnd プロパティーファイル instructionsURL を指定します。この構文では、参照される WAR ファイルの場所は URL に明示的に表示されません。代わりに、WAR ファイルは、プロパティーファイルの (必須の) WAR-URL プロパティーにより指定されます。
15.5.3. WAR 固有のプロパティー/命令
以下のように、.bnd 命令ファイルのプロパティーの一部は、War URL ハンドラーに固有です。
WAR-URL- (必須) バンドルに変換する War ファイルの場所を指定します。
Web-ContextPathWeb コンテナー内にデプロイされた後に、この Web アプリケーションへのアクセスに使用される URL パスを指定します。
注記PAX Web の以前のバージョンでは、現在非推奨となっているプロパティー
Webapp-Contextが使用されていました。
15.5.4. デフォルトの手順
デフォルトでは、表15.2「WAR ファイルをラッピングするデフォルトの命令」 に示すように、War URL ハンドラーは WAR の META-INF/Manifest.mf ファイルにマニフェストヘッダーを追加します。
| マニフェストヘッダー | デフォルト値 |
|---|---|
|
|
|
|
| パッケージはエクスポートされません。 |
|
|
WAR ファイルの名前。セット |
|
|
デフォルト値はありません。しかし、WAR エクステンダーは、デフォルトで |
|
| 明示的に指定されたクラスパスエントリーの他に、以下のエントリーが自動的に追加されます。
|
15.5.5. 例
以下の War URL は、Maven リポジトリーの wicket-examples WAR のバージョン 1.4.7 を見つけ、これをデフォルトの命令を使用して OSGi バンドルに変換します。
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 URL は、wicket-examples-1.4.7.bnd ファイルの WAR-URL プロパティーによって参照される WAR ファイルを変換し、.bnd ファイルの他の命令を使用して WAR を OSGi バンドルに変換します。
warref:file:E:/Data/Examples/wicket-examples-1.4.7.bnd
15.5.6. 参照資料
war URL 構文の詳細は、元の Pax URL の War Protocol ドキュメントを参照してください。
