| 変換構成の使用 |
現在のビューに応じて、以下のステップのいずれかを実行します。
|
| 変換構成に定義されている変換ソースのオーバーライド |
モデリング・パースペクティブにいる場合は、ソース・モデルまたはプロジェクト内の要素を選択して右クリックしてから
、「変換」をクリックして変換構成をクリックし、変換をクリックします。
変換構成ファイルは、選択した要素と同じプロジェクト内に存在する必要があります。
変換構成は影響を受けず、変換構成エディターまたは「新規変換構成」ウィザードの「ソースとターゲット」ページで指定したソースも変更されません。
ヒント: この変換を再び実行するには、をクリックします。最後に変換を実行した時と同じソース要素を使用して変換が行われます。
|
| コマンド行からの変換の実行 |
コマンド行から変換を実行するには、以下の構文を使用し、コマンドを 1 行で入力します。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 変換を呼び出すには、以下のコマンドを 1 行で入力することで、MyConfig.tc 構成を実行できます。
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner
-transformConfigs "MyProject/MyConfig.tc"
- 後方変換を実行するには、変換構成パスの先頭に -R オプションを指定し、コマンドを 1 行で入力します。
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner
-transformConfigs "-RMyProject/MyConfig.tc"
- 複数の変換を実行するには、-transformConfigs パラメーターに、各構成のワークスペース・パス名を含む、変換構成のコンマ区切りのリストを指定します。コマンドを 1 行で入力します。以下の例のように、前方変換または後方変換を実行できます。
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner
-transformConfigs "MyProject/MyConfig.tc, -RMyProject/MyConfig.tc"
|
| 変換 API の起動 |
変換をアプリケーションの一部として実行するには、以下の例のように、変換 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
|
| Ant スクリプトからの変換構成の実行 |
変換を Ant スクリプトまたは build.xml ファイルから実行するには、以下のステップを実行します。- 現行ワークスペースで、build.xml という名前のファイルを作成します。
- build.xml ファイルに、以下の内容を挿入します。
<?xml version="1.0" encoding="UTF-8"?>
<project name="myProject" default="generate" basedir=".">
<target name="generate">
<echo>Running transformation 'myProject/myConfig.tc' ...</echo>
<com.ibm.xtools.transform.core.runTransformation transformConfig="myProject/myConfig.tc"
reverse="false"/>
</target>
</project>
- myProject 変数をターゲット・プロジェクトの名前に置換し、myConfig.tc 変数をそのプロジェクトで参照されている変換構成ファイルの名前に置換します。
- 後方変換をサポートしている変換タイプの場合、後方変換を実行するには、reverse 属性を「true」に設定します。
注: 変換構成は、調整されたモデリングの設計規約管理プロトコル (DCMP) を実装する必要があります。
- build.xml ファイルを右クリックし、の順にクリックします。
|
| 複数の変換構成の連続的な実行 |
複数の変換構成を連続的に実行して、次のタスクを完了できます。 - UML モデルを複数ドメインのコードへ変換
- UML モデルまたはそのモデル内の要素を異なるターゲット・プロジェクトに変換
- モデルおよびコード間における変更内容の同期化
連続的な構成の実行について詳しくは、このトピックの最後にある変換および変換構成の関連概念のトピックのリンクを参照してください。 複数の変換構成を連続的に実行するには、コンポジット変換の変換構成を作成および実行します。実行する構成が、現行のワークスペースに既に存在している必要があります。
- の順にクリックして、「次へ」をクリックします。
- 新規変換構成ウィザードでステップを完了します。
- 「構成名および変換の指定」ページで、構成の詳細を指定します。
コンポジット変換を選択する場合は、「変換」セクションで、をクリックします。
- 「変換構成」ページで、実行する変換構成と、それらを実行する順序を選択します。
「選択済み変換構成」表の「変換」列で、前方変換か後方変換かを選択します。
- 「終了」をクリックします。
- 変換構成エディターの「メイン」ページで、「実行」をクリックします。
|