RenderContext & Auth

핵심 구성

RenderContext 인터페이스

public interface RenderContext {
  Object model(String key);
  RenderContext model(String key, Object value);
  <T> T get(String key, Class<T> type);
  RenderContext set(String key, Object value);

  // 헬퍼
  default String userId() { return get("auth.userId", String.class); }
  default Set<String> roles() { return get("auth.roles", Set.class); }
  default Set<String> permissions() { return get("auth.permissions", Set.class); }
  default Set<String> flags() { return get("flags", Set.class); }
  default String tenant() { return get("tenant", String.class); }
  default Locale locale() { return get("locale", Locale.class); }

  default boolean hasRole(String role) { return roles() != null && roles().contains(role); }
  default boolean hasPerm(String perm) { return permissions() != null && permissions().contains(perm); }
  default boolean feature(String flag) { return flags() != null && flags().contains(flag); }
}

스프링 인터셉터로 컨텍스트 적재

@Component
public class RenderContextInterceptor implements HandlerInterceptor {

  @Autowired private AuthFacade auth; // SecurityContext 래퍼
  @Autowired private TenantResolver tenantResolver;
  @Autowired private FeatureFlagService flags;

  @Override
  public boolean preHandle(HttpServletRequest req, HttpServletResponse res, Object handler) {
    RenderContext ctx = (RenderContext) req.getAttribute("RC");
    if (ctx == null) {
      ctx = new DefaultRenderContext(); // 스레드/요청 범위
      req.setAttribute("RC", ctx);
    }

    // 인증/권한
    ctx.set("auth.userId", auth.currentUserId().orElse(null));
    ctx.set("auth.roles", auth.currentRoles());
    ctx.set("auth.permissions", auth.currentPermissions());

    // 테넌트/로캘/플래그
    ctx.set("tenant", tenantResolver.resolve(req));
    ctx.set("locale", req.getLocale());
    ctx.set("flags", flags.forUser(auth.currentUserId().orElse("anonymous")));

    return true;
  }
}

컨트롤러에서 모델 세팅

@GetMapping("/docs/kosmos/spring/render-context")
public ResponseEntity<String> page(HttpServletRequest req) {
  RenderContext ctx = (RenderContext) req.getAttribute("RC");
  ctx.model("page.title", "RenderContext & Auth");
  ctx.model("doc.subtitle", "컨텍스트 기반 렌더링");
  HtmlComponent body = viewBody(); // 아래 예시 구성
  return ResponseEntity.ok(new PageTemplate()
    .header(new GlobalHeader())
    .breadcrumbs(new Breadcrumbs(List.of(
      new String[]{"Docs","/docs/kosmos/overview"},
      new String[]{"RenderContext & Auth","/docs/kosmos/spring/render-context"}
    )))
    .sidebar(new DocsSidebar(loadSideTree()))
    .content(body)
    .render(ctx));
}

코드 심화: Auth/Flag로 조건 렌더

// 버튼 영역: ADMIN만 편집, 일반은 읽기 전용
HtmlComponent actions = ctx.hasRole("ADMIN")
  ? El.div().children(
      El.a().css("btn btn-primary").href("/admin/tools").text("관리도구"),
      El.a().css("btn btn-outline-secondary").href("/docs/kosmos/reference").text("Reference")
    )
  : El.div().css("text-muted").text("읽기 전용");

// 신규 폼 플래그
HtmlComponent formArea = ctx.feature("newForm")
  ? El.div().css("card").child(El.div().css("card-body").children(
      El.h2().css("h5").text("신규 폼(v2)"),
      El.p().css("mb-0").text("실험 채널에서만 노출됩니다.")
    ))
  : El.div().css("card").child(El.div().css("card-body").children(
      El.h2().css("h5").text("기존 폼(v1)"),
      El.p().css("mb-0").text("안정 채널")
    ));

테넌트/로캘 응용

// 테넌트별 브랜드 컬러/로고 적용
String tenant = ctx.tenant(); // "acme" / "globex"
HtmlComponent banner = El.div().css("alert " + ("acme".equals(tenant) ? "alert-primary" : "alert-success"))
  .text("Welcome, " + tenant.toUpperCase(Locale.ROOT));

// 로캘 맞춤 날짜/숫자
Locale locale = ctx.locale();
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy.MM.dd", locale);
HtmlComponent stamp = El.small().css("text-muted").text("생성일: " + LocalDate.now().format(fmt));

보안/권한 가이드

통합 예: 템플릿 + 조건 렌더

HtmlComponent content = El.div().children(
  banner,                      // 테넌트 배너
  El.div().css("mb-3").child(stamp),
  El.hr(),
  formArea                     // 플래그 분기
);

var page = new PageTemplate()
  .header(new GlobalHeader())
  .breadcrumbs(new Breadcrumbs(List.of(
    new String[]{"Docs","/docs/kosmos/overview"},
    new String[]{"RenderContext & Auth","/docs/kosmos/spring/render-context"}
  )))
  // 데이터가 있으면 사이드바 표시 같은 조건도 가능
  .sidebar(new DocsSidebar(loadSideTree()))
  .content(content)
  .actions(actions);

테스트 전략

• 컨텍스트 스텁: 테스트용 DefaultRenderContext에 roles/flags/tenant를 주입하여 스냅샷 비교
• 권한 케이스: ADMIN/USER/익명별 UI 차이 검증
• 다국어: ko_KR/en_US 로캘 변경 시 날짜/라벨이 적절히 표시되는지 확인
• 테넌트 분기: 브랜드 컬러/리소스 경로가 테넌트마다 분기되는지 확인

성능 팁

• 불변 데이터: 롤/플래그는 세션/캐시에 저장하고 요청마다 재계산을 최소화
• 지연 로딩: 무거운 모델은 필요할 때만 ctx.model()에 세팅
• 로캘 포맷: 포맷터를 재사용(캐시)하여 반복 생성 비용 절감

주의사항

다음으로

• Conditional Rendering — 역할/플래그 기반 분기 패턴
• GenericCrudController — CRUD와 컨텍스트 결합
• Alerts — 권한/검증 결과 피드백
• Validation — 서버 검증과 UI 연동
• Kosmos API — RenderContext 관련 API 요약