符合中小企业对网站设计、功能常规化式的企业展示型网站建设
本套餐主要针对企业品牌型网站、中高端设计、前端互动体验...
商城网站建设因基本功能的需求不同费用上面也有很大的差别...
手机微信网站开发、微信官网、微信商城网站...
这篇“restful接口规范与postman调试工具实例分析”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“restful接口规范与postman调试工具实例分析”文章吧。
创新互联于2013年开始,是专业互联网技术服务公司,拥有项目网站制作、网站设计网站策划,项目实施与项目整合能力。我们以让每一个梦想脱颖而出为使命,1280元桐庐做网站,已为上家服务,为桐庐各地企业和个人服务,联系电话:13518219792
1.什么是RESTful?
REST:是web服务的一种架构风格;使用HTTP,URI,XML,JSON,HTML等广泛流行的标准和协议;轻量级,跨平台,跨语言的架构设计;它是一种设计风格,不是一种标准,是一种思想。
RESTful:对应的中文是rest式的;Restful web service是一种常见的rest的应用,是遵守了rest风格的web服务;rest式的web服务是一种ROA(The Resource-Oriented Architecture)(面向资源的架构)
RESTful的本质是一种软件构架风格,核心是面向资源,解决的问题:
降低开发的复杂性
提高系统的可伸缩性
2.SOAP和REST的区别:
SOAP (Simple Object Access Protocol):交换数据一种协议规范,是一种轻量的、简单的、基于XML的协议。
REST (Representational State Transfer):一种软件架构风格,可以降低开发的复杂性,提高系统的可伸缩性。
效率和易用性:
SOAP:由于各种需求不断扩充其本身协议的内容,导致在SOAP处理方面的性能有所下降。同时在易用性方面以及学习成本上也有所增加。
RESTful:由于其面向资源接口设计以及操作抽象简化了开发者的不良设计,同时也最大限度的利用了Http最初的应用协议设计理念。
安全性:
RESTful对于资源型服务接口来说很合适,同时特别适合对于效率要求很高,但是对于安全要求不高的场景。
SOAP的成熟性可以给需要提供给多开发语言的,对于安全性要求较高的接口设计带来便利。
总之:
安全性: SOAP会好于REST;
效率和易用性: REST更胜一筹;
成熟度:总的来说SOAP在成熟度上优于REST。
3.如何设计RESTful API:
资源路径:在RESTful架构中,每个网址代表一种资源,所以网址中不能有动词,只能有名词。一般来说API中的名词应该使用复数。
HTTP动词:对于资源的操作( CURD ) ,由HTTP动词(谓词)表示。
GET :从服务器取出资源(一项或多项)。
POST:在服务器新建一个资源。
PUT:在服务器更新资源(客户端提供改变后的完整资源)。
DELETE :从服务器删除资源。
我们以动物园(zoo)举个例子(包括各种动物和雇员的信息):
https://api.example.com/v1/zoos //动物园资源 https://api.example.com/v1/animals //动物资源 https://api.example.com/v1/employees //雇员资源
POST /zoos :新建一个动物园
GET /zoos/ID :获取某个指定动物园的信息
PUT /zoos/ID:更新某介指定动物园的信息
DELETE /zoos/D:删除某个动物园
过滤信息:
?limit=10:指定返回记录的数量
?offset=10:指定返回记录的开始位置。
?page=2&per_page=100:指定第几页,以及每页的记录数。
?sortby=name&order=asc:指定返回结果按照哪个属性排序,以及排序顺序。
?animal_type_id=1:指定筛选条件
状态码:
200 (OK)-如果现有资源已被更改
201 ( created )-如果新资源被创建
202 ( accepted )-已接受处理请求但尚未完成(异步处理)
301 (Moved Permanently )-资源的URI被更新
303 ( See Other )-其他(如,负载均衡)
400 ( bad request )-指代坏请求
404 (not found )-资源不存在
406 (not acceptable )-服务端不支持所需表示
409 (conflict)-通用冲突
412 (Precondition Failed )-前置条件失败(如执行条件更新时的冲突)
415 (unsupported media type )-接受到的表示不受支持
500 (internal server error )-通用错误响应
503 (Service Unavailable )-服务当前无法处理请求
错误处理:
返回的信息中将error作为键名,出错信息作为键值。
{ error: “Invalid API key” }
返回结果:
GET /collection:返回资源对象的列表(数组)
GET /collection/resource:返回单个资源对象
POST /collection:返回新生成的资源对象
PUT /collection/resource:返回完整的资源对象
PATCH /collection/resource:返回完整的资源对象
DELETE /collection/resource:返回一个空文档
4.REST风格的接口测试流程:
我们直接用一张图来介绍吧
5.代码编写和Postman测试:
工具:idea,MySQL数据库,Postman
数据库表数据:
实体类:
@Data @ApiModel("用户实体类") public class User extends Modelimplements Serializable { @ApiModelProperty("用户id") @NotNull(message = "用户id不能为空") private Integer id; @NotBlank(message = "用户名不能为空") @ApiModelProperty("用户名") private String name; @Min(1) @Max(100) @ApiModelProperty("用户年龄") private Integer age; @NotEmpty(message = "邮箱不能为空") @ApiModelProperty("用户邮箱") @Email private String email; @ApiModelProperty("0:未删除 1:已删除") @TableLogic private Integer deleted; @NotBlank(message = "密码不能为空") @ApiModelProperty("用户密码") private String password; }
controller层的代码(service层省略):
@Api(tags = "用户管理") @RestController @RequestMapping("/MyWebsite/user") public class UserController { @Autowired private UserServiceImpl userServiceimpl; @ApiOperation(value = "新增用户") @PostMapping public int insertUser(User user) { System.out.println("新增成功"); return userServiceimpl.insertUser(user); } @ApiOperation(value = "修改用户信息") @PutMapping public void updateUser(@RequestBody @Valid User user) { userServiceimpl.updateUser(user); System.out.println("修改成功"); } @ApiOperation(value = "删除用户", notes = "根据id删除用户") @DeleteMapping("/{id}") public int deleteUser(@ApiParam("用户id") @PathVariable @Valid Integer id) { System.out.println("删除成功"); return userServiceimpl.deleteUser(id); } @ApiOperation(value = "查询所有用户") @GetMapping public ListallUser() { System.out.println("查询成功"); return userServiceimpl.allUser(); } @ApiOperation(value = "id查询用户") @GetMapping("/{id}") public User selectById(@PathVariable("id") String id) { return userServiceimpl.selectById(id); } }
利用Postman测试(url路径要对应上):
查询所有用户:http://localhost:8081/MyWebsite/user
Header:Content-Type=application/json
Body:空
查询成功!
根据id查询:
查询成功!
新增用户:
查看数据库新增成功!
修改用户信息(修改id为7的姓名和年龄):
查看数据库修改成功!
根据id删除用户:
查看数据库删除成功!(deleted=1)
可能你的是直接删除了整一条数据
当查询或更新或删除不存在的数据时(或者数据不合法),都是执行失败的
还有其他接口,例如删除所有等接口,这里不一一测试了
以上就是关于“restful接口规范与postman调试工具实例分析”这篇文章的内容,相信大家都有了一定的了解,希望小编分享的内容对大家有帮助,若想了解更多相关的知识内容,请关注创新互联行业资讯频道。