モデル / プレゼンテーションの編集

編集を行う場合は必ずトランザクション処理が必要となります。
なお、下記条件を満たしていない場合は例外が発生します。

  • プロジェクトアクセサにプロジェクトを登録していること
  • 編集APIが対応しているエディションであること
  • 対象が編集可能であること

トランザクション処理

トランザクションはastah*のプロジェクトに対して行われる更新処理の単位です。

beginTransactionメソッドがトランザクションの開始、endTransactionメソッドがトランザクションを確定させる処理です。 beginTransactionメソッドからendTransactionメソッドまでが1つの更新処理となり、undo/redoした場合はこの処理単位で行われます。 abortTransactionメソッドがトランザクションを取消す処理です。トランザクションを取消した場合、プロジェクトはトランザクション開始前の状態に戻ります。 例外処理で必ずabortTransactionメソッドを呼ぶようにしましょう。

モデルの編集

モデルエディタ

モデルの編集はモデルエディタ(ModelEditor)を使用して行います。 モデルとプレゼンテーションが1:nで対応するモデルは各種モデルエディタから作成できます。

モデルエディタの取得

下記以外に、プレゼンテーションの作成と同時に時に一緒に作成されるモデルがあります。これについては図・プレゼンテーションの編集をご覧ください。

モデルエディタの種類 作成可能要素
BasicModelEditor クラス、成果物、関連、関連クラス、属性、コンポーネント、制限、コピー、依存、導出、汎化、インタフェース、モデル、ノード、操作、パッケージ、パラメタ、ポート、限定子、実現、洗練、要求、満足、サブシステム、タグ付き値、テンプレートバインディング、テンプレートパラメタ、テストケース、トレース、使用依存、検証
UseCaseModelEditor アクター、ユースケース、拡張点、拡張、包含
CompositeStructureModelEditor コネクタ、実現、使用
ERModelEditor ERモデル、ERエンティティ、ドメイン、属性、データ型、インデックス、依存型リレーションシップ、多対多型リレーションシップ、非依存型リレーションシップ、サプタイプ

パッケージにクラスを作成する

タグ付き値を作成する

モデルを削除する

クラスに定義を設定する

モデルにステレオタイプを追加する

図・プレゼンテーションの編集

ダイアグラムエディタ

図およびプレゼンテーションの作成や削除はダイアグラムエディタ(DiagramEditor)を使用して行います。

DiagramEditor は基本的に事前に図を設定することが必要です。
図を作成すると DiagramEditor にその図が自動的に設定されますが、既存の図を編集する場合は DiagramEditor#setDiagram(IDiagram diagram) を用いて図を設定します。

ダイアグラムエディタの取得

ダイアグラムエディタの種類 編集可能図
ClassDiagramEditor クラス図
UseCaseDiagramEditor ユースケース図
StateMachineDiagramEditor ステートマシン図
ActivityDiagramEditor アクティビティ図、フローチャート
SequenceDiagramEditor シーケンス図
CompositeStructureDiagramEditor 合成構造図
RequirementDiagramEditor 要求図
ERDiagramEditor ER図
MindmapEditor マインドマップ

クラス図を作成する

クラスプレゼンテーションを作成する

アクティビティ図のアクションを作成する

アクティビティ図のアクション等、モデルとプレゼンテーションの対応が1:1となる場合、プレゼンテーションを作成するとモデルも一緒に作成されます。

プレゼンテーションを削除する

プレゼンテーション情報を変更する

プレゼンテーション情報(背景色等)の変更はPresentationPropertyConstantsPresentationPropertyUtilを使用します。
モデルとプレゼンテーションの対応関係については対応プレゼンテーション一覧をご覧ください。

プレゼンテーション群の操作

プレゼンテーションの背景色を変更する

プレゼンテーションの位置を変更する