[Java知识库] springboot---003（Spring Boot 下的 Spring MVC 讲解以前没遇到的注解）

1.@Controller

Spring MVC 的注解，处理 http 请求

2.@RestController

Spring 4 后新增注解，是 @Controller 注解功能的增强

是 @Controller 与 @ResponseBody 的组合注解

如果一个 Controller 类添加了 @RestController ，那么该 Controller 类下的所有方法都相当

于添加了 @ResponseBody 注解

用于返回字符串或 json 数据

演示@RestController 替代@Controller + @ResponseBody

3.@RequestMapping （常用? ?增删改查）

支持 Get（查）? 请求，也支持 Post（增、删、改）? 请求（浏览器只支持这两种请求）

4. @GetMapping（查）

RequestMapping 和 Get 请求方法的组合

只支持 Get 请求

Get 请求主要用于查询操作

5.@PostMapping（增）

RequestMapping 和 Post 请求方法的组合

只支持 Post 请求

Post 请求主要用户新增数据

6.@PutMapping（改）

RequestMapping 和 Put 请求方法的组合

只支持 Put 请求

Put 通常用于修改数据

7.@DeleteMapping

RequestMapping 和 Delete 请求方法的组合

只支持 Delete 请求

通常用于删除数据

实例展示：（要会）

package com.zsz.springboot.web;

import com.zsz.springboot.model.Student;
import org.springframework.web.bind.annotation.*;


//@Controller
@RestController  //相当于控制层类上加@Controller + 方法上加@ResponseBody
// 意味着当前控制层类中所有方法返还的都是JSON对象
public class StudentController {


    @RequestMapping(value = "/student")
//    @ResponseBody
    public Object student() {
        Student student = new Student();
        student.setId(1001);
        student.setName("zhangsan");
        return student;
    }

    //该方法请求方式支持:GET和POST请求
    @RequestMapping(value = "/queryStudentById",method = {RequestMethod.GET,RequestMethod.POST})
    public Object queryStudentById(Integer id) {
        Student student = new Student();
        student.setId(id);
        return student;
    }


//    @RequestMapping(value = "/queryStudentById2",method = RequestMethod.GET)
    @GetMapping(value = "/queryStudentById2") //相当于上一句话,只接收GET请求,如果请求方式不对会报405错误
    //该注解通过在查询数据的时候使用 -> 查询
    public Object queryStudentById2() {
        return "Ony GET Method";
    }

//    @RequestMapping(value = "/insert",method = RequestMethod.POST)
    @PostMapping(value = "/insert") //相当于一句话
    //该注解通常在新增数据的时候使用 -> 新增
    public Object insert() {
        return "Insert success";
    }

//    @RequestMapping(value = "/delete",method = RequestMethod.DELETE)
    @DeleteMapping(value = "/delete")//相当于上一句话
    //该注解通常在删除数据的时候使用 -> 删除
    public Object delete() {
        return "delete Student";
    }


//    @RequestMapping(value = "/update",method = RequestMethod.PUT)
    @PutMapping(value = "/update") //相当于上一句话
    //该注解通常在修改数据的时候使用 -> 更新
    public Object update() {
        return "update student info1";
    }
}

那这些接口在哪里测试呢？怎么知道他是什么请求？

postman：

因为通过浏览器输入地址，默认发送的只能是 get 请求，通过 Postman 工具，可以模拟

发送不同类型的请求，并查询结果。

?顺便了解一下：

Spring Boot 实现 RESTful（就只是一种风格，不是标准）

1.认识 RESTFul

REST （英文： Representational State Transfer ，简称 REST ）

一种互联网软件架构设计的风格，但它并不是标准，它只是提出了一组客户端和服务器

交互时的架构理念和设计原则，基于这种理念和原则设计的接口可以更简洁，更有层次， REST

这个词，是 Roy Thomas Fielding 在他 2000 年的博士论文中提出的。

任何的技术都可以实现这种理念，如果一个架构符合 REST 原则，就称它为 RESTFul 架

构

比如我们要访问一个 http 接口： http://localhost:8080/boot/order?id=1021&status=1

采用 RESTFul 风格则 http 地址为： http://localhost:8080/boot/order/1021/1

（1）@PathVariable

获取 url 中的数据

该注解是实现 RESTFul 最主要的一个注解

实例展示：

package com.zsz.springboot.web;

import com.zsz.springboot.model.Student;
import org.springframework.web.bind.annotation.*;

import java.util.HashMap;
import java.util.Map;


@RestController
public class StudentController {


    @RequestMapping(value = "/student")
    public Object student(Integer id,Integer age) {
        Student student = new Student();
        student.setId(id);
        student.setAge(age);
        return student;
    }

//    @RequestMapping(value = "/student/detail/{id}/{age}")
    @GetMapping(value = "/student/detail/{id}/{age}")
    public Object student1(@PathVariable("id") Integer id,
                           @PathVariable("age") Integer age) {
        Map<String,Object> retMap = new HashMap<>();

        retMap.put("id",id);
        retMap.put("age",age);
        return retMap;
    }

//    @RequestMapping(value = "/student/detail/{id}/{status}")
    @DeleteMapping(value = "/student/detail/{id}/{status}")
    public Object student2(@PathVariable("id") Integer id,
                           @PathVariable("status") Integer status) {
        Map<String,Object> retMap = new HashMap<>();

        retMap.put("id",id);
        retMap.put("status",status);
        return retMap;
    }

    //以上代码student1和student2会出现请求路径冲突问题
    //通常在RESTful风格中方法的请求方式会按增删改查的请求方式来区分
    //修改请求路径
    //RESUful请求风格要求路径中使用的单词都是名称,最好不要出现动词

    @DeleteMapping(value = "/student/{id}/detail/{city}")
    public Object student3(@PathVariable("id") Integer id,
                           @PathVariable("city") Integer city) {
        Map<String,Object> retMap = new HashMap<>();

        retMap.put("id",id);
        retMap.put("city",city);
        return retMap;
    }

    @PostMapping(value = "/student/{id}")
    public String addStudent(@PathVariable("id") Integer id) {
        return "add student ID:" + id;
    }

    @PutMapping(value = "/student/{id}")
    public String updateStudent(@PathVariable("id") Integer id) {
        return "update Student ID:" +id;
    }
}

RESTful 原则

1.增 post 请求、删 delete 请求、改 put 请求、查 get 请求

2.请求路径不要出现动词

例如：查询订单接口

/boot/order/1021/1 （推荐）

/boot/queryOrder/1021/1 （不推荐）

3.分页、排序等操作，不需要使用斜杠传参数

例如：订单列表接口

/boot/orders?page=1&sort=desc

一般传的参数不是数据库表的字段，可以不采用斜杠

[Java知识库]springboot---003（Spring Boot 下的 Spring MVC 讲解以前没遇到的注解）