程序员人生 网站导航

REST资源定位(不断更新)

栏目:框架设计时间:2015-01-22 08:13:20

前言:

        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();
}




------分隔线----------------------------
------分隔线----------------------------

最新技术推荐