RESTful

REpresentational State Transfer

Agenda
●
簡介 REST
●
Example

Types of Web Services
●
There are mainly two types of web
services.
–
SOAP web services.
–
RESTful web services.

REST 簡介
●
REST 是一種軟體架構風格，全名是
REpresentational State Transfer ，可譯為
表徵狀態轉移。
●

What is RESTful
●
符合 REST Constraint 的系統
–
Client–server
–
Stateless
–
Cacheable
–
Layered system
–
Code on demand (optional)
–
Uniform interface
–

RESTful Web Services
●
又稱 RESTful Web API ，以 HTTP 為基礎
–
所有的 API 或是以 Resource 的形式存在，例
如 htttp://www.example.com/products/12345
–
這個服務可以接受與返回某個 MIME-TYPE ，
最常見的是 JSON 格式，也可以回傳
PNG/JPG/TXT 等格式。
–
對資源的操作會支援各種請求方法 ( 例如
GET, POST, PUT, DELETE)
●

實際案例
●
假設我們系統有個 product 類型的資源。那
麼取得所有的 products ：
–
GET http://www.example.com/products
●
●
取得某個 product id 的 product ：
–
GET http://www.example.com/products/12345
●

實際案例
●
新增一個 product ：
–
POST http://www.example.com/products
–
{
●
{'name': 'foo'}, {'price': 1000}
–
}
●

實際案例
●
更新一個 proudct ：
–
PUT http://www.example.com/products/12345
–
{
–
{'inventory': 5}
–
}

JAX-RS
●
Java API for RESTful Web Services
●
Java 對 RESful Web Service 的解決方案

Sample Application
●
假設我們有一個簡單的 hello 的
resource ，他的 URI 可能是：
–
http:///localhost:8080/hello/codedata
●
我們希望輸出是：
–
Hello, codedata
●

Sample Application
●
程式碼可能如下：
–
@Path("/hello")
–
public class HelloRS
–
@GET
–
@Path("/{name}")
–
public String sayHello(@PathParam("name") String name) {
●
return "Hello, " + name;
–
}
–
}

架設可執行 RESTful API 與程式設計環境
●
JAX-RS 的技術跟 Java Web Service ，它只提供了技術標準，可以允許各家廠
商有自己的實作，本次教學用的 Jersey 就是實作之一。
●
可執行 RESTful API 與程式設計的環境需要兩項元素
–
Java Web Service
–
Jersey
●
使用 Java Web Service 需要有以下四個要素
–
(1) JDK 7
–
(2) Eclipse IDE for Java EE Developers
–
(3) Apache Tomcat
–
(4) Axis 2 服務包

安裝 Java Web Service 所需環境
●
安裝 JDK
Step 1. 先看自己的電腦為查 32 Bit 或 64 Bit ，到
http://www.oracle.com/technetwork/java/javase/downloads/index.html
下載符合自己電腦的 JDK ，我的作業系統是 Win7 X64, 所以我下載的
是 jdk-8u60-windows-x64.exe 。

Step 2. 下載完後，執行 exe ，進行安裝。檔
Step 3.
到 C:Program FilesJava 找剛剛所安裝的 JDK 版本資料夾，以本範例為
C:Program FilesJavajdk1.7.0_80 。
接著，複製 C:Program FilesJavajdk1.7.0_80bin 路徑。
Step 4.
我的電腦 > 右鍵容內 > 進階系統設定 > 「進階」頁籤 > 環境變數。

Step 5.
系統變數 >Path> 編輯。
Step 6.
在變數上加上一個「值 ; 」分號後，再
把剛剛
複製的 C:Program
FilesJavajdk1.7.0_80bin 路徑
貼上去。

Step 7.
看查 JDK 是否安裝與設定成功。開始 > 執行 >CMD> 打開命令
提示字元，輸入 java>Enter 會出現一堆訊息，代表 JDK 已安裝
與設定成功。

2. 安裝 Eclipse IDE for Java EE Developers
Step 1.
下載 Eclipse IDE for Java EE Developers ，下載前請先確認自己電
腦是 32 Bit 或 64 Bit ，下載位置
https://eclipse.org/downloads/

3. 安裝 Apache Tomcat
Step 1.
到 http://tomcat.apache.org/download-80.cgi 下載 32-bit/64-bit
Windows Service Installer 。
Step 2.
安裝 Tomcat 8 ，選取所需要安裝的項目。

Step 3.
設定 HTTP 的 Port ：本範例用
預設 8080 ，設定 Tomcat 的帳
號
密碼，按下 Next 。
Step 4.
選擇所下載 jre 的位置，本範例
路徑為
C:Program FilesJavajre7 ，按
下 Next

Step 5.
選擇 Tomcat 安裝的路徑，
本範例路徑為 D:Program Files
Apache Software Foundation
Tomcat 8.0 ，按下 Install 。
Step 6.
開始 > 所有程式 >
Apache Tomcat 8.0 Tomcat8 >
Configure Tomcat ，按下
Start ，
開服務。啟

Step 7.
在瀏覽器上打上 http://localhost:8080，看到以下畫面代表服務安
裝成功。

建立 Dynamic Web Project
Step1. File → New → Dynamic Web Project

建立 Dynamic Web Project
●
web.xml deployment descriptor

AddJersey JARs
●
Copy all JARs from your Jersey download
into the WEB-INF/lib folder.

Hello RESTful
●
Create Class
–
Hello.java
●
Define Jersey Servlet dispatcher
–
web.xml
●
Run your rest service
–
http://localhost:8080/HiRESTful/rest/hello/goo
d

Create a client
●
Create a new Java project
HiRESTfulClient and add the Jersey JARs
to the project and the project build path.
Create the following test class
–
Test.java

RESTful Web Service Cases
●
Amazon AWS
●
Facebook
●
Yahoo Web Service
●
Hadoop API
●
Google Web Service
●
...etc

Contact
●
E-mail: pinglunliao [at] gmail [dot] com
●
LINE: Holan.Liao

References
●
http://www.dsc.com.tw/newspaper/46/46-1.ht
●

RESTful

Recomendados

Recomendados

Mais conteúdo relacionado

Mais procurados

Mais procurados (20)

Semelhante a RESTful

Semelhante a RESTful (20)

Mais de PingLun Liao

Mais de PingLun Liao (20)

RESTful