Application Integration Design Console の使い方
|
 |
 |
|
WebLogic Integration には、アプリケーション ビューに使用する簡単なインポート/エクスポート ユーティリティが用意されています。このユーティリティはコマンド ラインから実行でき、アプリケーション ビューのインポート/エクスポート API と共にコードに組み込むことができます。ユーティリティの出力は、アプリケーション ビューが所有するすべての情報が保持されている JAR ファイルに格納されます。アプリケーション ビューで使用された情報のうち、そのアプリケーション ビューが所有していないものは、手動でインポートまたはエクスポートする必要があります。
インポート/エクスポート ユーティリティを使用すると、アプリケーション統合メタデータ オブジェクトをファイル リポジトリからエクスポートしたり、それらのオブジェクトをファイル リポジトリにインポートし直すことができます。このユーティリティでインポートまたはエクスポートできるオブジェクトは次のとおりです。
あるユーティリティの呼び出しでエクスポートされたオブジェクトはすべて、1 つの JAR アーカイブに格納されます。以前にエクスポートされた JAR をインポートすると、その JAR ファイル内のオブジェクトもすべてインポートされます。また、インポートと同時に、既存のエクスポート済みの JAR にオブジェクトを追加して、アプリケーション ビューと接続ファクトリをデプロイすることもできます。
WebLogic Integration 7.0 環境から WebLogic Integration 8.1 環境にアプリケーション ビューを移行するには、インポート/エクスポート ユーティリティを使用します。このユーティリティでは、移行中にアプリケーション ビューから ACL が削除され、接続ファクトリの使用がリソース アダプタの使用に変換されます。移行されたアプリケーション ビューは、ファイルベースのリポジトリにロードされます。
注意 : アプリケーション ビューを移行するには、事前に WebLogic Workshop にプロジェクトを定義する必要があります。このプロジェクトによって、リポジトリの場所が決まります。
ユーティリティは API としても、コマンドライン ツールとしても使用できます。いずれの場合も、サーバが実行されている必要があります。ユーティリティの実行に使用するスクリプトは、次の場所に保存されています。
WLI_HOME/bin/aiimportexport (cmd または sh)
以下の節では、インポート/エクスポート ユーティリティのコマンドライン パラメータとメソッドについて説明します。
インポート/エクスポート ユーティリティのコマンドライン構文は、次のようになります。
aiimportexport <appname> <root_dir> <file>
[-codepage=Cp<codepage_number>] [-dump=< <namespace> | <'Root'> >]
[-append] [-overwrite] [-publish]
< [-export [object_name]*] | [-import [edit-on-import_filename]
[-eventProps=<connection_factory_name>,<properties_file_name>]*] >
次の表は、インポート/エクスポート ユーティリティのコマンドライン パラメータを示しています。
インポート時編集ファイル (edit-on-import_filename) を指定すると、インポートするオブジェクトのテキストに対して編集コマンドを実行できます。実行された編集は、オブジェクトをリポジトリに格納する前、またはデプロイする前に完了します。また、このメソッドは、「オブジェクトをインポートする」で説明する方法で使用することもできます。
指定するドキュメントは、次の DTD に準拠している必要があります。
<!ELEMENT ApplicationView (replace*)>
<!ATTLIST ApplicationView name NMTOKEN #REQUIRED
newName NMTOKEN #IMPLIED>
<!ELEMENT ConnectionFactory (replace*)>
<!ATTLIST ConnectionFactory name NMTOKEN #REQUIRED
newName NMTOKEN #IMPLIED>
<!ELEMENT Schema (replace*)>
<!ATTLIST Schema name NMTOKEN #REQUIRED
newName NMTOKEN #IMPLIED>
<!ELEMENT replace EMPTY>
<!ATTLIST replace xpath CDATA #REQUIRED
old CDATA #REQUIRED
new CDATA #REQUIRED
インポート時編集ドキュメントには、編集するオブジェクトごとに <ELEMENT> タグで区切られたセクションが存在します。編集できるオブジェクトは ApplicationView と Schema です。各セクションでは、名前でオブジェクトを識別し、置換する要素を指定します。任意で、各セクションに、オブジェクトに新しい名前を割り当てるときに使用できる newName 属性を指定することもできます。
"") を指定した場合は、選択したノード内のすべてのテキストが検出されます。次のインポート時編集記述子のドキュメントは、DBMS.DBMS1 という名前のアプリケーション ビューを編集して、DBMS.DBMS1a という名前に変更する方法を示しています。この XML ドキュメントでは、アプリケーション ビューに対して 3 つの置換、接続ファクトリに対して 1 つの置換を設定しています。
<?xml version="1.0"?>
<!DOCTYPE edit SYSTEM "ImportExportEditOnImport.dtd">
<edit>
<ApplicationView name="DBMS.DBMS1" newName="DBMS.DBMS1a">
<replace xpath="/applicationView/@connectionFactory"
old=""
new="com.bea.wlai.connectionFactories.DBMS.
DBMS1a_connectionFactoryInstance"/>
<replace xpath="/applicationView/@connectionFactoryName"
old=""
new="DBMS.DBMS1a_connectionFactory"/>
<replace xpath="/applicationView/service[@name='Service1']/
interactionSpecProperty[@name='sql']"
old="CAJUN."
new="PBPUBLIC."/>
</ApplicationView>
<ConnectionFactory name="DBMS.DBMS1_connectionFactory"
newName="DBMS.DBMS1a_connectionFactory">
<replace xpath="/connection-factory-dd/jndi-name"
old=""
new="com.bea.wlai.connectionFactories.DBMS.
DBMS1a_connectionFactoryInstance"/>
</ConnectionFactory>
</edit>
最初の置換は、アプリケーション ビュー記述子の connectionFactory 属性を編集して、その中のテキストを新しい値に変更します。ここでは、古い値として空の文字列を指定しているので、ノード内のすべてのテキストが一致することに注意してください。
2 つ目の置換は、アプリケーション ビュー記述子の connectionFactoryName 属性を編集して、その中のテキストを新しい値に変更します。
3 つ目の置換は、Service1 というサービスのサービス記述子を編集して、sql という interactionSpecProperty 要素について、CAJUN. をすべて PBPUBLIC. に置換します。
4 つ目の置換は、接続ファクトリ記述子の jndi-name 属性を編集して、その中のテキストを新しい値に変更します。
以下の節では、インポート/エクスポート API に含まれるメソッドについて説明します。インポート/エクスポート API のクラス名は、com.bea.wlai.client.ImportExport です。
connect(<multiple signatures>)
connect() メソッドは、サーバ インスタンスとの接続方法を確立します。接続を開始する場所に応じて、connect() に適切な引数を指定する必要があります。
dumpNamespace(StringnamespaceName)
dumpNamespace() メソッドは、指定されたネームスペース名を表す文字列を取り、そのネームスペースとその中に埋め込まれたネームスペースに含まれるすべてのオブジェクトを印刷します。
exportNamespaceObjects(SetobjectNames, boolean append, List errors)
exportNamespaceObjects() メソッドは、オブジェクト名 (文字列による修飾名) のリストを取り、それらを指定の出力ファイル (「インポートおよびエクスポート用ファイルを指定する」を参照) にエクスポートします。エクスポート用に一覧されたすべてのオブジェクトは依存関係が検査されます。アプリケーション ビューで使用されたオブジェクトのうち、そのアプリケーション ビューで所有されていないものも、エクスポートされます。
アプリケーション ビューをエクスポートすると、ConnectionFactory と、そのアプリケーション ビューが依存するすべての Schema オブジェクトもエクスポートされます。ネームスペースをエクスポートした場合は、そのネームスペース内のオブジェクト (ネストされているネームスペースも含む) もすべてエクスポートされます。
エクスポートしたファイルを既存のアーカイブに追加する場合、ファイルを上書きする場合、またはファイルを作成する場合は、append を true に設定します。
エクスポート中に発生した致命的でないエラーは、指定した errors List オブジェクトに Exception オブジェクトとして格納されます。
importNamespaceObjects(boolean overwrite, boolean deploy, List errors)
importNamespaceObjects() メソッドは、指定した入力ファイル (「インポートおよびエクスポート用ファイルを指定する」を参照) 内のすべてのエントリを取って、リポジトリにインポートします。リポジトリ内の既存のメタデータを上書きするには、overwrite を true に設定します。インポート時に接続ファクトリとアプリケーション ビューをデプロイするには、deploy を true に設定します。
インポート中に発生した致命的でないエラーは、指定した errors List オブジェクトに Exception オブジェクトとして格納されます。
importNamespaceObjects(IDocumenteditOnImportDocboolean overwrite,
boolean deploy, List errors)
importNamespaceObjects() メソッドにインポート時編集ドキュメントを指定すると、インポートするオブジェクトのテキストに対して編集コマンドを実行できます。実行された編集は、オブジェクトをリポジトリに格納する前、またはデプロイする前に完了します。また、このメソッドは、「オブジェクトをインポートする」で説明する方法で使用することもできます。
editOnImportDoc 引数に指定するドキュメントは、「インポート時の編集」で示した DTD に準拠している必要があります。
setFile(Filefilename)
setFile() メソッドは、エクスポート先またはインポート元として使用されるファイルを指定します。
setPrintWriter(PrintWriter out)
setPrintWriter() メソッドは、メッセージ (ステータス、診断、エラー メッセージなど) が生成された場合に使用される PrintWriter オブジェクトを指定します。
setQuiet(boolean quiet)
setQuiet() メソッドは、進捗状況または情報的なメッセージを出力するかどうかを指定します。メッセージを出力するには、quiet を false に設定します。メッセージの出力を無効にするには、quiet を true に設定します。
|
|
|