본문 바로가기
SpringBoot/(책)스프링부트 시작하기

[springboot] 15. 스웨거

by 평범한kiki 2023. 5. 9.

스프링과 스웨거 버전에 따라 다르다.

꼭 쓰는 버전 확인해보고 할것

정말 헤맸다

 

springboot 3.x 버전에 스웨거는 3인거 같다

이거 하나면 된다

implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.0.2'
implementation 'org.springdoc:springdoc-openapi-ui:1.7.0'
implementation 'io.springfox:springfox-boot-starter:3.0.0'
 위의 두개는 지우자...
같이 쓰면 안뜬다.
 
 
일단 SwaggerConfiguration 이 없어도 기본으로 
 
http://localhost:8080/swagger-ui/index.html  로 뜬다.
 
 
* 설정파일
 
- /board/configuration/SwaggerConfiguration.java
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;

@Configuration
public class SwaggerConfiguration {
	
	// 스프링에서 지원하는것
	@Bean 
	public GroupedOpenApi publicapi() { 
		 return GroupedOpenApi.builder()
	       .group("v1-definition") //group 이름을 설정한다 
	       .pathsToMatch("/api/**")//Swagger API 명세서에 적을 API 주소를 적는다. 
	  .build(); 
	}
	 
	//Swagger API 명세서에 들어왔을 때 어떻게 보여줄 지 Customizing하는 부분이다
	@Bean
	public OpenAPI springShopOpenApi() {
		return new OpenAPI()
				.info(new Info().title("board 프로젝트 API 명세").version("v0.0.1"));
	}
  }

 

 

 

참고)

https://stackoverflow.com/questions/74614369/how-to-run-swagger-3-on-spring-boot-3

 

How to run Swagger 3 on Spring Boot 3

Using a fresh Spring Initialzr with Java17 and Spring Boot 3.0.0, and an extra addition to the pom.xml for Springfox Swagger 3, I can't for the life of me get Swagger pages to work. Instead, I get ...

stackoverflow.com

https://velog.io/@kjgi73k/Springboot3%EC%97%90-Swagger3%EC%A0%81%EC%9A%A9%ED%95%98%EA%B8%B0