🌱 Sprout Framework

Spring이 내부적으로 어떻게 작동하는지 이해하기 위해 처음부터 구축한 경량 Java 웹 프레임워크

Sprout는 현대 Java 웹 개발의 핵심 개념들을 처음부터 구현한 종합적인 웹 프레임워크입니다. 완전히 작동하는 NIO 및 하이브리드 서버와 비동기 WebSocket 스택을 갖추고 있으면서도, 명확성, 해킹 가능성, 확장성에 중점을 두고 있습니다.

왜 Sprout인가?

교육 목적: Spring과 같은 프레임워크가 내부적으로 어떻게 작동하는지 유사한 기능을 처음부터 구축해보며 이해합니다.

집중된 범위: 컨테이너/AOP/웹/서버 내부에 의도적으로 집중합니다. 완전한 ORM은 v1.0의 범위에서 제외하여 관리 가능한 표면적을 유지하고 코드를 쉽게 검토할 수 있도록 했습니다.

주요 기능

🏗️ IoC / DI 컨테이너

• @Component, @Service, @Controller, @Repository, @Configuration, @Aspect 스캔
• 자동 List<T> 채우기를 포함한 생성자 기반 주입
• 위상 정렬을 사용한 순환 의존성 감지
• 합리적인 기본값을 위한 BeanDefinitionRegistrar를 통한 자동 구성

🎯 AOP (관점 지향 프로그래밍)

• 어노테이션 기반 (@Before, @After, @Around)
• 와일드카드가 포함된 AspectJ 스타일 포인트컷 (*, .., ?)
• CGLIB 서브클래싱 + Objenesis 폴백 (기본 생성자 불필요)
• 대상별 프록시를 가진 순서화된 어드바이저 체인

🌐 웹 계층

• 선언적 라우팅 (@GetMapping, @PostMapping 등)
• 경로 변수 ({id})와 요청 매개변수 바인딩
• 포괄적인 인수 리졸버와 응답 처리
• @ControllerAdvice를 통한 예외 처리

⚡ 고성능 서버

• java.nio.channels를 기반으로 한 NIO 서버
• 하이브리드 모드: 가상 스레드를 통한 HTTP, NIO를 통한 WebSocket
• 학습과 디버깅을 위한 블로킹 폴백
• 구성 가능한 실행 모드와 스레드 유형

🔒 보안 시스템

• 모듈화된 인증 (AuthenticationManager, UserDetailsService)
• @PreAuthorize를 통한 메서드 보안 (AOP 기반)
• URL 권한 부여와 역할 기반 접근 제어
• 요청별 ThreadLocal을 가진 SecurityContextHolder

🔌 WebSocket 지원

• RFC6455 준수 핸드셰이크와 프레임 처리
• 우아한 연결 처리를 가진 논블로킹 쓰기 큐
• 대용량 메시지를 위한 분할 지원
• 생명주기 훅 (@OnOpen, @OnMessage, @OnClose, @OnError)

품질 및 테스트

577개 테스트

85% 라인 커버리지

75% 브랜치 커버리지

0개 실패

포괄적인 테스트 슈트는 다음을 다룹니다:

• 핵심 컨테이너 기능 (스캔, 주입, 생명주기)
• AOP 어드바이스 빌더와 인터셉터
• MVC 요청/응답 처리
• 보안 인증과 권한 부여
• 서버 구현 (블로킹/NIO/하이브리드)
• WebSocket 프로토콜 준수

시작하기

빠른 시작 가이드를 확인하여 몇 분 만에 시작해보세요.

아키텍처를 이해하고 싶으신가요? 아키텍처 가이드를 탐색하여 Sprout가 IoC, AOP, 웹 서빙을 어떻게 구현하는지 알아보세요.

커뮤니티 및 지원

• 📚 문서 - 종합적인 가이드와 API 참조
• 🐛 이슈 - 버그 리포트와 기능 요청
• 💬 토론 - 커뮤니티 지원과 아이디어
• 📊 테스트 리포트 - 최신 테스트 실행 결과
• 📈 커버리지 리포트 - 코드 커버리지 분석