web-dev-qa-db-ja.com

Swagger UI-デフォルトですべての操作を拡張するにはどうすればよいですか?

開くとすべての操作が折りたたまれて表示され、デフォルトで展開する必要があります。

それを達成するために変更する必要があるプロパティはありますか?

これは私のSwagger Beanです。

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket restApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .paths(regex("/api/.*"))
                .build()
                .directModelSubstitute(XMLGregorianCalendar.class, Date.class)
                .apiInfo(apiInfo())                
                .useDefaultResponseMessages(false);
    }
}
15
Gemasoft

docExpansion:"full" swagger-uiを作成するとき。

詳細は https://github.com/swagger-api/swagger-ui#parameters を参照してください。

docExpansion:操作とタグのデフォルトの展開設定を制御します。 'list'(タグのみを展開)、 'full'(タグと操作を展開)、または 'none'(何も展開しない)を指定できます。デフォルトは「リスト」です。

31
fehguy

私は実際にパラメーターをswagger urlに渡すことができることがわかりました:

http://...../swagger/index.html?docExpansion = expand

docExpansion: "none"-すべてを非表示にします。

docExpansion: "list"-すべての操作のみを展開/一覧表示します。

docExpansion: "full"-すべてを展開します(名前のとおり完全に展開します)。

4
Rosdi Kasim

あなたが使用しているように見えるSpringfoxの答えは次のとおりです:

  @Bean
  UiConfiguration uiConfig() {
    return UiConfigurationBuilder.builder()
        .docExpansion(DocExpansion.LIST) // or DocExpansion.NONE or DocExpansion.FULL
        .build();
  }  

ソース: http://springfox.github.io/springfox/docs/current/#springfox-swagger2-with-spring-mvc-and-spring-boot

4
Tristan

私は必要な変更をswaggerUiに追加することでそれを行いました。以下のように、要件に従って変更する必要があります。

  1. docExpansion: "none"-すべてを非表示にします。
  2. docExpansion: "list"-すべての操作のみを展開/一覧表示します。
  3. docExpansion: "full"-すべてを展開します(名前のとおり、完全に展開します)。
2
JR Sahoo.'JS'
private static final String DOC_EXPANSION = "list"; //none, full

    @Bean
    public UiConfiguration uiConfig() {
        return new UiConfiguration(
                null, DOC_EXPANSION, "alpha", "schema", UiConfiguration.Constants.DEFAULT_SUBMIT_METHODS, false, true, null
        );
    }
1
membersound