如何在Spring启动的swagger页面中添加文本框/文本字段？

Question

我正在尝试使用注释为Spring Boot中的RestAPI自动生成swagger页面。

控制器代码：

@RestController
@Api(value="UserManagementAPI", produces = MediaType.APPLICATION_JSON_VALUE)
public class UserManagementController {

    @RequestMapping("/")
    public String index() {
        return "Greetings from Spring Boot!";
    }

    @ApiOperation(value="add a pro",consumes="application/json")
    @RequestMapping(value = "/getUser", method = RequestMethod.GET, produces="application/json")    
    public static List<UserDetails> getUser(@PathVariable(name="id") String id) throws UserException
    {
        return UserHelper.getUserByEmail(id);
    }

Application.java

@SpringBootApplication
@EnableSwagger2
@Configuration
@ComponentScan({ "userManagement"})
@EnableAutoConfiguration
public class Application {
@Bean
    public Docket simpleDiffServiceApi() {
        return new Docket(DocumentationType.SWAGGER_2).groupName("userManagement").apiInfo(apiInfo()).select()
                .apis(RequestHandlerSelectors.any())
                // .paths(PathSelectors.any())
                // Will also include the basic error controllers by default
                .paths(Predicates.not(PathSelectors.regex("/error")))
                // Exclude basic error controllers
                .build().pathMapping("/");
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("Business Location Service")
                .description("Spring Boot REST APIs for Business Location Service")
                .contact(new Contact("EntSol-IoT (Niche Technology Delivery Group)", "http://somewebsite.com",
                        "some@mail.com"))
                .version("1.0").build();
    }

在招摇页面中，我可以看到所有的API。但还有更多。它显示了所有可能的方法类型（例如POST，GET，PUT等），尽管在Controller中我只编写了GET方法。  另一个问题是API下的swagger页面中没有Textbox，我可以在其中搜索 id 。可能是我错过了什么。过去两天我一直试图解决它。但是忍不住了。提前谢谢。

Answer 1

我遇到了问题。您的getUser方法声明为static。请删除static，以使其生效。

public List<UserDetails> getUser(@PathVariable(name="id") String id) throws UserException { }