Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
REST to RESTful Web Service
Search
SJ Chou
January 13, 2014
Programming
2
200
REST to RESTful Web Service
從混沌的 Web 世界中,回頭探討 HTTP 最初的 REST 架構與精神,想想我們創造了什麼?也忽略了什麼?
SJ Chou
January 13, 2014
Tweet
Share
More Decks by SJ Chou
See All by SJ Chou
用 Keras 玩 Machine Learning
samejack
0
120
2020 MLaaS 產業介紹
samejack
0
27
Linux Container Introduction
samejack
0
20
Cloud Foundry Introduction
samejack
0
42
WordPress Blog SEO 兩三事
samejack
0
59
小猴子也會的 Ubuntu Desktop 14.04 安裝教學
samejack
0
100
軟體品質與持續整合
samejack
1
77
Android_Day_2013_-_Mobile_Web_App_Design.pdf
samejack
0
89
Caching in HTTP
samejack
0
82
Other Decks in Programming
See All in Programming
チーム力を高めるスクラム実践法:カンバン公開と課題攻略について - ニフティのスクラムトーク Vol. 2 - NIFTY Tech Talk #18
niftycorp
PRO
1
110
ゆるい個人開発のススメ
kuroppe1819
10
950
はてなにおける CSS Modules、及び CSS Modules に足りないもの / CSS Modules in Hatena, and CSS Modules missing parts
mizdra
4
580
Rubyでたのしむクリエイティブコーディング/Enjoy Creative coding with Ruby
chobishiba
1
160
[技育CAMPアカデミア]アイディアを形に!【超入門】スマホアプリ開発〜リリースまでの流れをご紹介
teamlab
PRO
0
350
脱・初心者!脱・マネコン!AWS CDKを使ってみませんか!?
har1101
0
300
Elm 0.19.0 Changes
bkuhlmann
0
490
try! Swift Tokyo 2024 参加報告 / try! Swift Tokyo 2024 Report
hironytic
0
180
元気予報
suu_mire0726
0
860
Tailwind CSSを本気でカスタマイズする方法
fsubal
5
1.2k
#phpcon_odawara オープン・クローズドなテストフィクスチャを求めて / open closed test fixtures
77web
3
220
1BRC--Nerd Sniping the Java Community
gunnarmorling
0
300
Featured
See All Featured
Reflections from 52 weeks, 52 projects
jeffersonlam
344
19k
Testing 201, or: Great Expectations
jmmastey
27
6.3k
A Philosophy of Restraint
colly
196
16k
How to name files
jennybc
64
92k
The Brand Is Dead. Long Live the Brand.
mthomps
48
28k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
76
41k
Unsuck your backbone
ammeep
662
57k
Fantastic passwords and where to find them - at NoRuKo
philnash
36
2.5k
Exploring the Power of Turbo Streams & Action Cable | RailsConf2023
kevinliebholz
1
3.4k
What's new in Ruby 2.0
geeforr
337
31k
Designing Experiences People Love
moore
136
23k
No one is an island. Learnings from fostering a developers community.
thoeni
14
2.1k
Transcript
REST to RESTful Web Service sj 2011/09/28
[email protected]
http://blog.toright.com
Representational State Transfer 2000 年 Dr. Roy Fielding 提 出的博士論文
RFC 2616 的基礎 / Web 的聖經
REST 不是標準或協定 REST 是一種軟體設計架構風格 http://www.techcn.com.cn/index.php?doc-view-146097.html
What is RESTful ?? 美麗 (beauty) 的事物可以稱為 Beautiful 同理可證 設計為
REST 的系統我們就稱為 RESTful
How I Explained REST to My Wife 作者:Ryan Tomayko 導讀推薦文章
使用 Internet 是一件簡單且 直覺的動作 就像是豐富的名詞加上多態的動詞
REST 概念介紹
REST Constraints • Client-Server • Stateless - 無狀態設計 • Cacheable
- 可實作快取 • Uniform Interface - 一致性的介面 ◦Identification of resources - 唯一的資源識別 ◦Manipulation of resources - 特定的操作方法 ◦Self-descriptive messages - 訊息自我描述 ◦Hypermedia as the engine of application state - !? • Layered System - 層級式架構 • Code-On-Demand (optional) - 像是 JavaScript
REST Architectural Elements •REST Data Elements •REST Connectors •REST Components
REST Data Elements • Resources and Resource Identifiers 透過一個全域的資源識別命名來對應與實體 (Entity)
間的關 係。 ex: HTTP URL • Representations 在超媒體網路中資源呈現的各種方式 ex: HTTP Content-Type
REST Connectors • Client ex: HTTP Client Library • Server
ex: Apache API • Cache ex: Browser Cache, Network Cache • Resolver ex: DNS lookup • Tunnel ex: SOCKS, SSL
REST Components • User Agent ex: Browser • Origin Server
ex: Apache httpd, M$ IIS • Gateway • Proxy Components 透過 Connectors 進行訊息交換
REST 到底是什麼!? http://futbol1.io.ua/s381473/sistema_super_bystroy_podgotovki_futbolistov_vysshego_klassa
HTTP 本身就是 REST 的實作! http://news.sina.com.tw/books/history/barticle/15368.html
RESTful Web Service
What is RESTful Web Service ?? • 符合 REST Constraints
的 Web Service 設計 Q : HTTP 不就是 REST 的實作了嗎??那到底該怎麼設計 RESTful Web Service ?? A : 只要善用 HTTP 就對了!! http://www.history.com/this-day-in-history/united-states-nicknamed-uncle-sam
傳統 Web Service 設計 •設計書籍管理系統 •新增、刪除、修改、查詢 - CRUD •XML Web
Service
Web Service 傳統設計 (1) • Web Service 網址 /books •
新增書籍 <action>create</action> <book isbn="A0100"> <title>I hate the REST</title> </book> Response : <status>ok|fail</status> • 修改書籍 <action>edit</action> <book isbn="A0100"> <title>I hate REST very much</title> </book> Response : <status>ok|fail</status>
Web Service 傳統設計 (1) • 刪除書籍 <action>delete</action> <isbn>A0010</isbn> Response :
<status>ok|fail</status> • 查詢書籍 <action>search</action> <isbn>A0010</isbn> Response : <status>ok|fail</status>
Web Service 傳統設計 (2) 改良!? • 更直覺的網址、更簡易 XML 內文、更通用的回應格式 <response
code="0" messgae="ok"> <data/> </respone> • 新增書籍 /books/create <book isbn="A0100"> <title>I hate the REST</title> </book> • 修改書籍 /books/update <book isbn="A0100"> <title>I hate REST very much</title> </book>
Web Service 傳統設計 (2) 改良!? • 刪除書籍 /books/delete <isbn>A0010</isbn> •
查詢書籍 /books/get <isbn>A0010</isbn>
Web Service 傳統設計 (3) SOAP SOAP Request <soapenv:Envelope> <soapenv:Body> <req:echo
xmlns:req="http://xxx.com/MyService/"> <req:category>classifieds</req:category> </req:echo> </soapenv:Body> </soapenv:Envelope>
Web Service 傳統設計 (3) SOAP SOAP Response <soapenv:Envelope> <soapenv:Header> <wsa:ReplyTo>
<wsa:Address>http://schemas...</wsa:Address> </wsa:ReplyTo> <wsa:From> <wsa:Address>http://xxx.com/MyService</wsa:Address> </wsa:From> <wsa:MessageID>28BC11433905662036</wsa:MessageID> </soapenv:Header> <soapenv:Body> <req:echo xmlns:req="http://xxx.com/MyService"> <req:category>classifieds</req:category> </req:echo> </soapenv:Body> </soapenv:Envelope>
引述:How I Explained REST to My Wife 很遺憾,多數人為了達到同樣的目標,忙著用不同的方法創造出 複雜且不易使用的設計。不但名詞 (Nouns)
不通用,且動詞 (Verbs) 也不多態。我們拋棄了過去幾十年的失敗經驗,再度重 蹈覆轍。我們使用 HTTP 不僅僅是幫助我們使用網路,而卻忽略 了 HTTP Simplicity 的設計初衷與理念,得到的卻是華而不實 而絢麗的工具。 http://bellsee2.blogspot.tw/2011/01/pagliacci.html
遵循 HTTP 設計 RESTful Web Service • Nouns 為你的資源進行 URL
定義 • Verbs 選擇適合的 Method 動詞 GET, POST, PUT, DELETE • Content Types 選擇 Content-type ex: XML / JSON / HTML http://www.onlamp.com/pub/a/onlamp/2008/02/19/developing-restful-web-services-in-perl.html
RESTful Web Service 規格 功能 URL HTTP Method Resquest Response
Status Code 新增 /books POST <book isbn="A0100"> <title>REST1</title> </book> 200|401 刪除 /books/{isbn} DELETE 200|401|404 修改 /books/{isbn} PUT <book isbn="A0100"> <title>REST2</title> </book> 200|401|404 查詢 /books/{isbn} GET <book isbn="A0100"> <title>REST1</title> </book> 200|404 Content-type:application/xml, allpication/json, text/html
Conclusion 直覺、簡單、快速 再次實作 HTTP 已經擁有的功能是多餘的 善用 HTTP 就是實現 RESTful 的好方法
『簡單』才是系統設計最佳法則
RESTful Web Service Cases Amazon AWS, eBay, Facebook, Yahoo Web
Service, Hadoop API, Google Web Service...
and you !? http://www.superhappiness.com/albert-einstein.html
References • Ryan Tomayko - How I Explained REST to
My Wife • SOUL & SHELL BLOG - 淺談 REST 軟體架構風格 (Part.I) – 從了解 REST 到設計 RESTful! • SOUL & SHELL BLOG - 淺談 REST 軟體架構風格 (Part. II) – 如何設計 RESTful Web Service? • Architectural Styles andthe Design of Network-based Software Architectures
The End Thanks!
[email protected]
http://blog.toright.com