Auf die Implementierung einer RESTful-Ressourcen für eine state-machine oder endliche Automaten

Ein wenig spät zur party hier, aber ich war die Erforschung genau dieses Problem für mich selbst und fand, dass der Edelstein ich bin derzeit mit verwalten meine state machines (state_machine von pluginaweek) hat einige Methoden, die sich mit diesem Problem sehr schön.

Wenn verwendet mit ActiveRecord (und ich gehe davon aus anderen Persistenz-Schichten als auch), es bietet eine #state_event= - Methode akzeptiert eine Zeichenfolge Darstellung der Veranstaltung, die Sie möchten, um das Feuer. Siehe Dokumentation hier.

# For example,

vehicle = Vehicle.create          # => #<Vehicle id: 1, name: nil, state: "parked">
vehicle.state_event               # => nil
vehicle.state_event = 'invalid'
vehicle.valid?                    # => false
vehicle.errors.full_messages      # => ["State event is invalid"]

vehicle.state_event = 'ignite'
vehicle.valid?                    # => true
vehicle.save                      # => true
vehicle.state                     # => "idling"
vehicle.state_event               # => nil

# Note that this can also be done on a mass-assignment basis:

vehicle = Vehicle.create(:state_event => 'ignite')  # => #<Vehicle id: 1, name: nil, state: "idling">
vehicle.state                                       # => "idling"

Diese können Sie einfach fügen Sie eine state_event Feld in Ihrem Ressource Bearbeiten Sie Formulare und erhalten Sie die Zustandsübergänge so einfach wie die Aktualisierung von jedem anderen Attribut.

Nun sind wir offensichtlich immer noch mit PUT-trigger-Ereignisse mit dieser Methode, und die ist nicht Erholsam. Die gem bietet aber eine ein Interessantes Beispiel, dass zumindest "fühlt" sich ganz Ruhig, obwohl es mit dem gleichen nicht-Erholsamen-Methode unter der Decke.

Wie Sie sehen können hier und hier, die gem Introspektion Fähigkeiten können Sie in Ihrem Formen entweder in der Veranstaltung, die Sie möchten, um das Feuer oder den Namen dieses Ereignis resultierenden Zustand.

<div class="field">
  <%= f.label :state %><br />
  <%= f.collection_select :state_event, @user.state_transitions, :event, :human_to_name, :include_blank => @user.human_state_name %>
</div>

<div class="field">
  <%= f.label :access_state %><br />
  <%= f.collection_select :access_state_event, @user.access_state_transitions, :event, :human_event, :include_blank => "don't change" %>
</div>

Diese Technik, erhalten Sie einfach die Formular-basierte Aktualisierung der Modell-Status keine gültigen nächste Staat, ohne zu schreiben zusätzlichen code. Es ist technisch nicht Erholsam ist, aber es erlaubt Ihnen, leicht zu präsentieren, dass die Art und Weise, in der UI.

Die Sauberkeit dieser Technik kombiniert mit der inhärenten Konflikte und versuchen, die Umwandlung ein event-based state-Maschine, die in einem einfachen RESTful-Ressourcen war genug, um mich, so dass ich hoffe, es bietet einige Einblicke, um Sie als gut.

Wenn Ihr Ressource hat eine Art status-Attribut können Sie verwenden eine Technik namens micro-PUT zum aktualisieren den status.

PUT /Customer/1/Status
Content-Type: text/plain

Closed

=> 200 OK
Content-Location: /Customer/1

Können Sie modellressource Staaten als Sammlungen und verschieben von Ressourcen zwischen diesen Sammlungen.

GET /Customer/1
=>
Content-Type: application/vnd.acme.customer+xml
200 OK


POST /ClosedCustomers
Content-Type: application/vnd.acme.customer+xml
=>
200 OK

POST /OpenCustomers
Content-Type: application/vnd.acme.customer+xml
=>
200 OK

Konnten Sie immer die Verwendung der neuen PATCH-Methode

PATCH /Customer/1
Content-Type: application/x-www-form-urlencoded
Status=Closed
=>
200 OK