Java進(jìn)階之走進(jìn)RESTful接口
一、什么是API
API (應(yīng)用程序編程接口) 兩種用法
1.類似jar的使用:A軟件將功能打包成組件(功能塊:比如java中的jar),讓B軟件導(dǎo)入直接使用
2.http請(qǐng)求方式:A項(xiàng)目(系統(tǒng))提供一個(gè)映射方法路徑,B項(xiàng)目(系統(tǒng))發(fā)起http請(qǐng)求得到對(duì)應(yīng)功能 (應(yīng)用請(qǐng)求方式)
應(yīng)用接口:很多情況下,需要把系統(tǒng)的部分功能(組件)作為服務(wù)暴露給外部的其他應(yīng)用使用,所以就需要把系統(tǒng)中的服務(wù)作為API接口暴露出去,一般分為公共接口和私用接口(公司內(nèi)部)
二、了解Web技術(shù)的發(fā)展階段
- 靜態(tài)內(nèi)容階段:Web 由大量的靜態(tài) HTML 文檔組成
- CGI程序階段:Web 服務(wù)器增加了一些編程 API,可以提供一些動(dòng)態(tài)的內(nèi)容
- 腳本語(yǔ)言階段:服務(wù)器端出現(xiàn)了 ASP、PHP、JSP、ColdFusion 等支持 session 的腳本語(yǔ)言技術(shù),瀏覽器端出現(xiàn)了 Java Applet、JavaScript 等技術(shù)
- 瘦客戶端應(yīng)用階段:服務(wù)器端出現(xiàn)了獨(dú)立于 Web 服務(wù)器的應(yīng)用服務(wù)器。同時(shí)出現(xiàn)了 Web MVC 開(kāi)發(fā)模式
- RIA 應(yīng)用階段:出現(xiàn)了多種 RIA(Rich Internet Application)技術(shù),應(yīng)用最為廣泛的 RIA 技術(shù)是 DHTML+Ajax
- 移動(dòng) Web 應(yīng)用階段:出現(xiàn)了大量面向移動(dòng)設(shè)備的 Web 應(yīng)用開(kāi)發(fā)技術(shù) Android、iOS 、H5等
三、前后端分離模式
前后端分離,字面意思就是 前端+后端分離,傳統(tǒng)的開(kāi)發(fā)模式前后端耦合過(guò)高,不利于維護(hù),一旦前后端任意一方換,不利于開(kāi)發(fā).

優(yōu)點(diǎn):
- 前后端責(zé)任分離,后端負(fù)責(zé)數(shù)據(jù),前端負(fù)責(zé)頁(yè)面
- 提高工作效率,無(wú)需等待對(duì)方開(kāi)發(fā)工作結(jié)束
- 增強(qiáng)代碼的可維護(hù)性
- 應(yīng)對(duì)復(fù)雜的前端需求
四、RESTful風(fēng)格
是一種規(guī)范,規(guī)范后端編寫的邏輯. REST是一種設(shè)計(jì)API的模式(風(fēng)格),常用JSON數(shù)據(jù)格式(能被JS直接讀取) , REST只是一種設(shè)計(jì)風(fēng)格 , 而不是標(biāo)準(zhǔn)
五、restful規(guī)范與傳統(tǒng)規(guī)范的區(qū)別
傳統(tǒng)的請(qǐng)求映射方法(接口)設(shè)計(jì)考慮要點(diǎn):
1.請(qǐng)求路徑 : /employee/list
2.請(qǐng)求方法:GET/POST
3.請(qǐng)求參數(shù): employee對(duì)象
4.請(qǐng)求響應(yīng)值: JsonResult對(duì)象
RESTful風(fēng)格接口約束的要點(diǎn):
1.請(qǐng)求路徑: 要求是操作資源(實(shí)體對(duì)象:domain)名稱復(fù)數(shù) /employees
2.請(qǐng)求方式: 使用請(qǐng)求方式替換資源CRUD操作 :POST–新增 ,GET–查詢 ,DELETE–刪除 ,PUT–更新
3.請(qǐng)求參數(shù):跟之前一樣,需求決定
4.請(qǐng)求響應(yīng)值:跟之前一樣,需求決定,但是建議返回值都是json格式
六、RESTful設(shè)計(jì)
網(wǎng)絡(luò)上的所有事物都被抽象為資源
restful認(rèn)為,每個(gè)資源都有自己唯一的資源定位符(URI), 每個(gè)URI都代表了一種資源,以一張圖片為例:圖片有自己的路徑, 所以圖片也是一種資源. 所以URI中不用動(dòng)詞,只用名詞. 一般數(shù)據(jù)庫(kù)的表都是記錄同種的集合,所以為名詞為復(fù)數(shù) 這就是為什么請(qǐng)求路徑中的操作資源要加 s , 可以不遵循這個(gè)規(guī)范(看自己喜歡或者公司規(guī)范)
資源狀態(tài)轉(zhuǎn)換
當(dāng)我們?cè)L問(wèn)一個(gè)網(wǎng)站,必然代表客戶端和服務(wù)端間的互動(dòng),這種互動(dòng),會(huì)涉及資源間的狀態(tài)變化,HTTP協(xié)議,是一個(gè)無(wú)狀態(tài)協(xié)議,所以資源的狀態(tài)保存在服務(wù)器中,如果需要改變狀態(tài),需要使用http方法去讓服務(wù)器資源發(fā)生改變.簡(jiǎn)單的說(shuō)就是,對(duì)應(yīng)請(qǐng)求發(fā)生改變
新增 :從無(wú)到有 更新:從某個(gè)狀態(tài)變成另一個(gè)狀態(tài) 刪除 :從有到無(wú)
使用統(tǒng)一接口
REST要求,必須通過(guò)統(tǒng)一的接口來(lái)對(duì)資源執(zhí)行各種操作
- GET: 查詢?nèi)縧ist http://localhost:8080/employees
- GET :查詢單個(gè) http://localhost:8080/employees/1 (1是id參數(shù)值,同時(shí)也是請(qǐng)求路徑的一部分)
- POST: http://localhost:8080/employees?新增的員工信息
- PUT: http://localhost:8080/employees?id=1 更新 id為1的員工信息
- DELETE: http://localhost:8080/employees?id=1 更新 id為2的員工信息
- HEAD:獲得一個(gè)資源的元數(shù)據(jù),比如一個(gè)資源的hash值或者最后修改日期
- OPTIONS:獲得客戶端針對(duì)一個(gè)資源能夠?qū)嵤┑牟僮?獲取該資源的api
員工列表查詢與員工單個(gè)查詢,使用相同映射路徑" /employees 和相同請(qǐng)求方法:RequestMethod.GET,
導(dǎo)致請(qǐng)求路徑(路徑+請(qǐng)求方法)一樣,報(bào)錯(cuò)
restful提供解決方案:使用參數(shù)路徑方法
參數(shù)路徑:將參數(shù)作為請(qǐng)求路徑的一部分 /employee/{id}
還要加上注解@PathVariable,將id拿到
瀏覽器/postman發(fā)起請(qǐng)求時(shí)使用:
http://localhost:8080/employee/1 其中1是id參數(shù)值,同時(shí)也是請(qǐng)求路徑的一部分
另外,請(qǐng)求映射方法必須使用@PathVariable 進(jìn)行參數(shù)讀取
注意: 如果路徑參數(shù)標(biāo)記與請(qǐng)求參數(shù)名不一致時(shí) ,怎么辦?
可以使用@PathVariable("eid") value屬性指定
七、例子:
@Controller
public class EmployeeController {
@RequestMapping(value = "employees",method = RequestMethod.GET)
@ResponseBody
public List<Employee> list(){
List<Employee> employees = Arrays.asList(new Employee(1L, "小羅", 22), new Employee(2L, "小軒", 18));
return employees;
}
@RequestMapping(value = "employees/{id}",method = RequestMethod.GET)
@ResponseBody
public Employee get(@PathVariable Long id){
List<Employee> employees = Arrays.asList(new Employee(1L, "xxx", 22), new Employee(2L, "qqq", 22));
return employees.get((int) (id-1));
}
@RequestMapping(value = "employees",method = RequestMethod.POST)
@ResponseBody
public Employee save(Employee employee){
employee.setId(1L);
return employee ;
}
@RequestMapping(value = "employees",method = RequestMethod.DELETE)
@ResponseBody
public JsonResult delete(Long id){
return new JsonResult(true,"刪除成功");
}
@RequestMapping(value = "employees",method = RequestMethod.PUT)
@ResponseBody
public JsonResult update(Long id){
return new JsonResult(true,"更新成功");
}
}
參數(shù)路徑方法與傳統(tǒng)方式對(duì)比
參數(shù)路徑方式: 優(yōu)點(diǎn):可以隱藏參數(shù),避免暴露參數(shù),相對(duì)安全 缺點(diǎn):如果參數(shù)較多,url過(guò)長(zhǎng) 不建議使用 參數(shù)較少選用參數(shù)路徑方法
同一資源具有多種表現(xiàn)形式
HTTP請(qǐng)求的頭信息中用Accept和Content-Type字段表現(xiàn)形式
Accept與Content-Type的區(qū)別
1.Accept屬于請(qǐng)求頭, Content-Type屬于實(shí)體頭。
2.Accept代表發(fā)送端(客戶端)希望接受的數(shù)據(jù)類型。Content-Type代表發(fā)送端(客戶端|服務(wù)器)發(fā)送的實(shí)體數(shù)據(jù)的數(shù)據(jù)類型。
Accept:application/json :代表客戶端希望接受得數(shù)據(jù)類型是json類型,后臺(tái)返回json數(shù)據(jù) Content-Type:application/json:代表發(fā)送端發(fā)送數(shù)據(jù)格式是json,后臺(tái)要以這種格式類接收前端的數(shù)據(jù)
八、使用Ajax發(fā)送請(qǐng)求
刪除,更新操作
$.ajax({
url: 路徑 ,
type: 類型 ,
data: 參數(shù){id:111},
success:(回調(diào)函數(shù))function(data){
}
})
<script>
$(function () {
//查全部
$("#btn1").click(function () {
$.get("/employees" ,function (data) {
console.log(data);
})
});
//查單個(gè)
$("#btn2").click(function () {
$.get("/employees/1" ,function (data) {
console.log(data);
})
});
//新增
$("#btn4").click(function () {
$.post("/employees" ,{name:"xiao",age:18},function (data) {
console.log(data);
})
});
//刪除
$("#btn3").click(function () {
$.ajax({
url:"/employees",
type: "DELETE",
data:{id:1},
success:function (data) {
console.log(data);
}
})
});
//更新
$("#btn5").click(function () {
$.ajax({
url:"/employees",
type: "PUT",
data:{id:1},
success:function (data) {
console.log(data);
}
})
})
})
</script>
springMVC默認(rèn)不支持put請(qǐng)求,需要額外處理put或patch請(qǐng)求方式的過(guò)濾器,Springboot支持
<filter> <filter-name>httpPutFormContentFilter</filter-name> <filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class> </filter> <filter-mapping> <filter-name>httpPutFormContentFilter</filter-name> <servlet-name>springMVC</servlet-name> </filter-mapping>
九、相關(guān)注解
@GetMapper、@PostMapping、@DeleteMapping、@PutMapping
等價(jià)于 method =RequestMethod.GET|POST|DELETE|PUT
@RestController
等價(jià)于 @Controller +@ResponseBody
@PathVariable
通過(guò) @PathVariable 可以將 URL 中占位符參數(shù)綁定到控制器處理方法參數(shù)中
URL 中的 {xxx} 占位符可以通過(guò)@PathVariable(“xxx“) 綁定到操作方法的參數(shù)中。
@RequestMapping標(biāo)簽屬性
params :要求請(qǐng)求中必須攜帶指定名稱的參數(shù)
params="name" :必須攜帶name參數(shù)
params="name=xuan" :必須攜帶name參數(shù),并且name=xuan
headers :請(qǐng)求頭,限定要處理請(qǐng)求的請(qǐng)求頭信息,只有匹配才會(huì)被方法處理
consume :等價(jià)于Content-Type
value/path:映射路徑
method:限定請(qǐng)求的方式
優(yōu)化RESTful規(guī)范的 例子代碼
@RestController
@RequestMapping("employees")
public class EmployeeController {
@GetMapping
public List<Employee> list(){
List<Employee> employees = Arrays.asList(new Employee(1L, "小羅", 22), new Employee(2L, "小軒", 18));
return employees;
}
@GetMapping(value = "/{id}")
public Employee get(@PathVariable Long id){
List<Employee> employees = Arrays.asList(new Employee(1L, "xxx", 22), new Employee(2L, "qqq", 22));
return employees.get((int) (id-1));
}
@PostMapping
public Employee save(Employee employee){
employee.setId(1L);
return employee ;
}
@DeleteMapping
public JsonResult delete(Long id){
return new JsonResult(true,"刪除成功");
}
@PutMapping
public JsonResult update(Long id){
return new JsonResult(true,"更新成功");
}
}
API接口測(cè)試工具
Postman, Insomnia
RESTful開(kāi)發(fā)框架
常見(jiàn)的有 SpringMVC , jersey , play
到此這篇關(guān)于Java進(jìn)階之走進(jìn)RESTful的文章就介紹到這了,更多相關(guān)Java RESTful內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Java實(shí)現(xiàn)CORS跨域請(qǐng)求的實(shí)現(xiàn)方法
本篇文章主要介紹了Java實(shí)現(xiàn)CORS跨域請(qǐng)求的實(shí)現(xiàn)方法,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-09-09
Java使用bcrypt實(shí)現(xiàn)對(duì)密碼加密效果詳解
bcrypt是一種自帶鹽值(自動(dòng)加鹽)的加密方案。本文將通過(guò)示例為大家詳細(xì)介紹這一對(duì)密碼進(jìn)行加密的算法,感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2022-03-03
Java Volatile應(yīng)用單例模式實(shí)現(xiàn)過(guò)程解析
這篇文章主要介紹了Java Volatile應(yīng)用單例模式實(shí)現(xiàn)過(guò)程解析,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-11-11

