Apa itu Diagram Urutan?
Sebuah Diagram Urutan adalah diagram perilaku diagram UML yang menjelaskan bagaimana operasi perangkat lunak dilakukan seiring waktu. Sebagai standar utama dalam spesifikasi Bahasa Pemodelan Terpadu (UML), diagram ini memodelkan urutan kronologis yang tepat ketika objek, proses, atau mikroservis bertukar pesan. Dengan memetakan garis hidup secara vertikal dan interaksi berurutan secara horizontal, jenis diagram UML ini memungkinkan insinyur perangkat lunak dan arsitek sistem untuk memvisualisasikan secara jelas urutan pemanggilan API yang kompleks, pertukaran data jaringan, dan batas transaksi basis data sebelum menulis kode produksi.jenis diagram UML memungkinkan insinyur perangkat lunak dan arsitek sistem untuk memvisualisasikan secara jelas urutan pemanggilan API yang kompleks, pertukaran data jaringan, dan batas transaksi basis data sebelum menulis kode produksi.
Dengan VPasCode, Anda tidak perlu menghabiskan berjam-jam untuk menyelaraskan panah paralel, memanjangkan garis pesan, atau memindahkan kotak batas agar ada ruang untuk langkah baru. Mesin tata letak kami menghitung seluruh kisi waktu secara dinamis saat Anda mengetik skrip deklaratif teks biasa.
Panduan Sintaks Inti: Elemen dan Konstruksi
Untuk merancang diagram urutan UML yang dapat dijalankan dan sesuai standar di PlantUML, Anda perlu menguasai deklarasi komponen, gaya panah pesan, garis hidup, dan struktur kontrol logis.
1. Deklarasi Peserta dan Bentuk UML
Secara default, komponen dalam diagram UML ini mewarisi bentuk kotak persegi standar. Namun, Anda dapat mengubah arketipe visual entitas Anda untuk memberi pembaca konteks arsitektur langsung mengenai batas sistem Anda menggunakan kata kunci UML tertentu:
aktor Client
batas "API Gateway" sebagai Gateway
kontrol Controller
database "PostgreSQL" sebagai DB
2. Panah Pesan dan Sinkronisitas
Gaya garis panah dan ujungnya menentukan protokol komunikasi yang tepat yang terjadi di seluruh saluran infrastruktur Anda berdasarkan standar diagram UML:
- Permintaan Sinkron (Blokir):Ditandai dengan garis padat dan ujung panah padat. Pengirim menunggu respons:
A -> B - Pesan Asinkron (Non-Blokir):Ditandai dengan garis padat dan ujung panah tipis terbuka. Pengirim menyerahkan data dan langsung melanjutkan:
A ->> B - Respons / Nilai Kembalian:Ditandai dengan garis putus-putus dan ujung panah terbuka:
B --> A
3. Mengelola Garis Kehidupan (Aktivasi dan Deaktivasi)
Untuk mencegah komponen Anda terlihat seperti batang datar, Anda harus secara eksplisit menunjukkan kapan suatu proses sedang aktif menggunakan thread CPU atau kapasitas memori. Gunakan marker aktifkan dan nonaktifkan marker, atau gunakan sintaks singkat inkremen inline (++ / --):
Gateway -> Controller ++ : "prosesPembayaran()"
Controller --> Gateway -- : "kembalikan bukti pembayaran"
4. Blok Logika: Alternatif, Perulangan, dan Paralel
Logika bisnis yang kompleks (seperti cabang if/else, pengulangan basis data, atau thread eksekusi paralel) harus dibungkus di dalam batas kerangka global terstruktur yang dikenal sebagai fragmen gabungan dalam spesifikasi diagram UML:
- Logika Bersyarat (alt / else): Memodelkan cabang bersyarat.
Plantuml Edit Plantuml in VPasCode
alt kondisi berhasil A -> B : "Lanjutkan permintaan" else status kegagalan A -> B : "Kirim kode kesalahan" end
- Perulangan Pengulangan (loop): Memodelkan iterasi, pengulangan, atau blok pemrosesan antrian hingga suatu kondisi terpenuhi.
Plantuml Edit Plantuml in VPasCode
loop hingga antrian kosong Pekerja -> Antrian : "Ambil pekerjaan berikutnya" end
- Eksekusi Paralel (par): Model memisahkan operasi yang berjalan secara bersamaan di seluruh thread yang independen.
Plantuml Edit Plantuml in VPasCode
par Jalankan proses paralel A -> LogService : "Tulis analitik jejak" else A -> DB : "Simpan data profil pelanggan" end
Praktik Terbaik untuk Urutan yang Bersih
- Kelompokkan Pesan Menggunakan Pembatas: Gunakan tanda sama dengan ganda (“
== Tahap Anda ==) untuk membagi urutan otentikasi ke checkout yang sangat besar menjadi milestone logis yang terpisah. - Gunakan Penomoran Otomatis: Tempatkan
autonumberarahan langsung di bawah@startuml. Ini memaksa ruang kerja untuk menandai bilangan bulat langkah pada setiap panah, membuat ulasan kode jauh lebih mudah. - Jaga Respons Tetap Bersih: Hindari menulis kalimat deskriptif yang sangat panjang pada panah kembali (
-->). Sebaliknya, cukup beri label pada objek data mentah atau kode HTTP yang kembali (misalnya,"201 Dibuat Token").
Contoh Diagram Urutan PlantUML Dunia Nyata
Contoh 1: Putaran Otentikasi Mikroservis (Blok Alt & Garis Kehidupan)
Contoh ini menangani urutan keamanan standar di mana klien melakukan otentikasi terhadap gateway, menampilkan garis kehidupan yang jelas dan kerangka hasil kondisional alternatif di dalam format diagram UML standar.
@startuml
autonumber
aktor User
batas "Aplikasi Web" sebagai App
kontrol "Layanan Otentikasi" sebagai Auth
User -> App ++ : "Kirim Kredensial"
App -> Auth ++ : "POST /v1/auth"
alt #LightGreen Login Berhasil
Auth --> App : "200 OK (Token JWT)"
App --> User : "Tampilkan Dashboard"
else #LightPink Kredensial Tidak Valid
Auth --> App : "401 Tidak Diizinkan"
App --> User : "Tampilkan Notifikasi Kesalahan"
end
desaktifkan Auth
desaktifkan App
@enduml
Analisis Sintaks: The autonumber tag secara otomatis mengelola angka 1 hingga 5. The alt dan else blok ditambahkan dengan bendera warna heksa custom (misalnya, #LightGreen) untuk menambahkan sorotan visual langsung pada jalur eksekusi sukses dibandingkan kegagalan. The ++ token memastikan lifeline tetap aktif selama blok panggilan jaringan.
Contoh 2: Pemrosesan Pesanan Lanjutan (Perulangan, Paralel, dan Pembagi)
Rancangan arsitektur perusahaan ini memodelkan sistem checkout yang kuat yang membagi tugas ke pekerja paralel, mengeksekusi penulisan basis data, dan mengandalkan putaran sinkronisasi sistem eksternal.
@startuml
autonumber
boundary "API Checkout" sebagai API
database "DB Pesanan" sebagai DB
control "Antrian Pekerja" sebagai Queue
boundary "Stripe" sebagai Stripe
== Fase 1: Validasi Buku Jurnal Transaksi ==
API -> DB ++ : "Tulis Pesanan Tertunda"
DB --> API -- : "ID Pesanan Dikonfirmasi"
== Fase 2: Pembayaran & Pemenuhan Asinkron ==
API -> Stripe ++ : "Tagih Akun Pelanggan"
Stripe --> API -- : "Pembayaran Diperbolehkan"
par Operasi Latar Belakang Paralel
API -> Queue ++ : "Terbitkan acara 'Order_Placed'"
nonaktifkan Queue
else
API -> DB ++ : "Perbarui status menjadi 'Lunas'"
nonaktifkan DB
end
loop Mencoba Kembali Hingga 3 Kali Saat Terjadi Kegagalan Jaringan
API -> API : "Ping Webhook Sinkronisasi Pemberitahuan"
end
API --> Client : "Kembalikan HTTP 200 (Sukses)"
@enduml
Analisis Sintaks: The == pembagi membagi tata letak menjadi fase operasional yang berbeda. The par blok secara bersih bercabang dari jalur panah pesan menjadi dua jalur horizontal terpisah, menggambarkan bahwa publikasi acara dan pembaruan status basis data terjadi secara bersamaan tanpa saling menghambat. Panah yang mengarah ke dirinya sendiri (API -> API) memetakan lingkaran fungsi instans internal lokal dengan sempurna.