[Java] JSP - 지시어(Directive)

지시어(Directive)

JSP 문서(웹프로그램)에 필요한 정보를 제공하도록 지시한다.

page Directive 속성

ERROR

page 디렉티브에서 isErrorPage 속성을 [true]로 설정하면 예외 관련 정보가 저장된 exception 내장객체를 JSP 문서에 제공한다.

<%@ 
page language="java"
contentType="text/html; 
charset=UTF-8"
pageEncoding="UTF-8"
isErrorPage="true"
%>

[web.xml] 파일에서 모든 웹프로그램에 대한 요청에러(4XX)와 응답에러(5XX)에 대한 에러페이지 설정할 수 있다(클라이언트의 요청 URL 주소 미변경).

• exception-type
  웹프로그램 실행시 발생된 예외에 대한 예외클래스를 설정하는 엘리먼트
• location
  에러메세지를 제공하기 위한 웹프로그램을 설정하는 엘리먼트
• error-code
  클라이언트에 전달되는 상태코드(에러코드:4XX or 5XX)를 설정하는 엘리먼트

 <error-page>
  	<exception-type>java.lang.NullPointerException</exception-type>
  	<location>/error/error_null.jsp</location>
  </error-page>
  
  <error-page>
  	<error-code>500</error-code>
  	<location>/error/error_500.jsp</location>
  </error-page>

import

JSP 문서에서 사용될 클래스 또는 인터페이스를 패키지로 명확하게 표현하기 위한 속성이다.
page Directive에서는 동일한 속성에 다른 속성값으로 중복 선언한 경우 500 에러 발생하지만,
import 속성은 다른 속성값으로 여러번 선언하는 것이 가능하다.

<%@page import="java.util.ArrayList"%>
<%@page import="java.util.List"%>

contentType

JSP 문서를 요청하여 응답 받을 수 있는 문서(파일)의 유형(MimeType)과
캐릭터셋(Charset - encoding)을 제공하기 위한 속성이다.

<%@ 
page language="java" 
contentType="application/vns.ms-excel; 
charset=UTF-8"
pageEncoding="UTF-8"
%>

include Directive

JSP 문서에 외부 파일의 코드를 포함하도록 지시한다.
컨텍스트에 존재하는 파일의 코드를 현재 JSP 문서에 포함하는 지시어다.
file 속성값으로 설정된 외부파일의 내용(코드)을 include Directive 위치에 포함한다.
file 속성값으로 설정된 외부파일이 존재하지 않을 경우 에러가 발생한다.

<%@include file="URL"%>

• jspf 파일
  요청에 대한 처리와 응답이 목적이 아닌 다른 JSP 문서에 코드를 제공하여
  포함되도록 작성된 파일이다.
  JSPF 파일과 파일을 포함하는 JSP 파일의 contentType 속성값은 반드시 동일하게 설정해야 한다.

<%@include file="include_sub.jspf"%>

taglib Directive

JSP 문서에 태그 라이브러리 파일의 Java 태그를 포함하도록 지시한다.
태그 라이브러리 파일에 등록된 커스텀 태그 사용할 수 있다.

• 태그 라이브러리 파일
  태그 클래스를 커스텀 태그로 등록하는 XML 파일이다.
• prefix 속성
  커스텀 태그를 사용하여 위한 네임스페이스(NameSpace)를 속성값으로 설정한다.
• uri 속성
  태그 라이브러리 파일에 등록된 식별자(uri 엘리먼트의 태그내용)를 속성값으로 설정한다.

<%@taglib prefix="namespace" uri="tldId"%>