Upgrade to Pro — share decks privately, control downloads, hide ads and more …

More fun, less pain: a strategy for writing mai...

Stefano Verna
September 26, 2014

More fun, less pain: a strategy for writing maintainable Rails admin backends

The Rails ecosystem features many full-fledged solutions to generate administrative interfaces (ActiveAdmin, RailsAdmin, you name it...). Although these tools come very handy to bootstrap a project quickly, they all obey the 80%-20% rule and tend to be very invasive (and incredibly painful to test). A time always comes when they start getting in the way, and all the cumulated saved time will be wasted to solve a single, trivial problem with ugly workarounds and EPIC FACEPALMS. This talk will walk through an alternative strategy for building administrative backends: we'll make use of well-known gems like Inherited Resources and Simple Form, the Rails 3.1+ template-inheritance feature and a mix of some good ol' OOP patterns to build an (arguably) more maintainable, testable and modular codebase, without sacrificing the super-DRY, declarative style ActiveAdmin and similar gems offer.

Stefano Verna

September 26, 2014
Tweet

More Decks by Stefano Verna

Other Decks in Programming

Transcript

  1. # app/models/contact.rb ! class Contact < ActiveRecord::Base validates :first_name, presence:

    true validates :last_name, presence: true validates :twitter, presence: true, uniqueness: true ! def full_name [first_name, last_name].join(" ") end end
  2. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  3. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/controllers/admin/contacts_controller.rb class Admin::ContactsController < ApplicationController respond_to :html ! # ... ! end
  4. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/controllers/admin/contacts_controller.rb def index @contacts = Contact.all respond_with @contacts end
  5. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/controllers/admin/contacts_controller.rb ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end
  6. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/controllers/admin/contacts_controller.rb ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end
  7. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/controllers/admin/contacts_controller.rb def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end
  8. # app/views/admin/contacts/index.html.erb ! <h1>Contacts</h1> ! <table> ! <thead> <tr> <th>Name</th>

    <th>Twitter</th> <th>Actions</th> </tr> </thead> ! <tbody> <% @contacts.each do |contact| %> <tr> <td><%= contact.full_name %></td> <td><%= contact.twitter %></td> <td> <%= link_to "Edit", edit_admin_contact_path(contact) %> <%= link_to "Delete", admin_contact_path(contact), data: { method: :delete } %> </td> </tr> <% end %> </tbody> ! </table> ! <p><%= link_to "Create new Contact", new_admin_contact_path %></p>
  9. # app/views/admin/contacts/edit.html.erb ! <h1>Edit Contact</h1> ! <%= form_for(@contact, url: admin_contact_path(@contact))

    do |f| %> <%= render "form", form: f %> <%= f.button %> <% end %> # app/views/admin/contacts/new.html.erb ! <h1>New Contact</h1> ! <%= form_for(@contact, url: admin_contacts_path) do |f| %> <%= render "form", form: f %> <%= f.button %> <% end %>
  10. # app/views/admin/contacts/_form.html.erb ! <div> <%= form.label :first_name %> <%= form.text_field

    :first_name %> <p><%= form.object.errors.full_messages_for(:first_name).first %></p> </div> ! <div> <%= form.label :last_name %> <%= form.text_field :last_name %> <p><%= form.object.errors.full_messages_for(:last_name).first %></p> </div> ! <div> <%= form.label :twitter %> <%= form.text_field :twitter %> <p><%= form.object.errors.full_messages_for(:twitter).first %></p> </div>
  11. # app/admin/contact.rb ! ActiveAdmin.register Contact do permit_params :first_name, :last_name, :twitter

    ! index do column :full_name column :twitter actions end ! form do |f| f.inputs "Details" do f.input :first_name f.input :last_name f.input :twitter end f.actions end end
  12. # app/views/admin/contacts/_form.html.erb ! <div> <%= form.label :first_name %> <%= form.text_field

    :first_name %> <p><%= form.object.errors.full_messages_for(:first_name).first %></p> </div> ! <div> <%= form.label :last_name %> <%= form.text_field :last_name %> <p><%= form.object.errors.full_messages_for(:last_name).first %></p> </div> ! <div> <%= form.label :twitter %> <%= form.text_field :twitter %> <p><%= form.object.errors.full_messages_for(:twitter).first %></p> </div>
  13. # app/views/admin/contacts/new.html.erb ! <h1>New Contact</h1> ! <%= form_for(@contact, url: admin_contacts_path)

    do |f| %> <%= render "form", form: f, contact: @contact %> <%= f.button %> <% end %>
  14. # app/views/admin/contacts/new.html.erb ! <h1>New Contact</h1> ! <%= simple_form_for(@contact, url: admin_contacts_path)

    do |f| %> <%= render "form", form: f, contact: @contact %> <%= f.button %> <% end %>
  15. # app/views/admin/contacts/_form.html.erb ! <div> <%= form.label :first_name %> <%= form.text_field

    :first_name %> <p><%= form.object.errors.full_messages_for(:first_name).first %></p> </div> ! <div> <%= form.label :last_name %> <%= form.text_field :last_name %> <p><%= form.object.errors.full_messages_for(:last_name).first %></p> </div> ! <div> <%= form.label :twitter %> <%= form.text_field :twitter %> <p><%= form.object.errors.full_messages_for(:twitter).first %></p> </div>
  16. # app/controllers/admin/contacts_controller.rb ! def update @contact = Contact.find(params[:id]) ! if

    @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  17. # app/controllers/admin/contacts_controller.rb class Admin::ContactsController < ApplicationController respond_to :html ! #

    ... ! end class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  18. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/controllers/admin/contacts_controller.rb class Admin::ContactsController < ApplicationController respond_to :html responders :flash ! # ... ! end
  19. # app/controllers/admin/contacts_controller.rb ! def update @contact = Contact.find(params[:id]) ! if

    @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  20. # app/controllers/admin/contacts_controller.rb ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_params) respond_with

    @contact, location: admin_contacts_path end class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  21. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy flash[:notice] = "Contact was successfully destroyed" else flash[:alert] = "Contact could not be destroyed" end ! respond_with @contact, location: admin_contacts_path end ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/controllers/admin/contacts_controller.rb ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_params) respond_with @contact, location: admin_contacts_path end # config/locales/en.yml ! en: flash: actions: create: notice: '%{resource_name} created.' alert: '%{resource_name} could not be created.' update: notice: '%{resource_name} was updated.' alert: '%{resource_name} could not be updated.' destroy: notice: '%{resource_name} was destroyed.' alert: '%{resource_name} could not be destroyed.'
  22. class Admin::ContactsController < ApplicationController respond_to :html ! def index @contacts

    = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) ! if @contact.save flash[:notice] = "Contact was successfully created" else flash[:alert] = "Contact could not be created" end ! respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) ! if @contact.update_attributes(permitted_params) flash[:notice] = "Contact was successfully updated" else flash[:alert] = "Contact could not be updated" end ! respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) ! if @contact.destroy responders :flash # app/controllers/admin/contacts_controller ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_para respond_with @contact, location: admin_co end # config/locales/en.yml ! en: flash: actions: create: notice: '%{resource_name} created.' alert: '%{resource_name} could not update: notice: '%{resource_name} was updat alert: '%{resource_name} could not destroy: notice: '%{resource_name} was destr alert: '%{resource_name} could not
  23. class Admin::ContactsController < ApplicationController respond_to :html responders :flash ! !

    ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end def index @contacts = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) @contact.save respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_params) respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) @contact.destroy respond_with @contact, location: admin_contacts_path end # app/controllers/admin/contacts_controller ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_para respond_with @contact, location: admin_co end # config/locales/en.yml ! en: flash: actions: create: notice: '%{resource_name} created.' alert: '%{resource_name} could not update: notice: '%{resource_name} was updat alert: '%{resource_name} could not destroy: notice: '%{resource_name} was destr alert: '%{resource_name} could not
  24. class Admin::ContactsController < ApplicationController respond_to :html responders :flash ! !

    ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! private ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end def index @contacts = Contact.all respond_with @contacts end ! def new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) @contact.save respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_params) respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) @contact.destroy respond_with @contact, location: admin_contacts_path end
  25. def index @contacts = Contact.all respond_with @contacts end ! def

    new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) @contact.save respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_params) respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) @contact.destroy respond_with @contact, location: admin_contacts_path end Contact @contacts @contact admin_contacts_path new_admin_contact_path edit_admin_contact_path admin_contact_path
  26. def index @contacts = Contact.all respond_with @contacts end ! def

    new @contact = Contact.new respond_with @contact end ! def create @contact = Contact.new(permitted_params) @contact.save respond_with @contact, location: admin_contacts_path end ! def edit @contact = Contact.find(params[:id]) respond_with @contact end ! def update @contact = Contact.find(params[:id]) @contact.update_attributes(permitted_params) respond_with @contact, location: admin_contacts_path end ! def destroy @contact = Contact.find(params[:id]) @contact.destroy respond_with @contact, location: admin_contacts_path end resource_class ! @collection @resource ! collection_path new_resource_path edit_resource_path resource_path
  27. def index @collection = resource_class.all respond_with @collection end ! def

    new @resource = resource_class.new respond_with @resource end ! def create @resource = resource_class.new(permitted_params) @resource.save respond_with @resource, location: collection_url end ! def edit @resource = resource_class.find(params[:id]) respond_with @resource end ! def update @resource = resource_class.find(params[:id]) @resource.update_attributes(permitted_params) respond_with @resource, location: collection_url end ! def destroy @resource = resource_class.find(params[:id]) @resource.destroy respond_with @resource, location: collection_url end resource_class ! @collection @resource ! collection_path new_resource_path edit_resource_path resource_path
  28. The template method pattern is a design pattern that defines

    the skeleton of an algorithm in a method, called template method, which defers some steps to subclasses. ! It lets one redefine certain steps of an algorithm without changing the algorithm's structure.
  29. def index @collection = resource_class.all respond_with @collection end ! def

    new @resource = resource_class.new respond_with @resource end ! def create @resource = resource_class.new(permitted_params) @resource.save respond_with @resource, location: collection_url end ! def edit @resource = resource_class.find(params[:id]) respond_with @resource end ! def update @resource = resource_class.find(params[:id]) @resource.update_attributes(permitted_params) respond_with @resource, location: collection_url end ! def destroy @resource = resource_class.find(params[:id]) @resource.destroy respond_with @resource, location: collection_url end resource_class ! @collection @resource ! collection_path new_resource_path edit_resource_path resource_path
  30. def @collection respond_with @collection end ! def @resource respond_with @resource

    end ! def @resource @resource respond_with @resource, end ! def @resource respond_with @resource end ! def @resource @resource respond_with @resource, end ! def @resource @resource respond_with @resource, end # controllers/concerns/rest_actions_concern.rb ! module RestActionsConcern extend ActiveSupport::Concern ! included do respond_to :html responders :flash end ! # actions here! ! end resource_class ! @collection @resource ! collection_path new_resource_path edit_resource_path resource_path
  31. # controllers/concerns/rest_actions_concern.rb ! module RestActionsConcern extend ActiveSupport::Concern ! included do

    respond_to :html responders :flash end ! def index @collection = resource_class.all respond_with @collection end ! def new @resource = resource_class.new respond_with @resource end ! def create @resource = resource_class.new(permitted_params) @resource.save respond_with @resource, location: collection_url end ! def edit @resource = resource_class.find(params[:id]) respond_with @resource end ! def update @resource = resource_class.find(params[:id]) @resource.update_attributes(permitted_params) respond_with @resource, location: collection_url end ! def destroy @resource = resource_class.find(params[:id]) @resource.destroy respond_with @resource, location: collection_url end end
  32. class Admin::ContactsController < ApplicationController include RestActionsConcern ! private ! !

    ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! def resource_class Contact end ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end def collection_path admin_contacts_path end ! def new_resource_path new_admin_contact_path end ! def edit_resource_path(resource) edit_admin_contact_path end ! def resource_path(resource) admin_contact_path(resource) end
  33. def collection_path admin_contacts_path end ! def new_resource_path new_admin_contact_path end !

    def edit_resource_path(resource) edit_admin_contact_path end ! def resource_path(resource) admin_contact_path(resource) end
  34. def collection_path url_for(controller: controller_path, action: :index) end ! def new_resource_path

    url_for(controller: controller_path, action: :new) end ! def edit_resource_path(resource) url_for(controller: controller_path, action: :edit, id: resource) end ! def resource_path(resource) url_for(controller: controller_path, action: :show, id: resource) end
  35. # controllers/concerns/resource_urls_concern.rb ! module ResourceUrlsConcern extend ActiveSupport::Concern ! def collection_path

    url_for(controller: controller_path, action: :index) end ! def new_resource_path url_for(controller: controller_path, action: :new) end ! def edit_resource_path(resource) url_for(controller: controller_path, action: :edit, id: resource) end ! def resource_path(resource) url_for(controller: controller_path, action: :show, id: resource) end end
  36. class Admin::ContactsController < ApplicationController include RestActionsConcern include ResourceUrlsConcern ! private

    def resource_class Contact end ! def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  37. class Admin::ContactsController < ApplicationController include RestActionsConcern include ResourceUrlsConcern ! private

    def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end def resource_class controller_name.classify.constantize # => Contacts end
  38. class Admin::ContactsController < ApplicationController include RestActionsConcern include ResourceUrlsConcern ! private

    def permitted_params params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  39. class Admin::ContactsController < ApplicationController include RestActionsConcern ! private def permitted_params

    params. require(:contact). permit(:first_name, :last_name, :twitter) end end
  40. class Admin::ContactsController < ApplicationController include RestActionsConcern ! private def permitted_params

    params. require(:contact). permit(:first_name, :last_name, :twitter) end end # app/admin/contact.rb ! ActiveAdmin.register Contact do permit_params :first_name, :last_name, :twitter ! # … end
  41. # app/views/admin/contacts/edit.html.erb ! <h1>Edit Contact</h1> ! <%= simple_form_for(@resource, url: resource_path(@resource))

    do |f| %> <%= render "form", form: f %> <%= f.button :submit %> <% end %> # app/views/admin/contacts/new.html.erb ! <h1>New Contact</h1> ! <%= simple_form_for(@resource, url: collection_path) do |f| %> <%= render "form", form: f %> <%= f.button :submit %> <% end %>
  42. module ResourceInflectionsConcern extend ActiveSupport::Concern ! included do helper_method :inflections end

    ! private ! def inflections { resource_name: , collection_name: } end end resource_class.model_name.human(count: 1) resource_class.model_name.human(count: 2)
  43. # app/views/admin/contacts/edit.html.erb ! <h1>Edit Contact</h1> ! <%= simple_form_for(@resource, url: resource_path(@resource))

    do |f| %> <%= render "form", form: f %> <%= f.button :submit %> <% end %> # app/views/admin/contacts/new.html.erb ! <h1>New Contact</h1> ! <%= simple_form_for(@resource, url: collection_path) do |f| %> <%= render "form", form: f %> <%= f.button :submit %> <% end %>
  44. # app/views/admin/contacts/edit.html.erb ! <h1><%= t('admin.resource.edit.title', inflections) %></h1> ! <%= simple_form_for(@resource,

    url: resource_path(@resource)) do |f| %> <%= render "form", form: f %> <%= f.button :submit %> <% end %> # app/views/admin/contacts/new.html.erb ! <h1><%= t('admin.resource.new.title', inflections) %></h1> ! <%= simple_form_for(@resource, url: collection_path) do |f| %> <%= render "form", form: f %> <%= f.button :submit %> <% end %>
  45. # app/controllers/admin/contacts_controller.rb class Admin::ContactsController < Admin::BaseController include RestActionsConcern ! #

    ... ! end # app/controllers/admin/base_controller.rb class Admin::BaseController < ApplicationController end
  46. # app/views/admin/contacts/_form.html.erb ! <%= form.input :first_name %> <%= form.input :last_name

    %> <%= form.input :twitter %> # app/admin/contact.rb ! ActiveAdmin.register Contact do form do |f| f.inputs "Details" do f.input :first_name f.input :last_name f.input :twitter end end end
  47. # app/views/admin/contacts/index.html.erb ! <h1><%= t("admin.resource.index.title", inflections) %></h1> <table> <thead> <tr>

    <th>Name</th> <th>Twitter</th> <th>Actions</th> </tr> </thead> <tbody> <% @collection.each do |contact| %> <tr> <td><%= contact.full_name %></td> <td><%= contact.twitter %></td> <td> <%= link_to "Edit", edit_admin_contact_path(contact) %> <%= link_to "Delete", admin_contact_path(contact), data: { method: :delete } %> </td> </tr> <% end %> </tbody> </table> <% new_label = t('admin.resource.index.actions.new', inflections) %> <p><%= link_to(new_label, new_resource_url) %></p>
  48. # app/views/admin/base/index.html.erb ! <h1><%= t('admin.resource.index.title', inflections) %></h1> ! <%= table_for(@collection)

    do |table, record| %> <%= render 'table', table: table %> ! <%= table.actions do %> <%= table.action :edit, edit_resource_path(record) %> <%= table.action :destroy, resource_path(record), method: :delete %> <% end %> <% end %> ! <% new_label = t('admin.resource.index.actions.new', inflections) %> <p><%= link_to(new_label, new_resource_url) %></p>
  49. # app/views/admin/base/index.html.erb ! <h1><%= t('admin.resource.index.title', inflections) %></h1> ! <%= table_for(@collection)

    do |table, record| %> <%= render 'table', table: table %> ! <%= table.actions do %> <%= table.action :edit, edit_resource_path(record) %> <%= table.action :destroy, resource_path(record), method: :delete %> <% end %> <% end %> ! <% new_label = t('admin.resource.index.actions.new', inflections) %> <p><%= link_to(new_label, new_resource_url) %></p>
  50. # app/views/admin/base/index.html.erb ! <h1><%= t('admin.resource.index.title', inflections) %></h1> ! <%= table_for(@collection)

    do |table, record| %> <%= render 'table', table: table %> ! <%= table.actions do %> <%= table.action :edit, edit_resource_path(record) %> <%= table.action :destroy, resource_path(record), method: :delete %> <% end %> <% end %> ! <% new_label = t('admin.resource.index.actions.new', inflections) %> <p><%= link_to(new_label, new_resource_url) %></p>
  51. # app/views/admin/contacts/_table.html.erb ! <%= table.column :full_name %> <%= table.column :twitter

    %> # app/admin/contact.rb ! ActiveAdmin.register Contact do index do column :full_name column :twitter actions end end
  52. # app/controllers/admin/contacts_controller.rb ! class Admin::ContactsController < ApplicationController include RestActionsConcern !

    private ! def permitted_params params.require(:contact).permit(:first_name, :last_name, :twitter) end end ! # app/views/admin/contacts/_form.html.erb ! <%= form.input :first_name %> <%= form.input :last_name %> <%= form.input :twitter %> # app/views/admin/contacts/_table.html.erb ! <%= table.column :full_name %> <%= table.column :twitter %>
  53. recap avoid monoliths concerns view inheritance "unix" gems keep it

    testable trust OOP decomposition single responsibility object composition