前言
為了鞏固所學(xué)的知識,作者嘗試著開始發(fā)布一些學(xué)習(xí)筆記類的博客,方便日后回顧。當(dāng)然,如果能幫到一些萌新進(jìn)行新技術(shù)的學(xué)習(xí)那也是極好的。作者菜菜一枚,文章中如果有記錄錯誤,歡迎讀者朋友們批評指正。
(博客的參考源碼可以在我主頁的資源里找到,如果在學(xué)習(xí)的過程中有什么疑問歡迎大家在評論區(qū)向我提出)
發(fā)現(xiàn)寶藏
前些天發(fā)現(xiàn)了一個巨牛的人工智能學(xué)習(xí)網(wǎng)站,通俗易懂,風(fēng)趣幽默,忍不住分享一下給大家?!緦毑厝肟凇?。
四、REST風(fēng)格入門簡介
1.了解REST風(fēng)格
- REST風(fēng)格簡介
REST (Representational State Transfer) ,表現(xiàn)形式狀態(tài)轉(zhuǎn)換,是一種軟件架構(gòu)風(fēng)格,或者說是一種規(guī)范,其強調(diào)HTTP應(yīng)當(dāng)以資源為中心,并且規(guī)范了URI的風(fēng)格;規(guī)范了HTTP請求動作(GET/PUT/POST/DELETE/HEAD/OPTIONS)的使用,具有對應(yīng)的語義。
- REST風(fēng)格對比傳統(tǒng)風(fēng)格
傳統(tǒng)風(fēng)格資源描述形式:
http://localhost/user/getById?id=1
http://localhost/user/saveUser
對應(yīng)的REST風(fēng)格描述形式:
http://localhost/user/1
http://localhost/user
- REST風(fēng)格的優(yōu)點
1.隱藏資源的訪問行為,無法通過地址得知對資源是何種操作
2.書寫簡化
- REST風(fēng)格增刪改查舉例
按照REST風(fēng)格訪問資源時使用行為動作區(qū)分對資源進(jìn)行了何種操作
http://localhost/users – 查詢?nèi)坑脩粜畔?– GET(查詢)
http://localhost/users/1 – 查詢指定用戶信息 – GET(查詢)
http://localhost/users – 添加用戶信息 POST – (新增/保存)
http://localhost/users – 修改用戶信息 – PUT(修改/更新)
http://localhost/users/1 – 刪除用戶信息 – DELETE (刪除)
描述模塊的名稱通常使用復(fù)數(shù),也就是加s的格式描述,表示此類資源,而非單個資源,例如: users、books、accounts。上述行為是約定方式,約定不是規(guī)范,可以打破,所以稱REST風(fēng)格,而不是REST規(guī)范
2.REST風(fēng)格寫法一般步驟
- 設(shè)定http請求動作作(動詞)
- 設(shè)定請求參數(shù)(路徑變量)
3.REST風(fēng)格快速開發(fā)
//@Controller
//@ResponseBody配置在類上可以簡化配置,表示設(shè)置當(dāng)前每個方法的返回值都作為響應(yīng)體
//@ResponseBody
//使用@RestController注解替換@Controller與@ResponseBody注解,簡化書寫
@RestController
@RequestMapping("/books")
public class BookController {
// 使用@PostMapping簡化Post請求方法對應(yīng)的映射配置
// @RequestMapping( method = RequestMethod.POST)
@PostMapping
public String save(@RequestBody Book book){
System.out.println("book save..." + book);
return "{'module':'book save'}";
}
// 使用@DeleteMapping簡化DELETE請求方法對應(yīng)的映射配置
// @RequestMapping(value = "/{id}" ,method = RequestMethod.DELETE)
@DeleteMapping("/{id}")
public String delete(@PathVariable Integer id){
System.out.println("book delete..." + id);
return "{'module':'book delete'}";
}
// 使用@PutMapping簡化Put請求方法對應(yīng)的映射配置
// @RequestMapping(method = RequestMethod.PUT)
@PutMapping
public String update(@RequestBody Book book){
System.out.println("book update..."+book);
return "{'module':'book update'}";
}
// 使用@GetMapping簡化GET請求方法對應(yīng)的映射配置
// @RequestMapping(value = "/{id}" ,method = RequestMethod.GET)
@GetMapping("/{id}")
public String getById(@PathVariable Integer id){
System.out.println("book getById..."+id);
return "{'module':'book getById'}";
}
// 使用@GetMapping簡化GET請求方法對應(yīng)的映射配置
// @RequestMapping(method = RequestMethod.GET)
@GetMapping
public String getAll(){
System.out.println("book getAll...");
return "{'module':'book getAll'}";
}
}
4.REST風(fēng)格中的注解
- @RequestMapping
1.名稱:@RequestMapping
2.類型:方法注解
3.位置:SpringMVC控制器方法定義上方
4.作用:設(shè)置當(dāng)前控制器方法請求訪問路徑
5.屬性:
value (默認(rèn)) :請求訪問路徑
method: http請求動作,標(biāo)準(zhǔn)動作 (GET/POST/PUT/DELETE)
6.范例:
- @PathVariable
1.名稱:@PathVariable
2.類型:形參注解
3.位置:SpringMVC控制器方法形參定義前面
4.作用:綁定路徑參數(shù)與處理器方法形參間的關(guān)系,要求路徑參數(shù)名與形參名一一對應(yīng)
5.范例:
- @RequestBody、@RequestParam、@PathVariable 的區(qū)別與應(yīng)用
區(qū)別
1.@RequestParam用于接收ur1地址傳參或表單傳參
2.@RequestBody用于接收ison數(shù)據(jù)
3.@PathVariable用于接收路徑參數(shù),使用(參數(shù)名稱}描述路徑參數(shù)
應(yīng)用
1.后期開發(fā)中,發(fā)送請求參數(shù)超過1個時,以json格式為主,@RequestBody應(yīng)用較廣
2.如果發(fā)送非ison格式數(shù)據(jù),選用@RequestParam接收請求參數(shù)
3.采用RESTful進(jìn)行開發(fā),當(dāng)參數(shù)數(shù)量較少時,例如1個,可以采用Pathvariable接收請求路徑變量,通常用于傳遞id值
- @RestController
1.名稱:@RestController
2.類型:類注解
3.位置:基于springMVC的RESTful開發(fā)控制器類定義上方
4.作用:設(shè)置當(dāng)前控制器類為RESTful風(fēng)格,等同于@Controller@ResponseBody
5.兩個注解組合功能
6.范例:
- @GetMapping 、@PostMapping 、@PutMapping 、@DeleteMapping
1.名稱:@GetMapping @PostMapping @PutMapping @DeleteMapping
2.類型:方法注解
3.位置:基于SpringMVC的RESTfu1開發(fā)控制器方法定義上方
4.作用:設(shè)置當(dāng)前控制器方法請求訪問路徑與請求動作,每種對應(yīng)下個請求動作
5.例如:@GetMapping對應(yīng)GET請求
6.屬性value (默認(rèn)) :請求訪問路徑
7.范例:
5. 案例:基于REST風(fēng)格頁面數(shù)據(jù)交互
- 案例需求:點擊新建按鈕后臺對應(yīng)方法能運行和保存模擬數(shù)據(jù)后前臺能顯示
2. 編碼環(huán)境準(zhǔn)備
- 創(chuàng)建maven模塊,選擇webapp開發(fā)模板(Archetype)
- 右鍵打開模塊設(shè)置,創(chuàng)建一個目錄java,標(biāo)記為Source源碼,并將Language level等級設(shè)置成8
- 在pom.xml中導(dǎo)入坐標(biāo)
<!--servlet技術(shù)支持-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<!--springmvc技術(shù)支持-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.10.RELEASE</version>
</dependency>
<!--json轉(zhuǎn)換技術(shù)支持-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.0</version>
</dependency>
<!--tomcat服務(wù)器-->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.1</version>
<configuration>
<port>80</port>
<path>/</path>
</configuration>
</plugin>
- SpringMvc 全局配置
@Configuration
@ComponentScan({"org.example.controller"})
@EnableWebMvc
public class SpringMvcConfig {
}
- 容器初始化和中文亂碼過濾
public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
protected Class<?>[] getRootConfigClasses() {
return new Class[0];
}
protected Class<?>[] getServletConfigClasses() {
return new Class[]{SpringMvcConfig.class};
}
protected String[] getServletMappings() {
return new String[]{"/"};
}
//亂碼處理
@Override
protected Filter[] getServletFilters() {
CharacterEncodingFilter filter = new CharacterEncodingFilter();
filter.setEncoding("UTF-8");
return new Filter[]{filter};
}
}
- 實體類book
public class Book {
private Integer id;
private String type;
private String name;
private String description;
}
- 相關(guān)模塊控制器BookController
@RestController
public class BookController {
}
- 文件結(jié)構(gòu)參考
- 用REST風(fēng)格編寫book模塊控制器類,編寫保存和查詢功能
不涉及數(shù)據(jù)庫,用模擬數(shù)據(jù)代替
@RestController
@RequestMapping("/books")
public class BookController {
@PostMapping
public String save(@RequestBody Book book){
System.out.println("book save ==> "+ book);
return "{'module':'book save success'}";
}
@GetMapping
public List<Book> getAll(){
System.out.println("book getAll is running ...");
List<Book> bookList = new ArrayList<Book>();
Book book1 = new Book();
book1.setType("計算機(jī)");
book1.setName("SpringMVC入門教程");
book1.setDescription("小試牛刀");
bookList.add(book1);
Book book2 = new Book();
book2.setType("計算機(jī)");
book2.setName("SpringMVC實戰(zhàn)教程");
book2.setDescription("一代宗師");
bookList.add(book2);
Book book3 = new Book();
book3.setType("計算機(jī)叢書");
book3.setName("SpringMVC實戰(zhàn)教程進(jìn)階");
book3.setDescription("一代宗師嘔心創(chuàng)作");
bookList.add(book3);
return bookList;
}
}
- postman接口示例
- 查全部
- 保存圖書
- 編寫前端頁面(詳情見個人主頁資源代碼)
- 前端頁面文件結(jié)構(gòu)示例
- 配置攔截器,放行tomcat負(fù)責(zé)的路徑(前端)
- 重啟服務(wù)器,訪問book.html
報錯原因分析:SpringMVC攔截了所有請求
- 配置放行路徑
@Configuration
public class SpringMvcSupport extends WebMvcConfigurationSupport {
//設(shè)置靜態(tài)資源訪問過濾,當(dāng)前類需要設(shè)置為配置類,并被掃描加載
@Override
protected void addResourceHandlers(ResourceHandlerRegistry registry) {
//當(dāng)訪問/pages/????時候,從/pages目錄下查找內(nèi)容
registry.addResourceHandler("/pages/**").addResourceLocations("/pages/");
registry.addResourceHandler("/js/**").addResourceLocations("/js/");
registry.addResourceHandler("/css/**").addResourceLocations("/css/");
registry.addResourceHandler("/plugins/**").addResourceLocations("/plugins/");
}
}
- SpringMVC配置類掃描新配置的放行路徑配置類 SpringMvcSupport
@Configuration
@ComponentScan({"org.example.controller","org.example.config"})
@EnableWebMvc
public class SpringMvcConfig {
}
- 刷新頁面
7. 新增模擬數(shù)據(jù)前臺能顯示
- 前端頁面通過異步提交訪問后臺控制器
- 新建按鈕
-
book.html中的js部分
-
點擊新建按鈕
- 新增模擬數(shù)據(jù)前臺能讀取
- BookController中的查詢方法手動添加模擬數(shù)據(jù)
- 重啟服務(wù)器
文章來源:http://www.zghlxwxcb.cn/news/detail-464301.html
總結(jié)
歡迎各位留言交流以及批評指正,如果文章對您有幫助或者覺得作者寫的還不錯可以點一下關(guān)注,點贊,收藏支持一下作者,后續(xù)還會更新mybatis, springboot,maven高級,微信小程序,等前后端內(nèi)容的學(xué)習(xí)筆記。
(博客的參考源碼可以在我主頁的資源里找到,如果在學(xué)習(xí)的過程中有什么疑問歡迎大家在評論區(qū)向我提出)文章來源地址http://www.zghlxwxcb.cn/news/detail-464301.html
到了這里,關(guān)于REST風(fēng)格 -- SpringMVC入門保姆級教程(四)的文章就介紹完了。如果您還想了解更多內(nèi)容,請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持TOY模板網(wǎng)!