SIP 1.1 어노테이션

SIP 1.1부터 SIP 서블릿 애플리케이션에서 어노테이션을 사용할 수 있습니다. 어노테이션을 사용하여 배치 디스크립터를 사용하는 대신 어노테이션을 사용하여 애플리케이션에서 데이터를 직접 임베드할 수 있습니다.

SIP 1.1에서 사용 가능한 어노테이션

SIP 1.1에서는 다음 어노테이션을 사용할 수 있습니다.
  • @SipApplication
  • @SipServlet
  • @SipListener
  • @SipApplicationKey
팁: 어노테이션 대신 배치 디스크립터를 사용하도록 선택할 수도 있습니다. 배치 디스크립터는 어노테이션에 설명된 설정을 대체합니다.

@SipApplication 어노테이션

@SipApplication 어노테이션은 애플리케이션에 대한 공통 구성 정보를 정의합니다. 이는 패키지 레벨 어노테이션이며 package-info.java 파일에 있어야 합니다. 패키지의 모든 서블릿은 동일한 애플리케이션에 있습니다.
중요사항: 배치 디스크립터나 어노테이션을 사용하는지 여부에 상관 없이 각각 .war 또는 .sar 파일에 대한 컨테이너를 사용하여 한 SIP 애플리케이션만 등록할 수 있습니다.

표 1. @SipApplication 특성 및 해당 배치 디스크립터 요소에 대한 맵핑
어노테이션 특성 배치 디스크립터 요소 설명 기본 어노테이션 값
이름 <app-name> SIP 애플리케이션의 이름입니다. 필수 필드
displayName <display-name> 애플리케이션의 표시 이름입니다. 애플리케이션 이름
설명 <description> 애플리케이션에 대한 설명입니다. 비어 있는 문자열
smallicon <small-icon> 작은 아이콘의 위치가 포함된 경로입니다. 비어 있는 문자열
largeicon <large-icon> 큰 아이콘의 위치가 포함된 경로입니다. 비어 있는 문자열
distributable <destributable> 애플리케이션이 분배 환경에서 작동 가능한지 여부입니다. False(부울)
proxyTimeout <proxy-timeout> 모든 프록시 오퍼레이션에 대한 기본 제한시간입니다. 3분(초 단위)
sessionTimeout <session-timeout> 모든 애플리케이션 오퍼레이션에 대한 기본 제한시간입니다. 3분(분 단위)
mainServlet <main-servlet> 기본 서블릿으로 지정된 SIP 서블릿을 표시합니다. 비어 있는 문자열

@SipServlet 어노테이션

@SipServlet 어노테이션은 클래스가 SIP 서블릿임을 나타냅니다.

표 2. @SipServlet 특성 및 해당 배치 디스크립터 요소에 대한 맵핑
어노테이션 특성 배치 디스크립터 요소 설명 기본 어노테이션 값
@SipServletServlet <servlet-class> 클래스가 SIP 서블릿임을 표시합니다. 어노테이션은 클래스에서 선언됩니다.
이름 <servlet-name> 서블릿의 이름입니다. 어노테이션이 있는 클래스의 축약 이름
applicationName <app-name> 애플리케이션의 이름입니다. @SipApplication을 사용하거나 배치 디스크립터에서 정의할 수 있습니다(선택사항).
loadOnStartup <load-on-startup> 서블릿 애플리케이션의 시작 순서를 정의합니다. 음수(컨테이너에서 해당 서블릿을 시작하는 시기를 선택함)

@SipListener 어노테이션

@SipListener 어노테이션은 <listener> 배치 디스크립터 요소에 대한 대체 요소를 제공합니다.

@SipListener 어노테이션에는 필수 필드가 없지만 선택적으로 애플리케이션 이름과 설명을 사용할 수 있습니다. @SipListener에 의해 어노테이션이 작성된 클래스는 하나 이상의 리스너 인터페이스를 구현해야 합니다.

@SipApplicationKey 어노테이션

@SipApplicationKey 어노테이션은 수신 요청 및 SipSession을 특정 SipApplicationSession과 연관시키는 메소드를 표시합니다. 이 어노테이션은 세션 키 기반 대상과 함께 사용할 수 있습니다.

Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: SIP_dd_mappingtoservlet.html