シーケンス図

シーケンス図は、オブジェクトが時間経過に伴ってどのようにやり取りするかを視覚化します。特定のタスクやシナリオを達成するために参加者間で交換されるメッセージの順序を示します。

基本概念

参加者

参加者は、インタラクションに関与するオブジェクトやアクターを表します。各参加者には、時間を表す下向きに延びる垂直の破線である ライフライン があります。

メッセージ

メッセージは参加者間のやり取りで、ライフライン間の水平な矢印として表示されます。時間は上から下に流れます。

アクティベーションボックス

アクティベーションボックス(実行仕様とも呼ばれます)は、参加者がアクティブに処理していることを示す、ライフライン上の細い矩形です。

参加者の作成

参加者ツールの使用

UMLシーケンス図 ページで、P を押すか、ツールバーの UML メニューから 参加者 を選び、キャンバスをクリックして参加者を配置します。新しい参加者は既存のものと一列に並びます。参加者を選択した状態で Return を押すと名前を変更できます。

参加者の種類

参加者はさまざまな種類のエンティティを表せます:

  • 参加者 - 汎用のオブジェクトまたはシステムの一部(矩形)
  • アクター - ユーザーまたは外部システム(棒人間)
  • バウンダリ - UIまたはシステムの境界
  • コントロール - プロセスまたはコントローラのロジック
  • エンティティ - データまたはドメインオブジェクト
  • データベース - データストア

インスペクタの 配置 タブ → UML セクションで ロールタイプ を設定します。

メッセージの作成

メッセージツールの使用

M を押してメッセージツールを有効にし、次のようにします:

  1. ソース参加者のライフラインをクリック
  2. ターゲット参加者のライフラインまでドラッグ
  3. 離してメッセージを作成

メッセージの種類

種類矢印スタイル説明
同期実線、塗りつぶし矢印送信者が応答を待つ
非同期実線、開いた矢印送信者が待たずに続行する
リターン破線、開いた矢印同期呼び出しへの応答
生成破線、ボックスへの開いた矢印新しい参加者を作成する
破棄Xで終わる線参加者を終了する
自己呼び出し同じライフラインに戻ってくる矢印参加者が自分自身を呼び出す

選択したメッセージの メッセージの種類 は、インスペクタの UML セクションで設定します。

メッセージのラベル

メッセージを選択し、インスペクタの UML セクションで ラベル を編集します。一般的な形式:

  • methodName() - シンプルなメソッド呼び出し
  • methodName(param1, param2) - パラメータ付き呼び出し
  • result := methodName() - 戻り値の代入付き呼び出し
  • [condition] methodName() - 条件付きメッセージ(ガード)

アクティベーションボックス

アクティベーションボックスは、参加者が実行中または応答を待っている期間を示します。

アクティベーションボックスの追加

  1. ツールバーの UML メニューから アクティベーション を選ぶ
  2. 参加者のライフライン上で、アクティブな期間に沿ってドラッグする
  3. アクティベーションボックスがそのライフライン上に配置される

ネストされたアクティベーション

参加者が自分自身を呼び出す場合(再帰呼び出し)や、複数のネストされた呼び出しを処理する場合、アクティベーションボックスを重ねて表示できます。

フラグメント

フラグメントはメッセージをグループ化して、条件付きロジック、ループ、その他の制御フローを示します。

フラグメントの種類

種類キーワード目的
代替altif-else分岐
オプションoptオプションの実行(elseなしのif)
ループloop繰り返し実行
ブレークbreak囲んでいるループからの脱出
並列par並行実行
クリティカルcriticalアトミック/クリティカルセクション
否定neg無効なインタラクション
アサーションassert必須のインタラクション
無視ignore無視してよいメッセージ
考慮consider考慮すべきメッセージ
参照ref別のインタラクションへの参照

フラグメントの作成

  1. ツールバーの UML メニューから フラグメント を選ぶ
  2. グループ化したい参加者とメッセージの上に矩形をドラッグする
  3. フラグメントを選択し、インスペクタの UML セクションで フラグメントの種類 を設定する
  4. 必要に応じて ガード条件 を入力する

フラグメントのガード

ガードは角括弧で表される条件です:

  • [x > 0] - 数値条件
  • [user.isAdmin] - プロパティチェック
  • [else] - altフラグメントのデフォルト/else分岐

要素の並べ替え

参加者の移動

参加者を水平にドラッグして順序を変更します。接続されたメッセージも追従します。

メッセージの移動

メッセージを選択し、Cmd+↑ または Cmd+↓ を押して、シーケンス内での順序を前後に動かします。

ベストプラクティス

  1. メインフローから始める - まず正常系をモデル化し、その後に代替パスを追加する
  2. 読みやすさを保つ - ダイアグラムごとに5〜7参加者に制限する
  3. 意味のある名前を使う - メッセージには実際のメソッド名や説明をラベル付けする
  4. リターンメッセージを表示する - 特に戻り値が重要な同期呼び出しでは
  5. フラグメントは控えめに使う - ネストが多すぎると読みやすさが下がる
  6. メモを追加する - 複雑なロジックの説明には付箋を使う

例:ユーザーログインフロー

典型的なログインシーケンスには、次が含まれます:

  1. ユーザーが認証情報を入力する
  2. クライアントがサーバーにログインリクエストを送信する
  3. サーバーがデータベースで検証する
  4. データベースがユーザーレコードを返す
  5. サーバーがセッションを作成する
  6. サーバーがクライアントに成功・失敗を返す
  7. クライアントがUIを更新する

このフローは、同期呼び出し、リターンメッセージ、そして成功・失敗パスに使われうるaltフラグメントを示しています。