一、什么是API
API (应用程序编程接口) 两种用法
1.类似jar的使用:A软件将功能打包成组件(功能块:比如java中的jar),让B软件导入直接使用
2.http请求方式:A项目(系统)提供一个映射方法路径,B项目(系统)发起http请求得到对应功能 (应用请求方式)
应用接口:很多情况下,需要把系统的部分功能(组件)作为服务暴露给外部的其他应用使用,所以就需要把系统中的服务作为API接口暴露出去,一般分为公共接口和私用接口(公司内部)
二、了解Web技术的发展阶段
静态内容阶段:Web 由大量的静态 HTML 文档组成
CGI程序阶段:Web 服务器增加了一些编程 API,可以提供一些动态的内容
脚本语言阶段:服务器端出现了 ASP、PHP、JSP、ColdFusion 等支持 session 的脚本语言技术,浏览器端出现了 Java Applet、JavaScript 等技术
瘦客户端应用阶段:服务器端出现了独立于 Web 服务器的应用服务器。同时出现了 Web MVC 开发模式
RIA 应用阶段:出现了多种 RIA(Rich Internet Application)技术,应用最为广泛的 RIA 技术是 DHTML+Ajax
移动 Web 应用阶段:出现了大量面向移动设备的 Web 应用开发技术 Android、iOS 、H5等
三、前后端分离模式
前后端分离,字面意思就是 前端+后端分离,传统的开发模式前后端耦合过高,不利于维护,一旦前后端任意一方换,不利于开发.
优点:
前后端责任分离,后端负责数据,前端负责页面
提高工作效率,无需等待对方开发工作结束
增强代码的可维护性
应对复杂的前端需求
四、RESTful风格
是一种规范,规范后端编写的逻辑. REST是一种设计API的模式(风格),常用JSON数据格式(能被JS直接读取) , REST只是一种设计风格 , 而不是标准
五、restful规范与传统规范的区别
传统的请求映射方法(接口)设计考虑要点:
1.请求路径 : /employee/list
2.请求方法:GET/POST
3.请求参数: employee对象
4.请求响应值: JsonResult对象
RESTful风格接口约束的要点:
1.请求路径: 要求是操作资源(实体对象:domain)名称复数 /employees
2.请求方式: 使用请求方式替换资源CRUD操作 :POST–新增 ,GET–查询 ,DELETE–删除 ,PUT–更新
3.请求参数:跟之前一样,需求决定
4.请求响应值:跟之前一样,需求决定,但是建议返回值都是json格式
六、RESTful设计
网络上的所有事物都被抽象为资源
资源状态转换
当我们访问一个网站,必然代表客户端和服务端间的互动,这种互动,会涉及资源间的状态变化,HTTP协议,是一个无状态协议,所以资源的状态保存在服务器中,如果需要改变状态,需要使用http方法去让服务器资源发生改变.简单的说就是,对应请求发生改变
使用统一接口
REST要求,必须通过统一的接口来对资源执行各种操作
GET: 查询全部list :8080/employees
GET :查询单个 :8080/employees/1 (1是id参数值,同时也是请求路径的一部分)
POST: :8080/employees?新增的员工信息
PUT: :8080/employees?id=1 更新 id为1的员工信息
DELETE: :8080/employees?id=1 更新 id为2的员工信息
HEAD:获得一个资源的元数据,比如一个资源的hash值或者最后修改日期
OPTIONS:获得客户端针对一个资源能够实施的操作,获取该资源的api
七、例子:
参数路径方法与传统方式对比
同一资源具有多种表现形式
HTTP请求的头信息中用Accept和Content-Type字段表现形式
Accept与Content-Type的区别
1.Accept属于请求头, Content-Type属于实体头。
2.Accept代表发送端(客户端)希望接受的数据类型。Content-Type代表发送端(客户端|服务器)发送的实体数据的数据类型。
八、使用Ajax发送请求
springMVC默认不支持put请求,需要额外处理put或patch请求方式的过滤器,Springboot支持
九、相关注解
@GetMapper、@PostMapping、@DeleteMapping、@PutMapping
@RestController
@PathVariable
通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法参数中
URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx“) 绑定到操作方法的参数中。
@RequestMapping标签属性
优化RESTful规范的 例子代码
API接口测试工具
Postman, Insomnia
RESTful开发框架
常见的有 SpringMVC , jersey , play
到此这篇关于Java进阶之走进RESTful的文章就介绍到这了,更多相关Java RESTful内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
Java进阶之走进RESTful接口
发布日期:2025-01-03 19:25 点击次数:124
上一篇:没有了
下一篇:京东电器11.11即将开启 买电器享30天价保 PLUS会员可享折上折福利
下一篇:京东电器11.11即将开启 买电器享30天价保 PLUS会员可享折上折福利