Kosmos Spring 0.2.0 — Spring Boot에서 Kosmos DSL로 페이지 만들기

A. IntelliJ IDEA Community

1. File > New > Project
2. Generators > Spring Boot 선택
   • Name: kosmos-spring-lec01
   • Language: Java
   • Type: Gradle-Groovy (Gradle-Kotlin도 가능)
   • Group/Artifact: 예) com.example / kosmos-spring-lec01
   • Java: 17
   • Packaging: Jar (추천)
3. Dependencies(의존성): Spring Web 선택
4. 생성 후 실행 버튼(▶)으로 기본 앱이 실행되는지 먼저 확인

B. VS Code

1. 확장 설치: Extension Pack for Java, Spring Boot Extension Pack
2. Ctrl+Shift+P → Spring Initializr: Create a Gradle Project
3. Java 17 / Boot 3.x / Dependencies: Spring Web 선택
4. 폴더 생성 후 열기

package com.example.demo.config;

import net.uneedsoft.kosmos.spring.web.config.RenderContextResolver;
import org.springframework.context.MessageSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Lazy;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.List;

@Configuration
public class KosmosWebMvcConfig implements WebMvcConfigurer {

    private final RenderContextResolver resolver;

    public KosmosWebMvcConfig(RenderContextResolver resolver) {
        this.resolver = resolver;
    }

    // RenderContextResolver는 kosmos-spring 라이브러리에 포함되어 있으므로 "작성"하지 않습니다.
    // 여기서는 프로젝트에서 Bean으로 생성만 해줍니다.
    @Bean
    public RenderContextResolver renderContextResolver(@Lazy MessageSource messageSource) {
        return new RenderContextResolver(messageSource);
    }

    // 컨트롤러 파라미터(RenderContext) 자동 주입을 위해 ArgumentResolver 등록
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(resolver);
    }
}

package com.example.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.web.SecurityFilterChain;

@Configuration
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        return http
            .authorizeHttpRequests(auth -> auth.anyRequest().permitAll())
            // 초보자 단계에서는 GET 위주로 먼저 확인하므로 기본 CSRF를 유지해도 됩니다.
            // 폼/POST까지 진행하면서 막히면 그때 csrf.disable()을 안내하는 방식이 깔끔합니다.
            .build();
    }
}

package com.example.demo.pages;

import net.uneedsoft.kosmos.dsl.core.base.HtmlComponent;
import net.uneedsoft.kosmos.dsl.core.context.RenderContext;
import net.uneedsoft.kosmos.dsl.factory.El;

public class HomePage implements HtmlComponent {

    @Override
    public String render(RenderContext ctx) {
        return El.div().css("container py-5")
            .children(
                El.h1().text("Kosmos + Spring Boot"),
                El.p().text("kosmos-spring 0.2.0 설정이 완료되었습니다."),
                El.p().css("text-muted mb-0")
                    .text("RenderContext가 컨트롤러 파라미터로 자동 주입됩니다.")
            )
            .render(ctx);
    }
}

package com.example.demo;

import com.example.demo.pages.HomePage;
import net.uneedsoft.kosmos.dsl.core.context.RenderContext;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HomeController {

    @GetMapping("/")
    public String home(RenderContext ctx) { // 자동 주입
        return new HomePage().render(ctx);
    }
}