디렉티브 태그

디렉티브 태그

JSP 페이지를 어떻게 처리할 것인지 설정하는 태그이다.
page, include, taglib 총 세 종류이며, 모두 <%@ ··· %>를 사용한다.

디렉티브 태그	형식	설명
page	<%@ page ··· %>	JSP 페이지에 대한 정보를 설정한다.
include	<%@ include ··· %>	JSP 페이지의 특정 영역에 다른 문서를 포함한다.
taglib	<%@ taglib ··· %>	JSP 페이지에서 사용할 태그 라이브러리를 설정한다.

page 디렉티브 태그의 형식

<%@ page 속성1 = "값1" [속성2 = "값2"  ··· ] %>

page 디렉티브 태그의 특징

하나의 page 디렉티브 태그에 하나 또는 여러 개의 속성을 설정할 수 있다.
또는 여러개의 속성마다 개별적으로 page 디렉티브 태그를 선언할 수 있다.
import 속성을 제외한 속성은 JSP페이지에 한 번씩만 설정할 수 있다.

page 디렉티브 태그의 속성

속성	설명	기본 값
language	현재 JSP 페이지가 사용할 프로그래밍 언어를 설정한다.	java
contentType	현재 JSP 페이지가 생성할 문서의 콘텐츠 유형을 설정한다.	text/html
pageEncoding	현재 JSP 페이지의 문자 인코딩을 설정한다.	ISO-8859-1
import	현재 JSP 페이지가 사용할 자바 클래스를 설정한다.
session	현재 JSP 페이지의 세션 사용 여부를 설정한다.	true
buffer	현재 JSP 페이지의 출력 버퍼 크기를 설정한다.	8KB
autoFlush	출력 버퍼의 동작 제어를 설정한다.	true
isThreadSafe	현재 JSP 페이지의 멀티스레드 허용 여부를 설정한다.	true
info	현재 JSP 페이지에 대한 설명을 설정한다.
errorPage	현재 JSP 페이지에 오류가 발생했을 때 보여줄 오류 페이지를 설정한다.
isErrorPage	현재 JSP 페이지가 오류 페이지인지 여부를 설정한다.	false
isElIgnored	현재 JSP 페이지의 표현언어(EL) 지원 여부를 설정한다.	false
isCriptingEnabled	현재 JSP 페이지의 스크립트 태그 사용 여부를 설정한다.

language 속성

기본 값은 java이지만 향후 JSP 컨테이너가 자바 이외의 언어를 지원할 수 있도록 하기 위한 속성이다.
JSP 페이지는 자체적으로 자바 언어를 지원하므로, 이를 생략 가능하다.

[language 속성 사용 예]

<%@ page language = "java" %>

contentType 속성

현재 JSP 페이지의 콘텐츠 유형을 설정하는데 사용한다.
콘텐츠 유형은 주로 text/html, text/xml, text/plain 등이며, 기본 값은 text/html이기에 JSP는 contentType을 사용할 필요가 없다.
하지만, 문자열 세트(charset)를 설정하여 JSP 페이지의 전체 문자열을 변경가능하기에, UTF-8등의 인코딩에 유용하다.

[contentType 속성 사용 예]

<%@ page contentType="text/html" %>

<%@ page contentType="text/html:charset=UTF-8" %>

pageEncoding 속성

pageEncoding 속성은 현재 JSP 페이지의 문자 인코딩 유형을 설정하는데 사용된다.
기본값은 ISO-8859-1이다.
contentType 속성에서 문자열 세트(charset)를 설정한 것과 같은 기능을 한다.

[pageEncoding 속성 사용 예]

<%@ page pageEncoding="UTF-8" %>

import 속성

import 속성은 현재 JSP 페이지에서 사용할 자바 클래스를 설정하는데 쓰인다.
둘 이상의 자바 클래스를 퐇마하는 경우에는 쉼표(,)로 구분하여 연속해서 여러 개의 자바 클래스를 설정할 수 있다.
또는 여러개의 자바 클래스를 각각 별도로 설정할 수도 있다.

[import 속성 사용 예]

<% page import="java.io.*" %>

[import 속성의 다중 자바 클래스 참조 사용 예]

<% page import="java.io.*, java.lang.*" %>

[import 속성 개별적으로 사용 예]

<% page import="java.io.*" %>
<% page import="java.lang.*" %>

session 속성

현재 JSP 페이지의 HTTP 세션 사용 여부를 설정하는 사용한다.
기본 값은 세션을 자동으로 사용하는 true이며, 세션을 사용하지 않으려면 false로 설정한다.
session 속성값이 true면, 현재 JSP 페이지에서 JSP 내장 객체인 session 변수를 사용할 수 있다.

[session 속성 사용 예 : session 내장 객체 사용을 위한 true 설정]

<% page session="true" %>

buffer 속성

현재 JSP 페이지의 출력 버퍼 크기를 설정하는 데 사용한다.
이 속성 값은 none과 '버퍼 크기'로 설정할 수 있다.
none으로 설정할 경우, 출력 버퍼를 채우지 않고 웹 브라우저로 직접 보내게 된다.
기본 값은 8KB이다.
아래와 같이 32KB로 버퍼크기를 설정한 경우에는, 출력 내용이 최소한 32KB 누적될 때 까지 웹 브라우저에 전송되지 않는다.

[buffer 속성 사용 예 : none과 32KB]

<%@ page buffer="none" %>

<%@ page buffer="32KB" %>

autoFlush 속성

autoFlush 속성은 자동으로 출력 버퍼를 비우는 것을 제어하는 데 사용한다.
즉, 출력 버퍼가 채워진 경우 자동으로 버퍼에 있는 데이터를 웹 브라우저로 보내고 버퍼를 비울지 또는 버퍼 오버플로의 예외를 나타낼지 등의 처리를 설정하는 것이다.
기본값은 true이며, 속성 값을 true로 설정하면 출력 버퍼가 채워질 때마다 자동으로 웹 브라우저에 보내고 버퍼를 비운다.
반면에 false로 설정하면, 출력 버퍼가 가득 채워질 때 버퍼 오버플로의 예외를 발생시킨다.

[autoFlush 속성 사용 예]

<%@ page autoFlush="true" %>

isThreadSafe 속성

isThreadSafe 속성은 멀티스레드의 동작을 제어하는 데 사용한다.
여러 요청이 동시에 수신되는 경우 어떻게 동작해야 하는지 JSP 컨테이너에 지시하여 응답할 수 있게한다.
기본값은 true이며, true일 경우에는 JSP 페이지에 대해 수신된 여러 요청이 동시에 처리된다.
반면에 falsue로 설정하면, JSP 페이지에 대한 요청이 순차적으로 처리된다.

[isThreadSafe 속성 사용 예]

<%@ page isThreadSafe="true" %>

info속성

info 속성은 JSP 페이지에 대한 설명을 설정하는 데 사용한다.
JSP개발자에게 도움을 주는 속성이다.
JSP페이지의 설명 부분으로 주석문의 기능과 같기에 JSP 컨테이너는 info 속성을 무시한다.

[info속성 사용 예]

<%@ page info="Home Page JSP" %>

errorPage 속성

errorPage 속성은 현재 JSP 페이지가 실행되는 동안 오류가 발생하면 특정 오류 페이지로 이동하는데 사용한다.
웹 서버가 제공하는 기본 오류 페이지를 사용하지 않고, 이동할 오류페이지의 URL을 설정한다.

[errorPage 속성 사용 예 : 이동할 오류 페이지 = MyErrorPage.jsp로 설정]

<%@ page errorPage="MyErrorPage.jsp" %>

isErrorPage 속성

isErrorPage 속성은 오류 페이지 여부를 설정하는 데 사용한다.
기본값은 false이며, 예외 처리를 위한 내장 객체인 exception 변수를 사용할 수 없다.
속성 값을 true로 설정하면, JSP 페이지는 오류 페이지가 된다.
만약 다른 페이지에서 오류가 발생하면, 호출되는 오류페이지는 true가 설정된 JSP 페이지가 된다.

[isErrorPage 속성 사용 예]

<%@ pageisErrorPage="true" %>

isELIgnored 속성

isELIgnored 속성은 현재 JSP 페이지의 표현 언어(expression language) 사용 여부를 설정하는데 사용한다.
기본 값은 false이며 JSP 페이지에 표현 언어의 표현식 '${}'를 사용할 수 있다.
속성 값을 true로 설정하면 JSP 페이지에 사용된 표현 언어의 표현식을 처리할 수 없기 때문에 정적 텍스트로 처리된다.

[isELIgnored 속성 사용 예 : 표현 언어를 처리하지 않기 위한 true 설정]

<%@ page isELIgnored="true" %>

isScriptingEnabled 속성

isScriptingEnabled 속성은 스크립트 태그(선언문, 스크립틀릿, 표현문) 사용 여부를 설정하는 데 사용한다.
속성 값은 true나 false이며 true로 설정하면 기본 스크립트 태그를 사용할 수 있고, false면 제한한다.

[isScriptingEnabled 속성 사용 예]

<%@ page isScriptingEnabled="false" %>

---

include 디렉티브 태그의 형식

<%@ include file="파일명" %>

include 디렉티브 태그의 속성

file의 속성 값은 현재 JSP 페이지에 포함할 내용을 가진 외부 파일명이다.
외부파일이 현재 JSP 페이지와 같은 디렉터리에 있으면 파일명만 설정하고, 그렇지 않으면 전체 URL(또는 상대 경로)을 설정해야 한다.
include 디렉티브 태그는 서블릿 프로그램으로 번역될 때 현재 JSP 페이지와 설정된 다른 외부 파일의 내용이 병합되어 번역된다.
현재 JSP 페이지에서 include 디렉티브 태그가 사용된 위치에 설정된 파일의 원본 내용을 '있는 그대로' 붙여넣은 다음 전체 페이지를 자바 코드(서블릿)으로 변환한다.

inclue 디렉티브 태그를 사용하는 이유?

inclue 디렉티브 태그를 사용하게 되면 코드 재사용의 가능성을 향상할 수 있다.
웹 애플리케이션의 모든 JSP 페이지에 공통된 특정 코드나 데이터를 하나의 별도 외부 파일로 만들면 이 외부 파일을 모든 JSP 페이지에 포함할 수 있기 때문이다.

include 디렉티브 태그의 특징

include 디렉티브 태그는 현재 JSP 페이지의 특정 영역에 외부 파일의 내용을 포함하는 태그이다.
현재 JSP 페이지에 포함할 수 있는 외부 파일은 HTML, JSP, 텍스트 파일 등이다.
inclu;de 디렉티브 태그는 JSP 페이지 어디서든 선언할 수 있다.
include 디렉티브 태그는 머리글과 바닥글 같은 공통된 부분을 별도의 JSP 파일로 만들어 웹 페이지를 모듈화할 수 있다.
그렇기에 코드를 재사용하고 중복된 코드를 줄임으로 유지 보수 측면에서 매우 유용하다.

---

taglib 디렉티브 태그의 형식

<%@ taglib uri="경로" prefix="태그 식별자" %>

uri 속성은 사용자가 정의한 태그의 설정 정보를 가진 경로 주소이고, prefix 속성은 uri에 설정한 사용자가 정의한 태그를 식별하기 위한 고유 이름이다.
해당 JSP 페이지 내에서 uri 속성 값을 그대로 사용하면 복잡하므로 prefix 속성 값이 대신 식별할 수 있게 해주는 것이다.
taglib 디렉티브 태그가 서블릿 프로그램으로 번역될 때 uri 속성값은 JSP 컨테이너에 사용자가 정의한 태그 라이브러리의 위치를 알려준다.
prefix 속성 값은 사용자가 정의한 태그 라이브러리의 접두어 태그가 무엇인지 JSP 컨테이너에게 알려주는 역할을 한다.

[taglib 디렉티브 태그 사용 예]

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<html>
<head>
<title>JSTL</title>    
</head>
<body>
    <c:out value="JSTL Core 태그 라이브러리"/>    
</body>
</html>