UML

UML＝Unified Modeling Language
統一モデリング言語。さまざまな種類があったオブジェクト指向分析・設計を行う上での図表記述方式を統一したもの。 各種の図表の書き方が定められている。

• 上流工程から下流工程まで一貫した表現が可能
• 開発手法を選ばない
• 必要に応じて適切な図を使用する。
• 国際的な標準

要求図

ユースケース図

システムを使う人とシステムに分け、どのような機能が必要かをまとめる。

構造図

クラス図

クラスの属性や操作、関連、継承を図式化する。

振る舞い図

シーケンス図

オブジェクト間のメッセージのやりとりを時系列に沿って図式化する。

ステートマシン図

オブジェクトの「状態」の移り変わりを図式化する。状態遷移図。

アクティビティ図

処理や手順の流れを図式化する。

実装図

コンポーネント図

ソフトウェアコンポーネントの実装時の構造を図式化する。

配置図

ハードウェア、ソフトウェア、ネットワークなど実装時の配置を図式化する。

テキストで特定書式を書くことでUML図を書くことができるツール。

インストール

Graphviz

まず、PlantUMLが利用する描画ライブラリであるGraphvizをインストールする。

コマンドプロンプトから以下を入力しインストールする。

winget install graphviz

Asciidoctor editor

次にPlantUMLをインストールする。Eclipseの場合、「Asciidoctor editor」プラグインを入れる。

1. プロジェクト内にUML用のフォルダを作成（exampleを右クリックし、[新規]-[フォルダー]で「uml」と入力）
2. umlフォルダを右クリックし、[新規]-[ファイル]から sample.pu でファイルを作成
3. sample.puをダブルクリックで開くと「マーケットプレースで利用可能なエディター」という画面が出る
4. 「このファイルタイプのIDE拡張を表示してインストールする」を選択した状態でＯＫボタンを押す、[Eclipseマーケットプレイス]で「Asciidoctor editor」が表示されるので「インストール」を押してインストールを行う。

Asciidoctor editorの設定

Eclipseの[ウィンドウ]-[設定]で[Asciidoctor editor]の一番上「Default preview layout」を「水平方向（Horizontal）」にしておく。

使用方法

Eclipseの場合、[ファイル]-[新規]-[ファイル]から拡張子.pu でファイルを作成。右クリックし[次で開く]-[PlantUML Editor（Asciidoctor）]で開く

@startuml から @enduml の間に書いていく。詳細な記述方法は PlantUML のサイトで。

外部から見たシステムの機能を表す図。要求・分析モデリングなどの上流工程で使用する。
システムを表す四角形を書き、そのシステムを表すユーザを表すアクター（人の形）を周りに書く。
システム内に楕円でユーザの利用内容（ユースケース）を書き、アクターからこれに線を伸ばす（関連）。

ユースケースはユーザから見た「システムができること」を書く。処理の仕組みには立ち入らない。

PlantUMLでの記述

@startuml
left to right direction
actor 管理者
rectangle 販売管理{
	管理者 -- (商品の一覧)
	管理者 -- (商品の追加)
	管理者 -- (商品の変更)
	管理者 -- (商品の削除)
}
@enduml

アクターが２種類の場合

@startuml
left to right direction
actor 在庫管理者
actor 売上管理者
rectangle 販売管理{
	在庫管理者 -- (商品の一覧)
	在庫管理者 -- (商品の追加)
	在庫管理者 -- (商品の変更)
	在庫管理者 -- (商品の削除)
	(商品の一覧) -- 売上管理者
	(売上の一覧) -- 売上管理者 
}
@enduml

ユースケースごとに詳細を書いた文書「ユースケース記述」を作成する。
「ユースケース記述」は本来UMLで定義されるものではないため、書くことが厳密には決まっていないが、そのユースケースはどういうことをユーザが行うかをイメージできるように書く（ユーザ向けのマニュアルのようなイメージ）。

※練習用テキストファイル

※注１：シナリオには具体的に書くこと

良い例

• いちご横の削除リンクをクリック

悪い例

• 削除リンクをクリック・・どこの削除リンクをクリックするかが書かれていない
• 削除リンクをクリック（例：いちご）・・シナリオが１つの例なので例として挙げない
• いちごを削除したいときにはいちご横のリンクをクリック・・「○○したいときは」など条件など書かない、１つの例を書く。
• いちごが存在しなかったらエラーと表示する・・・「○○しなかったら」など条件など書かない。１つの例を書く。

※注２：事前条件、事後条件はテストを意識する

システム完成後のテストはユースケース記述を元に行います。事前条件はテストをはじめようとするときに何を準備していないといけないか、事後条件はテストを終えたときに何が達成していないといけないかを定義します。

クラスの構造、関連を表す。分析・設計工程で使用する。

@startuml
left to right direction
package model {
	class 商品{
		-商品ID
		-商品名
		-単価
	}
	class 書籍{
		-著者
		-出版社
	}
	class 売上{
		-個数
		-日付
		+金額():金額
	}
	class 商品DB {
		+全検索():商品リスト
		+検索(商品ID):商品
		+追加(商品)
		+変更(商品)
		+削除(商品ID)
	}
	class 売上DB {
		+全検索():売上リスト
		+検索(商品ID):売上リスト
	}
}
package control{
	class 販売管理{
		+商品一覧()
		+追加(商品)
		+削除確認(商品ID)
		+削除(商品)
		+編集(商品ID)
		+変更(商品)
		+商品別売上(商品ID)
	}
}
販売管理 --> 商品DB
販売管理 --> 売上DB

売上->商品
商品DB o-- 商品
売上DB o-- 売上

商品 <|-- 書籍
@enduml

クラス

長方形でクラスを表し、内部を線で区切り、クラス名、属性、操作を書く。
操作には()を付ける。
属性と操作にはpublicの場合 + を、privateの場合- を付ける。

@startuml
class 売上{
	-個数
	-日付
	+金額()
}

@enduml

操作の括弧内には引数を書く。また、後に : を付け戻り値が何かを指定する（詳細時には戻り値の型を示す）

@startuml
class 商品DB {
	+全検索() : 商品リスト
	+検索(商品ID) : 商品
	+追加(商品)
	+変更(商品)
	+削除(商品ID)
}
@enduml

詳細設計時には名前は実際にプログラムで使う名前になる。また、属性の後に : を付け型を指定する

@startuml
class Shouhin{
	-sid :int
	-sname :String
	-tanka :int
}

@enduml

関連

各クラスに関連があれば実線を引いて表す。線上に関連名を書く。矢印によってどのクラスがどのクラスを参照しているかを示す。

売上 -> 商品

Javaでの実装例としては、インスタンスをフィールドに持つことなどである。

// Javaでの実装例
class Uriage{
	private int kosu;
	private LocalDate hi;
	
	private Shouhin shouhin;	//	インスタンスを持つ

集約

関連の一種で全体と部分の関係。◇と実線で示す。実装では配列やリストで表されることが多い。◆はより強い集約関係を表す「コンポジション」。全体が消えたときにそこに含まれる部分も消える関係。

PlantUML

集約： o--

コンポジション： *--

@startuml
left to right direction
class 商品{
	-商品ID
	-商品名
	-単価
}
class 商品DB {
	+全検索():商品リスト
	+検索(商品ID):商品
	+追加(商品)
	+変更(商品)
	+削除(商品ID)
}

商品DB o--  商品
@enduml

実線の端には数字で多重度を書くことができる。多重度に範囲がある場合には 最小値..最大値 のように書く。不特定多数の場合 * を書く。

商品管理 "1" o-- "0..*" 商品

汎化

汎化（継承）は△と実線で表す。
実現（インタフェースの実装）は△と破線で表す。

PlantUML

汎化： <|--

実現： <|..



@startuml
class 商品{
	-商品ID
	-商品名
	-単価
}
class 書籍{
	-著者
	-出版社
}
class 期間限定商品{
	-開始日
	-終了日
}
商品 <|--書籍
商品 <|--期間限定商品
@enduml


依存

それ以外の関係は破線で表す。これは「依存」と呼ばれ、何らかの形で別のクラスに依存していることを示す。依存とはクラスに変化があれば、別のクラスに変化が及ぶこと。実装例では他のクラスを引数や戻り値、ローカル変数等で使用することなどが含まれる。



@startuml
class 商品別売上{
	+表示()
}
class 売上管理{
	+売上検索(商品ID):売上リスト
}
商品別売上 ..> 売上管理
@enduml


パッケージ


パッケージを表す場合、package 名前 { } で囲む。



@startuml
package モデル{
	class 商品{
		- 商品ID
		- 商品名
		- 単価
	}
	class 売上{
		- 個数
		- 日付
	}
}

売上 -> 商品
@enduml

オブジェクト間のメッセージのやりとりを時系列に沿って図式化する。分析・設計工程で使用する。

オブジェクト：四角で囲み、下に破線で生存線を書く。ここにユーザなどのアクターを書くこともできる。

メッセージ：オブジェクト間でやりとりされるメッセージ。具体的にはメソッドの呼び出しやオブジェクトの生成、アクターの操作を表す。生存線を矢印の線で結ぶ。呼ばれる方に矢印を書き、どのようなメッセージかを必ず書く。また、メッセージからの戻り値がある場合は破線で返す。

@startuml
title 商品一覧
autonumber "#."

actor ユーザ

ユーザ -> 商品一覧:アクセス
商品一覧 -> 商品管理:一覧表示()
商品管理 -> 商品DB:全検索()
商品DB -> 商品:生成
商品DB --> 商品管理:商品リスト
商品管理 --> 商品一覧:表示
商品一覧 --> ユーザ:表示
@enduml

詳細設計レベルではプログラミングを前提としたオブジェクトに変化する。

@startuml
title 商品一覧 /slist GET
autonumber "#."

actor ユーザ

ユーザ -> "/slist":GET /slist
"/slist"-> HanbaiController: slist()
HanbaiController -> ShouhinRepository:findAll()
ShouhinRepository -> Shouhin:生成
ShouhinRepository --> HanbaiController:List
HanbaiController -> Model:list
HanbaiController -> "/slist":slist.html
"/slist" --> ユーザ:表示
@enduml

繰り返し・条件分岐

説明の表示

グループ化：繰り返し(loop)や条件分岐（alt/else、opt）がある場合、四角で囲んで何によるグループ化かを書く。

条件分岐（alt/else）の例

@startuml
title 削除確認画面(分析レベル)
actor ユーザ
ユーザ -> 商品一覧:削除クリック
商品一覧 -> 削除画面:遷移
削除画面 -> 商品DB:検索(sid)
商品DB -> 商品:生成
商品DB --> 削除画面:商品
alt 商品が存在
	削除画面 --> ユーザ:確認表示
else
	削除画面 --> ユーザ:エラー表示
end
@enduml

※繰り返しのとき

loop
	// 繰り返しのときの処理
end

アイコン・並び順の変更

各オブジェクトのアイコンを変更することが出来る

アイコンを指定した並び順で左から表示される

@startuml
title 商品一覧
autonumber "#."

actor ユーザ
boundary 商品一覧
control 商品管理
database 商品DB
entity 商品

ユーザ -> 商品一覧:アクセス
商品一覧 -> 商品管理:一覧表示()
商品管理 -> 商品DB:全検索()
商品DB -> 商品:生成
商品DB --> 商品管理:商品リスト
商品管理 --> 商品一覧:表示
商品一覧 --> ユーザ:表示
@enduml

オブジェクトの「状態」の移り変わりを図式化する。状態遷移図。分析・設計工程で使用する。

• 開始状態：オブジェクト生成時を表し、黒丸で書く。
• 終了状態：オブジェクト消滅時を表し、黒丸を円で囲んで書く。
• 遷移：矢印で表す。

@startuml
title 画面遷移図

[*]->商品一覧
商品一覧-->追加処理 :追加ボタン
商品一覧-->削除確認 :削除リンク
商品一覧-->変更確認 :変更リンク
削除確認-->削除処理 :削除ボタン
変更確認-->変更処理 :変更ボタン
商品一覧-->商品別売上 :売上リンク
@enduml

詳細レベル

@startuml
title ページ遷移図

state insert
state "del/{sid}" as delget
state "edit/{sid}" as editget
state "suriage/{sid}" as suriage

slist : 商品一覧
insert:POST 追加処理
delget:GET 削除確認
del:POST 削除処理
editget:GET 変更入力
edit:POST 変更処理
suriage:GET 商品別売上

[*]->slist
slist-->insert: 追加ボタン
slist-->delget: 削除リンク
delget-->del: POST\n削除ボタン
slist-->editget: 変更リンク
editget-->edit: POST\n変更ボタン
slist-->suriage: 売上リンク
@enduml

※改行するには\nを書く

処理や手順の流れを図式化する。主に上流工程で要求・分析工程で業務の処理手順などを表す。下流工程ではプログラムの手順などを表す。

• 開始状態：処理の開始を表し、黒丸で書く。
• 終了状態：処理の終了を表し、黒丸を円で囲んで書く。
• 遷移：矢印で表す。
• 処理の分岐、合流：◇で表す

@startuml
start
:変更リンククリック<
:変更画面表示;
:商品名、単価入力<
:変更ボタン押下<
if(入力チェック)then(エラー無し)
	:商品リストにリダイレクト;
else(エラー有り)
	:エラー画面表示;
endif
stop
@enduml

ソフトウェアコンポーネントの実装時の構造を図式化する。実装工程で使用する。コンポーネントの依存関係を表す。

@startuml
rectangle model{
	[ShouhinDAO]..>[Shouhin]
	[UriageDAO]..>[Uriage]
}
@enduml

ハードウェア、ソフトウェア、ネットワークなど実装時の配置を図式化する。実装工程で使用する。

@startuml
rectangle クライアント{
	[Webブラウザ] as browser
}
rectangle Webサーバ{
	[Tomcat]
	[サーブレット] as servlet
	[JSP]
}
rectangle データベース{
	[MySQL]
}

browser <-> http:use
http <-> Tomcat
Tomcat -> servlet
servlet --> JSP
servlet <-> MySQL
JSP -> Tomcat
@enduml

コメント（注釈）を表す。

@startuml
title 追加確認画面 /insert GET
actor ユーザ
ユーザ -> "/slist":追加フォーム入力
note right:	商品名、単価
ユーザ -> "/slist":追加ボタンクリック
"/slist" -> InsertServlet:POSTリクエスト
InsertServlet -> Shouhin:生成
note left:	商品IDは0
InsertServlet -> ShouhinDAO:insert(shouhin)
InsertServlet -> "/slist" : リダイレクト
"/slist" --> ユーザ:表示
@enduml

@startuml
[*]->商品一覧
商品一覧-->追加確認 :追加ボタン
追加確認-->追加 :追加ボタン
note bottom of 追加 :リダイレクトで\n商品一覧へ
@enduml

PlantUML 共通記法

基本設定

# フォント指定
skinparam DefaultFontName メイリオ

title タイトル
caption キャプション

# 拡大率
scale 1.5

位置

@startuml
クラス1 -> クラス2
クラス2 -up-> クラス3
クラス2 -down-> クラス4
クラス2 -right-> クラス5
クラス4 -left-> クラス6
@enduml

色

red,blue,greenなどHTML/CSSでの色の名前が使用可能

@startuml
クラス1 -> クラス2
クラス2 -[#blue]> クラス3
クラス3 -[#ff00ff]-> クラス2
@enduml

コメント

シングルクォーテーション以降はコメント

@startuml
' シーケンス図

クラス1 -> クラス2
@enduml

ER図

ER図はUMLの一部ではないが、PlantUMLで記述できる。
基本的にクラス図と同じだが class を entityに変え、以下の端子を使用する。

0か1	|o--
1のみ	||--
0以上	}o--
1以上	}|--

また、主キーは -- の上に書く。

@startuml
entity 商品{
	商品ID
	---
	商品名
	単価
	カテゴリID
}
entity 売上{
	売上ID
	---
	商品ID
	個数
	日付
}
entity カテゴリ{
	カテゴリID
	--
	カテゴリ名
}
商品 ||--o{ 売上
商品 }o-||カテゴリ
@enduml