X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=webapp-backend%2Fsrc%2Fmain%2Fjava%2Forg%2Foranosc%2Fric%2Fportal%2Fdash%2FSwaggerConfiguration.java;fp=webapp-backend%2Fsrc%2Fmain%2Fjava%2Forg%2Foranosc%2Fric%2Fportal%2Fdash%2FSwaggerConfiguration.java;h=76032328fdd917cc083727fc67ef6708141fbf4f;hb=e2cbc4d0304646febf7e2cbe0dccdf9840189222;hp=0000000000000000000000000000000000000000;hpb=dcf725626b3f7c67dda3655da048370f00b75cc3;p=portal%2Fric-dashboard.git diff --git a/webapp-backend/src/main/java/org/oranosc/ric/portal/dash/SwaggerConfiguration.java b/webapp-backend/src/main/java/org/oranosc/ric/portal/dash/SwaggerConfiguration.java new file mode 100644 index 00000000..76032328 --- /dev/null +++ b/webapp-backend/src/main/java/org/oranosc/ric/portal/dash/SwaggerConfiguration.java @@ -0,0 +1,67 @@ +/*- + * ========================LICENSE_START================================= + * ORAN-OSC + * %% + * Copyright (C) 2019 AT&T Intellectual Property and Nokia + * %% + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * ========================LICENSE_END=================================== + */ + +package org.oranosc.ric.portal.dash; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +import springfox.documentation.builders.ApiInfoBuilder; +import springfox.documentation.builders.PathSelectors; +import springfox.documentation.builders.RequestHandlerSelectors; +import springfox.documentation.service.ApiInfo; +import springfox.documentation.service.Contact; +import springfox.documentation.spi.DocumentationType; +import springfox.documentation.spring.web.plugins.Docket; +import springfox.documentation.swagger2.annotations.EnableSwagger2; + +/** + * http://www.baeldung.com/swagger-2-documentation-for-spring-rest-api + */ +@Configuration +@EnableSwagger2 +public class SwaggerConfiguration { + + /** + * @return new Docket + */ + @Bean + public Docket api() { + return new Docket(DocumentationType.SWAGGER_2).select() // + .apis(RequestHandlerSelectors.basePackage(DashboardApplication.class.getPackage().getName())) // + .paths(PathSelectors.any()) // + .build() // + .apiInfo(apiInfo()); + } + + private ApiInfo apiInfo() { + final String version = DashboardApplication.class.getPackage().getImplementationVersion(); + return new ApiInfoBuilder() // + .title("RIC Dashboard backend") // + .description("Provides demonstration services.")// + .termsOfServiceUrl("Terms of service") // + .contact(new Contact("RIC Dashboard Dev Team", // + "http://no-docs-yet.org/", // + "noreply@oran-osc.org")) // + .license("Apache 2.0 License").licenseUrl("http://www.apache.org/licenses/LICENSE-2.0") // + .version(version == null ? "version not available" : version) // + .build(); + } +}