変換を実行するには、事前に変換構成を作成しておきます。
変換構成を適用すると、変換のインスタンスが作成され、その構成内で定義したプロパティーを使用して変換が実行されます。
このタスクについて
変換を実行するには、作業しているビューに応じて、以下のステップのいずれかを実行します。- ナビゲーション・ビューにいる場合は、変換構成 (.tc) ファイルを右クリックしてから、「変換」をクリックし、変換をクリックします。
- 「パターン・エクスプローラー」ビューで変換を右クリックし、「変換を実行」をクリックします。「構成の選択」ダイアログ・ボックスで、実行する変換構成を指定し、「OK」をクリックします。
ヒント: 変換は変換構成エディターから実行することもできます。
「メイン」ページで、
「実行」をクリックします。
ヒント: この変換を再び実行するには、をクリックします。最後に変換を実行した時と同じソース要素を使用して変換が行われます。
- コマンド行から変換を実行するには、以下の構文を使用します。
eclipse -data workspace-path -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "[-R]transformation-configuration-path1,[-R]transformation-configuration-path2,..."
-transformConfigs パラメーターには、1 つ以上の変換構成の完全なワークスペース・パスと構成ファイル名 (ファイル・システムのパス名ではない) を指定する必要があります。
コマンド行から変換を実行すると、変換によって生成されるすべてのダイアログ・ボックスが抑制されます。
例として、MyConfig.tc という変換構成が MyWorkspace というワークスペース内の MyProject というプロジェクト内にあるとします。この変換構成は、MyTransformation という変換の構成情報と、MyReverseTransformation という対応する後方変換の構成情報を指定します。MyTransformation を呼び出すには、コマンド行で以下のテキストを入力することで、MyConfig.tc 構成を実行できます。eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MyProject/MyConfig.tc"
後方変換を実行するには、次の例に示すように、変換構成パスの先頭に -R オプションを指定します。eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "-RMyProject/MyConfig.tc"
複数の変換を実行するには、-transformConfigs パラメーターに、各構成のワークスペース・パス名を含む、変換構成のコンマ区切りのリストを指定します。以下の例のように、前方変換または後方変換を実行できます。eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MyProject/MyConfig.tc, -RMyProject/MyConfig.tc"
- 変換をアプリケーションの一部として実行するには、以下の例のように、変換 API を呼び出すことができます。
IFile file = ResourcesPlugin.getWorkspace().getRoot().getFile(new Path("/MyWorkspace/MyConfig.tc"));
try {
ITransformConfig config = TransformConfigUtil.loadConfiguration(file);
IStatus status = TransformController.getInstance().execute(config, null, false, null);
}
catch (IOException e) {
// 構成ファイルを読み取れませんでした。
}
以下の例のように URL を指定することで、変換構成をロードすることもできます。
try {
URL url= new URL(platform:/plugin/myPluginID/myConfig.tc);
ITransformConfig config = TransformConfigUtil.loadConfiguration(url);
}
catch (MalformedURLException malURLEx) {
// 例外を処理します。
}
catch (IOException ioEx) {
// 例外を処理します。
}
以下の例のように、さまざまなプロトコルを使用する URL を指定できます。
- platform:/plugin/myPluginID/myConfig.tc
- http://myServer.myCompany.com/myConfig.tc
- ftp://myUsername:myPassword@myServer.myCompany.com/myConfig.tc
- jar:file:c:/myFolder/myJar.jar!/myConfig.tc
- file:c:/myFolder/myConfig.tc