swagger3 传参格式

PageQuery.java

import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

@Data
public class PageQuery {

    @Schema(description = "当前页数", example = "1", required = true)
    private Integer pageNum;

    @Schema(description = "每页记录数", example = "5", required = true)
    private Integer pageSize;
}

TestController.java

import java.util.Date;
import java.util.List;

import com.example.eduserver.param.TestAddParam;
import com.example.eduserver.param.TestEditParam;
import com.example.eduserver.query.PageQuery;
import com.example.eduserver.result.PageResult;
import com.example.eduserver.result.Result;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springdoc.core.annotations.ParameterObject;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import com.example.eduserver.entity.Test;
import com.example.eduserver.service.ITestService;

@RestController
@Tag(name = "测试")
@RequestMapping("/test")
public class TestController {
	@Autowired
	private ITestService testService;

	@Operation(summary = "分页查询")
	@PostMapping("/page")
	public Result pageTestInfo(@RequestBody PageQuery pageQuery) {
		PageResult page = testService.getPage(pageQuery);
		return new Result(page);
	}
}

@RequestBody 为json格式 swagger页面长这样

将注解换成 @ModelAttribute @ParameterObject 即可看到表单式的swagger

public Result pageTestInfo(@ParameterObject PageQuery pageQuery) {
	PageResult page = testService.getPage(pageQuery);
	return new Result(page);
}