|
|
このリリースの WebLogic Server では、デプロイメント記述子は XML スキーマ定義 (XML Schema Definition : XSD) に基づいています。9.0 より前のリリースの WebLogic Server では、デプロイメント記述子は文書型定義 (Document Type Definition : DTD) に基づいていました。下位互換性を保持するために、このリリースの WebLogic Server は、XSD ベースと DTD ベースのデプロイメント記述子をサポートしています。このため、DTD ベースのデプロイメント記述子を使用するアプリケーションも記述子を変更せずにデプロイできます。
以下の節では、このリリースの WebLogic Server の EJB XSD ベースのデプロイメント記述子とネームスペース宣言、および 9.0 より前リリースの WebLogic Server の EJB DTD ベースのデプロイメント記述子と DOCTYPE ヘッダについて説明します。
WebLogic Server EJB デプロイメント記述子の要素については、以下の節を参照してください。
EJB 1.1 デプロイメント記述子要素については、「EJB 1.1 ユーザへの重要な情報」を参照してください。
デプロイメント記述子ファイルの内容と要素の配置は、適切な XSD に準拠している必要があります。
XSD デプロイメント記述子ファイルでは、ルート要素にネームスペース宣言が必要です。デプロイメント記述子ファイルのルート要素のネームスペース宣言は、その記述子のすべての要素に適用されます。ただし、特定の要素の中にルート ネームスペース宣言をオーバーライドする別のネームスペース宣言が含まれている場合を除きます。
| 注意 : | DDConverter を使用して DTD ベースのデプロイメント記述子を XSD ベースに変換する場合、適切なネームスペース宣言が記述子ファイルに自動的に書き込まれます。 |
XML デプロイメント記述子ファイルには、ネームスペース宣言と共にスキーマの URL を常に書き込むことをお勧めします。スキーマ URL を書き込まない場合、サードパーティ ツールで記述子ファイルを編集できない場合があります。
WebLogic Server 9.1 の weblogic-ejb-jar.xml ファイルのネームスペース宣言とスキーマの場所を表す正確なテキストは次のとおりです。
<weblogic-ejb-jar xmlns="http://www.bea.com/ns/weblogic/910" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.bea.com/ns/weblogic/910 http://www.bea.com/ns/weblogic/910/weblogic-ejb-jar.xsd">
WebLogic Server 9.1 の weblogic-cmp-jar.xml ファイルのネームスペース宣言とスキーマの場所を表す正確なテキストは次のとおりです。
<weblogic-rdbms-jar xmlns="http://www.bea.com/ns/weblogic/910" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.bea.com/ns/weblogic/910 http://www.bea.com/ns/weblogic/910/weblogic-rdbms20-persistence.xsd">
Enterprise JavaBeans 2.1 の ejb-jar.xml ファイルのネームスペース宣言とスキーマの場所を表す正確なテキストは次のとおりです。
<ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd">
旧リリースの WebLogic Server では、デプロイメント記述子ファイルの内容と要素の配置は、適切な DTD に準拠している必要がありました。
WebLogic Server では、XML デプロイメント ファイルの DOCTYPE ヘッダに埋めこまれた DTD の場所は無視され、代わりにサーバと一緒にインストールされた DTD の場所が使用されます。ただし、DOCTYPE ヘッダ情報には、パーサ エラーを避けるために有効な URL 構文を指定する必要があります。
XML デプロイメント ファイルの編集、作成時に、各デプロイメント ファイルに対して正しい DOCTYPE ヘッダを指定することが重要です。特に、DOCTYPE ヘッダ内部に不正な PUBLIC 要素を使用すると、原因究明が困難なパーサ エラーになることがあります。
このヘッダは、デプロイメント記述子の文書型定義 (DTD) ファイルの場所およびバージョンを表します。このヘッダは外部 URL の java.sun.com を参照していますが、WebLogic Server には独自の DTD ファイルが用意されているので、ホスト サーバがインターネットにアクセスする必要はありません。ただし、この要素の DTD のバージョンはデプロイメント記述子のバージョンの識別に使用されるので、<!DOCTYPE...> 要素を weblogic-ejb-jar.xml ファイルおよび weblogic-cmp-jar.xml ファイルに含めて、外部 URL を参照させる必要があります。
XML の解析ツール (appc など) でヘッダ情報が不正な XML ファイルを解析すると、次のようなエラー メッセージが表示されることがあります。
SAXException: This document may not have the identifier `identifier_name'
identifier_name には通常、PUBLIC 要素内の不正な文字列が表示されます。
表 A-1 に、WebLogic Server 固有の weblogic-ejb-jar.xml ファイルの PUBLIC 要素の正確なテキストを WebLogic Server のリリース別に示します。
表 A-2 に、WebLogic Server 固有の weblogic-cmp-jar.xml ファイルの PUBLIC 要素の正確なテキストを WebLogic Server のリリース別に示します。
weblogic-cmp-jar.xml ファイルの詳細については、「weblogic-cmp-jar.xml デプロイメント記述子のリファレンス」を参照してください。
表 A-3 に、Sun Microsystems 固有の ejb-jar.xml ファイルの PUBLIC 要素の正確なテキストをエンタープライズ JavaBean のバージョン別に示します。
  
|
