Repolode
제출하기
swagger-api

swagger-api/swagger-core

코드 어노테이션과 JAX-RS REST API로 OpenAPI 명세를 생성하며 OpenAPI 3.x를 지원하는 Java 라이브러리입니다.

GitHub에서 보기웹사이트
스타
7,535
포크
2,255
열린 이슈
219
마지막 커밋
어제

어떤 프로젝트인가요?

Swagger Core는 OpenAPI Specification의 Java 구현체입니다. Java 애플리케이션의 어노테이션과 REST 리소스 클래스를 읽어 엔드포인트, 파라미터, 요청 본문, 응답 모델을 설명하는 OpenAPI 문서를 생성합니다. Swagger UI 같은 도구는 이 문서를 대화형 API 문서로 렌더링할 수 있습니다.

이 프로젝트는 JAX-RS 2 애플리케이션을 대상으로 하며, javax와 Jakarta 네임스페이스용 아티팩트 세트를 각각 제공합니다. 버전 2.2.0부터 OpenAPI 3.1을 지원하며, 이전 1.x 계열은 OpenAPI 2.0을 지원합니다. Maven 및 Gradle 빌드에서 개별 모듈의 버전을 관리할 수 있도록 BOM 아티팩트도 제공합니다.

이 저장소는 Java 11 이상이 필요한 Maven 멀티 모듈 빌드입니다. 통합 샘플은 별도의 swagger-samples 저장소로 옮겨졌습니다.

핵심 기능

  • 01Java 어노테이션과 JAX-RS 리소스로 OpenAPI 3.x 문서를 생성합니다.
  • 02javax와 Jakarta 네임스페이스용 아티팩트를 모두 지원합니다.
  • 03버전 2.2.0부터 OpenAPI 3.1을 지원합니다.
  • 04Maven 및 Gradle에서 일관된 의존성 버전을 관리할 수 있도록 BOM을 제공합니다.

활용 사례

  • 코드에서 OpenAPI 명세를 생성해 Java REST API를 문서화합니다.
  • JAX-RS 서비스에 대화형 API 문서를 추가합니다.
  • API 문서를 유지하면서 Java 서비스를 javax 네임스페이스에서 Jakarta 네임스페이스로 마이그레이션합니다.

사용 전 알아둘 점

  • Java 및 JAX-RS 2 API를 대상으로 하므로 다른 스택에는 적합하지 않습니다.

토픽

#openapi#swagger#rest-api#java#api-documentation#jax-rs#hacktoberfest#open-source#openapi-specification#openapi3

자주 묻는 질문

swagger-core은(는) 무엇인가요?
코드 어노테이션과 JAX-RS REST API로 OpenAPI 명세를 생성하며 OpenAPI 3.x를 지원하는 Java 라이브러리입니다. Swagger Core는 OpenAPI Specification의 Java 구현체입니다. Java 애플리케이션의 어노테이션과 REST 리소스 클래스를 읽어 엔드포인트, 파라미터, 요청 본문, 응답 모델을 설명하는 OpenAPI 문서를 생성합니다. Swagger UI 같은 도구는 이 문서를 대화형 API 문서로 렌더링할 수 있습니다.
swagger-core은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
swagger-core은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
swagger-core은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. swagger-core의 마지막 커밋은 2026년 11월 5일입니다.
swagger-core은(는) 어디에 사용할 수 있나요?
코드에서 OpenAPI 명세를 생성해 Java REST API를 문서화합니다. JAX-RS 서비스에 대화형 API 문서를 추가합니다. API 문서를 유지하면서 Java 서비스를 javax 네임스페이스에서 Jakarta 네임스페이스로 마이그레이션합니다.
swagger-core은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/swagger-api/swagger-core

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트