UML から Java への変換の構成

• 「パターン・エクスプローラー」ビューで変換を右クリックし、「新規構成」をクリックします。
• その他のビューで、「ファイル」 > 「新規」 > 「変換構成」をクリックします。「変換構成」がメニュー項目でない場合は、「ファイル」 > 「新規」 > 「その他」 > 「変換」 > 「変換構成」をクリックします。

1. 「名前」フィールドに、構成の名前を指定します。
2. 「構成ファイル宛先」フィールドで、変換構成ファイルの宛先を指定します。宛先は、現行ワークスペース内の相対パスです。完全修飾プロジェクト名またはフォルダー名を指定できます。プロジェクト内のフォルダーを指定する場合は、フォルダー名の前に接頭部としてスラッシュ (/) を付ける必要があります。
3. 「変換」リストから変換を選択します。
   注: インストールされていても使用可能になっていない変換を表示するには、「すべての変換の表示」をクリックします。 変換は、このリストに表示するには、機能にバインドする必要があります。

• ソース・モデルが基本技術成果物の場合は、「概念」を選択します。 ソース・モデルへの変更はすべてターゲット・モデルに波及します。
• ターゲット・モデルが基本技術成果物の場合は、「混合」をクリックします。 変換により、ソースの成果物は、ターゲットの成果物に直結するビジュアル表示に 変換されます。 ソース・モデルで作業する代わりに ターゲット・ドメイン内で作業する場合、または分析のために成果物を保持する場合に このオプションを選択します。 変換出力は、基本技術成果物になります。
• ソース成果物が表すアーキテクチャーがターゲットとは独立して発展する場合は、「調整」を選択します。このオプションを選択すると、ソースとターゲットの比較や変更の調整に利用できる後方変換を使用できるようになります。また、他のチームによって該当のアーキテクチャーが 実装、開発、または保守される場合にも、このオプションを選択することができます。
  注: このオプションを選択すると、「メイン」ページの「後方変換」セクションで、追加のプロパティーが使用可能になります。 一部の変換では、変換構成エディターで追加のオプションまたはページが使用可能になります。 後方変換の構成について詳しくは、下の関連リンクを参照してください。

1. 「選択済みソース」ペインで、変換対象の変換用にソース要素を選択します。
2. 「選択済みターゲット」ペインで、変換出力の宛先を選択します。出力の新規の宛先を作成するには、「ターゲット・コンテナーの作成」をクリックします。

• 変換出力で getter メソッドと setter メソッドを生成するには、「getter と setter の生成」チェック・ボックスを選択します。変換によって UML プロパティー用の setter メソッドが生成されるかどうかは、ソース・モデルにあるプロパティーの特定の値に左右されます。
  UML プロパティーの値は「プロパティー」ビューで確認できます。

  • 「一般」ページで、プロパティーの「特化不可」または「読み取り専用」チェック・ボックスを選択した場合、setter メソッドは生成されません。プロパティーの「派生」チェック・ボックスを 選択すると、setter の実装は空になります。
  • 「詳細」ページで、プロパティーの「特化不可」または「読み取り専用」の値を true に設定すると、setter メソッドは生成されません。 プロパティーの「Is Derived」の値を true に設定すると、setter の実装は空になります。
• Java™ 2 Platform, Standard Edition (J2SE) 5.0 と互換性のあるコードを生成するには、「J2SE 5.0 と互換性のあるコードを生成」チェック・ボックスを選択します。このオプションをクリアすると、変換によって J2SE 1.4 のバージョンと互換性のあるコードが生成されます。このチェック・ボックスは、UML から Java 変換を構成する場合にのみ選択可能です。
• 変換の実行後に変更されたファイルのみを保存するには、「更新されたファイルのみをディスクに書き込む」チェック・ボックスを選択します。

  このオプションを選択して、大きいモデルを処理する場合に、パフォーマンスが低下することがあります。 これは、変換処理で、更新されたファイルを判別し、更新されなかったファイルをメモリー内のリストから削除する必要があるためです。チーム環境で作業している場合は、不要なチェックアウト操作やチェックアウト操作の取り消しをなくすためにこのチェック・ボックスを選択することもあります。

  このチェック・ボックスをクリアすると、変換によって未変更のファイルがそのメモリー内のリストから削除されることはありません。 変換の実行後、変更されたファイルと未変更のファイルのディスクへの書き込みが試行されます。チーム環境では、変換によって更新されなかったファイルのチェックアウト操作を、手動で取り消す必要がある場合があります。

• Java プロジェクト依存性をターゲット・プロジェクトに追加するには、「Java プロジェクト依存性の生成」チェック・ボックスを選択します。

  このオプションは、「Java から UML への変換の関連」ページで Java から UML への変換の関連ファイルを作成する際に使用できます。このチェック・ボックスを選択すると、UML から Java への変換で UML 参照が検出された場合に、変換により Java から UML への変換の関連モデルへの参照と比較されます。 UML 参照のマップ先が、変換の現在のターゲットではない Java プロジェクトである場合、変換によりターゲット・プロジェクトに Java プロジェクトの依存性が追加されます。

• UML から Java 変換構成を編集する場合は、「廃止された生成済みファイルの削除」セクションでオプションを選択します。
• UML から Java (非推奨) 変換構成を編集する場合は、「プロパティー」ページの、「廃止された生成済みファイルの削除」セクションでオプションを選択します。

UML から Java 変換によりクラス、操作、およびフィールドが生成される場合、 これらの要素に @generated タグが割り当てられます。次回に変換を実行したときに、 変換によりこれらの要素が上書きされます。ソース・モデルから要素を削除し、UML から Java 変換を再実行すると、以前生成されたフィールドやメソッドで、まだ @generated タグが付いていて、対応するソース・モデル要素を持っていないものが変換によって削除されます。ただし、 変換により生成されるファイルの場合、ファイルを削除するかどうかを指定できます。

ログ・ファイルは、ソース要素、ターゲット要素、および変換によってソース要素が変換されるときに適用される規則に関する情報を提供します。変換が多数の要素を変換する場合、変換がログ・ファイルを生成している間はパフォーマンスが低下することがあります。そのため、ログ・ファイルを生成するのは、デバッグ目的の場合のみにしてください。

サイレント・モードで変換を実行すると、変換によって生成されるすべてのダイアログ・ボックスが抑制されます。 変換ではデフォルトの規則と振る舞いが適用され、予期しない変換出力や不正確な変換出力が生成されることがあります。サイレント・モードでの変換の実行は、変換出力の検証ではなく、変換の実行を検証する場合のみ実行してください。例えば、自動化されたタスクや自動化されたテスト・スイートの一部として、変換をサイレント・モードで実行することがあります。

変換がサイレント・モードで実行されるよう設定すると、指定したファイル上書きオプションがオーバーライドされ、必要に応じてファイルが上書きされます。

Java から UML への変換が使用可能な場合、「サイレント・モードで後方変換を実行」チェック・ボックスを選択することができます。サイレント・モードで Java から UML への変換、または後方変換を実行するよう指定すると、マージ・エディターが抑止されます。マージ中に競合が発生すると、変換が停止します。その場合には、サイレント・オプションをクリアして変換を再実行する必要があります。

トレース関係とビジュアル開発ツールを使用して、ソース・モデル要素と変換出力の関係を理解することができます。 この機能は、複数のモデルおよび変換構成を持つような大規模なプロジェクトの場合に便利です。 ソース・モデルは変換によって変更されません。

• 「拡張」ページで、変換の拡張のチェック・ボックスを選択またはクリアして、使用可能または使用不可に設定します。

  列挙型リテラルの名前と値を保持する Java 列挙型を生成するには、「com.ibm.xtools.transform.java.enumext.u2j.transform」チェック・ボックスを選択します。列挙型リテラルの名前と値は、取得可能な文字列として生成されます。

  受動クラス状態マシン用の Java コードを生成するには、 com.ibm.xtools.transform.uml2.java.sm.PassiveClassStatemachine チェック・ボックスを選択します。 変換の実行後、生成された状態マシン・コードを Java アプリケーションとして実行できます。

• 「コレクション」ページで、UML コレクション・タイプの各リストで Java コレクション・タイプを選択します。 カスタム値を指定するには、適切なコレクション・フィールドに値を入力します。UML コレクション・タイプについて詳しくは、この変換についての関連概念のトピックを参照してください。

1. 「Java から UML への関連ファイル名」フィールドで、ファイル名を指定します。
2. 「Java から UML への関連」セクションで、 表の横にあるボタンをクリックして、 ファイルに関連を追加するか、またはファイルから関連を削除します。

1. 変換構成エディターの 「マッピング」ページで、「この構成でマッピング機能を使用可能にする」チェック・ボックスを選択します。
2. 「マッピング・モデルのファイル名」フィールドで、新規または既存のマッピング・モデルの名前を指定します。