webapp-backend/src/main/java/org/oranosc/ric/portal/dash/SwaggerConfiguration.java

   1 /*-
   2  * ========================LICENSE_START=================================
   3  * ORAN-OSC
   4  * %%
   5  * Copyright (C) 2019 AT&T Intellectual Property and Nokia
   6  * %%
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  *      http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  * ========================LICENSE_END===================================
  19  */
  20
  21 package org.oranosc.ric.portal.dash;
  22
  23 import org.springframework.context.annotation.Bean;
  24 import org.springframework.context.annotation.Configuration;
  25
  26 import springfox.documentation.builders.ApiInfoBuilder;
  27 import springfox.documentation.builders.PathSelectors;
  28 import springfox.documentation.builders.RequestHandlerSelectors;
  29 import springfox.documentation.service.ApiInfo;
  30 import springfox.documentation.service.Contact;
  31 import springfox.documentation.spi.DocumentationType;
  32 import springfox.documentation.spring.web.plugins.Docket;
  33 import springfox.documentation.swagger2.annotations.EnableSwagger2;
  34
  35 /**
  36  * http://www.baeldung.com/swagger-2-documentation-for-spring-rest-api
  37  */
  38 @Configuration
  39 @EnableSwagger2
  40 public class SwaggerConfiguration {
  41
  42         /**
  43          * @return new Docket
  44          */
  45         @Bean
  46         public Docket api() {
  47                 return new Docket(DocumentationType.SWAGGER_2).select() //
  48                                 .apis(RequestHandlerSelectors.basePackage(DashboardApplication.class.getPackage().getName())) //
  49                                 .paths(PathSelectors.any()) //
  50                                 .build() //
  51                                 .apiInfo(apiInfo());
  52         }
  53
  54         private ApiInfo apiInfo() {
  55                 final String version = DashboardApplication.class.getPackage().getImplementationVersion();
  56                 return new ApiInfoBuilder() //
  57                                 .title("RIC Dashboard backend") //
  58                                 .description("Provides demonstration services.")//
  59                                 .termsOfServiceUrl("Terms of service") //
  60                                 .contact(new Contact("RIC Dashboard Dev Team", //
  61                                                 "http://no-docs-yet.org/", //
  62                                                 "noreply@oran-osc.org")) //
  63                                 .license("Apache 2.0 License").licenseUrl("http://www.apache.org/licenses/LICENSE-2.0") //
  64                                 .version(version == null ? "version not available" : version) //
  65                                 .build();
  66         }
  67 }