본문으로 건너뛰기
버전: 4.6.1-saas

Java Agent

개요​

Java Agent는 Java 기반 Spring Boot 서버에서 NetFUNNEL 4 트래픽 제어 기능을 제공하는 서버 측 SDK입니다.

주요 기능​

  • 서버 측 SDK: Spring Boot 애플리케이션에 직접 통합
  • URL-Triggered 통합: 트리거 규칙 기반 자동 제어
  • Interceptor/Filter 지원: Spring Boot Interceptor 또는 Filter 방식으로 적용
  • 자동 대기실 리다이렉트: 대기 응답 시 자동으로 대기실 페이지로 리다이렉트
  • 트리거 규칙 매칭: URL 기반 트리거 규칙으로 대기열 적용 지점 제어
  • 강력한 오류 처리: 포괄적인 오류 처리 및 로깅

시스템 요구사항​

  • Java: 1.7 이상
  • Spring Boot: 3.x 이상
  • 외부 의존성:
    • gson: JSON 직렬화/역직렬화를 사용하기 위한 라이브러리
    • jackson-module-kotlin: Kotlin 사용을 위해 필요한 라이브러리 (Java 사용 시)

호환 환경​

  • Java 애플리케이션: Java 1.7 이상 기반 애플리케이션
  • Spring Boot 애플리케이션: Spring Boot 3.x 이상 기반 애플리케이션

작동 방식​

  1. 에이전트 초기화: NetFUNNEL을 초기화하고 설정 구성
  2. Interceptor/Filter 적용: 요청을 먼저 수신하는 Interceptor 또는 Filter에 NetFUNNEL 로직 적용
  3. 트리거 규칙 매칭: 사용자가 접속한 페이지의 URL과 트리거 규칙을 비교하여 일치하는 경우 대기열 적용
  4. 자동 대기실 처리: 대기 응답 시 자동으로 대기실 페이지로 리다이렉트

에이전트 동작 흐름​

대기 전: 페이지 로드 → 에이전트 초기화 → 트리거 규칙 매치

대기 중: 넷퍼넬 서버 요청 → 넷퍼넬 키 발급 → 대기실 페이지로 이동

대기 후: 서비스 페이지 진입 → 넷퍼넬 키 반납

통합 방법​

URL-Triggered 통합​

URL-Triggered 통합은 NetFUNNEL 콘솔의 세그먼트 트리거 규칙을 통해 대기열 제어 지점을 설정합니다. 사용자가 접속한 페이지의 URL과 트리거 규칙을 비교하여 일치하는 경우 대기열이 적용됩니다.

자세한 내용은 통합 방법 개요 문서를 참조하세요.

제한 사항​

코드 기반 통합 미지원

Java Agent는 코드 기반 통합을 지원하지 않습니다. URL-Triggered 통합만 사용할 수 있습니다.

빠른 시작​

Java Agent를 빠르게 시작하려면 빠른 시작 가이드를 참조하세요.

문서​

핵심 문서​

관련 콘텐츠​