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