[서블릿/JSP] JSP 2.0 커스텀 태그 관련 API

연관글

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

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

JSP 2.0 커스텀 태그 관련 API

JSP 2.0에서 커스텀태그를 더욱 심플하게 작성하기 위해 새로운 커스텀태그 확장 관련 API를 제공합니다. javax.servlet.jsp.tagext 패키지 하위에 있으며 SimpleTagSupport를 상속받아 개발합니다.

SimpleTagSupport

JSP2.0에 추가된 클래스로 SimpleTag 인터페이스를 상속하며 태그 핸들러를 작성할때 상속받아 사용하는 클래스입니다.

메서드	설명
public void doTag() throws JspException, IOException	태그의 실질적인 기능을 구현합니다. JSP에서 태그가 실행될때 이 메서드가 호출됩니다.
public static final JspTag findAncestorWithClass(JspTag from, Class<?> klass)	커스텀태그가 중첩 태그인 경우 부모태그에 대한 JspTag 인스턴스를 반환합니다.
protected JspFragment getJspBody()	서블릿컨테이너에 의해 처리된 태그 몸체를 JspFragment로 반환합니다.
protected JspContext getJspContext()	태그가 실행된 JSP의JspContext객체를 반환합니다. 이를 PageContext로 형변환하여 사용할 수 있습니다.
public JspTag getParent()	부모 태그를 반환합니다.
public void setJspBody(JspFragment jspBody)	JspFragment를 설정합니다.
public void setJspContext(JspContext pc)	JspContext를 설정합니다.
public void setParent(JspTag parent)	JspTag를 설정합니다.

JspFragment

JspFragment는 커스텀 태그의 바디부분을 처리하는 객체입니다. SimpleTagSupport#getJspBody()를 호출하여 얻을 수 있습니다.

메서드	설명
public abstract JspContext getJspContext()	JspContext를 반환합니다.
public abstract void invoke(Writer out)  throws JspException, IOException;	태그의 몸체를 처리하여 매개변수로 넘겨준 Writer객체에 출력합니다.

JspContext

JspContext의 실질적인 인스턴스는 JspContext를 상속받은 PageContext객체이며 태그핸들러 작성시 getJspContext()를 통해 얻은 객체는 다음과 같이 형변환 하여 사용할 수 있습니다.

PageContext context = (PageContext)this.getJspContext();

PageContext에 대한 내용은 다음의 링크를 참고합니다.

-> [서블릿/JSP] JSP pageContext 객체

-> [서블릿/JSP] JSP 기본 객체별 생명 주기(scope)