[emacs] Drawing uml under emacs org-mode using plantUML [emacs] Drawing uml under emacs org-mode using plantUML - 类图

此处, 类之间的关系以及所使用的符号如下:

对于上述的关系表示非常困惑, 不急, 慢慢看来, ;)

1. Association ¹² 有两个类, A 和 B, 如果A够根据将消息发送给B, 或是B的实例能够影响A, 那么就称两者之间的关系为Association, 并且在一般情况下两者是相互的. 如下所示:

   class class1 as "A"
   class class2 as "B"
   class1 --> class2
   

   

   class B {...}
   class A {
     B* itsB;
   }
   

2. extension³, 也被称为继承关系, 或is-a关系.

   class food {
   };
   class apple : public food{
   };
   

   上面的关系就可以理解为, apple是food

   class class1 as "food"
   class class2 as "apple"
   
   class2 --|> class1
   

   

3. composition and aggregation. 对于这两者的理解wikpedia中有一段很好的描述 ⁴:

   一个大学里面有很多的学院, 每个学院又有很多的教授. 当这个大学倒闭关门的时候, 原来存在的学院也就随着大学的关门而不存在了, 但是这些教授却依然活着. 因此, 学校是由学院组成的, 即compostition, 学院是教授的集合地, aggregation

   class Professor;
   
   class Department
   {
    private:
    // Aggregation
    Professor* members[5];
   };
   
   class University
   {
    private:
    std::vector<Department> faculty;
    create_dept() {
   
      // Composition
      faculty.push_back(Department());
      faculty.push_back(Department());
    }
   };
   

   class class1 as "University"
   class class2 as "Department"
   class class3 as "Professor"
   
   class3 -right--o class2
   class2 -right--* class1
   

   

在关系的后面加个":", 而后添加相应的label, 在连接符两边用""可以添加对应类的label, 如

Class01 "1" *-- "many" Class02 : contains
Class03 o-- Class04 : agregation

在类名后面添加":", 如:

Object <|-- ArrayList

Object : equals(0
ArrayList : Object[] elementData
ArrayList : size()

另一种方法为:

class Dummy {
  String data
  void methods()
}

在类中添加不同的方法的时候, 往往需要给出相应的方法的属性, 如private, protected, public等:

对图中的类进行注释, 采用"..", 定型(即, 给类一个特定的分类), 采用""和" ".

在注释中还可以使用html标签对注释的内容的格式进行美化.

• <b> 加粗
• <u> 加下划线
• <i> 斜体
• <s>, <del>, <strike> 删除线
• <font color="#AAAAAA"> or <font color="colorname"> 字体颜色
• <color:#AAAAAA> or <color:colorName> 字体颜色
• <size: nn> 字体大小
• <img src="file"> or <img:file> 添加图片

note top of Object
  In java, every <u>class</u>
  <b>extends</b>
  <i>this</i> one
end note

note as N1
  This <size:10>note</size> is <u>also</u>
  <b><color:royalBlue>on several</color></b>
  <s>words</s> lines
end note

抽象类使用"abstract"或"abstract class"关键字, 接口用"interface"关键字, 枚举用"enum"关键字

abstract class AbstractList
abstract AbstractConllection
interface List
interface Collection

List <|-- AbstractList
Collection <|-- AbstractConllection

Collection <|- List
AbstractConllection <|- AbstractList
AbstractList <|- ArrayList

ArrayList : Object[] elementData
ArrayList : size()

enum TimeUnit
TimeUnit : DAYS
TimeUnit : HOURS
TimeUnit : MINUTES 

可以使用 "hide/show" 命令实现对方法以及属性的隐藏, 常用的命令如下:

• hide empty members
• hide empty fields or hide empty attributes
• hide fields or hide attributes
• hide methods
• hide members
• hide circle 隐藏类名前面圆形的字符
• hide stereotype 通过""和" "增加的标识
• hide class
• hide interface
• hide enum
• hide foo1 隐藏所有foo1标识的类
• hide classname

class Dummy1 {
  +myMethods()
}

class Dummy2 {
  +hiddenMethod()
}

class Dummy3 <<tag>> {
  string name
}

hide members
hide <<tag>> circle
show Dummy1 method
show <<tag>> members

包的定义可以使用关键词"package"

package "Classic Collections" #DDDDDD {
  Object <|-- ArrayList
}

package net.sourceforge.plantuml #Snow {
  Object <|-- Demo1
  Demo1 *- Demo2
}

包之间的关系也可以通过类似的方式给出:

package foo1.foo2 {
}

package foo1.foo2.foo3 {
  class Object
}

foo1.foo2 +-- foo1.foo2.foo3

引用当前默认命名空间中的类时, 只要在类名前增加一个"."即可.

class BaseClass

namespace net.dummy #DDDDDD {
  .BaseClass <|-- Person
  Meeting o-- Person

  .BaseClass <|- Meeting
}

namespace net.foo {
  net.dummy.Person <|- Person
  .BaseClass <|-- Person

  net.dummy.Meeting o-- Person
}

BaseClass <|-- net.unused.Person

  <- or -left-> 向左
  -> or -right-> 向右
  <-- or -up-> 向上
  --> or -down-> 向下

foo1 -left-> dummyLeft
foo1 -right-> dummyRight
foo1 -up-> dummyUp
foo1 -down-> dummyDown

foo2 -> right
left <- foo2
up <-- foo2
foo2 --> down

使用"title"关键词

title Simple
Object <|- ArrayList