JSP 포함 지시문(Include Directive)이란?
include 지시문은 JSP 페이지가 서블릿으로 변환되는 번역(translation) 단계에서 다른 파일을 현재 페이지에 포함시키는 데 사용됩니다. 이 지시문은 JSP 컨테이너에게 번역 단계 동안 외부 파일의 내용을 현재 JSP에 병합하도록 지시하는 역할을 합니다.
즉, 소스 코드 수준에서 지정한 파일의 내용이 그대로 삽입된 후 하나의 서블릿으로 컴파일되기 때문에, 헤더, 푸터, 네비게이션 바처럼 여러 페이지에서 반복적으로 사용되는 공통 요소를 효율적으로 관리할 수 있습니다.
또한 include 지시문은 JSP 페이지의 어느 위치에든 자유롭게 작성할 수 있습니다.
기본 문법
include 지시문의 일반적인 사용 형식은 다음과 같습니다.
<%@ include file="relativeURL" %>
file 속성에는 포함시킬 파일의 상대 URL(relative URL) 경로를 지정합니다.
사용 예제
예를 들어 모든 페이지에 공통으로 들어가는 헤더와 푸터를 분리해 관리하고 싶다면 다음과 같이 작성할 수 있습니다.
<%@ include file="header.jsp" %>
<html>
<body>
<p>메인 페이지 본문 내용입니다.</p>
</body>
</html>
<%@ include file="footer.jsp" %>
주요 특징 및 참고 사항
- 번역 시점에 파일이 병합되므로, 포함된 파일이 변경되면 해당 JSP 페이지를 다시 번역해야 변경 사항이 반영됩니다.
- 정적인 콘텐츠를 포함하는 데 적합하며, 실행 시점에 동적으로 결과를 포함해야 한다면
<jsp:include>액션 태그를 사용하는 것이 좋습니다. - 코드 중복을 줄여 유지보수성을 높이는 데 큰 도움이 됩니다.