【Spring 篇】SpringMVC的数据响应:编织美妙的返回乐章

发布时间:2024年01月15日

在这里插入图片描述

在Web开发的舞台上,数据响应就如同一场美妙的音乐演奏,而SpringMVC作为这场音乐的指挥者,如何优雅地将数据传递给前端,引发了无尽的思考和探索。本篇博客将带你走进SpringMVC的数据响应世界,解开其中的奥秘,感受这场编织美妙的返回乐章。

起舞的ModelAndView

在SpringMVC中,ModelAndView是一个神奇的对象,它承载着控制器方法的返回值,将模型数据和视图信息一同传递给前端。让我们通过一个简单的例子来感受一下ModelAndView的魅力。

@Controller
@RequestMapping("/music")
public class MusicController {

    @GetMapping("/play")
    public ModelAndView playMusic() {
        ModelAndView modelAndView = new ModelAndView("music-player");
        modelAndView.addObject("song", "Spring Symphony");
        return modelAndView;
    }
}

在这个例子中,playMusic方法返回一个ModelAndView对象,其中指定了视图名为"music-player",并通过addObject方法将音乐的信息传递给前端。接下来,我们需要在/WEB-INF/views目录下创建一个名为music-player.jsp的JSP页面,用于展示音乐信息。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Music Player</title>
</head>
<body>
    <h1>Now Playing: ${song}</h1>
</body>
</html>

在这个JSP页面中,${song}将会被替换为控制器传递过来的音乐信息。当用户访问/music/play时,将看到页面上显示着"Now Playing: Spring Symphony"的欢迎消息。

Model:数据的魔法师

在SpringMVC的数据传递中,Model起到了一个重要的角色,它是一个接口,代表了模型数据的容器。控制器方法的参数中使用Model,就可以向前端传递数据。

@Controller
@RequestMapping("/magician")
public class MagicianController {

    @GetMapping("/castSpell")
    public String castSpell(Model model) {
        model.addAttribute("magicWord", "Abracadabra!");
        return "magic-show";
    }
}

在这个例子中,castSpell方法的参数中使用了Model,通过addAttribute方法将"magicWord"属性和对应的值传递给前端。在/WEB-INF/views目录下创建一个名为magic-show.jsp的JSP页面,用于展示魔法词语。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Magic Show</title>
</head>
<body>
    <h1>Behold the magic: ${magicWord}</h1>
</body>
</html>

当用户访问/magician/castSpell时,页面将显示"Behold the magic: Abracadabra!"。

响应JSON:数据的轻盈旋律

除了传递HTML页面,SpringMVC还能轻松应对前后端分离的场景,以JSON的形式返回数据。JSON,即JavaScript Object Notation,是一种轻量级的数据交换格式,易于阅读和编写,也易于机器解析和生成。

@RestController
@RequestMapping("/api")
public class ApiController {

    @GetMapping("/getSong")
    public Map<String, String> getSong() {
        Map<String, String> songMap = new HashMap<>();
        songMap.put("songName", "Spring Serenade");
        return songMap;
    }
}

在这个例子中,ApiController使用了@RestController注解,表示这是一个RESTful风格的控制器,专门用于返回数据。getSong方法返回一个Map,其中包含了歌曲的信息。当用户访问/api/getSong时,将得到一个JSON格式的响应:

{
  "songName": "Spring Serenade"
}

响应状态码:音符的情感色彩

有时候,我们不仅需要返回数据,还需要传达一些特定的情感或状态信息。在HTTP协议中,状态码是一种常用的传递方式,SpringMVC也提供了简便的方式来设置响应状态码。

@RestController
@RequestMapping("/emotion")
public class EmotionController {

    @GetMapping("/express")
    public ResponseEntity<String> expressEmotion() {
        HttpHeaders headers = new HttpHeaders();
        headers.add("Express-Color", "Spring Green");
        return new ResponseEntity<>("Expressing happiness!", headers, HttpStatus.OK);
    }
}

在这个例子中,EmotionController返回了一个ResponseEntity对象,其中包含了响应的主体内容、头信息和状态码。用户访问/emotion/express时,将得到一个带有自定义头信息的HTTP 200 OK响应,响应内容为"Expressing happiness!"。

异常处理:和弦的优雅回响

在音乐的世界里,有时会出现一些不可避免的小插曲,而在编写Web应用程序时,处理异常也是不可或缺的一环。SpringMVC通过@ExceptionHandler注解提供了简单而强大的异常处理机制。

@Controller
@RequestMapping("/orchestra")
public class OrchestraController {

    @GetMapping("/playConcert")
    public String playConcert() {
        // 模拟异常
        throw new ConcertFailedException("Concert failed due to technical issues.");
    }

    @ExceptionHandler(ConcertFailedException.class)
    public ModelAndView handleConcertFailedException(ConcertFailedException ex) {
        ModelAndView modelAndView = new ModelAndView("concert-failed");
        modelAndView.addObject("errorMessage", ex.getMessage());
        return modelAndView;
    }
}

在这个例子中,playConcert方法模拟了一个音乐会中的异常,抛出了一个ConcertFailedException。而在同一个控制器中,通过@ExceptionHandler注解的handleConcertFailedException方法,对特定的异常进行处理。创建一个名为concert-failed.jsp的JSP页面,用于展示音乐会失败的信息。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Concert Failed</title>
</head>
<body>
    <h1>Oh no! The concert failed.</h1>
    <p>Error Message: ${errorMessage}</p>
</body>
</html>

当用户访问/orchestra/playConcert时,将得到一个页面,显示"Oh no! The concert failed.",并展示详细的错误信息。

静态资源:背景音乐的魔法

在Web应用中,除了动态生成的数据,还有一些静态资源,比如图片、样式表和JavaScript文件等。SpringMVC通过ResourceHandlerRegistry提供了方便的静态资源处理。

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/music-bg.mp3")
                .addResourceLocations("classpath:/static/music/")
                .setCachePeriod(3600)
                .resourceChain(true)
                .addResolver(new GzipResourceResolver())
                .addResolver(new PathResourceResolver());
    }
}

在这个例子中,通过addResourceHandlers方法配置了静态资源的处理,当用户访问/music-bg.mp3时,将从classpath中的/static/music/目录下寻找对应的音乐文件。这样,我们就能够在Web应用中添加一些背景音乐了。

跨域请求处理:音乐的跨界演奏

在现代Web开发中,跨域请求已成为常态。SpringMVC通过@CrossOrigin注解提供了简单的跨域请求处理方式。

@RestController
@RequestMapping("/cross-domain")
public class CrossDomainController {

    @GetMapping("/playMusic")
    @CrossOrigin(origins = "http://allowed-domain.com")
    public Map<String, String> playMusic() {
        Map<String, String> songMap = new HashMap<>();
        songMap.put("songName", "Cross-domain Symphony");
        return songMap;
    }
}

在这个例子中,通过@CrossOrigin注解,设置了允许访问的域名为"http://allowed-domain.com"。当该控制器方法被访问时,只有来自该域名的请求将被允许。

结语

SpringMVC的数据响应,就如同一场千变万化的音乐会,通过ModelAndViewModel、JSON、响应状态码、异常处理、静态资源处理、跨域请求处理等组件,为开发者提供了丰富而灵活的数据传递方式。在这个美妙的乐章中,每个组件都有其独特的声音,共同奏响了Web开发的交响曲。愿你在编写代码的过程中,能够更好地驾驭这些乐谱,创造出属于自己的音乐之美。在代码的海洋里,与数据的旋律共舞,愉悦前行。

作者信息

作者 : 繁依Fanyi
CSDN: https://techfanyi.blog.csdn.net
掘金:https://juejin.cn/user/4154386571867191
文章来源:https://blog.csdn.net/qq_21484461/article/details/135611895
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。