+1
+1
+1
+1
+1 +1
+1
+1 +1 +1
+1
+1
+1
+1 +1
+1 +1
+1
+1
+1
+1 +1
+1 +1
1

Jon Crosby
http://joncrosby.me

Engine Yard Solo
“The platform for
on-demand management of your
Ruby on Rails application
in the cloud.”

We’re Hiring

CloudKit

Open Web
JSON
Appliance

Open Web
JSON
Appliance

RESTful Collections
of
JSON Documents

CouchDB
Persevere

Ruby

$ gem install cloudkit

WayOfThinking.new

WayOfThinking.web

2009

if (developer.building_web_framework?) {
MVCAbstraction.new
}

Rails 3

Rails 3 => API

framework = {
:orm => AR
:dispatcher => AD}.merge(
:orm => YourORM)

framework = {
:orm => AR
:dispatcher => AD}.merge(
:orm => YourORM)

framework = {
:orm => AR
:dispatcher => AD}.merge(
:orm => YourORM)

! MVC

! MVC “in the back?”

RESTful Application Architectures

RADAR
Dave Thomas
http://pragdave.pragprog.com/pragdave/2007/03/the_radar_archi.html

Resource Composition in the Browser
A.S.
Focus

Resource Composition in the Browser
A.S.
Focus

Resource Composition in the Browser
A.S.
Focus

Cappuccino
http://280slides.com

Sproutcore
http://sproutcore.com

Desktop / Mobile Apps

ESI
Caching Layer
REST
Fragment A Service
Client
REST
Fragment B
Service

jQueryUI
Dojo
MooTools

WayOfThinking.web

Rack

The Web

HTTP

Intermediaries
HTTP

Intermediaries App
HTTP

Intermediaries App
HTTP

Intermediaries Rack
HTTP

HTTP

Intermediaries
HTTP

Middleware
HTTP

Middleware App
HTTP

Rack is the Web

Constraints

Constraints => Interface

Constraints => Interface => SPEC

CloudKit

REST

Roy Fielding
Architectural Styles and the
Design of Network-based Software Architectures
http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm

Build An App

config.ru

require ‘cloudkit’
expose :todos, :profiles

Done

$ rackup config.ru

$ curl -i http://localhost:9292/cloudkit-meta

$ curl -i http://localhost:9292/cloudkit-meta
HTTP/1.1 200 OK
ETag: \"5b6f484abf2d95cec3ea8867d1754418\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 33
{\"uris\":[\"\\/todos\",\"\\/profiles\"]}

$ curl -i -XOPTIONS http://localhost:9292/todos

$ curl -i -XOPTIONS http://localhost:9292/todos
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0
Allow: GET, HEAD, POST, OPTIONS

$ curl -i http://localhost:9292/todos

$ curl -i http://localhost:9292/todos
HTTP/1.1 200 OK
ETag: \"df392c5664e6ecd64b83210fb925f6c8\"
Link: <http://localhost:9292/todos/_resolved>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 32
{\"uris\":[],\"total\":0,\"offset\":0}

$ curl -i http://localhost:9292/todos
HTTP/1.1 200 OK
ETag: \"df392c5664e6ecd64b83210fb925f6c8\"
Link: <http://localhost:9292/todos/_resolved>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 32
{\"uris\":[],\"total\":0,\"offset\":0}

$ curl -i http://localhost:9292/todos
HTTP/1.1 200 OK
ETag: \"df392c5664e6ecd64b83210fb925f6c8\"
Link: <http://localhost:9292/todos/_resolved>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 32
{\"uris\":[],\"total\":0,\"offset\":0}

$ curl -i http://localhost:9292/todos
HTTP/1.1 200 OK
ETag: \"df392c5664e6ecd64b83210fb925f6c8\"
Link: <http://localhost:9292/todos/_resolved>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 32
{\"uris\":[],\"total\":0,\"offset\":0}

Link Relations and HTTP Header Linking
IETF Draft by Mark Nottingham
http://tools.ietf.org/html/draft-nottingham-http-link-header-04

Hypermedia
as the
Engine of Application State
-- Fielding

Connectedness
-- Richardson, Ruby

$ curl -i -XPOST -d'{\"title\":\"foo\"}' \\
http://localhost:9292/todos

$ curl -i -XPOST -d'{\"title\":\"foo\"}' \\
http://localhost:9292/todos
HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 159
{
\"ok\":true,
\"uri\":\"\\/todos\\/9216df80-0c7b-012c-af2e-0023dfa0a208\",
\"etag\":\"9216dde0-0c7b-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:13:04 GMT\"
}

Read-optimized

HTTP-Oriented Storage

Metadata
+
Document

URI, ETag, Last-Modified, etc.
+
Document

SQL

ORM

Tokyo Cabinet

Tokyo Cabinet Tables

todos[“random_id”] = {
“uri” => “/todos/abc”,
“etag” => “9216dde0-0c7b-012c”,
“last_modified” => “Thu, 16 Apr 2009 06:13:04 GMT”,
“remote_user” => “http://joncrosby.me”,
“json” => “{\\”title\\”:\\”foo\\”}”,
...
}

Rufus::Tokyo
record = store.query { |q|
q.add_condition(“uri”, :eql, “/todos/abc”)
}

Schema-free

*
Schema-free

HTTP and JSON
are the Schema

$ curl -i -XPUT -d'{\"title\":\"bar\"}' \\
http://localhost:9292/todos/abc

$ curl -i -XPUT -d'{\"title\":\"bar\"}' \\
http://localhost:9292/todos/abc
HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 126
{
\"ok\":true,
\"uri\":\"\\/todos\\/abc\",
\"etag\":\"f4538ca0-0c7b-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:15:49 GMT\"
}

$ curl -i -XOPTIONS http://localhost:9292/todos/abc

$ curl -i -XOPTIONS http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0
Allow: GET, HEAD, PUT, DELETE, OPTIONS

$ curl -i http://localhost:9292/todos/abc

$ curl -i http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:15:49 GMT
ETag: \"f4538ca0-0c7b-012c-af2e-0023dfa0a208\"
Link: <http://localhost:9292/todos/abc/versions>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/versions\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 15
{\"title\":\"bar\"}

$ curl -i http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:15:49 GMT
ETag: \"f4538ca0-0c7b-012c-af2e-0023dfa0a208\"
Link: <http://localhost:9292/todos/abc/versions>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/versions\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 15
{\"title\":\"bar\"}

$ curl -i http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:15:49 GMT
ETag: \"f4538ca0-0c7b-012c-af2e-0023dfa0a208\"
Link: <http://localhost:9292/todos/abc/versions>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/versions\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 15
{\"title\":\"bar\"}

$ curl -i http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:15:49 GMT
ETag: \"f4538ca0-0c7b-012c-af2e-0023dfa0a208\"
Link: <http://localhost:9292/todos/abc/versions>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/versions\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 15
{\"title\":\"bar\"}

Auto-versioning

/:collection
/:collection/:uuid
/:collection/:uuid/versions
/:collection/:uuid/versions/:etag

/:collection
/:collection/:uuid
/:collection/:uuid/versions
/:collection/:uuid/versions/:etag

/:collection
/:collection/:uuid
/:collection/:uuid/versions
/:collection/:uuid/versions/:etag

/:collection
/:collection/:uuid
/:collection/:uuid/versions
/:collection/:uuid/versions/:etag

/:collection
/:collection/:uuid
/:collection/:uuid/versions
/:collection/:uuid/versions/:etag

$ curl -i http://localhost:9292/todos

$ curl -i http://localhost:9292/todos
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:15:49 GMT
ETag: \"0aca58964aa2e15a9365d72dd4c43472\"
Link: <http://localhost:9292/todos/_resolved>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 94
{
\"uris\":[
\"\\/todos\\/abc\",
\"\\/todos\\/9216df80-0c7b-012c-af2e-0023dfa0a208\"
],
\"total\":2,
\"offset\":0
}

Lost Update Problem:

Lost Update Problem: Solved

2 Users

2 Users
2 Browsers

2 Users
2 Browsers
1 Document

2 Users
2 Browsers
1 Document
Fight!

2 Users
2 Browsers
1 Document
Hand Wave!

$ curl -i -XPUT -d'{\"title\":\"baz\"}' \\
http://localhost:9292/todos/abc

$ curl -i -XPUT -d'{\"title\":\"baz\"}' \\
http://localhost:9292/todos/abc
HTTP/1.1 400 Bad Request
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 25
{\"error\":\"etag required\"}

$ curl -i -XPUT \\
-H'If-Match:f4538ca0-0c7b-012c-af2e-0023dfa0a208' \\
-d'{\"title\":\"baz\"}' \\
http://localhost:9292/todos/abc

$ curl -i -XPUT \\
-H'If-Match:f4538ca0-0c7b-012c-af2e-0023dfa0a208' \\
-d'{\"title\":\"baz\"}' \\
http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 126
{
\"ok\":true,
\"uri\":\"\\/todos\\/abc\",
\"etag\":\"55286040-0c7d-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:25:41 GMT\"
}

$ curl -i -XPUT \\
-H'If-Match:f4538ca0-0c7b-012c-af2e-0023dfa0a208' \\
-d'{\"title\":\"box\"}' \\
http://localhost:9292/todos/abc

$ curl -i -XPUT \\
-H'If-Match:f4538ca0-0c7b-012c-af2e-0023dfa0a208' \\
-d'{\"title\":\"box\"}' \\
http://localhost:9292/todos/abc
HTTP/1.1 412 Precondition Failed
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 31
{\"error\":\"precondition failed\"}

$ curl -i http://localhost:9292/todos/abc/versions

$ curl -i http://localhost:9292/todos/abc/versions
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:25:41 GMT
ETag: \"f7aae4894429a39c7c3fe0c8ea9aa00e\"
Link: <http://localhost:9292/todos/abc/versions/_resolved>;
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 109
{
\"uris\":[
\"\\/todos\\/abc\",
\"\\/todos\\/abc\\/versions\\/f4538ca0-0c7b-012caf2e-0023dfa0a208\"
],
\"total\":2,
\"offset\":0
}

$ curl -i http://localhost:9292/todos/abc/versions
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:25:41 GMT
ETag: \"f7aae4894429a39c7c3fe0c8ea9aa00e\"
Link: <http://localhost:9292/todos/abc/versions/_resolved>;
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 109
{
\"uris\":[
\"\\/todos\\/abc\",
\"\\/todos\\/abc\\/versions\\/f4538ca0-0c7b-012caf2e-0023dfa0a208\"
],
\"total\":2,
\"offset\":0
}

Why _resolved?

O(n)

1000 documents = 1001 GETs

:-(

Time to rewrite in Scala?

$ curl -i http://localhost:9292/todos/abc/versions/_resolved

$ curl -i http://localhost:9292/todos/abc/versions/_resolved
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:25:41 GMT
ETag: \"ea2238f8f2da37b70f3d2f09464f166e\"
Link: <http://localhost:9292/todos/abc/versions>; rel=\"index\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 384
{
\"documents\":[
{
\"etag\":\"55286040-0c7d-012c-af2e-0023dfa0a208\",
\"uri\":\"\\/todos\\/abc\",
\"last_modified\":\"Thu, 16 Apr 2009 06:25:41 GMT\",
\"document\":\"{\\\"title\\\":\\\"baz\\\"}\"
},
{
\"etag\":\"f4538ca0-0c7b-012c-af2e-0023dfa0a208\",
\"uri\":\"\\/todos\\/abc\\/versions\\/f4538ca0-0c7b-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:15:49 GMT\",
\"document\":\"{\\\"title\\\":\\\"bar\\\"}\"
}
],
\"total\":2,
\"offset\":0
}

$ curl -i http://localhost:9292/todos/abc/versions/_resolved
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:25:41 GMT
ETag: \"ea2238f8f2da37b70f3d2f09464f166e\"
Link: <http://localhost:9292/todos/abc/versions>; rel=\"index\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 384
{
\"documents\":[
{
\"etag\":\"55286040-0c7d-012c-af2e-0023dfa0a208\",
\"uri\":\"\\/todos\\/abc\",
\"last_modified\":\"Thu, 16 Apr 2009 06:25:41 GMT\",
\"document\":\"{\\\"title\\\":\\\"baz\\\"}\"
},
{
\"etag\":\"f4538ca0-0c7b-012c-af2e-0023dfa0a208\",
\"uri\":\"\\/todos\\/abc\\/versions\\/f4538ca0-0c7b-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:15:49 GMT\",
\"document\":\"{\\\"title\\\":\\\"bar\\\"}\"
}
],
\"total\":2,
\"offset\":0
}

$ curl -i http://localhost:9292/todos/_resolved

$ curl -i http://localhost:9292/todos/_resolved
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:25:41 GMT
ETag: \"59edaebe03b5fe90fa59ef6de633afce\"
Link: <http://localhost:9292/todos>; rel=\"index\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 369
{
\"documents\":[
{
\"etag\":\"55286040-0c7d-012c-af2e-0023dfa0a208\",
\"uri\":\"\\/todos\\/abc\",
\"last_modified\":\"Thu, 16 Apr 2009 06:25:41 GMT\",
\"document\":\"{\\\"title\\\":\\\"baz\\\"}\"
},
{
\"etag\":\"9216dde0-0c7b-012c-af2e-0023dfa0a208\",
\"uri\":\"\\/todos\\/9216df80-0c7b-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:13:04 GMT\",
\"document\":\"{\\\"title\\\":\\\"foo\\\"}\"
}
],
\"total\":2,
\"offset\":0
}

$ curl -i -XDELETE \\
-H'If-Match:55286040-0c7d-012c-af2e-0023dfa0a208' \\
http://localhost:9292/todos/abc

$ curl -i -XDELETE \\
-H'If-Match:55286040-0c7d-012c-af2e-0023dfa0a208' \\
http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 92
{
\"ok\":true,
\"uri\":\"\\/todos\\/abc\\/versions\\/55286040-0c7d-012c-af2e-0023dfa0a208\",
\"etag\": \"55286040-0c7d-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:33:50 GMT\"
}

$ curl -i -XDELETE \\
-H'If-Match:55286040-0c7d-012c-af2e-0023dfa0a208' \\
http://localhost:9292/todos/abc
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 92
{
\"ok\":true,
\"uri\":\"\\/todos\\/abc\\/versions\\/55286040-0c7d-012c-af2e-0023dfa0a208\",
\"etag\": \"55286040-0c7d-012c-af2e-0023dfa0a208\",
\"last_modified\":\"Thu, 16 Apr 2009 06:33:50 GMT\"
}

$ curl -i http://localhost:9292/todos/abc

$ curl -i http://localhost:9292/todos/abc
HTTP/1.1 410 Gone
Link: <http://localhost:9292/todos/abc/versions>;
rel=\"http://joncrosby.me/cloudkit/1.0/rel/versions\"
Cache-Control: no-cache
Content-Type: application/json
Content-Length: 37
{\"error\":\"entity previously deleted\"}

$ curl -i http://localhost:9292/todos/abc/versions

$ curl -i http://localhost:9292/todos/abc/versions
HTTP/1.1 200 OK
Last-Modified: Thu, 16 Apr 2009 06:25:41 GMT
ETag: \"22116ccbc80e6356aec956be63c9c440\"
Link: <http://localhost:9292/todos/abc/versions/_resolved>; \\
rel=\"http://joncrosby.me/cloudkit/1.0/rel/resolved\"
Cache-Control: proxy-revalidate
Content-Type: application/json
Content-Length: 157
{
\"uris\":[
\"\\/todos\\/abc\\/versions\\/55286040-0c7d-012c-af2e-0023dfa0a208\",
\"\\/todos\\/abc\\/versions\\/f4538ca0-0c7b-012c-af2e-0023dfa0a208\"
],
\"total\":2,
\"offset\":0
}

Uniform Interface

RESTful Collections

Addressable Nouns

Manipulate with HTTP Methods

Expose Relationships with Links

Fully Discoverable API

What’s Missing?

Ability to Ask Questions

Pagination
/todos?page=2&limit=50

Querying
/todos?user=http://joncrosby.me
/todos?only=title

Uniform Interface

Uniform Interface
... for querying?

JSONQuery
Kris Zyp
http://www.sitepen.com/blog/2008/07/16/jsonquery-data-querying-beyond-jsonpath/

XPath

XPath=> JSONPath
http://goessner.net/articles/JsonPath/

Array Slice Operators
/todos[10:20]

Array Slice Operators
/todos[10:20:2]

Comparisons
/todos[?priority>=3]

Chained Expressions
/todos[?priority>=3][0:5]

Extractions
/todos[=name]

Sorting
/todos[/priority][\\name]

Recursive Finders
/todos[objectid..firstName]

Unions
/todos[?foo=‘bar’,rating=4]

JSONQuery.js
http://github.com/jcrosby/jsonquery

jquery.cloudkit.js
http://github.com/jcrosby/jquery-cloudkit

var store = $.cloudkit;
store.boot({
success: function() {
// do something
},
error: function(status) {
// fail gracefully
}
});

var store = $.cloudkit;
store.boot({
success: function() {
// do something
},
error: function(status) {
// fail gracefully
}
});

var store = $.cloudkit;
store.boot({
success: function() {
// do something
},
error: function(status) {
// fail gracefully
}
});

store.boot
1) Local collection per remote collection
2) Loads remote data

store.boot
1) Local collection per remote collection
2) Loads remote data

store.boot
1) Local collection per remote collection
2) Loads remote data

var store = $.cloudkit;
store.boot({
success: function() {
// do something
},
error: function(status) {
// fail gracefully
}
});

var store = $.cloudkit;
store.boot({
success: function() {
// do something
},
error: function(status) {
// fail gracefully
}
});

// insert a 'todo'
store.collection('todos').create({name:\"foo\"}, {
success: function(todo) {
// do something with the todo
alert(todo.json().name);
}
});

// insert a 'todo'
store.collection('todos').create({name:\"foo\"}, {
success: function(todo) {
// do something with the todo
alert(todo.json().name);
}
});

// insert a 'todo'
store.collection('todos').create({name:\"foo\"}, {
success: function(todo) {
// do something with the todo
alert(todo.json().name);
}
});

// insert a 'todo'
store.collection('todos').create({name:\"foo\"}, {
success: function(todo) {
// do something with the todo
alert(todo.json().name);
}
});

// insert a 'todo'
store.collection('todos').create({name:\"foo\"}, {
success: function(todo) {
// do something with the todo
alert(todo.json().name);
}
});

// update the 'todo'
todo.update({name:\"bar\"} {
success: function() {
// updated remotely, ready for use
alert(todo.json().name); // now “bar”
},
error: function(status) {
// fail gracefully or recover
}
});

// update the 'todo'
todo.update({name:\"bar\"} {
success: function() {
// updated remotely, ready for use
alert(todo.json().name); // now “bar”
},
error: function(status) {
// fail gracefully or recover
}
});

// update the 'todo'
todo.update({name:\"bar\"} {
success: function() {
// updated remotely, ready for use
alert(todo.json().name); // now “bar”
},
error: function(status) {
// fail gracefully or recover
}
});

// update the 'todo'
todo.update({name:\"bar\"} {
success: function() {
// updated remotely, ready for use
alert(todo.json().name); // now “bar”
},
error: function(status) {
// fail gracefully or recover
}
});

// update the 'todo'
todo.update({name:\"bar\"} {
success: function() {
// updated remotely, ready for use
alert(todo.json().name); // now “bar”
},
error: function(status) {
// fail gracefully or recover
}
});

Recovery
410 => Remove Locally? Create New?

Recovery
410 => Remove Locally? Create New?
412 => Progressive Diff/Merge

Recovery
410 => Remove Locally? Create New?
412 => Progressive Diff/Merge (Sync)

// delete the 'todo'
todo.destroy({
success: function() {
// the 'todo' has now been deleted
}
});

// delete the 'todo'
todo.destroy({
success: function() {
// the 'todo' has now been deleted
}
});

// delete the 'todo'
todo.destroy({
success: function() {
// the 'todo' has now been deleted
}
});

// delete the 'todo'
todo.destroy({
success: function() {
// the 'todo' has now been deleted
}
});

store.collection('todos').query(\"?name='foo'\");

Johnson
Ruby/JavaScript Bridge
http://github.com/jbarnette/johnson

1.0 Roadmap

JSONSchema
/:collection/_schema
http://www.json.com/json-schema-proposal/

{
\"description\":\"A person\",
\"type\":\"object\",
\"properties\": {
\"name\": {
\"type\":\"string\"
},
\"age\": {
\"type\":\"integer\",
\"maximum\":125
}
}
}

Open Web
JSON
Appliance

Open Web
JSON
Appliance

require ‘cloudkit’
expose :todos, :profiles

require ‘cloudkit’
contain :todos, :profiles

OpenID
+
OAuth
+
OAuth/Discovery

Browser
OAuth OpenID Service

Browser
OAuth OpenID Service

Browser
{...}
OAuth OpenID Service

Browser
OAuth OpenID Service

Browser
OAuth OpenID Service
{...}
Login

Browser
OAuth OpenID Service

Browser
OAuth OpenID Service

Browser
OAuth OpenID Service

Service or Desktop App
OAuth OpenID Service

Service or Desktop App
OAuth OpenID Service

Service or Desktop App
{...}
OAuth OpenID Service

Service or Desktop App
OAuth OpenID Service

Service or Desktop App
OAuth OpenID Service
{...}
Login

curl -i http://localhost:9292/todos
HTTP/1.1 401 Unauthorized
Connection: close
Date: Thu, 15 Jan 2009 22:24:23 GMT
WWW-Authenticate: OAuth realm=\"http://localhost:9292\"
Link: <http://localhost:9292/oauth/meta>;
rel=\"http://oauth.net/discovery/1.0/rel/provider\"
Content-Type: text/html
Set-Cookie: rack.session=d6b1c6aa6d463a478eb9af0e921eb997;
path=/; HttpOnly
Content-Length: 1280
<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\"
\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">
<html xmlns=\"http://www.w3.org/1999/xhtml\" xml:lang=\"en\" lang=\"en\">
... etc ...

$ curl -i http://localhost:9292/oauth/meta

$ curl -i http://localhost:9292/oauth/meta
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<XRD>
<Type>http://oauth.net/discovery/1.0</Type>
<Service>
<Type>http://oauth.net/discovery/1.0/rel/provider</Type>
<URI>http://localhost:9292/oauth</URI>
</Service>
</XRD>

$ curl -i http://localhost:9292/oauth

(squint)

<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<XRDS xmlns=\"xri://$xrds\">
<XRD xml:id=\"oauth\" xmlns:simple=\"http://xrds-simple.net/core/1.0\" xmlns=\"xri://$XRD*($v*2.0)\" version=\"2.0\">
<Type>xri://$xrds*simple</Type>
<Expires>2009-02-14T22:27:50Z</Expires>
<Service priority=\"10\">
<Type>http://oauth.net/core/1.0/endpoint/request</Type>
<Type>http://oauth.net/core/1.0/parameters/auth-header</Type>
<Type>http://oauth.net/core/1.0/parameters/uri-query</Type>
<Type>http://oauth.net/core/1.0/signature/PLAINTEXT</Type>
<URI>http://localhost:9292/oauth/request_tokens</URI>
</Service>
<Service priority=\"10\">
<Type>http://oauth.net/core/1.0/endpoint/authorize</Type>
<Type>http://oauth.net/core/1.0/parameters/uri-query</Type>
<URI>http://localhost:9292/oauth/authorization</URI>
</Service>
<Service priority=\"10\">
<Type>http://oauth.net/core/1.0/endpoint/access</Type>
<Type>http://oauth.net/core/1.0/parameters/auth-header</Type>
<Type>http://oauth.net/core/1.0/parameters/uri-query</Type>
<Type>http://oauth.net/core/1.0/signature/PLAINTEXT</Type>
<URI>http://localhost:9292/oauth/access_tokens</URI>
</Service>
<Service priority=\"10\">
<Type>http://oauth.net/core/1.0/endpoint/resource</Type>
<Type>http://oauth.net/core/1.0/parameters/auth-header</Type>
<Type>http://oauth.net/core/1.0/parameters/uri-query</Type>
<Type>http://oauth.net/core/1.0/signature/HMAC-SHA1</Type>
</Service>
<Service priority=\"10\">
<Type>http://oauth.net/discovery/1.0/consumer-identity/static</Type>
<LocalID>cloudkitconsumer</LocalID>
</Service>
</XRD>
<XRD xmlns=\"xri://$XRD*($v*2.0)\" version=\"2.0\">
<Type>xri://$xrds*simple</Type>
<Service priority=\"10\">
<Type>http://oauth.net/discovery/1.0</Type>
<URI>#oauth</URI>
</Service>
</XRD>
</XRDS>

Service or Desktop App
OAuth OpenID Service

Service or Desktop App
OAuth OpenID Service

Service or Desktop App
OAuth OpenID Service

Service or Desktop App
OAuth OpenID Service

1.0

JSONQuery Release

JSONSchema Release

Templating

Done

CloudKit
http://getcloudkit.com
http://joncrosby.me