Atlrug intermodal - sep 2011

Intermodal

Ho-Sheng Hsiao
Github: github.com/hosh
Twitter: hosheng

Rails Stopped Innovating

500,000 Android Activated
per day
Source: bit.ly/500k-android-activtions

Computer

500,000 Android Activated
per day
Source: bit.ly/500k-android-activtions

Computer

Rails Stopped Innovating

Platforms
iOS
Android
Blackberry
Windows 8
HP/Palm WebOS

Cross Platform
jQuery Mobile
Sencha
Backbone.js
Spine.js
PhoneGap
Titanium

Rails?

API=Machine Legibility

Write the API First

Write the API First
No Server-Side HTML

Write the API First
No Templates

Write the API First
Just Endpoints

Write the API First
REST

RESTful Endpoints
RESTful
CRUD

RESTful Endpoints
Create
Read
Update
Delete
POST /posts.json
GET /posts/1.json
PUT /posts/1.json
DELETE /posts/1.json
GET /posts.json

RESTful Endpoints
Create
Read
Update
Delete
POST /authors.json
GET /authors/1.json
PUT /authors/1.json
DELETE /authors/1.json
GET /authors.json

See the pattern?

resources :postsresources :authors

POST /posts.json
GET /posts/1.json
PUT /posts/1.json
GET /posts.json

POST /authors.json
GET /authors/1.json
PUT /authors/1.json
DELETE /authors/1.json
GET /authors.json

Intermodal

Intermodal
DSL for API

Intermodal
Not Scaffolding

Intermodal
Three
Common Patterns

Intermodal
Resources

resources :posts

POST /posts.json
GET /posts/1.json
PUT /posts/1.json
GET /posts.json

Intermodal
Nested Resources

# One-to-Many# Post has_many :comments# Comment belongs_to :postnested_resources:post, :comments

POST /posts/1/comments.json
GET /posts/1/comments/1.json
PUT /posts/1/comments/1.json
DELETE /posts/1/comments/1.json
GET /posts/1/comments.json

Intermodal
Linking Resources

# Many-to-Many# Post has_many :authors # :through => :contributions# Author has_many :posts# :through => :contributionslink_resources_from:post, :to =>:authors

POST /posts/1/authors.json
GET /posts/1/authors.json
PUT /posts/1/authors.json
DELETE /posts/1/authors.json

Intermodal
Presenters

presentation_for:postsdo presents :id presents :title presents :content presents :authors => ->(p) { p.authors.map(&:id) }end

{ “post”: { “id”: 1, “title”: “Hello World”, “content”: “Best of Times, Worst of Times”, “authors”: [1,2,3] }}

<post> <id>1</id> <title>1</title> <content>Best of Times, Worst of Times</content> <authors> <author>1</author> <author>2</author> <author>3</author> </authors></post>

Intermodal
Acceptors

acceptance_for:postsdo accepts :title accepts :contentend

acceptance_for:postsdo accepts :title accepts :contentend# Does not accept :id# Does not accept :authors

acceptance_for:postsdo accepts :title accepts :contentend# Passes only :title and :content# from params to#Post#update_attributes

Intermodal
Testing

Intermodal
Test the API
Not the Controller

Intermodal
Send
Rack Request

POST /posts.json
GET /posts/1.json
PUT /posts/1.json
GET /posts.json

Intermodal
ExpectRack Response

POST /posts.json 201 Created
GET /posts/1.json 200 OK
PUT /posts/1.json 200 OK
DELETE /posts/1.json 200 OK
GET /posts.json 200 OK

POST /posts.json utf8 json
GET /posts/1.json utf8 json
PUT /posts/1.json utf8 json
DELETE /posts/1.json utf8 json
GET /posts.json utf8 json

POST /posts.json Create
GET /posts/1.json Read
PUT /posts/1.json Update
DELETE /posts/1.json Delete
GET /posts.json Index

Intermodal
CRUD specs

resources ’posts' dogiven_create_attributes:title => 'New Post', :account_id=> 1 given_update_attributes:name => 'Updated Post’expects_resource_crudend

Intermodal
CRUD specs
for
Nested Resource

resources [:posts, :comments] dogiven_create_attributes:title => 'New Comment', :account_id=> 1 given_update_attributes:name => 'Updated Comment’expects_resource_crudend

Intermodal
CRUD specs
for
Linked Resource

link_resource:post, :to => :authors, :with => Contributiondolet(:model_collection) do contributions post.authors.to_author_idsendlet(:unlinked_targets) { Author.make(3, :account => account) }expects_crud_for_linked_resourceend

Caveats

Extracted from Production

Yes, but …

Caveats
Installation sucks
No independent specs
Non-existent documentation
No Rails 3.1 support (yet)
No Ruby 1.9.2 support (yet)

Rails Stopped Innovating?

github.com/hosh/intermodal
Questions?
Ho-Sheng Hsiao

Atlrug intermodal - sep 2011

by hosheng on Sep 16, 2011

Accessibility

Categories

Tags

Upload Details

Usage Rights

1 Embed 3

Statistics

Atlrug intermodal - sep 2011 — Presentation Transcript