[서블릿/JSP] TLD(Tag Library Descriptor)란? tld 파일 작성 방법

연관글

[서블릿/JSP] JSP 커스텀 태그란? JSP 2.0 SimpleTagSupport를 이용한 태그 작성 방법

[서블릿/JSP] JSP 1.2 버전 커스텀 태그 만들기

TLD(Tag Library Descriptor)란

Tag Library Descriptor 줄여서 tld란 JSP에서 사용되는 커스텀 태그나 JSTL의 태그들에 대한 설정 파일입니다. Servlet을 개발하면 WEB-INF/web.xml에 해당 서블릿에 대한 접근 url-pattern이나 servlet-class등을 설정하여 서블릿컨테이너인 톰캣이 인식할 수 있도록 하는것과 마찬가지로 개발한 태그 핸들러에 대해 속성이나 속성의 타입, 태그명, uri 등을 정의해두는 설정이 tld이며 *.tld라는 확장자를 갖습니다.

tld 파일은 web.xml과 마찬가지로 웹 어플리케이션 경로의 WEB-INF 디렉터리 하위에 작성해 주어야 인식되며, JSP 1.2 버전의 경우는 web.xml 파일에 따로 tld 파일에 대한 추가 설정이 필요하며, JSP 2.0 이상인 경우에는 WEB-INF 하위에만 작성해주면 자동으로 인식됩니다.

tld 파일 템플릿 만들기

tld 파일은 XML 기반이며 dtd나 schema를 tld 파일 내용의 상단에 명시해 주어야 합니다. 이클립스에서는 버전에 따라 tld 파일 기본 템플릿 파일을 만들 수 있는 기능을 제공하고 있습니다.

이클립스에서 JSP 1.2 TLD 파일 작성법

이클립스 상단 메뉴의 File > New > Other...

XML File 클릭 > Next

원하는 위치를 지정하고 파일명의 확장자를 tld로 변경한 후 Next 클릭

Create XML file from a DTD file 체크 > Next

Select XML Catalog entry 체크 > JSP Tag Library 1.2//EN 선택 > Next

Finish 클릭하여 마무리

만들어진 TLD입니다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag  Library 1.2//EN"  "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd" >
<taglib>
    <tlib-version>tlib-version</tlib-version>
    <jsp-version>jsp-version</jsp-version>
    <short-name>short-name</short-name>
    <tag>
        <name>name</name>
        <tag-class>tag-class</tag-class>
    </tag>
</taglib>

이클립스에서 JSP 2.0 TLD 파일 작성법

이클립스 상단 메뉴의 File > New > Other...

XML File 클릭 > Next

원하는 위치를 지정하고 파일명의 확장자를 tld로 변경한 후 Next 클릭

Create XML file from an XML schema file 체크 > Next

jsptaglibrary_2_0.xsd를 찾아 선택 > Next

저의 경우 STS를 이용하여 실습을 진행했는데, 최신 버전의 이클립스인 경우 끝에 버전에 2_0이 아닌 2_1.xsd라거나 다른 버전일 수 있습니다. 그 중 최신버전을 선택합니다.

첫번째 항목을 선택 후 Edit... 클릭

Prefix를 공백으로 만들고 OK

Finish 클릭하여 마무리합니다.

tld파일이 생성됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xml="http://www.w3.org/XML/1998/namespace"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee  http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd ">
    
    <tlib-version>0.0</tlib-version>
    <short-name>customTag</short-name>
    <uri>http://customTag.com</uri>
    
</taglib>