开发规范——Restful风格

目录

Restful

Apifox

介绍

端口号8080怎么来的？

为什么要使用Apifox?

---

Restful

如果请求方式是Post，那我就知道了要执行新增操作，要新增一个用户

如果请求方式是Put，那就代表我要修改用户

具体要对这些资源进行什么样的操作，传统的Url通过动词来描述，但Restful风格的Url通过请求方式来描述，由于请求方式是固定的，get是查询，Delete是删除，Post是新增，Put是修改，分别对应于增删改查的四项操作

所以Restful风格的url中有两大特点

第一大特点就是通过Url来定位要操作的资源

/user/1那我就知道我要操作的是一号用户的信息，具体对这个用户进行什么样的操作由请求方式决定

所以Restful风格的url第二大特点就是通过HTTP动词来描述操作，而这块说的HTTP动词指的就是请求方式，通过请求方式就知道到底是对增删改查进行的哪项操作

• REST是风格，是约定方式，约定不是规定，可以打破

• 描述模块的功能通常使用复数，也就是加s的格式来描述，表示此类资源，而非单个资源。如：users、emps、books…

Apifox

将来前端和后端都是并行开发的，假设我们后端工程师已经将对应的功能接口都已经开发完毕了，我如何对服务器端的功能接口进行测试呢

在前端开发过程中，如果服务器端还没有开发好，那前端如何来获取数据来测试页面渲染展示呢？

其实要解决这两个问题，我们只需要借助一个工具就可以了

介绍

API三大功能

第一大功能，可以管理我们项目中的接口文档

第二大功能，也可以基于Apifox来测试我们服务器端所开发的功能接口，也就是接口的请求测试

第三大功能，还可以对前端去提供对应的Mock服务，Mock服务就是为前端提供的模拟的url地址，你访问这个模拟的url地址，我就会对你返回对应的测试数据来供前端测试调试使用的

安装完Apifox之后扫码登录，在主窗口新建项目，这样就新建了一个项目

点击快捷请求，之后要输入一个url地址，这个url就是用来指定你要访问哪个功能接口，在前面选择对应的请求方式

输入http://localhost:8080/hello?name=Tom

端口号8080怎么来的？

后端服务（例如 Spring Boot 应用）在启动时会监听一个特定的端口，用于接收 HTTP 请求

端口号 8080 是后端服务配置中指定的，前端或工具（如 Apifox）需要根据后端的实际运行端口来发送请求

在许多 Java Web 框架（如 Spring Boot）中，默认的 HTTP 端口号是 8080

如果开发者没有显式地配置端口号，框架会使用默认值 8080

开发者可以通过配置文件（如 application.properties 或 application.yml）手动设置端口号

通过 application.yml 配置端口

server:port: 8080

如果将 server.port 设置为其他值（如 9090），则后端服务会在该端口上运行，URL 也会变成：

http://localhost:9090/hello?name=Tom

Body代表的是请求体中返回的内容

Header展示的是响应头的信息

实际请求中展示了这次请求的相关信息，请求的url地址，请求的方式，以及传递的请求头

为什么要使用Apifox?

由于浏览器地址发起的请求，都是GET方式的请求，如果我们需要发起POST，PUT，DELETE方式的请求，就需要借助于这类工具