Spring Boot参数接收和结果响应

一、请求处理核心注解

1、@RequestMapping注解

@RequestMapping注解是所有常用注解中，最基本的一个注解，用于标注HTTP服务端点。它的很多属性对于丰富我们的应用开发方式方法，都有很重要的作用。如：

• value： 应用请求端点，最核心的属性，用于标志请求处理方法的唯一性；
• method： HTTP协议的method类型， 如：GET、POST、PUT、DELETE等；
• consumes： HTTP协议请求内容的数据类型（Content-Type），例如application/json, text/html;
• produces: HTTP协议响应内容的数据类型。
• params： HTTP请求中必须包含某些参数值的时候，才允许被注解标注的方法处理请求。
• headers： HTTP请求中必须包含某些指定的header值，才允许被注解标注的方法处理请求。

@RequestMapping(value = "/article", method = POST)
@PostMapping(value = "/article")

上面代码中两种写法起到的是一样的效果，也就是PostMapping等同于@RequestMapping的method等于POST。同理：@GetMapping、@PutMapping、@DeleteMapping也都是简写的方式。

2、@RestController与@Controller

@Controller注解是开发中最常使用的注解，它的作用有两层含义：

• 一是告诉Spring，被该注解标注的类是一个Spring的Bean，需要被注入到Spring的上下文环境中。
• 二是该类里面所有被RequestMapping标注的注解都是HTTP服务端点。

@RestController相当于 @Controller和@ResponseBody结合。它有两层含义：

• 一是作为Controller的作用，将控制器类注入到Spring上下文环境，该类RequestMapping标注方法为HTTP服务端点。
• 二是作为ResponseBody的作用，请求响应默认使用的序列化方式是JSON，而不是跳转到jsp或模板页面。

二、常用请求参数接收方式

HTTP协议组成	示例	Spring注解
path传参	/articles/12 (查询id为12的文章，12是参数)	@PathVariable
URL Query String传参	/articles?id=12	@RequestParam
Body 传参	name=jack&age=18	@RequestParam
Body 传参	name=jack&age=18或者json格式	@RequestBody
Headers 传参	token: xxxxxxxx	@RequestHeader

1、@PathVariable 与@RequestParam

PathVariable用于URI上的{参数}，如下方法用于删除一篇文章，其中id为文章id。如：我们的请求URL为“/article/1”,那么将匹配DeleteMapping并且PathVariable接收参数id=1。而RequestParam用于接收普通表单方式或者ajax模拟表单提交的参数数据。

@DeleteMapping("/article/{id}")
public @ResponseBody ResponseResult deleteArticle(@PathVariable Long id) {

@PostMapping("/article")
public @ResponseBody ResponseResult deleteArticle(@RequestParam Long id) {

 2、@RequestBody

@RequestBody修饰请求参数，注解用于接收HTTP的body，默认是使用JSON的格式

//注意并不要求@RequestBody与@ResponseBody成对使用。
public @ResponseBody  ResponseResult saveArticle(@RequestBody ArticleVO article)

3、使用@RequestBody接收复杂嵌套对象参数

有一些朋友可能还无法理解RequestBody注解存在的真正意义，表单数据提交用RequestParam就好了，为什么还要搞出来一个RequestBody注解呢？RequestBody注解的真正意义在于能够使用对象或者嵌套对象接收前端数据。

仔细看上面的代码，是一个Articled的json对象里面包含了多个Reader的json对象。这种数据结构使用RequestParam就无法接收了，RequestParam只能接收平面的、一对一的参数。像上文中这种数据结构的参数，就需要我们在java服务端定义两个类，一个类是Article，一个类是Reader。具体对象结构为：

/**
 * 文章
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Article {
    private Long  id;
    private String title; //标题
    private String categoryName;//分类
    private String content;//内容
    private Date createTime;//发布时间
    private List<Reader> authors;//文章读者
}

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Reader {
  private String name;
  private Integer age;
}

完成以上动作，我们就可以使用 @RequestBody Article article ，一次性的接收以上所有的复杂嵌套对象参数了，参数对象的所有属性都将被赋值。

三、请求响应结果处理

1、@ResponseBody

@ResponseBody修饰返回值，注解用于在HTTP的body中携带响应数据，默认是使用JSON的格式。如果不加该注解，Spring响应字符串类型，是跳转到模板页面或JSP页面的开发模式。说白了：加上这个注解你开发的是一个数据接口，不加这个注解你开发的是一个页面跳转控制器。

四、HttpMessageConverter请求和响应数据处理原理

大家现在使用JSON都比较普遍了，其方便易用、表达能力强，是绝大部分数据接口式应用的首选。那么如何响应其他的类型的数据？其中的判别原理又是什么？

• 当一个HTTP请求到达时是一个InputStream，通过HttpMessageConverter转换为Java对象，从而进行参数接收。
• 当对一个HTTP请求进行响应时，我们首先输出的是一个Java对象，然后由HttpMessageConverter转换为OutputStream输出。

当我们在Spring Boot应用中集成了Jackson的类库之后，如下的一些HttpMessageConverter将会被加载。

实现类	功能说明
StringHttpMessageConverter	将请求信息转为字符串
FormHttpMessageConverter	将表单数据读取到MultiValueMap中
XmlAwareFormHttpMessageConverter	扩展与FormHttpMessageConverter，如果部分表单属性是XML数据，可用该转换器进行读取
ResourceHttpMessageConverter	读写org.springframework.core.io.Resource对象
BufferedImageHttpMessageConverter	读写BufferedImage对象
ByteArrayHttpMessageConverter	读写二进制数据
SourceHttpMessageConverter	读写java.xml.transform.Source类型的对象
MarshallingHttpMessageConverter	通过Spring的org.springframework,xml.Marshaller和Unmarshaller读写XML消息
Jaxb2RootElementHttpMessageConverter	通过JAXB2读写XML消息，将请求消息转换为标注的XmlRootElement和XmlType连接的类中
MappingJacksonHttpMessageConverter	利用Jackson开源包的ObjectMapper读写JSON数据
RssChannelHttpMessageConverter	读写RSS种子消息
AtomFeedHttpMessageConverter	和RssChannelHttpMessageConverter能够读写RSS种子消息

根据HTTP协议的Accept和Content-Type属性，以及参数数据类型来判别使用哪一种HttpMessageConverter。当使用RequestBody或ResponseBody时，再结合前端发送的Accept数据类型，会自动判定优先使用MappingJacksonHttpMessageConverter作为数据转换器。但是，不仅JSON可以表达对象数据类型，XML也可以。如果我们希望使用XML格式该怎么告知Spring呢，那就要使用到produces属性了。

@GetMapping(value ="/articles",produces = MediaType.APPLICATION_XML_VALUE)

这里我们明确的告知了返回的数据类型是xml，就会使用Jaxb2RootElementHttpMessageConverter作为默认的数据转换器。当然实现XML数据响应比JSON还会更复杂一些，还需要结合@XmlRootElement、@XmlElement等注解实体类来使用。同理consumes属性你是不是也会用了呢。

 五、自定义HttpMessageConverter

其实绝大多数的数据格式都不需要我们自定义HttpMessageConverter，都有第三方类库可以帮助我们实现(包括下文代码中的Excel格式)。但有的时候，有些数据的输出格式并没有类似于Jackson这种类库帮助我们处理，需要我们自定义数据格式。该怎么做?

下面我们就以Excel数据格式为例，写一个自定义的HTTP类型转换器。实现的效果就是，当我们返回ResponseResult这种数据类型的话，就自动将ResponseResult转成Excel数据响应给客户端。

<dependency>
   <groupId>org.apache.poi</groupId>
   <artifactId>poi-ooxml</artifactId>
   <version>3.9</version>
</dependency>

package com.yiidian.springboot.demo.conveter;

import com.yiidian.springboot.demo.utils.ResponseResult;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.usermodel.Workbook;
import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.MediaType;
import org.springframework.http.converter.AbstractHttpMessageConverter;
import org.springframework.http.converter.HttpMessageNotReadableException;
import org.springframework.http.converter.HttpMessageNotWritableException;
import org.springframework.stereotype.Service;

import java.io.IOException;

@Service
public class ResponseToXlsConverter extends AbstractHttpMessageConverter<ResponseResult> {

    private static final MediaType EXCEL_TYPE = MediaType.valueOf("application/vnd.ms-excel");

    ResponseToXlsConverter() {
        super(EXCEL_TYPE);
    }

    @Override
    protected ResponseResult readInternal(final Class<? extends ResponseResult> clazz,
                                final HttpInputMessage inputMessage)
            throws IOException, HttpMessageNotReadableException {
        return null;
    }

    //针对ResponseResult类型返回值，使用下面的writeInternal方法进行消息类型转换
    @Override
    protected boolean supports(final Class<?> clazz) {
        return (ResponseResult.class == clazz);
    }

    @Override
    protected void writeInternal(final ResponseResult responseResult, final HttpOutputMessage outputMessage)
            throws IOException, HttpMessageNotWritableException {

        final Workbook workbook = new HSSFWorkbook();
        final Sheet sheet = workbook.createSheet();

        final Row row = sheet.createRow(0);
        row.createCell(0).setCellValue(responseResult.getMessage());
        row.createCell(1).setCellValue(responseResult.getData().toString());

        workbook.write(outputMessage.getBody());
    }
}

• 实现AbstractHttpMessageConverter接口
• 指定该转换器是针对哪种数据格式的？如上文代码中的"application/vnd.ms-excel"
• 指定该转换器针对那些对象数据类型？如上文代码中的supports函数
• 使用writeInternal对数据进行输出处理，上例中是输出为Excel格式。

浏览器访问：http://localhost:8888/rest/article/1，发现会下载一个Excel文件

打开Excel内容如下：

 

下载本文源码：springboot-demo