/** * Builds the Swagger2MarkupConfig. * * @return the Swagger2MarkupConfig */ public Swagger2MarkupConfig build() { buildNaturalOrdering(); return config; }
public Swagger2MarkupExtensionRegistry build() { return new DefaultSwagger2MarkupExtensionRegistry(context); }
public Swagger2MarkupConverter build() { if (config == null) config = new Swagger2MarkupConfigBuilder().build(); if (extensionRegistry == null) extensionRegistry = new Swagger2MarkupExtensionRegistryBuilder().build(); Context context = new Context(config, extensionRegistry, swagger, swaggerLocation); initExtensions(context); applySwaggerExtensions(context); return new Swagger2MarkupConverter(context); }
@Test public void testWithInterDocumentCrossReferencesAndNoOutputPath() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() .withInterDocumentCrossReferences() .build(); Swagger2MarkupConverter.Context context = createContext(config); assertThat(new DefinitionDocumentNameResolver(context).apply("DefinitionName")) .isEqualTo("definitions.adoc"); }
public void swagger2MarkupConfigBuilder() { Path localSwaggerFile = Paths.get("/path/to/swagger.yaml"); // tag::swagger2MarkupConfigBuilder[] Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() //<1> .withMarkupLanguage(MarkupLanguage.MARKDOWN) //<2> .withOutputLanguage(Language.DE) //<3> .withPathsGroupedBy(GroupBy.TAGS) //<4> .build(); //<5> Swagger2MarkupConverter converter = Swagger2MarkupConverter.from(localSwaggerFile) .withConfig(config) //<6> .build(); // end::swagger2MarkupConfigBuilder[] }
@Test public void testWithSeparatedOperationsAndInterDocumentCrossReferences() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() .withSeparatedOperations() .withInterDocumentCrossReferences() .build(); Swagger2MarkupConverter.Context context = createContext(config); assertThat(new OperationDocumentNameResolver(context).apply(operation)) .isEqualTo("operations" + fileSeparator + "test_get.adoc"); }
@Test public void testWithSeparatedOperations() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() .withSeparatedOperations() .build(); Swagger2MarkupConverter.Context context = createContext(config); assertThat(new OperationDocumentNameResolver(context).apply(operation)) .isEqualTo("operations" + fileSeparator + "test_get.adoc"); }
@Test public void testWithSeparatedDefinitions() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() .withSeparatedDefinitions() .build(); Swagger2MarkupConverter.Context context = createContext(config); assertThat(new DefinitionDocumentResolverDefault(context).apply("DefinitionName")).isNull(); }
public void swagger2MarkupConfigFromCommonsConfiguration() throws IOException, ConfigurationException { Path localSwaggerFile = Paths.get("/path/to/swagger.yaml"); // tag::swagger2MarkupConfigFromCommonsConfiguration[] Configurations configs = new Configurations(); Configuration configuration = configs.properties("config.properties"); //<1> Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder(configuration) //<2> .build(); Swagger2MarkupConverter converter = Swagger2MarkupConverter.from(localSwaggerFile) .withConfig(config) .build(); // end::swagger2MarkupConfigFromCommonsConfiguration[] } }
@Test public void testConfigBuilderListDelimiter() { Swagger2MarkupConfigBuilder builder = new Swagger2MarkupConfigBuilder(); assertThat(builder.config.isListDelimiterEnabled()).isEqualTo(false); builder.withListDelimiter(Character.valueOf('|')); assertThat(builder.config.getListDelimiter()).isEqualTo(Character.valueOf('|')); assertThat(builder.config.isListDelimiterEnabled()).isEqualTo(true); } }
public static Swagger2MarkupConverter.Context createContext(Swagger2MarkupConfig config, Swagger swagger) { Swagger2MarkupExtensionRegistry extensionRegistry = new Swagger2MarkupExtensionRegistryBuilder().build(); return new Swagger2MarkupConverter.Context(config, extensionRegistry, swagger, null); } }
public void swagger2MarkupExtensionRegistryBuilder() throws IOException, ConfigurationException { Path localSwaggerFile = Paths.get("/path/to/swagger.yaml"); // tag::swagger2MarkupExtensionRegistryBuilder[] Swagger2MarkupExtensionRegistry registry = new Swagger2MarkupExtensionRegistryBuilder() //<1> .withDefinitionsDocumentExtension(new MyExtension()) //<2> .build(); //<3> Swagger2MarkupConverter converter = Swagger2MarkupConverter.from(localSwaggerFile) .withExtensionRegistry(registry) //<4> .build(); // end::swagger2MarkupExtensionRegistryBuilder[] }
@Test public void testListing() { SwaggerModelExtension ext1 = new MySwaggerModelExtension(); SwaggerModelExtension ext2 = new MySwaggerModelExtension(); SwaggerModelExtension ext3 = new SwaggerModelExtension() { public void apply(Swagger swagger) { } }; Swagger2MarkupExtensionRegistry registry = new Swagger2MarkupExtensionRegistryBuilder() .withSwaggerModelExtension(ext2) .withSwaggerModelExtension(ext3) .withSwaggerModelExtension(ext1) .build(); List<SwaggerModelExtension> extensions = registry.getSwaggerModelExtensions(); assertThat(extensions.size()).isEqualTo(3); assertThat(extensions).contains(ext1, ext2, ext3); } }
@Test public void testRegistering() { Swagger2MarkupExtensionRegistryBuilder registryBuilder = new Swagger2MarkupExtensionRegistryBuilder(); registryBuilder.withSwaggerModelExtension(new MySwaggerModelExtension()); }
public Swagger2MarkupExtensionRegistryBuilder() { List<SwaggerModelExtension> swaggerModelExtensions = toList(load(SwaggerModelExtension.class).iterator()); List<OverviewDocumentExtension> overviewDocumentExtensions = toList(load(OverviewDocumentExtension.class).iterator()); List<DefinitionsDocumentExtension> definitionsDocumentExtensions = toList(load(DefinitionsDocumentExtension.class).iterator()); List<PathsDocumentExtension> pathsDocumentExtensions = toList(load(PathsDocumentExtension.class).iterator()); List<SecurityDocumentExtension> securityDocumentExtensions = toList(load(SecurityDocumentExtension.class).iterator()); context = new Context( swaggerModelExtensions, overviewDocumentExtensions, definitionsDocumentExtensions, pathsDocumentExtensions, securityDocumentExtensions); }
@Test public void testWithInterDocumentCrossReferencesAndNoOutputPath() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() .withInterDocumentCrossReferences() .build(); Swagger2MarkupConverter.Context context = createContext(config); assertThat(new DefinitionDocumentResolverFromDefinition(context).apply("DefinitionName")) .isNull(); }
public static Swagger2MarkupConverter.Context createContext() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder().build(); Swagger2MarkupExtensionRegistry extensionRegistry = new Swagger2MarkupExtensionRegistryBuilder().build(); return new Swagger2MarkupConverter.Context(config, extensionRegistry, null, null); }
public static Swagger2MarkupConverter.Context createContext(Swagger2MarkupConfig config) { Swagger2MarkupExtensionRegistry extensionRegistry = new Swagger2MarkupExtensionRegistryBuilder().build(); return new Swagger2MarkupConverter.Context(config, extensionRegistry, null, null); }
@Test public void testWithInterDocumentCrossReferencesAndNoOutputPath() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() .withInterDocumentCrossReferences() .build(); Swagger2MarkupConverter.Context context = createContext(config); assertThat(new SecurityDocumentResolver(context).apply("petstore_auth")) .isNull(); }
@Test public void testWithInterDocumentCrossReferencesAndNoOutputPath() { Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder() .withInterDocumentCrossReferences() .build(); Swagger2MarkupConverter.Context context = createContext(config); assertThat(new DefinitionDocumentResolverFromOperation(context).apply("DefinitionName")) .isNull(); }