Command は、コマンドについてのメタ情報と、現在の実装 (Command.impl) を示す CommandImpl へのアクセッサで構成されています。コマンドの機能を実際に使用するには、Command.impl プロパティを取得する必要があります。なお、コマンドの現在の状態によっては、このプロパティは null の可能性があります。

Command を観察対象にすることができます。この場合、その実装の値、またはその実装によって保持される状態が変更されたときに、その Observer に通知することを約束します。特に、UI 要素は、コマンドを観察し、Command の状態が変わるときにそのアフォーダンスを変更します。

コマンドの命名規則の詳細については、クラス CommandContext を参照してください。

Command の状態は、状態の再計算とオブザーバーの通知をできるだけたくさんバッチ処理するプロトコルを使って保持されます。これは、効率の面では重要ですが、このクラスを実装するユーザーに対していくつかの重要な要件を提示します。

• コマンドの状態が変更される可能性があるとき、および再計算が必要なときはいつでも Command.request-update が呼び出されることを確認します。これは、コマンド自体、または CommandContext などの外部オブジェクトによって実行できます。これは、再計算されるコマンドの状態を、そのコマンドが再使用される前にトリガします。また、コマンドが観察されている場合はそのイベント ループが次にヒットされたときにトリガします。
• Command.update をオーバーライドして、コマンドに対する状態の変更を再計算します。
• Command.update-completed をオーバーライドして、最終更新 後のコマンドの状態についての情報を調査またはキャッシュします。
• Command.note-state-changed を呼び出して、オブザーバーへの通知が必要とされるような変更がコマンドの状態に対して行われたことを示します。このメソッドは、いつでも呼び出し可能で、次回の更新の完了後に、任意のオブザーバーへの通知を実行することを保証します。

コマンドの更新プロセスは繰り返し処理ではないことに注意してください。特に、Command.update または Command.update-completed の実行中に生成される Command.request-update の任意の呼び出しは、引数 error-if-updating? が false に設定されている場合を除いて、エラーになります。この引数が false に設定されている場合、これらの呼び出しでは何も行なわれません。

また、基本クラスのコンストラクタは、Command.request-update 呼び出しを行って、すべての Command が必ず初回に更新サイクルを通過してから実際に使用されるようにします。