はじめに

本書ではastah* APIについて説明します。 astah* APIを利用することでastah*をより有効に活用することができます。

最終更新日
2024年10月30日
対象製品
astah* professional 10.0
astah* UML 10.0

astah* APIとは

astah* APIは、astah*のモデルデータを活用するためのJavaインタフェース群です。
本APIは、プラグインの作成や、スクリプトエディタでも利用可能です。

astah* APIでサポートしている機能  
  • モデル、プレゼンテーションの参照、作成、編集

使用許諾事項

  • astah* APIの.jar形式ファイルであるastah-api.jarの再配布を禁止します。
  • その他のastah* API使用上の許諾事項は「astah*使用許諾契約書」に準じます。

利用要件

astah* APIを利用したアプリケーションを利用するには、下記の要件を満たすことが必要です。

パス 必須
astah*API astah-api.jar コンパイル、実行
astah*の本体 astah-pro.jar
または astah-uml.jar		 実行
同梱ライブラリ インストールフォルダ/lib配下
インストールフォルダ/lib/rlm配下		 -
実行（フローティングライセンス利用時必須）

注意事項

  • astah* APIは複数スレッドからの同時アクセスに対応しておりません。複数スレッドから利用する場合は、アプリケーション側で排他制御をしてください。
  • astah* APIのクラス構造は、UMLメタモデルの一部を省略した簡素化した構造になっています。
  • 実行時にファイルサイズが大きなastah*プロジェクトファイルを扱う場合は、Java VMのメモリ管理オプション設定が必要です。
    VMの起動オプションとしての初期ヒープサイズ16Mバイト、最大ヒープサイズ256Mバイトを指定する例：-Xms16m -Xmx256m

API利用のヒント

astah* APIはスクリプトエディタを用いると気軽に試すことができます。
スクリプトエディタはastah* APIを使用してモデルにアクセス可能となるスクリプトエディタを表示するプラグインです（astah* professional、UML 7.2以降をご利用の場合、製品に同梱されています）。
スクリプト言語で astah*にアクセスでき、プロジェクトを開いた状態で操作ができるため、APIの挙動を簡単に確認することができます。

モデルとプレゼンテーション

astah*のプロジェクト内には、モデルと、図要素を描画するための情報を持つプレゼンテーションを保持しています。
例えば、クラス図のあるクラスの属性を参照、編集するならモデルへの操作ですし、クラス図の図要素であるクラスの色を参照、編集するならプレゼンテーションへの操作となります。
モデルとプレゼンテーションの対応は必ずしも1:1ではありません。共通のモデルを持つプレゼンテーションもあれば、モデルを持たないプレゼンテーションもあります。
詳しくは、対応モデル/プレゼンテーション一覧、ならびに、Javadocをご覧ください。

モデルとプレゼンテーションの関係