本篇将主要介绍以下几种数据格式的返回实例
-
返回文本
-
返回数组
-
返回json串
-
返回静态网页
-
返回图片
I. 环境搭建
首先得搭建一个web应用才有可能继续后续的测试,借助SpringBoot搭建一个web应用属于比较简单的活;
创建一个maven项目,pom文件如下
依然是一般的流程,pom依赖搞定之后,写一个程序入口
II. 数据返回姿势实例
以下返回实例都放在同一个Controller中,具体定义如下
1. 文本返回
这个属于基础功能了,发起请求,返回一串文本,在SpringMVC的体系中,要实现这种通常的写法通常是直接定义方法的返回为String;当然还有另外一种非常基础的写法,直接将返回的数据通过 HttpServletResponse
写入到输出流中
下面给出这两种写法的实例
注意上面的实现中,方法上面多了一个注解 @ResponseBody
,这个表示返回数据,而不是视图(后面会详细说明)
strRsp2
的输出借助了FastJson来实现将map序列化为json串,然后写入输出流
实例访问如下
从上面的输出也可以看出,第一种返回方式, ResponseHeaders
的 Content-Type:text/html;charset=UTF-8
;而第二种方式则没有这个响应头,需要我们自己主动设置(这里注意一下即可,在后面的返回图片中有实例)
2,返回数组
前面请求参数的博文中,我们看到请求参数允许传入数组,那么我们返回可以直接返回数组么?讲道理的话,应该没啥问题
然后请求输出为
注意下响应头,为 application/json
, 也就是说SpringMVC将数组当成json串进行返回了
3. Bean返回
在我们实际的业务开发中,这种应该属于非常常见的使用姿势了,直接返回一个POJO,调用者接收的是一个json串,可以很容易的反序列化为需要的对象
4. 网页返回
前面都是直接返回数据,但是我们平常在使用浏览器,更多的是发起一个请求,然后返回一个网页啊,难道说springmvc不能直接返回网页么?
当然返回网页怎么可能会不支持,(题外话:个人感觉在前后端分离逐渐流行之后,直接由后端返回网页的case不太多了,前端和后端作为独立的项目部署,两者之间通过json串进行交流;这里扯远了),我们下面看一下SpringMVC中如何返回网页
我们可以从上面直接返回字符串的case中,得到一个思路,如果我直接返回一个html文本,会怎样?既然返回 content-type
是 text/html
,那浏览器应该可以解析为网页的,下面实测一下
-
@ResponseBody
-
@GetMapping(path = "html")
-
public String strHtmlRsp() {
-
return "<html>\n" + "<head>\n" + " <title>返回数据测试</title>\n" + "</head>\n" + "<body>\n" +
-
"<h1>欢迎欢迎,热烈欢迎</h1>\n" + "</body>\n" + "</html>";
-
}
测试如下
浏览器发起请求之后,将我们返回的html文本当做网页正常渲染了,所以我们如果想返回网页,就这么干,没毛病!
上面这种方式虽然说可以返回网页,然而在实际业务中,如果真要我们这么干,想想也是可怕,还干什么后端,分分钟全栈得了!!!
下面看一下更常规的写法,首先我们需要配置下返回视图的前缀、后缀, 在 application.yml
配置文件中添加如下配置
文章来源地址https://www.toymoban.com/news/detail-833932.html
然后我们的静态网页,放在资源文件的static目录下,下面是我们实际的项目截图,index.html为我们需要返回的静态网页
接下来就是我们的服务接口
注意下上面的接口,没有 @ResponseBody
注解,表示这个接口返回的是一个视图,会从static目录下寻找名为 index.html
(前缀路径和后缀是上面的application.yml中定义)的网页返回
实测case如下
5. 图片返回
图片返回与前面的又不太一样了,上面介绍的几种case中,要么是返回文本,要么返回视图,而返回图片呢,更多的是返回图片的字符数组,然后告诉浏览器这是个图片,老哥你按照图片渲染
直接返回二进制流,上面在介绍文本返回的两种方式中,有个直接通过 HttpServletResponse
向输出流中写数据的方式,我们这里是不是可以直接这么用呢?
下面给出一个从网络下载图片并返回二进制流的实际case
注意下上面的实例case,首先设置了返回的 ContentType
,然后借助 ImateIO
来下载图片(个人不太建议这种写法,很容易出现403;这里演示主要是为了简单...),并将图片写入到输出流
实例演示如下
III 小结
1. 返回数据小结
本篇博文主要介绍了几种常见数据格式的返回使用姿势,本文更多的是一种使用方式的实例case演示,并没有涉及到底层的支持原理,也没有过多的提及如何设置响应头,web交互中常见的cookies/session也没有说到,这些将作为下篇的内容引入,恳请关注
下面做一个简单的小结
返回纯数据
-
添加
@ResponseBody
注解,则表示我们返回的是数据,而不需要进行视图解析渲染; -
如果一个controller中全部都是返回数据,不会返回视图时,我们可以在添加
@RestController
注解,然后这个类中的接口都不需要添加@ResponseBody
注解了 -
返回视图时,我们会根据接口返回的字符串,结合定义的前缀,后缀,到资源路径的static目录下寻找对应的静态文件返回
-
可以直接通过向
HttpServletResponse
的输出流中写数据的方式来返回数据,如返回图片常用这种case文章来源:https://www.toymoban.com/news/detail-833932.html
到了这里,关于SpringBoot系列教程web篇之返回文本、网页、图片的操作姿势的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!