Skip to content

v0.2.3-alpha — Ready for Real APIs | 실 서비스용 API 구현 가능!🚀

Choose a tag to compare

View all tags
@NARUBROWN NARUBROWN released this 21 Jan 13:50
v0.2.3
b8805eb
image_dbd618d3-f313-41fd-a093-d97d3493550d

🦴 Spine v0.2.3-alpha

Ready for Real APIs | 실 서비스용 API 구현 가능! 🚀

Spine v0.2.3-alpha는
실제 서비스용 API 서버를 구현할 수 있는 최소 실행 단위를 완성한 첫 알파 릴리즈입니다.

요청 실행 흐름을 명시적으로 모델링하는 Spine의 핵심 철학을 유지한 채,
CRUD API와 인증 흐름을 끝까지 책임질 수 있는 구조를 제공합니다.

Spine v0.2.3-alpha is the first alpha release that completes the minimum execution backbone required to build real-world API servers.

While preserving Spine’s core philosophy of explicitly modeling request execution,
this release provides a structure capable of fully supporting CRUD APIs and authentication flows.

✨ 추가된 기능 | Added

Route-level Interceptor 지원

  • 인터셉터를 전역뿐 아니라 라우트 단위로 명시적으로 등록할 수 있습니다.
  • 인증, 로깅, 트랜잭션 같은 횡단 관심사를
    실행 흐름의 일부로 정확히 제어할 수 있습니다.

Route-level Interceptors

  • Interceptors can now be registered explicitly at the route level, not only globally.
  • Cross-cutting concerns such as authentication, logging, and transactions
    are precisely controlled as part of the execution flow.

Graceful Shutdown 지원

  • SIGTERM / SIGINT 수신 시
    • 신규 요청 차단
    • 진행 중인 요청 정상 완료
    • 설정된 타임아웃 내 안전한 종료 보장
  • Kubernetes 환경의 Rolling Update, Blue/Green 배포를 고려한 종료 모델을 제공합니다.

Graceful Shutdown

  • On SIGTERM / SIGINT:
    • Stops accepting new requests
    • Allows in-flight requests to complete
    • Ensures safe shutdown within the configured timeout
  • Designed for Kubernetes environments, including Rolling Update and Blue/Green deployments.

🛠 고쳐짐 | Fixed

Pipeline 오류 발생 시 AfterCompletion 미호출 문제 수정

  • 요청 처리 중 Router 단계에서 오류가 발생하면
    Interceptor.afterCompletion 이 호출되지 않던 문제를 수정했습니다.
  • 이제 요청 성공/실패와 관계없이
    요청 생명주기의 종료가 항상 보장됩니다.

AfterCompletion not invoked on pipeline errors

  • Fixed an issue where Interceptor.afterCompletion was not executed
    when an error occurred during the Router phase.
  • The request lifecycle is now always completed, regardless of success or failure.

✅ 이 버전으로 만들 수 있는 프로젝트 | What you can build with this version

이 알파 버전으로 다음과 같은 프로젝트를 구현할 수 있습니다.

  • REST 기반 CRUD API 서버
  • JWT 기반 로그인 / 인증 시스템
  • 인터셉터 기반 인증·로깅·트랜잭션 분리 구조
  • 실행 흐름이 명확히 드러나는 테스트 가능한 서버 구조

With this alpha version, you can build:

  • REST-based CRUD API servers
  • JWT-based authentication and login systems
  • Interceptor-driven authentication, logging, and transaction separation
  • Testable server architectures with clearly visible execution flows

🔮 다음 | Next

다음 버전에서는 다음 기능을 준비 중입니다.

  • 파일 업로드 Path 타입 제공
  • multipart/form-data 업로드를 ArgumentResolver 기반 타입으로 지원
  • 컨트롤러 시그니처에 명시적으로 드러나는 업로드 모델 제공

Planned for the next release:

  • File upload Path type support
  • multipart/form-data handling via ArgumentResolver
  • File uploads explicitly expressed in controller method signatures

⚠️ Alpha 안내 | Alpha Notice

Spine v0.2.3-alpha는 알파 버전입니다.

  • API 및 내부 구조는 변경될 수 있습니다.
  • 문서 및 예제는 지속적으로 보완될 예정입니다.
  • 피드백과 이슈 제보를 적극 환영합니다.

Spine v0.2.3-alpha is an alpha release.

  • APIs and internal structures may change.
  • Documentation and examples will continue to evolve.
  • Feedback and issue reports are highly welcome.
Assets 2
Loading