Java Server Page - Действие <jsp:include>

Действие <jsp:include> позволяет подключать статические и динамические ресурсы в контекст текущей страницы JSP. Так, например, выходной поток сервлета может быть включен в содержимое страницы JSP. Тогда при вызове страницы JSP выходной поток сервлета будет встроен в выходной поток JSP. Ресурс определяется по его относительному URL-адресу, который интерпретируется в контекст Web-сервера.

В отличие от директивы include, которая вставляет файл на этапе трансляции страницы JSP, действие <jsp:include> вставляет файл при запросе страницы. Это приводит к некоторой потере эффективности и исключает возможность наличия во вставляемом файле кода JSP, но дает существенное преимущество в гибкости. Если рассмотреть в качестве примера JSP-страницу, которая вставляет четыре различных отрывка в Web страницу с новостями сайта. Каждый раз когда меняются заголовки автору достаточно изменить содержимое четырех файлов, тогда как главная JSP страница остается неизменной.

Действие <jsp:include> имеет следующий синтаксис:

Синтаксис действия <jsp:include>
 
<jsp:include page="URLАдрес" [flush="true" | "false"] />
 
Второй вариант записи тега <jsp:include>
 
<jsp:include page="URLАдрес" [flush="true"]>
  <jsp:param .../>
  [<jsp:param .../>
  [...] ]
</jsp:include>
 

Примером может быть включение страницы-приветствия:

<jsp:include page="/general/welcome.html" />

Тег <jsp:include> имеет атрибуты, представленные в таблице.

Атрибут Описание атрибута
page Атрибут page определяется относительно текущей страницы JSP. Включаемая страница имеет доступ только к объекту JspWriter и не может устанавливать заголовки
flush Необязательный атрибут flush управляет переполнением. Если этот атрибут имеет значение true и выходной поток страницы JSP буферизуется, то буфер освобождается при переполнении, в противном случае - не освобождается. По умолчанию значение атрибута flush равно false

Действие <jsp:include> может включать элементы <jsp:param .../>, которые предоставляют значения для некоторых параметров запроса, используемые для включения.

Партнеры:


Rambler's Top100 Рейтинг@Mail.ru