Java-online.ru - все о Java


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 --> <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, которые предоставляют значения для некоторых параметров запроса, используемые для включения.




Copyright © 2009-2015