spine

Documentation

Index

• type App
  • func New() App
• type Component
  • func ComponentOf(ptr any) Component
• type Context
• type Interceptor
• type Next
• type RouteSpec

Types

type App

type App interface {
	// 컴포넌트 타입 선언
	Register(components ...Component)
	// 생성자 선언
	Constructor(constructors ...any)
	// 라우트 선언
	Route(method string, path string, handler any)
	// 실행
	Listen(address string) error
}

func New

func New() App

type Component

type Component struct {
	Type reflect.Type
}

컴포넌트는 컨테이너에 의해 등록되는 객체입니다. 컴포넌트 구조체는 싱글톤 오브젝트의 루트입니다.

func ComponentOf

func ComponentOf(ptr any) Component

ComponentOf는 주어진 값을 컨테이너가 관리하는 컴포넌트로 선언합니다.

type Context

type Context interface {
	// 경로 변수 값을 반환
	Param(name string) string
	// 쿼리 파라미터 값을 반환
	Query(name string) string
	// 요청 헤더 값을 반환
	Header(name string) string
	// 요청 본문을 주어진 구조체로 바인딩
	Bind(out any) error
	// 요청 범위 데이터 저장
	Set(key string, value any)
	// 요청 범위 데이터 조회
	Get(key string) (any, bool)
}

Context는 하나의 요청 실행 단위를 표현하는 공통 컨텍스트

type Interceptor

type Interceptor interface {
	/*
		Around는 실행을 감싸는 유일한 진입점

		next를 호출하면 다음 Interceptor 또는 최종 Handler 실행으로 제어가 전달된다.
		next를 호출하지 않으면 실행은 중단된다.
	*/
	Around(ctx Context, next Next) error
}

Interceptor는 실행 흐름을 감사는 횡단 관심사 처리 계약

Interceptor는 Handler 호출 전후에 개입할 수 있으며, 반드시 next를 호출해야 다음 단계로 실행이 전달됨

실행 순서, 중단 여부, 전후 처리의 책임은 Pipeline이 아닌 Interceptor 구현체에 있다.

type Next

type Next func() error

Next는 다음 실행 단계로 제어를 전달하는 함수입니다.

type RouteSpec

type RouteSpec struct {
	// 외부 요청의 메서드
	Method string
	// 외부 요청 경로
	Path string
	// 컨트롤러 메서드에 대한 참조
	Handler any
}

RouteSpec은 외부 프로토콜과 내부 핸들러 메서드를 명시적으로 연결하는 선언 정보

이 구조체는 부트스트랩(부팅) 단계에서 수집되며 Listen() 시점에 실제 라우터/실행 모델로 해석됨