前言:
REST使用URL實現資源定位。資源地址的設計是非常謹慎的。如果設計不好,不但REST接口的風格沒法統1,使得系統的擴大性和易用性下降,也很難實現資源的準肯定位。1個URL和Http方法,可以唯1肯定1個資源,但是1個資源可以具有多個URL,例如軟件的最新版本為2.0.那末最新版本的URL和2.0版本的URL就指向同1個資源。
1:資源地址設計
(1)資源路徑示例
http://192.168.1.183:8080/ecm/rest/users?page=1&per_page=10&name=亮
整體模式為:scheme://host:port/path?queryString
其中http表示協議名稱,通常是HTTP或HTTPS;
host表示主機名稱或IP地址
port表示端口
path資源地址
queryString查詢字符串,方法作用域信息。使用&分割查詢條件,使用逗號分割有次序作用域信息,使用分號分割無次序作用域信息。
示例中ecm表示ContextPath利用名稱
rest表示ServletPath
users?page=1&per_page=10&name=亮是PathInfo信息。
(2)作用域demo
Url:http://192.168.1.183:8080/ecm/rest/test/01,2014⑴2,2015
查詢2014-01到2015⑴2的測試數據
Api定義:
測試結果:
(3):PathSegment路徑片斷獲得子資源
獲得java和php語言關于web編程的數據。
http://192.168.1.183:8080/ecm/rest/test/編程;language=java,php;type=web
@GET
@Path("{condition}")
@Produces("application/json;charset=utf⑻")
public Response test4(@PathParam("condition") final PathSegment condition)
throws Throwable {
MultivaluedMap<String, String> matrixParameters = condition
.getMatrixParameters();
Iterator<Entry<String, List<String>>> iterator = matrixParameters
.entrySet().iterator();
StringBuffer queryString = new StringBuffer();
while (iterator.hasNext()) {
Entry<String, List<String>> entry = iterator.next();
if(queryString.length() > 0){
queryString.append(",");
}
queryString.append(entry.getKey()).append("=");
queryString.append(entry.getValue()).append(" ");
}
return Response.status(200).entity(queryString).build();
}