fbpx

Restlet 實作教學 - Representational State Transfer Web Service


Introduction

REST(Representational State Transfer)是一種分散式超媒體系統(如WWW)的軟體架構風格,你可以想像它是一個良好設計的Web應用程式規則。
REST 所描述的網路系統包括三個部份:

  • Data elements (resource, resource identifier, representation)
  • Connectors (client, server, cache, resolver, tunnel)
  • Domponents (origin server, gateway, proxy, user agent)

REST Principles

Data elements 由標準化介面存取

Components 透過介面傳輸 資源表徵 (representations of resources) 來溝通,而不是直接操作資源本身。

Connectors 提供 component 的抽象介面來溝通,隱藏溝通機制的實作細節。

REST符合以下幾個條件:

應用程式的狀態跟功能拆成 resources
每個 Resource 使用 URI 作為獨一無二的定址方式
所有 Resources 共用相同的介面在 Client 跟 Resource 之間轉換狀態,包括:

A. 定義操作 well-defined operations (在HTTP中即 GET/POST/PUT/DELETE)

B. 有限的內容格式 content types

REST包含以下特色:

A. Client/Server 架構
B. Stateless 狀態無關
C. Cacheable 快取能力
D. Layered 分層能力

符合 REST principles 的系統稱做 RESTful。

Lightweight REST framework, Restlet API

官方網站 http://www.restlet.org/

Restlet on Jetty Implement

載入相關Jar檔

    • org.restlet.jar
    • com.noelios.restlet.jar
    • com.noelios.restlet.ext.servlet.jar

以Eclipse開啟Dynamic Web Project新專案

新增EntryApplication.java

新增HelloWorldResource.java

新增UserResource.java

 編輯 web.xml

 專案的結構如下圖

執行Jetty與測試 http://127.0.0.1:8080/restlet/ 沒有輸入資源位置,自動轉換至預設處理Class,畫面顯示Hello,world

http://127.0.0.1:8080/restlet/users/mary 以資源位置處理相關的功能