Chỉ thị include dùng để đưa một tập tin vào giai đoạn dịch (translation phase). Chỉ thị này yêu cầu container hợp nhất nội dung các tập tin bên ngoài với JSP hiện tại trong giai đoạn dịch. Bạn có thể đặt chỉ thị include ở bất kỳ đâu trong trang JSP.
Cú pháp chung
<%@ include file = "relative url" %>
Tên tập tin trong include directive thực chất là một URL tương đối. Nếu chỉ đưa tên tập tin mà không kèm đường dẫn, trình biên dịch JSP giả định tập tin đó nằm cùng thư mục với JSP của bạn.
Dạng XML tương đương:
<jsp:directive.include file = "relative url" />
Ví dụ thực tế
Ví dụ điển hình của chỉ thị include là đưa header và footer chung vào nhiều trang nội dung.
Định nghĩa 3 tập tin: header.jsp, footer.jsp, main.jsp:
Nội dung header.jsp
<%! int pageCount = 0; void addCount() { pageCount++; } %>
<% addCount(); %>
<html>
<head> <title>The include Directive Example</title> </head>
<body>
<center>
<h2>The include Directive Example</h2>
<p>This site has been visited <%= pageCount %> times.</p>
</center>
<br/><br/>
Nội dung footer.jsp
<br/><br/> <center> <p>Copyright © 2010</p> </center> </body></html>
Nội dung main.jsp
<%@ include file = "header.jsp" %> <center> <p>Thanks for visiting my page.</p> </center> <%@ include file = "footer.jsp" %>
Đặt tất cả tập tin vào thư mục gốc và truy cập main.jsp. Kết quả:
The include Directive Example This site has been visited 1 times. Thanks for visiting my page. Copyright © 2010
Làm mới main.jsp – bộ đếm lượt truy cập sẽ tăng dần.
Mẹo: Tách các phần động của website vào các tập tin riêng rồi include vào trang chính. Việc này giúp bảo trì dễ dàng khi cần thay đổi một phần của trang web.