Spring04：Spring MVC

一、Spring MVC核心解析

Spring MVC是基于Java实现MVC模型的轻量级Web框架，其核心优势在于简化Web开发、灵活性强和与Spring生态无缝集成。通过分层设计，它将应用分为：

• Controller层：处理请求和响应

• Service层：业务逻辑处理

• Dao层：数据持久化操作

分层架构示例（Spring Boot + MyBatis） 

1. Dao层（数据访问层）

// UserDao.java（接口）
@Mapper
public interface UserDao {
    // 根据ID查询用户
    User getUserById(Long id);
    
    // 创建用户
    int createUser(User user);
    
    // 更新用户
    int updateUser(User user);
    
    // 删除用户
    int deleteUser(Long id);
}

    
        SELECT id, name, email FROM users WHERE id = #{id}
    
    
    
        INSERT INTO users(name, email) VALUES(#{name}, #{email})
    
    
    
        UPDATE users SET name=#{name}, email=#{email} WHERE id=#{id}
    
    
    
        DELETE FROM users WHERE id = #{id}
    

 2. Service层（业务逻辑层）

// UserService.java
@Service
public class UserService {
    @Autowired
    private UserDao userDao;

    public User getUserById(Long id) {
        // 可添加业务逻辑（如缓存、权限校验等）
        return userDao.getUserById(id);
    }

    public User createUser(UserCreateRequest request) {
        // 业务逻辑验证（如邮箱格式校验）
        User user = new User();
        user.setName(request.getName());
        user.setEmail(request.getEmail());
        userDao.createUser(user);
        return user;
    }

    public User updateUser(Long id, UserUpdateRequest request) {
        User user = userDao.getUserById(id);
        if (user == null) throw new ResourceNotFoundException("User not found");
        
        user.setName(request.getName());
        user.setEmail(request.getEmail());
        userDao.updateUser(user);
        return user;
    }

    public void deleteUser(Long id) {
        userDao.deleteUser(id);
    }
}

3. Controller层（控制层）

// UserController.java
@RestController
@RequestMapping("/api/users")  // 资源基础路径
public class UserController {
    @Autowired
    private UserService userService;

    // GET /api/users/123 -> 获取ID为123的用户
    @GetMapping("/{id}")
    public ResponseEntity getUser(@PathVariable Long id) {
        User user = userService.getUserById(id);
        return ResponseEntity.ok(user);
    }

    // POST /api/users -> 创建新用户
    @PostMapping
    public ResponseEntity createUser(@Valid @RequestBody UserCreateRequest request) {
        User user = userService.createUser(request);
        return ResponseEntity.created(URI.create("/api/users/" + user.getId())).body(user);
    }

    // PUT /api/users/123 -> 全量更新用户
    @PutMapping("/{id}")
    public ResponseEntity updateUser(
            @PathVariable Long id,
            @Valid @RequestBody UserUpdateRequest request) {
        User user = userService.updateUser(id, request);
        return ResponseEntity.ok(user);
    }

    // DELETE /api/users/123 -> 删除用户
    @DeleteMapping("/{id}")
    public ResponseEntity deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
        return ResponseEntity.noContent().build();  // 返回204状态码
    }
}

二、五大核心特性详解

1. 灵活的请求映射

注解	作用	使用位置	示例
@Controller	声明 MVC 控制器	类上方	@Controller class UserCtrl
@RequestMapping	定义类/方法级别的请求路径	类/方法上方	@RequestMapping("/api")
@GetMapping	映射 GET 请求	方法上方	@GetMapping("/users")
@PostMapping	映射 POST 请求	方法上方	@PostMapping("/users")
@PutMapping	映射 PUT 请求	方法上方	@PutMapping("/users/{id}")
@DeleteMapping	映射 DELETE 请求	方法上方	@DeleteMapping("/users/{id}")
@ResponseBody	将返回值直接写入响应体	方法上方	@ResponseBody User getUser()

• 路径映射：@RequestMapping 支持类/方法级映射

• RESTful支持：@GetMapping, @PostMapping 等简化HTTP方法映射

• 路径变量：@PathVariable 获取URI动态参数

@DeleteMapping("/{id}")
public boolean delete(@PathVariable Integer id) {
    return bookService.delete(id);
}

2. 强大的参数绑定

注解	数据来源	适用场景
@RequestParam	URL 查询字符串	?name=John&age=30
@PathVariable	URL 路径片段	/users/{id}
@RequestBody	HTTP 请求体	JSON/XML 格式数据

支持多种参数类型自动绑定：

参数类型	注解/用法	示例
普通参数	@RequestParam	?name=value
POJO对象	直接声明对象类型	表单字段匹配对象属性
JSON数据	@RequestBody	接收JSON请求体
数组/集合	@RequestParam List<>	?likes=game&likes=music

•  @RequestParam与@RequestBody的对比：

维度	@RequestParam	@RequestBody
数据位置	URL 查询参数（?key=value）	HTTP 请求体（JSON/XML 数据）
适用场景	GET 请求的简单参数	POST/PUT 的复杂对象传输
数据类型	基本类型（String/int/boolean）	对象/集合（DTO/List/Map）
必传性	默认必传，可设 required=false	默认必传，可设 required=false
示例	/users?name=John	{"name":"John","age":30}

3. 统一异常处理

通过@RestControllerAdvice实现全局异常处理：

@RestControllerAdvice
public class ProjectExceptionAdvice {
    
    @ExceptionHandler(BusinessException.class)
    public Result handleBusinessException(BusinessException ex) {
        return new Result(ex.getCode(), null, ex.getMessage());
    }
    
    @ExceptionHandler(Exception.class)
    public Result handleException(Exception ex) {
        return new Result(500, null, "系统繁忙");
    }
}

4. 拦截器机制

实现HandlerInterceptor接口创建拦截器：

@Component
public class AuthInterceptor implements HandlerInterceptor {
    
    @Override
    public boolean preHandle(HttpServletRequest request, 
                            HttpServletResponse response, 
                            Object handler) {
        // 权限验证逻辑
        if(!checkAuth(request)) {
            response.sendError(403);
            return false;
        }
        return true;
    }
}

5. RESTful风格支持

注解	RESTful 专用功能	使用示例
@RestController	=@Controller+@ResponseBody	@RestController class UserAPI
@PathVariable	获取 URI 中的动态变量	getUser(@PathVariable Long id)

• URI即资源标识符

  • 每个URI对应唯一资源：/api/users/123 表示ID为123的用户

  • 资源使用名词/users而非动词 /getUsers

• HTTP方法定义操作

  方法	操作	示例
  GET	查询	GET /users/123
  POST	创建	POST /users
  PUT	全量更新	PUT /users/123
  PATCH	部分更新	PATCH /users/123
  DELETE	删除	DELETE /users/123

• 状态码表示结果

  • 200 OK：成功

  • 201 Created：资源创建成功

  • 204 No Content：操作成功无返回体

  • 404 Not Found：资源不存在

 三、最佳实践：SSM整合

1. 整合关键配置

// Spring配置类
@Configuration
@ComponentScan({"com.service", "com.dao"})
@PropertySource("classpath:jdbc.properties")
@Import({JdbcConfig.class, MybatisConfig.class})
@EnableTransactionManagement
public class SpringConfig {}

// SpringMVC配置类
@Configuration
@ComponentScan("com.controller")
@EnableWebMvc
public class SpringMvcConfig {}

注解	整合作用	使用场景
@ComponentScan	配置 Spring 组件扫描路径	@ComponentScan("com.app")
@EnableWebMvc	启用 Spring MVC 特性	@Configuration @EnableWebMvc

2. 统一响应封装

public class Result {
    private Object data;
    private Integer code;
    private String msg;
    
    // 成功静态方法
    public static Result success(Object data) {
        return new Result(200, data, "操作成功");
    }
}

 3. 事务管理

@Service
@Transactional(rollbackFor = Exception.class)
public class BookServiceImpl implements BookService {
    // 业务方法自动具备事务
}

四、性能优化技巧

• 静态资源处理

@Override
protected void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/static/**")
            .addResourceLocations("/static/");
}

• JSON序列化优化

    com.fasterxml.jackson.core
    jackson-databind

• 拦截器链配置

@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(logInterceptor).order(1);
    registry.addInterceptor(authInterceptor).order(2);
}

五、常见问题解决方案

• 中文乱码问题

protected Filter[] getServletFilters() {
    CharacterEncodingFilter filter = new CharacterEncodingFilter();
    filter.setEncoding("UTF-8");
    return new Filter[]{filter};
}

• 跨域处理

@Bean
public CorsFilter corsFilter() {
    CorsConfiguration config = new CorsConfiguration();
    config.addAllowedOrigin("*");
    config.addAllowedMethod("*");
    config.addAllowedHeader("*");
    
    UrlBasedCorsConfigurationSource source = 
        new UrlBasedCorsConfigurationSource();
    source.registerCorsConfiguration("/**", config);
    return new CorsFilter(source);
}

• 日期类型转换

注解	整合作用	使用场景
@DateTimeFormat	日期参数格式化（基础用法）	方法参数或 DTO 字段

@RequestMapping("/date")
public String dateParam(@DateTimeFormat(pattern="yyyy-MM-dd") Date date) {
    // 处理日期
}

       DateTimeFormat 深度解析

属性	作用	示例值
pattern	自定义日期格式	"yyyy-MM-dd HH:mm:ss"
iso	使用 ISO 标准格式	ISO.DATE (yyyy-MM-dd)
timezone	设置时区	"GMT+8"

public List getEvents(
    @RequestParam @DateTimeFormat(pattern="yyyy-MM-dd") Date startDate
) {
    // 处理日期参数
}

六、总结

        Spring MVC通过其优雅的设计和强大的扩展能力，成为构建Java Web应用的首选框架。关键优势包括：

• 清晰的MVC分层架构

• 灵活的请求处理机制

• 强大的数据绑定能力

• 完善的异常处理体系

• 深度整合Spring生态