基础的资源路径:
创建 Create:POST /students
查询 Query:GET /studentsage=0,10&name=姓,&q=搜索
获取 Get: GET /students/{studentId}
删除 Destroy:DELETE /students/{studentId}
替换 Update:PUT /students/{studentsId}
补丁 Patch(部分更新):PATCH /students/{studentsId}
替换单个属性 Update Field:PUT /students/{studentId}/{fieldName},请求的 payload 就是对象的字段的值
班级的对应的方式与 Student 的一样,POST /classes 等
班级下的学生: POST /classes/{classId}/students 向班级中添加学生
查询班级下的学生:GET /classes/{classId}/studentsage=0,10&name=,姓,&q=搜索
获取班级下学生的详细信息:GET /classes/{classId}/students/{studentId}
……
我们将接口分为以下几种类型:
创建资源:Create,统一为 POST /resource-names
查询资源:Query,统一为 GET /resource-namesq=查询关键字&age=0,10&name=,姓&limit=10&offset=0
获取资源:Get,统一为 GET /resource-names/{recourceId}
删除资源:Destroy,统一为 DELETE /resource-names/{recourceId}
替换资源:Update(全量更新),统一为 PUT /resource-names/{recourceId}
部分更新:Patch(打补丁),统一为 PATCH /resouce-names/{resourceId}/{fieldName}
*** 作请求:Action(比如通过审核、激活等对资源的 *** 作)统一为 POST /resouce-names/{resourceId}/action-name
大型查询:Maga Query,比如我们希望从磁带库中查询某一个时间段的数据,可能查询需要很长的时间,那么按以下方式完成:
a 创建查询: POST /queries,创建一个新的查询,payload 为查询所需要的所有配置参数信息,接口返回 queryId
b 通过 queryId 获取状态(或者通过 WebSocket 直接通知响起方), GET /queries/{queryId}/status
c 通过 queryId 获取查询结果 GET /queries/{queryId}/rowslimit=10&offset=0&q=搜索,查询结果得到之后,同样可以对结果进行二次搜索
关于查询参数的规范:
age=0,10 表示查询 age 为 [0, 10) 区间的数据, , 区分起始,同样的还可应用于 时间、日期 等类型的数据
age=,10;20,30;40表示查询 age 为 [0, 10)以及[20,30)以及大于 40 的数据, , 前面表示开始值,若不提供,表示所有小于 , 右侧的值的值,, 右侧表示结束值,若没有,则表示所有大于 , 左侧的值,; 表示多个值的区分。
age=10 表示 age===10 的值
name=姓, 表示以 姓 开头的值,类似 LIKE %姓
name=,名 表示以 名 结尾的值
name=姓名 表示 name 完全等于 姓名 的值
limit 此次查询多少条数据
offset 从 0 开始的偏移量
q 万能的搜索关键字,后端根据需求选择性使用
概念是 Roy Thomas Fielding在他2000年的博士论文中提出的。他参与制定了 >
Restful风格的API是一种软件架构风格,设计风格而不是标准,只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。
在Restful风格中,用户请求的url使用同一个url而用请求方式:get,post,delete,put等方式对请求的处理方法进行区分,这样可以在前后台分离式的开发中使得前端开发人员不会对请求的资源地址产生混淆和大量的检查方法名的麻烦,形成一个统一的接口。
在Restful风格中,现有规定如下:
GET(SELECT):从服务器查询,可以在服务器通过请求的参数区分查询的方式。
POST(CREATE):在服务器新建一个资源,调用insert *** 作。
PUT(UPDATE):在服务器更新资源,调用update *** 作。
PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。(目前jdk7未实现,tomcat7也不行)。
DELETE(DELETE):从服务器删除资源,调用delete语句。
了解这个风格定义以后,我们举个例子:
如果当前url是 >
以上就是关于取webservice下目录路径全部的内容,包括:取webservice下目录路径、spring mvc restful 请求端url地址参数带/怎么处理、如何设计一个多条件查询的restfulAPI等相关内容解答,如果想了解更多相关内容,可以关注我们,你们的支持是我们更新的动力!
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)