Getting Started

Kosmos DSL을 처음 접하는 분들을 위한 가이드입니다. 설치부터 환경 설정, 첫 화면까지 5분 이내에 실행 가능한 과정을 안내합니다.

빠른 시작 4단계

 

1. 의존성 추가

Gradle/Maven에 kosmos-dsl 등록

 

2. 환경 설정

JDK 17+ & Spring Boot 3.x

 

3. 첫 컴포넌트

Hello Kosmos! 렌더링

 

4. 실행 & 확인

로컬 브라우저에서 결과 확인

Hello Kosmos 예시

의존성을 추가했다면, 아래처럼 HelloKosmosPage를 작성하여 첫 화면을 띄워볼 수 있습니다.

public class HelloKosmosPage implements HtmlComponent {
    @Override
    public String render(RenderContext ctx) {
        return El.div().css("container py-5").children(
            El.h1().text("Hello, Kosmos!"),
            El.p().text("타입 안정 DSL로 작성된 첫 페이지입니다."),
            El.a().css("btn btn-primary mt-3")
                 .href("/docs/kosmos/foundation")
                 .text("Foundation 문서 보기")
        ).render(ctx);
    }
}

필수 환경

항목 권장 버전 비고
Java 17 이상 LTS 안정 버전 권장
Gradle 8.5+ Groovy DSL 유지 가능
Spring Boot 3.2+ Servlet 기반 SSR
IDE IntelliJ / VS Code Annotation Processor 활성화

설치 & 실행 흐름

Gradle/Maven Spring Boot Kosmos DSL HelloKosmosPage 브라우저에서 확인

주의사항

  • Gradle Sync 오류: IDE에서 kosmos-dsl이 인식되지 않으면, mavenLocal() 또는 repositories { mavenCentral() } 재확인
  • 버전 호환성: JDK 21에서도 실행되지만, 일부 LTS 플러그인 호환성은 JDK 17 기준 검증됨
  • 첫 렌더링: Controller에서 return page.render(ctx); 구조를 지켜야 함
  • 패키지 구조: 컨트롤러, 서비스, DSL 구성은 초기에 명확히 분리하여 향후 확장을 대비

다음으로