Penjelasan pola Command beserta contohnya

Tujuan dan masalah yang diselesaikan

Tujuan: membungkus permintaan sebagai objek, sehingga klien dapat diparameterisasi dengan permintaan berbeda, permintaan dapat diantrekan atau dicatat, dan operasi yang bisa di-undo didukung. Command adalah salah satu pola behavioral dalam buku Gang of Four (GoF).

Pikirkan editor teks. Aksi yang sama, seperti "tebalkan teks", bisa dipicu oleh tombol toolbar, item menu, dan pintasan keyboard Ctrl+B. Jika masing-masing memanggil editor secara langsung, logikanya terduplikasi di tiga tempat. Lebih buruk lagi, editor juga harus mendukung undo: setelah pengguna menekan Ctrl+Z, program perlu tahu aksi terakhir apa dan bagaimana membalikkannya.

Command menyelesaikan kedua masalah itu. Setiap aksi menjadi objek dengan method execute, dan opsional method undo. Tombol, menu, dan pintasan semuanya memegang objek command yang sama. Editor menyimpan daftar riwayat command yang sudah dijalankan, sehingga undo berarti mengambil command terakhir dari daftar dan memanggil method undo-nya.

Struktur dan peserta

Implementasi TypeScript: undo dan redo

TextDocument adalah receiver. InsertText dan DeleteLast adalah command yang mengingat cukup informasi untuk membalikkan dirinya sendiri. Editor adalah invoker dengan dua stack: satu untuk undo dan satu untuk redo.

interface Command {
  execute(): void;
  undo(): void;
}
class TextDocument {
  text = "";
}
class InsertText implements Command {
  constructor(private doc: TextDocument, private value: string) {}
  execute() { this.doc.text += this.value; }
  undo() { this.doc.text = this.doc.text.slice(0, -this.value.length); }
}
class DeleteLast implements Command {
  private removed = "";
  constructor(private doc: TextDocument, private count: number) {}
  execute() {
    this.removed = this.doc.text.slice(-this.count);
    this.doc.text = this.doc.text.slice(0, -this.count);
  }
  undo() { this.doc.text += this.removed; }
}
class Editor {
  private done: Command[] = [];
  private undone: Command[] = [];
  run(cmd: Command) { cmd.execute(); this.done.push(cmd); this.undone = []; }
  undo() { const c = this.done.pop(); if (c) { c.undo(); this.undone.push(c); } }
  redo() { const c = this.undone.pop(); if (c) { c.execute(); this.done.push(c); } }
}
const doc = new TextDocument();
const editor = new Editor();
editor.run(new InsertText(doc, "Hello"));
editor.run(new InsertText(doc, ", world"));
editor.run(new DeleteLast(doc, 7));
console.log(doc.text); // Hello
editor.undo();
console.log(doc.text); // Hello, world
editor.redo();
console.log(doc.text); // Hello

Sebelum dan sesudah

Tanpa pola ini, UI memanggil dokumen secara langsung dan undo tidak mungkin dilakukan, karena tidak ada yang mencatat apa yang terjadi:

// Before: each trigger calls the receiver directly
boldButton.onclick = () => doc.makeBold(selection);
menuBold.onclick = () => doc.makeBold(selection);
// After: every trigger shares one command, and the editor records it
const bold = () => new MakeBold(doc, selection);
boldButton.onclick = () => editor.run(bold());
menuBold.onclick = () => editor.run(bold());

Versi kedua adalah potongan kode yang mengasumsikan class command MakeBold seperti yang di atas. UI tidak lagi tahu cara kerja penebalan, dan setiap aksi melewati satu tempat di mana ia bisa dicatat, di-log, atau di-undo.

Kapan dipakai dan kapan tidak

• Pakai untuk undo dan redo, makro (daftar command yang dijalankan bersama), dan riwayat command.
• Pakai untuk mengantrekan atau menjadwalkan pekerjaan: job queue menyimpan objek command dan worker menjalankannya nanti.
• Pakai untuk mencatat atau memutar ulang operasi, misalnya mengirim command yang sudah diserialisasi ke server lain.
• Pakai untuk memisahkan elemen UI dari kode yang dipicunya.
• Jangan dipakai bila Anda hanya butuh callback. Di TypeScript fungsi sudah merupakan nilai kelas satu, jadi button.onclick = save adalah command yang sangat memadai tanpa undo. Gunakan class command saat Anda butuh perilaku tambahan seperti undo, nama untuk ditampilkan, atau serialisasi.

Penggunaan di dunia nyata

• Interface Runnable di Java adalah command dengan satu method, run, yang dipakai thread dan executor untuk menjalankan pekerjaan nanti.
• Action Redux adalah objek biasa yang menjelaskan sebuah perubahan; reducer menerapkannya, dan log action memungkinkan time-travel debugging. Ini kerabat dekat Command, dengan logika disimpan di reducer, bukan di command.
• VS Code dan banyak editor lain mendaftarkan command bernama yang bisa dikaitkan ke tombol, menu, dan command palette.
• Migrasi database sering punya langkah up dan down, yaitu pasangan execute dan undo dari sebuah command.

Pola terkait