5

我已经使用springboot创建了rest webservice并添加了springdoc-open-api用于webservice的文档化，现在我有2个问题

1-如何在 swagger-ui 文档页面上显示的请求中添加自定义测试值？

2-如何在 swagger-ui 文档页面上单击 TRY IT OUT 按钮执行请求？

请参阅下面的代码片段以了解 REST Web 服务：

@PostMapping(value="/result", consumes={ "application/json"},produces={ "application/json" } )
@Parameter(description  = "Student object need to calculate the score" ,name="InputObject", required = true )
public ResponseEntity<Result> displayResult(@Valid  @RequestBody Student request);

Public class Student{
  String name;
  String birthDate;
  String motherName;
  int rollNo;
  int seatNo;
}

Public class Result{
  int marks;
  String grade;
  double percentage;
}

I have tried to add value of request using @Schema(name = "name", example= "Rubeena", description = "Name of student"), is it right way to add the value in example request ?
Even after adding this schema when i click on TRY IT OUT button i dont get the outcome.

Is there any way to solve this problem?
4

2 回答 2

4

使用 @Schema 注释，我可以在示例请求中提供值

Public class Student{
@Schema(example= "XXX", description = "Name of student")
 String name;

@Schema(example= "10-10-2020", description = "学生的出生日期") StringbirthDate; …… }

于 2020-11-26T10:56:22.257 回答
1

在您的 dto 类中使用 @ApiModelProperty 注释。

例子 -

Public class Student{
   @ApiModelProperty(value = "name", name = "name", dataType = "String" example = "Rube")
  String name;
   @ApiModelProperty(value = "birthDate", name = "birthDate", dataType = "birthDate" example = "12/12/1995")
  String birthDate;
 ........................
}

//should work with following dependencies 
     <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>
于 2020-10-23T15:24:55.410 回答