[JAVA] SpringMVC REST风格深入详细讲解

1940 0
王子 2022-11-9 09:42:06 | 显示全部楼层 |阅读模式
目录

    REST简介RESTful入门案例REST快速开发案例-基于RESTful页面数据交互


REST简介

REST介绍
    REST(Representational State Transfer),表现形式状态转换
传统风格资源描述形式
    http://localhost/user/getById?id=1http://localhost/user/saveUser
REST风格描述形式
    http://localhost/user/1http://localhost/user
优点
    隐藏资源的访问行为,无法通过地址得知对资源是何种操作书写简化
RESTful介绍
按照REST风格访问资源时使用==行为动作==区分对资源进行了何种操作
    http://localhost/users 查询全部用户信息 GET(查询)http://localhost/users/1查询指定用户信息 GET(查询)http://localhost/users添加用户信息 POST(新增/保存)http://localhost/users修改用户信息 PUT(修改/更新)http://localhost/users/1删除用户信息 DELETE(删除)
根据REST风格对资源进行访问称为RESTful
注意事项
    上述行为是约定方式,约定不是规范,可以打破,所以称REST风格,而不是REST规范描述模块的名称通常使用复数,也就是加s的格式描述,表示此类资源,而非单个资源,例如:users、books、accounts……

RESTful入门案例

快速入门
做法:在Controller中定义方法时设定"http请求动作(请求方式)"和"设定请求参数(路径变量)"
  1. @Controller
  2. public class UserController {
  3.     //设置当前请求方法为POST,表示REST风格中的添加操作
  4.     @RequestMapping(value = "/users",method = RequestMethod.POST)
  5.     @ResponseBody
  6.     public String save(){
  7.         System.out.println("user save...");
  8.         return "{'module':'user save'}";
  9.     }
  10.     //设置当前请求方法为DELETE,表示REST风格中的删除操作
  11.     //@PathVariable注解用于设置路径变量(路径参数),要求路径上设置对应的占位符,并且占位符名称与方法形参名称相同
  12.     @RequestMapping(value = "/users/{id}",method = RequestMethod.DELETE)
  13.     @ResponseBody
  14.     public String delete(@PathVariable Integer id){
  15.         System.out.println("user delete..." + id);
  16.         return "{'module':'user delete'}";
  17.     }
  18.     //设置当前请求方法为PUT,表示REST风格中的修改操作
  19.     @RequestMapping(value = "/users",method = RequestMethod.PUT)
  20.     @ResponseBody
  21.     public String update(@RequestBody User user){
  22.         System.out.println("user update..."+user);
  23.         return "{'module':'user update'}";
  24.     }
  25.     //设置当前请求方法为GET,表示REST风格中的查询操作
  26.     //@PathVariable注解用于设置路径变量(路径参数),要求路径上设置对应的占位符,并且占位符名称与方法形参名称相同
  27.     @RequestMapping(value = "/users/{id}" ,method = RequestMethod.GET)
  28.     @ResponseBody
  29.     public String getById(@PathVariable Integer id){
  30.         System.out.println("user getById..."+id);
  31.         return "{'module':'user getById'}";
  32.     }
  33.     //设置当前请求方法为GET,表示REST风格中的查询操作
  34.     @RequestMapping(value = "/users",method = RequestMethod.GET)
  35.     @ResponseBody
  36.     public String getAll(){
  37.         System.out.println("user getAll...");
  38.         return "{'module':'user getAll'}";
  39.     }
  40. }
复制代码
@PathVariable介绍
    名称:@PathVariable类型:形参注解位置:SpringMVC控制器方法形参定义前面作用:绑定路径参数与处理器方法形参间的关系,要求路径参数名与形参名一一对应


@RequestBody、@RequestParam、@PathVariable区别和应用
区别
    @RequestParam用于接收url地址传参或表单传参@RequestBody用于接收json数据@PathVariable用于接收路径参数,使用{参数名称}描述路径参数
应用
    后期开发中,发送请求参数超过1个时,以json格式为主,@RequestBody应用较广如果发送非json格式数据,选用@RequestParam接收请求参数采用RESTful进行开发,当参数数量较少时,例如1个,可以采用@PathVariable接收请求路径变量,通常用于传递id值

REST快速开发



代码中的问题
以上截图中的代码和之前写的UserController中的方法类似,其中图中两个方法都有三处是有问题的,可以进行优化。存在的问题如下:
    问题1:每个方法的@RequestMapping注解中都定义了访问路径/books,重复性太高。问题2:每个方法的@RequestMapping注解中都要使用method属性定义请求方式,重复性太高。问题3:每个方法响应json都需要加上@ResponseBody注解,重复性太高。
Rest快速开发
解决以上三个问题
解决问题1:在Controller类上使用@RequestMapping定义共同的访问路径。
  1. @Controller
  2. @RequestMapping("/books")
  3. public class BookController {
  4.     @RequestMapping(method = RequestMethod.POST)
  5.     public String save(@RequestBody Book book){
  6.         System.out.println("book save..." + book);
  7.         return "{'module':'book save'}";
  8.     }
  9.     @RequestMapping(value = "/{id}" ,method = RequestMethod.DELETE)
  10.     public String delete(@PathVariable Integer id){
  11.         System.out.println("book delete..." + id);
  12.         return "{'module':'book delete'}";
  13.     }
  14.     @RequestMapping(method = RequestMethod.PUT)
  15.     public String update(@RequestBody Book book){
  16.         System.out.println("book update..."+book);
  17.         return "{'module':'book update'}";
  18.     }
  19.     @RequestMapping(value = "/{id}" ,method = RequestMethod.GET)
  20.     public String getById(@PathVariable Integer id){
  21.         System.out.println("book getById..."+id);
  22.         return "{'module':'book getById'}";
  23.     }
  24.     @RequestMapping(method = RequestMethod.GET)
  25.     public String getAll(){
  26.         System.out.println("book getAll...");
  27.         return "{'module':'book getAll'}";
  28.     }
  29. }
复制代码
解决问题2:使用@GetMapping @PostMapping @PutMapping @DeleteMapping代替@RequestMapping(method=RequestMethod.XXX)
  1. @Controller   
  2. @RequestMapping("/books")
  3. public class BookController {
  4. //    @RequestMapping( method = RequestMethod.POST)
  5.     @PostMapping//使用@PostMapping简化Post请求方法对应的映射配置
  6.     public String save(@RequestBody Book book){
  7.         System.out.println("book save..." + book);
  8.         return "{'module':'book save'}";
  9.     }
  10. //    @RequestMapping(value = "/{id}" ,method = RequestMethod.DELETE)
  11.     @DeleteMapping("/{id}")  //使用@DeleteMapping简化DELETE请求方法对应的映射配置
  12.     public String delete(@PathVariable Integer id){
  13.         System.out.println("book delete..." + id);
  14.         return "{'module':'book delete'}";
  15.     }
  16. //    @RequestMapping(method = RequestMethod.PUT)
  17.     @PutMapping   //使用@PutMapping简化Put请求方法对应的映射配置
  18.     public String update(@RequestBody Book book){
  19.         System.out.println("book update..."+book);
  20.         return "{'module':'book update'}";
  21.     }
  22. //    @RequestMapping(value = "/{id}" ,method = RequestMethod.GET)
  23.     @GetMapping("/{id}")    //使用@GetMapping简化GET请求方法对应的映射配置
  24.     public String getById(@PathVariable Integer id){
  25.         System.out.println("book getById..."+id);
  26.         return "{'module':'book getById'}";
  27.     }
  28. //    @RequestMapping(method = RequestMethod.GET)
  29.     @GetMapping      //使用@GetMapping简化GET请求方法对应的映射配置
  30.     public String getAll(){
  31.         System.out.println("book getAll...");
  32.         return "{'module':'book getAll'}";
  33.     }
  34. }
复制代码
    名称:@GetMapping @PostMapping @PutMapping @DeleteMapping类型:方法注解位置:基于SpringMVC的RESTful开发控制器方法定义上方作用:设置当前控制器方法请求访问路径与请求动作,每种对应一个请求动作,例如@GetMapping对应GET请求属性: value(默认):请求访问路径
解决问题3:在Controller类上使用@RestController注解,等同于@Controller与@ResponseBody两个注解组合功能
  1. @RestController     //使用@RestController注解替换@Controller与@ResponseBody注解,简化书写
  2. @RequestMapping("/books")
  3. public class BookController {
  4.     //方法省略了没写
  5. }
复制代码
    名称:@RestController类型:类注解位置:基于SpringMVC的RESTful开发控制器类定义上方作用:设置当前控制器类为RESTful风格,等同于@Controller与@ResponseBody两个注解组合功能

案例-基于RESTful页面数据交互

案例效果和环境准备
案例效果


环境准备
  1. //POJO实体类
  2. public class Book {
  3.     private Integer id;
  4.     private String type;
  5.     private String name;
  6.     private String description;
  7.     //重写getter、setter、toString()方法...
  8. }
复制代码
  1. //SpringMVC容器初始化类
  2. public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
  3.     protected Class<?>[] getRootConfigClasses() {
  4.         return new Class[0];
  5.     }
  6.     protected Class<?>[] getServletConfigClasses() {
  7.         return new Class[]{SpringMvcConfig.class};
  8.     }
  9.     protected String[] getServletMappings() {
  10.         return new String[]{"/"};
  11.     }
  12.     //乱码处理
  13.     @Override
  14.     protected Filter[] getServletFilters() {
  15.         CharacterEncodinFilter filter = new CharacterEncodingFilter();
  16.         filter.setEncoding("UTF-8");
  17.         return new Filter[]{filter};
  18.     }
  19. }
复制代码
  1. //SpringMVC配置类
  2. @Configuration
  3. @ComponentScan({"com.moming.controller","com.moming.config"})
  4. @EnableWebMvc
  5. public class SpringMvcConfig {
  6. }
复制代码
代码实现
制作SpringMVC控制器,并通过PostMan测试接口功能
  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController {
  4.     @PostMapping
  5.     public String save(@RequestBody Book book){
  6.         System.out.println("book save ==> "+ book);
  7.         return "{'module':'book save success'}";
  8.     }
  9.     @GetMapping
  10.     public List<Book> getAll(){
  11.         System.out.println("book getAll is running ...");
  12.         List<Book> bookList = new ArrayList<Book>();
  13.         Book book1 = new Book();
  14.         book1.setType("计算机");
  15.         book1.setName("SpringMVC入门教程");
  16.         book1.setDescription("小试牛刀");
  17.         bookList.add(book1);
  18.         Book book2 = new Book();
  19.         book2.setType("计算机");
  20.         book2.setName("SpringMVC实战教程");
  21.         book2.setDescription("一代宗师");
  22.         bookList.add(book2);
  23.         Book book3 = new Book();
  24.         book3.setType("计算机丛书");
  25.         book3.setName("SpringMVC实战教程进阶");
  26.         book3.setDescription("一代宗师呕心创作");
  27.         bookList.add(book3);
  28.         return bookList;
  29.     }
  30. }
复制代码


静态页面资源(REST功能页面)
链接:链接: https://pan.baidu.com/s/1u9GSGrDejwDDbFAe_inEGQ?pwd=aaey
设置对静态资源的访问放行
  1. @Configuration
  2. public class SpringMvcSupport extends WebMvcConfigurationSupport {
  3.     //设置静态资源访问过滤,当前类需要设置为配置类,并被扫描加载
  4.     @Override
  5.     protected void addResourceHandlers(ResourceHandlerRegistry registry) {
  6.         //当访问/pages/????时候,从/pages目录下查找内容
  7.         registry.addResourceHandler("/pages/**")
  8.             .addResourceLocations("/pages/");
  9.         registry.addResourceHandler("/js/**")
  10.             .addResourceLocations("/js/");              
  11.         registry.addResourceHandler("/css/**")
  12.             .addResourceLocations("/css/");      
  13.         registry.addResourceHandler("/plugins/**")
  14.             .addResourceLocations("/plugins/");
  15.     }
  16. }
复制代码
books.html前端页面通过异步提交访问后台控制器
  1. //添加
  2. saveBook () {
  3.     axios.post("/books",this.formData).then((res)=>{
  4.     });
  5. },
  6. //主页列表查询
  7. getAll() {
  8.     axios.get("/books").then((res)=>{
  9.         this.dataList = res.data;
  10.     });
  11. },
复制代码
到此这篇关于SpringMVC REST深入详细讲解的文章就介绍到这了,更多相关SpringMVC REST内容请搜索中国红客联盟以前的文章或继续浏览下面的相关文章希望大家以后多多支持中国红客联盟!

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

×
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

中国红客联盟公众号

联系站长QQ:5520533

admin@chnhonker.com
Copyright © 2001-2025 Discuz Team. Powered by Discuz! X3.5 ( 粤ICP备13060014号 )|天天打卡 本站已运行