Pendahuluan

Diagram kelas PlantUML menggambarkan struktur statis sistem: kelas, atribut, operasi, dan hubungannya. Anda menulis spesifikasi teks dan merendernya menjadi diagram, sehingga sumbernya mudah diedit dan dikelola dalam kontrol versi.
1. Diagram minimal
Diagram kelas dimulai dengan@startuml dan diakhiri dengan@enduml:

@startuml
class User
class Order
User --> Order : places
@enduml
PlantUML dapat menyimpulkan kelas dari deklarasi hubungan, tetapi mendeklarasikannya secara eksplisit membuat diagram yang lebih besar lebih mudah dipindai dan dipelihara.
2. Kelas, atribut, dan metode
Masukkan atribut dan operasi di dalam kurung kurawal. Titik dua memisahkan nama anggota dari tipenya; tanda kurung menandai sebuah operasi.

@startuml
class User {
-id: int
-email: String
+login(password: String): boolean
+logout(): void
}
@enduml
Penanda visibilitas adalah:
-
+publik -
-pribadi -
#terlindungi -
~paket-swasta
Anda juga dapat menulis tipe sebelum nama anggota—misalnya, +String email atau +void logout(). PlantUML mendukung baik notasi anggota yang mirip kode yang sudah dikenal maupun penanda visibilitas ini.
Anggota statis dan abstrak
Gunakan {static} atau {classifier} untuk anggota statis dan {abstract} untuk anggota abstrak:

@startuml
abstract class PaymentMethod {
{abstract} +authorize(amount: Decimal): boolean
{static} +supportedCurrencies: String[]
}
class CardPayment {
+authorize(amount: Decimal): boolean
}
PaymentMethod <|-- CardPayment
@enduml
Sebuah kelas abstrak juga dapat dideklarasikan dengan kelas abstrak.
3. Relasi
Bentuk panah menyampaikan jenis relasi. Arah garis dipilih berdasarkan urutan nama; gunakan label untuk memperjelas maknanya.
| Relasi | Notasi PlantUML | Makna umum |
|---|---|---|
| Pewarisan / generalisasi | `Parent < | — Child` |
| Realisasi antarmuka | `Interface < | .. Class` |
| Komposisi | Keseluruhan *-- Bagian |
Masa hidup bagian dimiliki oleh keseluruhan |
| Agregasi | Keseluruhan o-- Bagian |
Keseluruhan mengelompokkan atau merujuk pada bagian yang dapat eksis secara mandiri |
| Alokasi berarah | A --> B |
A memiliki relasi yang dapat dilalui ke B |
| Ketergantungan | A ..> B |
A menggunakan atau bergantung pada B |
Ini adalah notasi relasi standar PlantUML.

@startuml
interface Repository
class SqlRepository
class OrderService
class Order
class OrderLine
Repository <|.. SqlRepository
OrderService ..> Repository : uses
Order *-- "1..*" OrderLine : contains
@enduml
Pilih dengan hati-hati: Komposisi dan agregasi mengekspresikan semantik siklus hidup yang berbeda. Gunakan komposisi hanya ketika bagian secara bermakna dimiliki oleh keseluruhan; gunakan asosiasi biasa ketika tidak ada interpretasi kepemilikan yang sesuai.
4. Multiplisitas, nama peran, dan label
Multiplisitas menentukan berapa banyak objek yang dapat berpartisipasi di setiap ujung asosiasi. Bentuk umum meliputi "1", "0..1", "*", dan "1..*".

@startuml
class Customer
class Order
Customer "1" --> "0..*" Order : places
@enduml
Di sini, setiap Pesanan terkait dengan satu Pelanggan, sedangkan seorang Pelanggan dapat menempatkan nol atau lebih pesanan. Baca multiplisitas dari ujung yang berlawanan: angka di dekat “Pesanan menjelaskan berapa banyak pesanan yang dapat dikaitkan dengan seorang pelanggan.
Untuk presisi ekstra, tambahkan nama peran atau batasan:

@startuml
class Tim
class Pemain
Tim "1" o-- "0..*" Pemain : anggota
catatan pada tautan
Seorang pemain dapat berpindah antar tim.
end note
@enduml
5. Antarmuka, enumerasi, stereotip, dan paket
PlantUML mendukung deklarasi seperti antarmuka, enumerasi, kelas abstrak, dan stereotip yang ditulis di antara << dan >>.

@startuml
paket "Pemesanan" {
antarmuka GerbangPembayaran {
+charge(amount: Decimal): HasilPembayaran
}
enumerasi StatusPesanan {
BARU
DIBAYAR
DIBATALKAN
}
kelas Pesanan <<Entitas>> {
+id: UUID
+status: StatusPesanan
}
kelas LayananCheckout <<Layanan>> {
+checkout(order: Pesanan): HasilPembayaran
}
LayananCheckout ..> GerbangPembayaran : memanggil
Pesanan --> StatusPesanan
}
@enduml
Package mengelompokkan tipe terkait secara visual. Gunakan stereotipe seperti “<<Entity>> atau “<<Service>> ketika mereka menambahkan konteks yang berguna; hindari menambahkan label yang hanya mengulang apa yang sudah dikatakan oleh nama kelas.
6. Catatan, alias, dan tata letak
Catatan dapat menjelaskan keputusan desain atau memperjelas batasan tanpa membebani nama kelas. Alias membantu ketika nama yang ditampilkan mengandung spasi atau tanda baca.

@startuml
class "External Payment API" as PaymentApi
class CheckoutService
CheckoutService ..> PaymentApi : submits payment
note right of CheckoutService
Retries transient failures.
Does not retry declined payments.
end note
left to right direction
@enduml
arah dari kiri ke kanan mengubah arah tata letak secara keseluruhan; defaultnya adalah dari atas ke bawah. Anda juga dapat menggunakan arah hubungan seperti “-left-> atau “-up-|> untuk memandu penempatan lokal.
7. Contoh yang lebih lengkap
Contoh ini menggabungkan visibilitas, tipe, metode, enum, multiplisitas, komposisi, dan ketergantungan:

@startuml
left to right direction
package "Sales" {
class Customer {
-id: UUID
+name: String
+placeOrder(): Order
}
class Order {
-id: UUID
-status: OrderStatus
+addLine(product: Product, quantity: int): void
+total(): Decimal
}
class OrderLine {
-quantity: int
+lineTotal(): Decimal
}
class Product {
+sku: String
+price: Decimal
}
enum OrderStatus {
NEW
PAID
CANCELLED
}
interface PaymentGateway {
+charge(amount: Decimal): PaymentResult
}
class CheckoutService {
+checkout(order: Order): PaymentResult
}
Customer "1" --> "0..*" Order : places
Order *-- "1..*" OrderLine : contains
OrderLine "*" --> "1" Product : refers to
Order --> OrderStatus
CheckoutService ..> PaymentGateway : uses
}
@enduml
8. Alat: Visual Paradigm VPasCode
VPasCode adalah editor teks-ke-diagram berbasis browser dari Visual Paradigm. Editor ini mendukung diagram kelas PlantUML dan menyediakan editor kode dengan pratinjau langsung, sehingga Anda dapat menulis atau menempelkan kode PlantUML dan memeriksa hasil rendernya saat bekerja.

Alur kerja tipikal:
-
Buka VPasCode dan pilih editor PlantUML atau contoh PlantUML.
-
Ganti teks awal dengan diagram Anda, termasuk
@startumldan@enduml. -
Periksa pratinjau langsung; jika render gagal, periksa kesalahan sintaks yang disorot dan barisnya.
-
Sempurnakan diagram, lalu ekspor atau bagikan sesuai kebutuhan. VPasCode menjelaskan opsi ekspor SVG, PNG, dan PDF.
VPasCode juga menyediakan antarmuka pemilihan tema untuk PlantUML, termasuk tema Visual Paradigm dan Rose. Untuk hasil yang konsisten dalam tim, simpan sumber PlantUML bersama dokumentasi atau kode Anda, daripada hanya mengandalkan gambar yang diekspor.
9. Jebakan umum dan praktik baik

-
Jangan kelirukan asosiasi dengan ketergantungan.Ketergantungan umumnya berarti “menggunakan”; asosiasi sering kali merepresentasikan hubungan struktural yang lebih persisten.
-
Hindari penggunaan komposisi yang berlebihan.Komposisi menyatakan klaim siklus hidup yang lebih kuat daripada sekadar koneksi.
-
Berikan label multiplisitas dari ujung yang berlawanan.Angka di sebelah satu kelas menunjukkan berapa banyak instance dari kelas tersebut yang dapat terkait dengan satu instance di ujung yang lain.
-
Jaga agar diagram tetap fokus.Pecah model yang sangat besar menjadi paket atau diagram terpisah untuk kepedulian yang berbeda.
-
Tampilkan detail yang bermanfaat bagi audiens.Gambaran konseptual mungkin hanya memerlukan nama kelas dan hubungan; diagram tingkat desain mungkin memerlukan tipe, visibilitas, dan operasi.
-
Anggap sumber sebagai artefak yang dipelihara.Tinjau perubahan pada teks, lakukan render setelah pengeditan, dan regenerasi ekspor ketika sumber berubah.
Referensi cepat

@startuml
class A {
+publicField: String
-privateField: int
#protectedMethod(): void
~packageMember(): boolean
}
interface I
abstract class Base
enum State { READY; DONE }
Base <|-- A
I <|.. A
A *-- B : composition
A o-- C : aggregation
A --> D : association
A ..> I : dependency
@enduml
PlantUML mendukung fitur tambahan untuk diagram kelas—termasuk pengelompokan anggota, catatan, warna, dan lainnya—ketika diagram memerlukan penyempurnaan lebih lanjut.










