지금까지 spring boot 에서 application.properties 를

사용해본 방법은 아래의 2 가지 상황이다.

서버의 환경 변수에 따른 dev, prd 등 의 능동적 적용
복수의 properties 파일을 적용

위에서 언급한 1,2번에 대한 사용 법을 안내 한다.

서버의 환경 변수에 따른 dev, prd 등 의 능동적 적용

- 사용 이유 :

소스의 수정 없이 서버 인프라의 환경에 따라 application.properties 의 값을 적용하고자 할 경우

- 방법 :

서버에서 VM argument 로

-Dspring.profiles.active=prd 와 같이 구동시 주입.

소스 상에서는

application-default.properties

application-prd.properties

와 같이

application-[값].properties

으로 구분함.

만약 구동 중 spring.profiles.active VM argument 값 없을경우 default 가 적용됨.

복수의 properties 파일을 적용

- 사용 이유 :

패키지별 설정파일을 따로 분리하고자 하여 사용 하게 됨.

- 방법 :

-Dspring.config.additional-location=classpath:config/*/

위와같이 VM argument 적용하면 /src/main/resources/config/모든폴더/application.properties 를 찾아 적용한다.

이때 기존에 존재하던 classpath:application.properties 파일이 먼저 적용 되고

추가 파일은 override 되므로 참고하길 바란다.

출처 : http://heidloff.net/article/usage-of-swagger-2-0-in-spring-boot-applications-to-document-apis/

Usage of Swagger 2.0 in Spring Boot Applications to document APIs

Posted on November 17, 2015 by Niklas Heidloff

As IBM VP Angel Diaz stated in an interview on SearchCloudComputing “Swagger is the way most developers describe [REST] APIs”. With version 2.0 many important features like extensibility have been added, there is a big community and many developers are using it by now. Additionally there is work going on to create an open governance model around the Swagger specification under the Linux Foundation as part of the Open API Initiative.

What I like most about Swagger is the ability to document APIs directly in the (Java) source code via annotations so that documentation and actual API implementations are not out of synch.

IBM uses Swagger for the API documentation of several products and services internally. Furthermore the API management service in IBM Bluemix can import Swagger 2.0 definitions to manage your APIs easily.

The Java Spring framework has a lot of traction in the enterprise community these days. In order to use Swagger in Spring Boot applications I tried Springfox which is not part of Swagger core but it integrates nicely in Spring and supports the core Swagger annotations.

Below I extended the Spring sample Building a RESTful Web Service with Swagger annotations.

First you need to define the dependencies to the Springfox and Swagger libraries, in my case in Maven.

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>org.springframework</groupId>

    <artifactId>gs-rest-service</artifactId>

    <version>0.1.0</version>

    <parent>

        <groupId>org.springframework.boot</groupId>

        <artifactId>spring-boot-starter-parent</artifactId>

        <version>1.3.0.RELEASE</version>

    </parent>

    <dependencies>

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

        </dependency>

        <dependency>

            <groupId>io.springfox</groupId>

            <artifactId>springfox-swagger-ui</artifactId>

            <version>2.2.2</version>

            <scope>compile</scope>

        </dependency>

        <dependency>

            <groupId>io.springfox</groupId>

            <artifactId>springfox-swagger2</artifactId>

            <version>2.2.2</version>

            <scope>compile</scope>

        </dependency>

    </dependencies>

    <properties>

        <java.version>1.8</java.version>

    </properties>

    <build>

        <plugins>

            <plugin>

                <groupId>org.springframework.boot</groupId>

                <artifactId>spring-boot-maven-plugin</artifactId>

            </plugin>

        </plugins>

    </build>

    <repositories>

        <repository>

            <id>spring-releases</id>

            <url>https://repo.spring.io/libs-release</url>

        </repository>

    </repositories>

    <pluginRepositories>

        <pluginRepository>

            <id>spring-releases</id>

            <url>https://repo.spring.io/libs-release</url>

        </pluginRepository>

    </pluginRepositories>

</project>

Then I enabled Swagger in the boot application.

package hello;

import static springfox.documentation.builders.PathSelectors.regex;

import org.springframework.boot.SpringApplication;

import org.springframework.boot.autoconfigure.SpringBootApplication;

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.ComponentScan;

import com.google.common.base.Predicate;

import springfox.documentation.builders.ApiInfoBuilder;

import springfox.documentation.service.ApiInfo;

import springfox.documentation.spi.DocumentationType;

import springfox.documentation.spring.web.plugins.Docket;

import springfox.documentation.swagger2.annotations.EnableSwagger2;

@SpringBootApplication

@EnableSwagger2

@ComponentScan("hello")

public class Application {

    public static void main(String[] args) {

        SpringApplication.run(Application.class, args);

    }

    @Bean

    public Docket newsApi() {

        return new Docket(DocumentationType.SWAGGER_2)

                .groupName("greetings")

                .apiInfo(apiInfo())

                .select()

                .paths(regex("/greeting.*"))

                .build();

    }

    private ApiInfo apiInfo() {

        return new ApiInfoBuilder()

                .title("Spring REST Sample with Swagger")

                .description("Spring REST Sample with Swagger")

                .termsOfServiceUrl("http://www-03.ibm.com/software/sla/sladb.nsf/sla/bm?Open")

                .contact("Niklas Heidloff")

                .license("Apache License Version 2.0")

                .licenseUrl("https://github.com/IBM-Bluemix/news-aggregator/blob/master/LICENSE")

                .version("2.0")

                .build();

    }

}

In the controller I used Swagger annotations to document the API.

package hello;

import java.util.concurrent.atomic.AtomicLong;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RequestMethod;

import org.springframework.web.bind.annotation.RequestParam;

import org.springframework.web.bind.annotation.RestController;

import io.swagger.annotations.ApiImplicitParam;

import io.swagger.annotations.ApiImplicitParams;

import io.swagger.annotations.ApiOperation;

import io.swagger.annotations.ApiResponse;

import io.swagger.annotations.ApiResponses;

import io.swagger.annotations.ResponseHeader;

@RestController

public class GreetingController {

    private static final String template = "Hello, %s!";

    private final AtomicLong counter = new AtomicLong();

    @ApiOperation(value = "getGreeting", nickname = "getGreeting")

    @RequestMapping(method = RequestMethod.GET, path="/greeting", produces = "application/json")

    @ApiImplicitParams({

        @ApiImplicitParam(name = "name", value = "User's name", required = false, dataType = "string", paramType = "query", defaultValue="Niklas")

      })

    @ApiResponses(value = { 

            @ApiResponse(code = 200, message = "Success", response = Greeting.class),

            @ApiResponse(code = 401, message = "Unauthorized"),

            @ApiResponse(code = 403, message = "Forbidden"),

            @ApiResponse(code = 404, message = "Not Found"),

            @ApiResponse(code = 500, message = "Failure")}) 

    public Greeting greeting(@RequestParam(value="name", defaultValue="World") String name) {

        return new Greeting(counter.incrementAndGet(),

                String.format(template, name));

    }

}

In the sample resource I documented parameters.

package hello;

import com.fasterxml.jackson.annotation.JsonProperty;

import io.swagger.annotations.ApiModelProperty;

public class Greeting {

    private final long id;

    private final String content;

    public Greeting(long id, String content) {

        this.id = id;

        this.content = content;

    }

    public long getId() {

        return id;

    }

    @JsonProperty(required = true)

    @ApiModelProperty(notes = "The name of the user", required = true)

    public String getContent() {

        return content;

    }

}

Here is the outcome in the API explorer.

재미나게 사는법?

2020년 11월 2일 월요일

Spring boot 의 application.properties 사용방법

2016년 12월 20일 화요일

swagger 2 spring boot

Usage of Swagger 2.0 in Spring Boot Applications to document APIs

블로그 보관함

프로필