基本语法

每个 @RequestParam 都可以单独设置 defaultValue 属性:
例程:

package com.example.demo;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestParam;

@RestController
public class testController {
    // 多个参数,都有默认值
    @RequestMapping("/test")
    public String test(
            @RequestParam(value = "name", defaultValue = "World") String name,
            @RequestParam(value = "age", defaultValue = "18") Integer age,
            @RequestParam(value = "city", defaultValue = "Beijing") String city) {
        return String.format("Hello %s, age %d, from %s", name, age, city);
    }
    
    // 简化写法(参数名与变量名相同时)
    @RequestMapping("/test2")
    public String test2(
            @RequestParam(defaultValue = "Guest") String name,
            @RequestParam(defaultValue = "0") Integer score) {
        return String.format("User: %s, Score: %d", name, score);
    }
}

详细说明

1. 完整写法

@RequestParam(value = "参数名", defaultValue = "默认值") 数据类型 变量名

2. 简化写法(当参数名与变量名相同)

@RequestParam(defaultValue = "默认值") 数据类型 变量名

实际使用示例

// 搜索接口示例
@RequestMapping("/search")
public String search(
        @RequestParam(defaultValue = "") String keyword,           // 搜索关键词,默认空
        @RequestParam(defaultValue = "1") Integer page,            // 页码,默认第1页
        @RequestParam(defaultValue = "10") Integer size,           // 每页大小,默认10条
        @RequestParam(defaultValue = "createTime") String sortBy,  // 排序字段,默认按创建时间
        @RequestParam(defaultValue = "desc") String sortOrder) {   // 排序方向,默认降序
    
    return String.format("搜索: %s, 第%d页, 每页%d条, 按%s %s排序", 
                        keyword, page, size, sortBy, sortOrder);
}

// 用户信息接口示例
@RequestMapping("/userInfo")
public String getUserInfo(
        @RequestParam(defaultValue = "0") Long userId,
        @RequestParam(defaultValue = "false") Boolean includeDetails,
        @RequestParam(defaultValue = "json") String format) {
    
    return String.format("用户ID: %d, 包含详情: %s, 格式: %s", 
                        userId, includeDetails, format);
}

注意事项

  1. 数据类型转换:Spring会自动进行类型转换
  2. 必需参数:如果不设置 defaultValue,参数就是必需的
  3. 可选参数:设置了 defaultValue 的参数变为可选
  4. 布尔值默认值"true""false"(字符串形式)
  5. 数字默认值:用字符串表示,如 "0""100"

进阶用法

@RequestMapping("/advanced")
public String advanced(
        @RequestParam(value = "q", defaultValue = "") String query,
        @RequestParam(defaultValue = "1") @Min(1) Integer page,
        @RequestParam(defaultValue = "10") @Range(min = 1, max = 100) Integer size,
        @RequestParam(required = false) String category,  // 可选参数,无默认值时为null
        @RequestParam(defaultValue = "false") Boolean exact) {
    
    // 处理逻辑
    return "搜索结果";
}

如何修改端口

要修改Web服务器端口,只需在 application.properties 文件中添加以下配置:

spring.application.name=demo
server.port=8081

常用端口配置示例

# 修改为8081端口
server.port=8081

# 修改为9000端口
server.port=9000

# 修改为3000端口(常用于前端开发)
server.port=3000

# 使用随机端口(测试时有用)
server.port=0

其他相关配置

还可以配置其他服务器相关属性:

# 端口配置
server.port=8081

# 上下文路径(访问路径前缀)
server.servlet.context-path=/api

# 服务器地址(默认为所有接口)
server.address=localhost

# 会话超时时间
server.servlet.session.timeout=30m

1. @RequestBody 的作用

@RequestBody 注解用于将HTTP请求体中的JSON数据自动映射到Java对象。Spring Boot会自动处理这个转换过程。

2. 自动映射机制

Spring Boot使用Jackson库(默认的JSON处理器)来完成JSON到Java对象的转换:

  1. 序列化:Java对象 → JSON(响应时)
  2. 反序列化:JSON → Java对象(请求时,@RequestBody的作用)

3. 如何编写接收类(DTO/Entity)

基本要求:

  • 使用类(Class)
  • 提供无参构造函数
  • 提供getter/setter方法(或使用Lombok)
  • 字段名要与JSON中的key对应

示例代码:

// 方式1:传统写法
public class User {
    private String name;
    private Integer age;
    private String email;
    
    // 无参构造函数(必需)
    public User() {}
    
    // 有参构造函数(可选)
    public User(String name, Integer age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }
    
    // Getter和Setter方法
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
}

// 方式2:使用Lombok(推荐)
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;

@Data  // 自动生成getter/setter/toString/equals/hashCode
@NoArgsConstructor  // 无参构造函数
@AllArgsConstructor // 全参构造函数
public class User {
    private String name;
    private Integer age;
    private String email;
}

tip:
如果想要使用Lombok,需要在pom.xml中写入依赖

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

4. Controller中的使用

@RestController
@RequestMapping("/api/users")
public class UserController {
    
    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody User user) {
        // Spring自动将JSON转换为User对象
        System.out.println("接收到用户:" + user.getName());
        
        // 处理业务逻辑
        User savedUser = userService.save(user);
        
        return ResponseEntity.ok(savedUser);
    }
    
    @PutMapping("/{id}")
    public ResponseEntity<User> updateUser(
            @PathVariable Long id, 
            @RequestBody User user) {
        User updatedUser = userService.update(id, user);
        return ResponseEntity.ok(updatedUser);
    }
}

5. JSON映射示例

前端发送的JSON:

{
    "name": "张三",
    "age": 25,
    "email": "[email protected]"
}

自动映射到User对象:

User user = new User();
user.setName("张三");
user.setAge(25);
user.setEmail("[email protected]");

6. 高级特性

字段验证:

import javax.validation.constraints.*;

public class UserCreateDTO {
    @NotBlank(message = "姓名不能为空")
    @Size(min = 2, max = 50, message = "姓名长度必须在2-50之间")
    private String name;
    
    @NotNull(message = "年龄不能为空")
    @Min(value = 0, message = "年龄不能为负数")
    @Max(value = 150, message = "年龄不能超过150")
    private Integer age;
    
    @Email(message = "邮箱格式不正确")
    private String email;
}

// Controller中启用验证
@PostMapping
public ResponseEntity<User> createUser(@Valid @RequestBody UserCreateDTO dto) {
    // 如果验证失败,Spring会自动返回400错误
    return ResponseEntity.ok(userService.create(dto));
}

JSON字段映射:

import com.fasterxml.jackson.annotation.JsonProperty;

public class UserDTO {
    @JsonProperty("user_name")  // JSON中的字段名
    private String name;        // Java中的字段名
    
    @JsonProperty("user_age")
    private Integer age;
}

1. 基本概念

@RequestMapping 是Spring MVC中最基础的请求映射注解,可以处理所有HTTP方法(GET、POST、PUT、DELETE等)。

@GetMapping 是Spring 4.3引入的组合注解,专门用于处理HTTP GET请求,本质上是 @RequestMapping(method = RequestMethod.GET) 的简化写法。

2. 主要区别

语法简洁性

// 使用 @RequestMapping
@RequestMapping(value = "/users", method = RequestMethod.GET)
public List<User> getUsers() {
    return userService.getAllUsers();
}

// 使用 @GetMapping(更简洁)
@GetMapping("/users")
public List<User> getUsers() {
    return userService.getAllUsers();
}

HTTP方法支持

  • @RequestMapping: 支持所有HTTP方法,需要通过 method 属性指定
  • @GetMapping: 只支持GET请求,无需指定method属性

类型安全

  • @RequestMapping: 如果忘记指定method,默认支持所有HTTP方法
  • @GetMapping: 类型安全,明确表示只处理GET请求

3. 其他相似的组合注解

Spring还提供了其他HTTP方法的组合注解:

  • @PostMapping = @RequestMapping(method = RequestMethod.POST)
  • @PutMapping = @RequestMapping(method = RequestMethod.PUT)
  • @DeleteMapping = @RequestMapping(method = RequestMethod.DELETE)
  • @PatchMapping = @RequestMapping(method = RequestMethod.PATCH)

4. 使用建议

  1. 优先使用具体的组合注解:如@GetMapping、@PostMapping等,代码更清晰
  2. @RequestMapping适用场景

    • 类级别的基础路径映射
    • 需要处理多种HTTP方法的场景
    • 需要复杂配置的场景

5. 实际示例

@RestController
@RequestMapping("/api/users")  // 类级别基础路径
public class UserController {
    
    @GetMapping  // 处理 GET /api/users
    public List<User> getAllUsers() {
        return userService.findAll();
    }
    
    @GetMapping("/{id}")  // 处理 GET /api/users/{id}
    public User getUserById(@PathVariable Long id) {
        return userService.findById(id);
    }
    
    @PostMapping  // 处理 POST /api/users
    public User createUser(@RequestBody User user) {
        return userService.save(user);
    }
    
    // 如果需要同时处理多种方法
    @RequestMapping(value = "/batch", method = {RequestMethod.POST, RequestMethod.PUT})
    public ResponseEntity<String> batchOperation() {
        return ResponseEntity.ok("Batch operation completed");
    }
}

总结:@GetMapping是@RequestMapping的特化版本,专门用于GET请求,代码更简洁、类型更安全。在实际开发中,建议优先使用@GetMapping等具体的HTTP方法注解。

1. 作用域差异

普通CSS:

  • 全局作用域,所有样式都是全局的
  • 容易出现样式冲突和覆盖问题
/* styles.css */
.button {
    background-color: blue;
}
// 使用普通CSS
import './styles.css';
<button className="button">按钮</button>

CSS模块:

  • 局部作用域,样式只在当前组件内生效
  • 自动生成唯一的类名,避免冲突
/* Button.module.css */
.button {
    background-color: blue;
}
// 使用CSS模块
import styles from './Button.module.css';
<button className={styles.button}>按钮</button>

2. 类名生成机制

普通CSS:

  • 类名保持原样:.buttonbutton

CSS模块:

  • 自动生成哈希类名:.buttonButton_button__2x3kl
  • 确保每个组件的样式独立

3. 使用方式

普通CSS:

// 直接使用字符串
<div className="container header active">

CSS模块:

// 通过styles对象引用
<div className={styles.container}>
<div className={`${styles.header} ${styles.active}`}>

4. 优缺点对比

特性普通CSSCSS模块
学习成本中等
样式冲突容易发生几乎不会
代码维护困难(大项目)容易
性能一般更好(按需加载)
调试容易稍复杂(类名被哈希)

5. 适用场景

普通CSS适合:

  • 小型项目
  • 全局样式(重置样式、主题等)
  • 第三方库的样式覆盖

CSS模块适合:

  • 中大型项目
  • 组件化开发
  • 需要样式隔离的场景