JSP 사용자 정의 태그 속성 정의하기: TLD 표준 속성 완벽 가이드

JSP 사용자 정의 태그의 속성이란?

JSP에서 사용자 정의 태그(Custom Tag)를 작성할 때는 TLD(Tag Library Descriptor) 파일에 해당 태그가 받아들일 속성(attribute)을 명확하게 정의해야 합니다. 속성을 올바르게 정의하면 태그의 재사용성이 높아지고, JSP 페이지에서 태그를 사용할 때 어떤 값을 전달해야 하는지 개발자가 쉽게 파악할 수 있습니다.

속성을 정의할 때는 아래와 같은 표준 속성 요소들을 포함하는 것이 좋습니다.

태그 속성의 주요 구성 요소

번호	속성 및 용도
1	name 속성의 이름을 정의하는 요소입니다. 하나의 태그 안에서 각 속성 이름은 반드시 고유(unique)해야 합니다.
2	required 해당 속성이 필수인지 선택 사항인지 지정합니다. 선택 사항인 경우 `false`로 설정합니다.
3	rtexprvalue 태그 속성 값으로 런타임 표현식(runtime expression)을 사용할 수 있는지 여부를 선언합니다. 예를 들어 `<%= ... %>`나 EL 표현식으로 동적인 값을 전달하고 싶다면 `true`로 설정해야 합니다.
4	type 속성의 자바(Java) 클래스 타입을 정의합니다. 별도로 지정하지 않으면 기본적으로 String 타입으로 간주됩니다.
5	description 속성의 용도나 사용 방법에 대한 설명 정보를 기술할 수 있습니다. 문서화와 유지보수에 도움이 됩니다.
6	fragment 해당 속성 값을 JspFragment로 처리해야 하는지 여부를 선언합니다.

단일 속성 정의 예제

다음은 TLD 파일에서 하나의 속성과 관련된 속성들을 지정하는 예제입니다.

.....
    <attribute>
      <name>attribute_name</name>
      <required>false</required>
      <type>java.util.Date</type>
      <fragment>false</fragment>
    </attribute>
.....

위 예제에서 attribute_name이라는 속성은 필수가 아니며(선택 사항), 자바의 java.util.Date 타입으로 선언되었고, 프래그먼트로는 처리되지 않습니다.

여러 속성 정의 예제

태그에 두 개 이상의 속성을 전달해야 한다면 TLD 파일에 <attribute> 요소를 여러 번 나열하면 됩니다.

.....
    <attribute>
      <name>attribute_name1</name>
      <required>false</required>
      <type>java.util.Boolean</type>
      <fragment>false</fragment>
    </attribute>

    <attribute>
      <name>attribute_name2</name>
      <required>true</required>
      <type>java.util.Date</type>
    </attribute>
.....

위 예제처럼 첫 번째 속성 attribute_name1은 선택 사항(false)이고, 두 번째 속성 attribute_name2는 필수 속성(true)으로 정의했습니다. 이렇게 하면 JSP 페이지에서 해당 태그를 사용할 때 attribute_name2 값을 반드시 전달해야 합니다.

정리

TLD 파일에서 속성을 정의할 때는 name, required, rtexprvalue, type, description, fragment 여섯 가지 표준 요소를 적절히 조합하여 사용하면 됩니다. 특히 속성의 필수 여부와 데이터 타입을 명확히 지정해 두면, 태그 사용 시 발생할 수 있는 오류를 사전에 방지하고 코드의 가독성과 유지보수성을 크게 향상시킬 수 있습니다.