SpringBoot入门(黑马)

1. SpringBootWeb入门开发

需求：使用SpringBoot 开发一个web 应用，浏览器发起请求 /hello 后，给浏览器返回字符串"Hello World~"。

步骤：

1. 创建springBoot工程，并勾选web开发相关依赖。

2. 定义 HelloController类，添加方法 hello，并添加注释。

3. 运行测试

@RestController
// @RestController 标识下面这个类为请求处理类
public class HelloController {
    @RequestMapping("/hello")
    // @RequestMapping("/hello") 指定请求处理路径
    public String hello(){
        System.out.println("hello world~");
        return "hello world~";
    }
}

启动类

// 启动类 启动springBoot 工程
@SpringBootApplication
public class Demo1Application {

    public static void main(String[] args) {
        SpringApplication.run(Demo1Application.class, args);
    }
}

2. postman

2.1 postman简介

Postman 是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件。

作用：常用于进行接口测试

2.2 postman安装

下方为安装链接

Postman API Platform | Sign Up for Free

3. 请求

3.1 简单参数

原始方式

在原始的web程序中，获取请求参数，需要通过HttpServletRequest 对象手动获取。

比较繁琐，需要手动的类型转换

@RestController
public class RequestController {
    @RequestMapping("/simpleParam")
    public String simpleParam(HttpServletRequest request) {
        String name = request.getParameter("name");
        String age = request.getParameter("age");
        int intAge = Integer.parseInt(age);
        System.out.println(name + "-" + age);
        return "ok";
    }
}

springboot方式

简单参数：参数名与形参变量名相同，定义形参即可接收参数。

@RestController
public class RequestController {
    @RequestMapping("/simpleParam")
    public String simpleParam(String name,Integer age) {
        System.out.println(name + "-" + age);
        return "ok";
    }
}

如果请求参数名不一致会出现什么结果呢

// 请求参数名不一致
@RequestMapping("/simpleParam")
public String simpleParam(String username,Integer age) {
    System.out.println(username + ":" + age);
    return "ok";
}

如果请求参数不一致如何请求成功呢？

如果方法形参名称与请求参数名称不匹配，可以使用@RequestParam 完成映射

@RequestMapping("/simpleParam")
    public String simpleParam(@RequestParam(name = "name",required = false)String username, Integer age) {
        System.out.println(username + ":" + age);
        return "ok";
    }

注意：

@RequestParam 中的required 属性默认为true，代表该请求参数必须传递，如果不传递将报错。如果该参数是可选的，可以将required属性设置为false。

小结

1. 原始方式获取请求参数

controller 方法形参中声明HttpServletRequest 对象

调用对象的getParameter(参数名)

2. SpringBoot 中接收简单参数

请求参数名与方法形参变量名相同

会自动进行类型转换

3. @RequestParam注解

方法形参名称与请求参数名称不匹配，通过该注解完成映射

该注解的required属性默认为true，代表请求参数必须传递

3.2 实体参数

简单实体对象

请求参数名与形参对象属性名相同，定义POJO接收即可

@NoArgsConstructor
@AllArgsConstructor
@Data
public class User {
    private String name;
    private Integer age;
}

@RequestMapping("/simplePojo")
    public String simplePojo(User user) {
        System.out.println(user);
        return "ok";
    }

复杂实体对象

请求参数名与形参对象属性名相同，按照对象层次结构关系即可接收嵌套POJO属性参数。

@AllArgsConstructor
@NoArgsConstructor
@Data
public class Address {
    private String province;
    private String city;
}

@NoArgsConstructor
@AllArgsConstructor
@Data
public class User {
    private String name;
    private Integer age;
    private Address address;
}

@RequestMapping("/simplePojo")
    public String simplePojo(User user) {
        System.out.println(user);
        return "ok";
    }

小结

规则：请求参数名与形参对象属性名相同，即可直接通过POJO接收

3.3 数组集合参数

数组参数

请求参数名与形参数组名称相同且请求参数为多个，定义数组类型形参即可传递参数

@RequestMapping("/arrayParam")
    public String arrayParam(String[] hobby) {
        System.out.println(Arrays.toString(hobby));
        return "OK";
    }

集合参数

请求参数名与形参集合名称相同且请求参数为多个，@RequestParam 绑定参数关系

@RequestMapping("/listParam")
    public String listParam(@RequestParam List<String> hobby) {
        System.out.println(hobby);
        return "OK";
    }

小结

数组：请求参数名与形参中数组变量名相同，可以直接使用数组封装

集合：请求参数名与形参中集合变量名相同，通过@RequestParam 绑定参数关系

3.4 日期时间参数

日期参数：使用 @DateTimeFormat 注解完成日期参数格式转换

@RequestMapping("/dateParam")
    public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime) {
        System.out.println(updateTime);
        return "OK";
    }

3.5 JSON参数

JSON参数：JSON数据键名与形参对象属性名相同，定义POJO类型形参即可接收参数，需要使用@RequestBody 标识

{
    "name":"ITCAST",
    "age":16,
    "address":{
        "province":"山西",
        "city":"晋中"
    }
}

@RequestMapping("/jsonParam")
    public String jsonParam(@RequestBody User user) {
        System.out.println(user);
        return "OK";
    }

3.6 路径参数

路径参数：通过请求URL直接传递参数，使用{...}来标识该路径参数，需要使用 @PathVariable 获取路径参数

传递一个参数

@RequestMapping("/path/{id}")
    public String pathParam(@PathVariable Integer id) {
        System.out.println(id);
        return "OK";
    }

传递多个参数

@RequestMapping("/path/{id}/{name}")
    public String pathParam(@PathVariable Integer id,@PathVariable String name) {
        System.out.println(id);
        System.out.println(name);
        return "OK";
    }

3.7 总结

简单参数

定义方法形参，请求参数名与形参变量名一致。

如果不一致，通过@RequstParam 手动映射。

实体参数

请求参数名，与实体对象的属性名一致，会自动接收封装

数组集合参数

数组：请求参数名与数组名一致，直接封装

集合：请求参数名与集合名一致，@RequestParam 绑定关系

日期参数

@DateTimeFormat

JSON参数

@RequestBody

路径参数

@PathVariable

4. 响应

注解解释

4.1 @ResponceBody

类型：方法注解、类注解

位置：Controller方法上/类上

作用：将方法返回值直接响应，如果返回值类型是实体对象/集合，将会转换为JSON格式响应

说明：@RestController = @Controller + @ResponseBody

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Controller
@ResponseBody
public @interface RestController {

	/**
	 * The value may indicate a suggestion for a logical component name,
	 * to be turned into a Spring bean in case of an autodetected component.
	 * @return the suggested component name, if any (or empty String otherwise)
	 * @since 4.0.1
	 */
	@AliasFor(annotation = Controller.class)
	String value() default "";

}

4.2 演示案例

@RequestMapping("hello")
    public String hello() {
        System.out.println("Hello World");
        return "Hello World";
    }

@RequestMapping("/getAddr")
    public Address getAddr() {
        Address addr = new Address();
        addr.setProvince("浙江");
        addr.setCity("杭州");
        return addr;
    }

 @RequestMapping("listAddr")
    public List<Address> listAddr() {
        ArrayList<Address> list = new ArrayList<>();
        Address addr = new Address();
        addr.setProvince("广东");
        addr.setCity("深圳");

        Address addr2 = new Address();
        addr2.setProvince("山西");
        addr2.setCity("太原");

        list.add(addr);
        list.add(addr2);
        return list;
    }

4.3 通一规范

@NoArgsConstructor
@AllArgsConstructor
@Data
public class Result {
    private Integer code; // 1 成功，0失败
    private String msg; // 提示信息
    private Object data; // 数据data

    public static Result success(Object data) {
        return new Result(1,"success",data);
    }
    public static Result success() {
        return new Result(1,"success",null);
    }
    public static Result error(String msg) {
        return new Result(0,msg,null);
    }
}

改造原始代码

    @RequestMapping("hello")
    public Result hello() {
        System.out.println("Hello World");
        return Result.success("Hello World");
    }

    @RequestMapping("/getAddr")
    public Result getAddr() {
        Address addr = new Address();
        addr.setProvince("浙江");
        addr.setCity("杭州");
        return Result.success(addr);
    }

    @RequestMapping("listAddr")
    public Result listAddr() {
        ArrayList<Address> list = new ArrayList<>();
        Address addr = new Address();
        addr.setProvince("广东");
        addr.setCity("深圳");

        Address addr2 = new Address();
        addr2.setProvince("山西");
        addr2.setCity("太原");

        list.add(addr);
        list.add(addr2);
        return Result.success(list);
    }