Table of Contents

2. Table of Contents
3. Rails controllers
   1. What is the problem with Rails controllers?
      1. Why the focus on controllers?
      2. Testing
      3. The gateway drug - service objects
      4. The Boy Scout rule
      5. Inspiration
   2. Why service objects?
      1. Why not service objects?
   3. What is a Rails service object?
      1. What it's not
   4. Refactoring
      1. Duplicate, duplicate, duplicate
   5. Refactoring and the human factor
      1. Do we really need to change the existing code?
      2. Refactoring takes a lot of time
      3. I wouldn't refactor this part
      4. I would refactor it differently
      5. Summary
   6. Tools
   7. How to use this book
      1. The structure
4. Refactoring recipes
   1. Inline controller filters
      1. Example
      2. Warnings
      3. Resources
   2. Explicitly render views with locals
      1. Introduction
      2. Algorithm
      3. Example
      4. Benefits
      5. Warnings
      6. Resources
   3. Extract render/redirect methods
      1. Introduction
      2. Algorithm
      3. Example
      4. Benefits
      5. Warnings
   4. Extract a Single Action Controller class
      1. Introduction
      2. Algorithm
      3. Example
      4. Benefits
      5. Warnings
      6. Resources
   5. Extract routing constraint
      1. Introduction
      2. Prerequisites
      3. Algorithm
      4. Example
      5. Benefits
      6. Warnings
      7. Resources
   6. Extract an adapter object
      1. Introduction
      2. Algorithm
      3. Example
      4. Benefits
      5. Warnings
      6. Resources
   7. Extract a repository object
      1. Introduction
      2. Prerequisites
      3. Algorithm
      4. Example
      5. Benefits
      6. Warnings
      7. Resources
   8. Extract a service object using the SimpleDelegator
      1. Prerequisites
      2. Algorithm
      3. Example
      4. Benefits
      5. Resources
5. Example: TripReservationsController#create
   1. Extract a service object
      1. Move the whole action code to the service, using SimpleDelegator
      2. Explicit dependencies
      3. What's an external dependency?
      4. Resources
   2. Service - controller communication
      1. How do we deal with failures?
      2. Extracting exceptions
      3. No more controller dependency
      4. Move the service to its own file
      5. Summary
6. Example: logging time
   1. The starting point
      1. The `aha' moment
7. Patterns
   1. Instantiating service objects
      1. Boring style
      2. Modules
      3. Dependor
   2. The repository pattern
      1. ActiveRecord class as a repository
      2. Explicit repository object
      3. No logic in repos
      4. Transactions
      5. The danger of too small repositories
      6. In-memory repository
   3. Wrap external API with an adapter
      1. Introduction
      2. Example
      3. Another long example
      4. Adapters and architecture
      5. Multiple Adapters
      6. Injecting and configuring adapters
      7. One more implementation
      8. The result
      9. Changing underlying gem
      10. Adapters configuration
      11. Testing adapters
      12. Dealing with exceptions
      13. Adapters ain't easy
      14. Summary
   4. 4 ways to early return from a rails controller
      1. 1. redirect_to and return (classic)
      2. 2. extracted_method and return
      3. 2.b extracted_method or return
      4. 3. extracted_method{ return }
      5. 4. extracted_method; return if performed?
      6. throw :halt (sinatra bonus)
      7. throw :halt (rails?)
      8. why not before filter?
   5. Service::Input
8. Testing
   1. Introduction
   2. Good tests tell a story.
   3. Unit tests vs class tests
      1. Class tests slow me down
      2. Test units, not classes
      3. The Billing example
   4. Techniques
      1. Service objects as a way of testing Rails apps (without factory_girl)
9. Related topics
   1. Service controller communication
   2. Naming Conventions
      1. The special .call method
   3. Where to keep services
   4. Routing constraints
      1. Resources
   5. Rails controller - the lifecycle
      1. Accessing instance variables in the view
      2. Resources
10. Appendix
    1. Thank you
11. Bonus
    1. Pretty, short urls for every route in your Rails app
       1. Top level routing for multiple resources
       2. Render or redirect
       3. Top level routing for everything
       4. Is it any good?