0106 springMVC REST风格

markdown 印象笔记语法练习带快捷键的

加粗 快捷键 cmd+b
斜体 cmd+i
分割线 cmd+u


编号列表: cmd+shift+o
无编号列表 cmd+shift+u
待办事项 cmd+shift+T
代码块 cmd+shift+P

  1. 编号列表项目1
  2. 编号项目列表2
  • 无编号列表项目1;

  • 无编号列表项目2;

  • [ ] 待办事项1

  • [ ] 待办事项2

System.out.println("hello world");

背景

rest是一种http协议的风格,在互联网时代这种风格在微服务中流行起来了,客户端对微服务,微服务之间交互;
一个URL代表一个资源,里面都是名词;

REST介绍

REST 全称 Representational state Transfer 表现层状态转换;是一种软件架构原则;

  1. 资源:具体存在的对象比如用户,角色,菜单,文本,图片,歌曲;用URI来描述;
  2. 表现层:如何表示资源,现在最流行的是json;
  3. 状态转换;资源并不是一成不变的是一个变化的过程,可以经历create,visit,update,delete;

HTTP的动作

请求方法 动作
GET 查询
POST 新增
PUT 修改全部
PATCH 修改部分
DELETE 删除
  1. URL中不应该出现动词
  2. 版本号放在URL中,应该移动到Header中
  3. 如果参数不多,应该放在path中,而不是通过getParam的方法传递,参数超过4个,应该把参数放到请求体,通过json传递;

SpringMVC对REST风格的支持

@RequestMapping是通用的url配置注解,为了支持rest,springboot引入了更多的注解;

注解 方法 说明
@GetMapping GET 查询
@PostMapping POST 新增
@PutMapping PUT 修改全部
@PatchMapping PATCH 修改部分
@DeleteMapping DELETE 删除

以上注解的方法中可以配置consumers,produces,即接受什么类型的资源请求,输出什么格式的资源;

  1. url上的path参数通过注解@PathVariable配置;
  2. 请求体的参数通过@RequestBody配置;
  3. 返回json数据,在方法申明位置配置@ResponseBody,或者在控制器上配置@RestController;如果需要返回其它格式的数据到客户端,通过协商资源视图解析器来配置;

渲染结果

springmvc返回结果的流程有两种:

  1. @ResponseBody注解标识的控制器方法,无需视图解析器,使用MappingJackson2HttpMessageConverter转换输出
  2. 使用ModelAndView,需要配置视图解析器;

springMVC容器启动的时候,默认注册了两个HttpMessageConverter,即:
1.StringHttpMessageConverter; 按照字符串输出;(produces=Text_plan_value)
2.MappingJackson2HttpMessageConverter;按照json字符串输出;(produces=xxxjson)

如果按照请求类型,找不到对应的HttpMessageConverter,则会流转到 ContentNegotiatingViewResolver,对结果进行解析;
springmvc内置了如下的视图解析器:

  1. BeanNameViewResolver;
  2. ViewResolverComposite
  3. InteernalResourceViewResolver;

@ResponseStatus注解标注在控制器方法上,可以设置响应状态码;
ResponseEntity对象也可以设置响应状态码和响应头信息;

统一异常处理
可以在@ExceptionHandler标注的异常处理方法上,标注@ResponseStatus,统一设置异常返回的响应状态码;

RestTemplate

为了完成微服务系统之间的REST调用,springMvC提供了 RestTemplate,它的底层是使用HttpURLConnection实现的;

 public static void testGet(){
         RestTemplate restTemplate = new RestTemplate();

        String url = "https://xxx.yyy.com/tiananuser_service/testNewUser/new/{plat}/{start}/{end}?requestId=x";
        Map<String,Object> params = new HashMap<>(3);
        params.put("plat",0);
        params.put("start","2019-12-20");
        params.put("end","2020-01-06");

        final ResponseEntity<Object> responseEntity = restTemplate.getForEntity(url,Object.class,params);

        System.out.println("responseEntity.getStatusCodeValue() : "+ responseEntity.getStatusCodeValue());
        System.out.println("responseEntity.getBody() : "+ responseEntity.getBody());


    }

小结

  • 简单的介绍了REST ,即表现层状态转移,是一种架构原则;
  • 介绍了springMVC对REST的支持,提供了5个方法注解;
  • 简单介绍了使用REST访问的客户端RestTemplate ;

原创不易,转载请注明出处。

相关文章

SpringMVC学习记录 注意:以下内容是学习 北京动力节点 的SpringMVC视频后所记录的笔记、源码以及个人的...
SpringMVC拦截器
SpringMVC学习记录 注意:以下内容是学习 北京动力节点 的SpringMVC视频后所记录的笔记、源码以及个人的...
SpringMVC流程及源码分析 前言 ​&#x9;学了一遍SpringMVC以后,想着做一个总结,复习一下。复习写下...
1、添加命名空间和xsd约束 2、在 application.xml文件中开启注解 3、配置扫描任务扫描包 4、demo
SpringMVC 概述 Spring 为展现层提供的基于 MVC 设计理念的优秀的 Web 框架,是目前最主流的 MVC 框架之...