내용보기

지금까지 우리는 <prefix:tagname />형의 한 줄로만 이루어진 독립형 태그만을 사용해 왔습니다. 이 절에서는 다음과 같은 형식으로 표시된 Body 즉, 본체를 포함하는 커스텀 태그에 대해 살펴볼 것입니다.

앞에서의 태그 핸들러 예제에서 일을 처리하는 doStartTag 메서드는 리턴 값으로 SKIP_BODY를 넘겨주었습니다. 이것은 바디의 내용이 있든 없든 상관하지 않고 무시해 버리는 것을 의미했습니다. 그렇게 하지 않고 바디의 내용을 출력하려면, 리턴 값으로 doStartTag 메서드가 EVAL_BODY_INCLUDE를 돌려줘야 합니다. 또한 여러 개의 태그를 처리하는 경우 하나의 태그가 끝나더라도 계속 수행을 할 수 있도록 하기 위해서 태그가 끝날 때 호출되는 doEndTag 메서드의 리턴 값을 EVAL_PAGE로 주어야 합니다.

그럼 위에 설명한 것들을 생각하면서 바디가 포함된 태그를 처리하는 태그 핸들러 클래스를 만들어 보겠습니다. 다음 예제는 커스텀 태그를 통해서 바디의 색깔과 크기를 조절한 후 내용을 그대로 출력하는 핸들러입니다.

FontMagic.java	바디를 출력하는 태그 핸들러
`package` `tags;` `import` `java.io.;` `import` `javax.servlet.jsp.;` `import` `javax.servlet.jsp.tagext.*;` `public class` `FontMagic` `extends` `TagSupport {` `String color =` `"black";` `String size =` `"3";` `public` `int` `doStartTag() {` `try{` `JspWriter out = pageContext.getOut();` `out.print("<font color="+color+" size = "+ size +` `">");` `}catch(IOException e){}` `return` `EVAL_BODY_INCLUDE;` `}` `public` `int` `doEndTag(){` `try{` `JspWriter out = pageContext.getOut();` `out.print("</font></br>");` `}catch(IOException e){}` `return` `EVAL_PAGE;` `}` `public` `void` `setColor(String color){` `this.color = color;` `}` `public` `void` `setSize(String size){` `this.size = size;` `}` `}`
C:\jakarta\webapps\MySample\WEB-INF\classes\tags>javac FontMagic.java

소스 내용을 보시면 폰트 컬러와 사이즈 속성을 정의해 주는 것을 알 수 있을 것입니다. 그런데 이것이 앞의 예제들과 다른점은 doStartTag 메서드에서 리턴 값으로 EVAL_BODY_INCLUDE를 돌려주어 바디를 포함하겠다는 것을 알리고 있습니다.

바디를 처리하고 태그가 끝날 때 호출되는 doEndTag 메서드에서는 태그의 계속적인 수행을 위해서 EVAL_PAGE를 리턴 하는 것을 알 수 있습니다.

위의 두 가지 사항만 주의한다면 하나도 어려울 것이 없는 핸들러입니다. 다음으로 핸들러 클래스를 정의할 TLD을 살펴보겠습니다. 역시 앞의 noveltag.tld 파일에서 FontMagic 핸들러 클래스를 정의하는 부분만 추가하여 다시 저장할 것입니다.

noveltag.tld

<! ... ... 앞부분 생략 -->
  <tag>
    <name>fontmagic</name>
    <tag-class>tags.FontMagic</tag-class>
    <description>adjust font color and font size </description>
    <attribute>
      <name>color</name>
      <required>false</required>
    </attribute>
    <attribute>
      <name>size</name>
      <required>false</required>
    </attribute>
  </tag>

</taglib>

특별히 더 설명드릴 것이 없군요. 단지 여기서는 두 속성의 required 엘리먼트 값을 false로 해서 태그에서 그 속성을 생략해도 된다는 것만 주의해 보십시오. 위의 태그 핸들러를 보시면, color와 size값을 각각 black과 3으로 디폴트 값을 정해 주었음을 알 수 있을 것입니다. 그럼 JSP에서 태그를 사용해 보도록 하겠습니다.

fontmagic.jsp	body내용을 출력하는 커스텀 태그의 JSP
`<%@ page contentType="text/html; charset=euc-kr"` `%>` `<%@ taglib uri ="noveltag.tld"` `prefix =` `"noveljsp"` `%>` `<html><body>` `<noveljsp:fontmagic>` `디폴트 값이군요.` `</noveljsp:fontmagic>` `<noveljsp:fontmagic color="blue"` `size="5">` `파란색에` `5크기입니다.` `</noveljsp:fontmagic>` `<noveljsp:fontmagic color="red"` `size="7">` `빨강색에` `7크기입니다.` `</noveljsp:fontmagic>` `</body></html>`

결과를 보시면, 속성을 가지지 않은 태그, 속성을 다르게 가진 두개의 태그가 각각 바디 내용을 가져서 속성에 따라서 글자의 색과 크기가 출력되었음을 확인 할 수 있습니다. 지금의 예제는 HTML의 <font>태그를 사용하는 것과 별반 다를 것이 없지만, 고정된 여러 종류의 테이블이나 폰트 등이 쓰이는 곳이라면, 커스텀 태그를 사용해 레이아웃을 정해 두면 편리하게 이용할 수 있을 것입니다.

7.7 Body를 가지는 태그