Spring MVC中Restful风格引入

一，RESTful概述

        在现代Web应用开发中，RESTful架构风格已成为一种标准实践，特别是在构建可扩展的Web服务时。Spring MVC提供了全面的支持来构建遵循REST原则的Web服务。我在此介绍如何在Spring MVC中实现RESTful风格的Web服务，并通过示例演示其使用。

二，什么是RESTful架构?

        Spring MVC是一个强大的模块化框架，可以通过声明式的方式轻松创建Web应用。使用Spring MVC实现RESTful Web服务的优势包括：

        支持注解：Spring的@RestController和@RequestMapping等注解使得创建RESTful服务变得简单直观。

        数据绑定：自动的数据绑定支持，可以将请求自动转换为模型对象，同时也支持多种数据格式的响应，如XML、JSON等。

        异常处理：通过@ExceptionHandler提供了统一的异常处理机制。        

        依赖注入：利用Spring的依赖注入优势，更好地管理服务层。

三，实现RESTful服务的基本步骤

1. 创建Spring MVC项目

2.定义资源表示类

        在Spring中，资源通常以POJO（Plain Old Java Object）类表示。例如，一个用户资源可以定义如下：

public class User {private Integer id;private String name;private String email;// getters and setters
}

 3. 创建REST控制器

@RestController
@RequestMapping("/api/users")
public class UserController {@GetMapping("/{id}/{a}/{b}")public ResponseEntity<User> getUserByIdAndParams(@PathVariable Integer id,@PathVariable String a,@PathVariable String b) {// 示例：根据id获取用户，并可能使用a和b进行一些额外操作User user = userService.findById(id);// 示例逻辑：假设a和b是要应用到User对象的操作或变量user.setSomeField(a);user.setAnotherField(b);return ResponseEntity.ok(user);}//处理POST请求，用于创建新用户@PostMappingpublic ResponseEntity<User> createUser(@RequestBody User user) {User createdUser = userService.create(user);//返回状态码201 (Created)，表示资源已被成功创建return new ResponseEntity<>(createdUser, HttpStatus.CREATED);}//处理PUT请求，用于更新指定ID的用户@PutMapping("/{id}")public ResponseEntity<User> updateUser(@PathVariable Integer id, @RequestBody User user) {User updatedUser = userService.update(id, user);//方法中首先根据ID更新用户信息，然后返回更新后的用户数据return ResponseEntity.ok(updatedUser);}// 处理DELETE请求，用于删除指定ID的用户@DeleteMapping("/{id}")public ResponseEntity<Void> deleteUser(@PathVariable Integer id) {userService.delete(id);//返回一个无内容的响应（HTTP 204 No Content），表示请求已成功处理，但没有内容返回return ResponseEntity.noContent().build();}
}

    在上面的方法中，我在@GetMapping("/{id}/{a}/{b}”)定义了一个带有三个参数的路径：

• {id} ：用户的唯一标识符。
• {a}和{b}：这两个参数可以用于业务逻辑中的其他目的，比如作为查询参数或用于修改返回的数据。
• @PathVariable：将URL中的变量绑定到方法的参数上。此方法接收三个参数：用户ID (id) 和两个字符串参数 (a,b)。

4. 异常处理

处理REST API中可能发生的异常，例如资源找不到。

@ResponseStatus(HttpStatus.NOT_FOUND)
public class ResourceNotFoundException extends RuntimeException {public ResourceNotFoundException(String message) {super(message);}
}

在控制器中使用@ExceptionHandler处理异常：

@ControllerAdvice
public class RestExceptionHandler {@ExceptionHandler(ResourceNotFoundException.class)public ResponseEntity<String> handleResourceNotFound(ResourceNotFoundException ex) {return new ResponseEntity<>(ex.getMessage(), HttpStatus.NOT_FOUND);}
}

 四，@RestController注解和@Controller注解对比

@RestController：该控制器的所有方法默认都是直接返回数据给客户端，而不是返回视图的名称。这种方式特别适用于构建RESTful Web服务，其中数据（如JSON或XML）直接返回给调用者。

@Controller：这通常用于更传统的Web应用程序，其中控制器的作用是设置模型数据并返回视图的名称，由视图（如JSP）来生成HTML响应。

  下面例子用@Controller重写上面提到的post方法

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.ModelAndView;@Controller
@RequestMapping("/api/users")
public class UserController {@PostMappingpublic String createUser(@ModelAttribute User user) {User createdUser = userService.create(user);return "redirect:/users/list"; // 重定向到用户列表页面}// 其他方法保持不变...
}

        这样做表明我们不再期望所有方法自动将返回值作为响应体返回，而是可以返回视图名称。这里返回的字符串"redirect:/users/list"指示Spring MVC进行重定向到给定的路径，有时候也可以直接返回视图jsp的名称，如:test.jsp可以直接return "test"，参考如下五

五，springmvc中使用转发和重定向

        通过SpringMVC来实现转发和重定向-有视图解析器;

<!--视图解折器:模板引等 Thymeleaf Freemarker...-->
<bean class="org.springframework,web.servlet.view,InternalResourceViewResolver" id="InternalResourceViewResolver"
<!--时级-->
<property name="prefix" value."/WEB-INF/jsP/"/>“--行级-->
<property name="suffix" value=".jsp"/>
</bean>

        重定向，不需要视图解析器，本质就是重新请求一个新地方嘛，所以注意路径问题可以重定向到另外一个请求实现

@controller
public class ResultspringMvc{@RequestMapping("/rsm2/t1")public string test1(){//转发return"test";//返回test.jsp视图}@RequestMapping("/rsm2/t2")public string test2(){//重定向return "redirect:/index.jsp";//return"redirect:hello.do";//hello.do为另一个请求/}
}