Введение в JSP

1. Обзор

JavaServer Pages (JSP) позволяют вам отделить динамическую часть ваших страниц от статического HTML. Вы, как обычно, пишете обычный код в HTML, используя для этого любую программу для создания Web страниц. Затем вы заключаете динамическую часть кода в специальные таги, большинство которых начинаются с "<%" и завершаются "%>". В качестве примера рассмотрим секцию JSP страницы, результатом которой будет что-то вроде "Спасибо за покупку Core Web Programming" по запросу с URL: http://host/OrderConfirmation.jsp?title=Core+Web+Programming:

Спасибо за покупку 
<I><%= request.getParameter("title") %></I>

Вы даете вашему файлу расширение .jsp и размещаете там же, где должны размещаться обычные Web страницы. Хотя то что вы написали больше похоже на обычный HTML файл чем на сервлет, просто за кадром JSP страница преобразуется в обычный сервлет с статическим HTML который просто направляется в поток вывода, связанный с методом сервлета service. Обычно это происходит при первом запросе страницы, и разработчики могут сразу после установки сами выполнить этот запрос, если хотят чтобы первый реальный пользователь при обращении к странице не столкнулся с небольшой задержкой, вызванной трансляцией JSP страницы в сервлет и его последующей компиляцией и загрузкой. Также отметим что большинство Web серверов позволяет вам задавать ссылки (aliases), так что адрес URL, указывающий на HTML файл в действительности будет указывать на сервлет или страницу JSP.

Помимо стандартных HTML конструкций существуют еще три основных типа конструкций JSP, котрые вы можете включить в страницу: элементы скриптов, директивы и действия. Элементы скриптов позволяют вам указать код на языке Java, который впоследствии станет частью в конечный сервлет, директивы дадут вам возможность управлять всей структурой сервлета, а действия служат для задания существующих используемых компонентов, а также для контроля поведением движка JSP. Для упрощения элементов скриптов, вы имеете доступ к нескольким заранее определенным переменным, таким, например, как переменная request, использованная в приведенном выше отрывке.

Обратите внимание что это руководство охватывает JSP версии 1.0. А начиная с версии 0.92 JSP претерпела множество изменений, и несмотря на то что эти изменения были лишь во благо, вы должны помнить что JSP версии 1.0 практически полностью не совместима с более ранними JSP движками. Также следует не забывать о том, что предлагаемое вашему вниманию руководство является частью более полного руководства по сервлетам и JSP доступного по адресу http://www.apl.jhu.edu/~hall/java/Servlet-Tutorial/.

2. Синтаксис

3. Текст шаблона: Статический HTML

Как правило большую часть вашей JSP страницы составляет статический HTML, называемый текстом шаблона. Во всех отношениях (кроме одного) этот HTML выглядит как обычный HTML, использующий те же правила синтаксиса, и он просто "передается" клиенту сервлетом, создаваемым для обработки страницы. При этом не только сам HTML выглядит нормальным, он может создаваться с применением тех инструментов, которые вы ранее использовали при создании Web страниц. Я, например, при создании большинства JSP страниц для этого руководства использовал Allaire's HomeSite.

Единственным печальным исключением из правила что "текст шаблона передается в неизменном виде" является ситуация, когда в тексте вы хотите отобразить последовательность символов "<%", для этого в тексте шаблона надо использовать сочетание символов "<\%".

4. Элементы скриптов JSP

Элементы скриптов JSP позволяют вам вставлять код на Java в сервлет, создаваемый из текущей JSP страницы. Существуют три формы:

1. Выражения, имеющие форму <%= выражение %>, которые обрабатываются и направляются на  вывод,
2. Скриплеты, имеющие форму <% код %>, которые вставляются в метод service сервлета
3. Объявления, имеющие форму <%! код %>, которые вставляются в тело класса сервлета, вне существующих методов.

4.1 Выражения JSP

Выражения JSP применяются для того чтобы вставить значения Java непосредственно в вывод. Для этого используется следующая форма:

<%= Выражение на Java %>

Выражения Java вычисляются, конвертируются в строку и вставляются в страницу. Эти вычисления происходит во время выполнения (то есть при при запросе страницы), а потому существует полный доступ к информации о самом запросе. Например, следующий код служит для отображения даты и времени запроса данной страницы:

Текущее время: <%= new java.util.Date() %>

Для того чтобы упростить эти выражения существует несколько заранее определенных переменных, которые вы можете использовать. Более детально они будут рассмотрены ниже, но тем не менее, рассматривая их применение при использовании выражений, приведем несколько наиболее важных:

Имя вашего хоста: <%= request.getRemoteHost() %>

<jsp:expression>
Выражения на Java
</jsp:expression>

Помните, что элементы XML в отличие от HTML чувствительны к регистру. Поэтому убедитесь в том, что используете строчные символы.

4.2 Скриплеты JSP

Если вы хотите сделать что-то большее чем вставка простых выражений, скриплеты JSP дадут вам возможность вставить любой код в метод сервлета, который будет создан при обработке данной страницы. Скриплеты имеют следующий вид:

<% Код на Java %>

Скриплеты также имеют доступ к тем же автоматически определенным переменным, что и выражения. Поэтому, например, если вы хотите вывести что-нибудь на страницу, вы должны воспользоваться переменной out.

<% 
String queryData = request.getQueryString();
out.println("Дополнительные данные запроса: " + queryData); 
%>

Обратите внимание на то, что код внутри скриплета вставляется в том виде, как он записан, и весь статический HTML (текст шаблона) до или после скриплета конвертируется при помощи оператора print. Это означает что скриплеты не обязательно должны содержать завершенные фрагменты на Java, и что оставленные открытыми блоки могут оказать влияние на статический HTML вне скриплета. Например, следующий фрагмент JSP содержит смешанный текст шаблона и скриплеты:

<% if (Math.random() < 0.5) { %>
<B>Удачного</B> Вам дня!
<% } else { %>
<B>Не удачного</B> Вам дня!
<% } %>

if (Math.random() < 0.5) { 
  out.println("<B>Удачного</B> вам дня!");
} else { 
  out.println("<B>Не удачного</B> вам дня!");
}

Если вы хотите использовать последовательность символов "%>" внутри скриплета, вместо нее используйте "%\>".  Эквивалентом <% Код %> для XML является:

<jsp:scriptlet>
Код
</jsp:scriptlet>

4.3 Объявления JSP

Объявления JSP позволят вам задать методы или поля, для вставки в тело класса сервлета (вне метода service, обрабатывающего запрос). Они имеют следующую форму:

<%! Код на Java %>

Поскольку объявления не осуществляют вывода, обычно они используются совместно с JSP выражениями или скриплетами. В приведенном в качестве примера фрагменте JSP отображается количество запросов к данной странице с момента загрузки сервера (или с момента последнего изменения и перезагрузки сервлета):

<%! private int accessCount = 0; %>
Количество обращений к странице с момента загрузки сервера: 
<%= ++accessCount %>

Также как и в скриплетах, если вам необходимо использовать последовательность символов "%>", используйте для этого последовательность "%\>". XML эквивалентом <%! Код %> является

<jsp:declaration>
Код
</jsp:declaration>

5. Директивы JSP

<%@ директива атрибут="значение" %>

<%@ директива атрибут1="значение1" 
              атрибут2="значение2"
              ...
              атрибутN="значениеN" %>

Существуют два основных типа директив: page, которая позволяет вам совершать такие операции, как импорт классов, изменение суперкласса сервлета, и т.п.; и include, которая дает вам возможность вставить файл в класс сервлета при трансляции JSP файла в сервлет. Также следует упомянуть директиву taglib, которая не поддерживается в JSP версии 1.0, но позволяет авторам JSP задавать свои собственные тэги. Предполагается что эта директива станет основной особенностью JSP 1.1.

5.1 Директива JSP page

• import="пакет.class" или import="пакет.class1,...,пакет.classN". Позволяет вам задать пакеты, которые должны быть импортированы. Например:
  <%@ page import="java.util.*" %>
  Атрибут import - единственный атрибут, допускающий многократное применение.
• contentType="MIME-Тип" или
  contentType="MIME-Тип; charset=Кодировка-Символов"
  Задает тип MIME для вывода. По умолчанию используется text/html. К примеру, директива
  <%@ page contentType="text/plain" %>
  приводит к тому же результату, что и использование скриплета
  <% response.setContentType("text/plain"); %>
• isThreadSafe="true|false". Значение true ("истина", принимается по умолчанию) задает нормальный режим выполнения сервлета, когда множественные запросы обрабатываются одновременно с использованием одного экземпляра сервлета, исходя из соображения что автор синхронизировал доступ к переменным этого экземпляра. Значение false ("ложь") сигнализирует о том, что сервлет должен наследовать SingleThreadModel (однопоточную модель) при которой последовательные или одновременные запросы обрабатываются отдельными экземплярами сервлета.
• session="true|false". Значение true ("истина", принимается по умолчанию) сигнализирует о том, что заранее определенная переменная session (тип HttpSession) должна быть привязана к существующей сессии, если таковая имеется, в противном случае создается новая сессия, к которой и осуществляется привязка. Значение false ("ложь") определяет что сессии не будут использоваться, и попытки обращения к переменной session приведут к возникновению ошибки при трансляции JSP страницы в сервлет.
• buffer="размерkb|none". Задает размер буфера для JspWriter out. Значение принимаемое по умолчанию зависит от настроек сервера, но должно превышать 8kb.
• autoflush="true|false". Значение  true ("истина", принимаемое по умолчанию) устанавливает что при переполнении буфер должен автоматически очищаться. Значение false ("ложь"), которое крайне редко используется, устанавливает что переполнение буфера должно приводить к возникновению исключительной ситуации. При установке значение атрибута buffer="none" установка значения false для этого атрибута недопустимо.
• extends="пакет.class". Задает суперкласс для генерируемого сервлета. Этот атрибут следует использовать с большой осторожностью, поскольку возможно что сервер уже использует какой-нибудь суперкласс.
• info="сообщение". Задает строку, которая может быть получена при использовании метода getServletInfo.
• errorPage="url". Задает JSP страницу, которая вызывается в случае возникновения каких-либо событий Throwables, которые не обрабатываются на данной странице.
• isErrorPage="true|false". Сигнализирует о том, может ли эта страница использоваться для обработки ошибок для других JSP страниц. По умолчанию принимается значение false ("ложь").
• language="java". Данный атрибут предназначен для задания используемого языка программирования. По умолчанию принимается значение "java", поскольку на сегодняшний день это единственный поддерживаемый язык программирования.

<jsp:directive.типДирективы атрибут=значение />

<%@ page import="java.util.*" %>

<jsp:directive.page import="java.util.*" />

5.2 Директива JSP include

Эта директива позволяет вам включать файлы в процессе трансляции JSP страницы в сервлет. Использование директивы выглядит следующим образом:

<%@ include file="относительный url" %>

Заданный URL обычно интерпретируется относительно JSP страницы, на которой расположена ссылка, но, как и при использовании любых других относительных URL вы можете задать системе положение интересующего вас ресурса относительно домашнего каталога Web сервера, добавив в начало URL символ "/". Содержимое подключаемого файла обрабатывается как обычный текст JSP и поэтому может включать такие элементы как статический HTML, элементы скриптов, директивы и действия.

Например, многие сайты используют небольшую панель навигации на каждой странице. В связи с проблемами использования фреймов HTML часто эта задача решается размещением небольшой таблицы сверху или в левой половине страницы, HTML код которой многократно повторяется для каждой страницы сайта. Директива include наиболее естественный способ решения этой задачи, избавляющий разработчика от кошмара рутины копирования HTML в каждый отдельный файл. Это происходит следующим образом:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Руководство по сервлетам: JavaServer Pages (JSP) 1.0</TITLE>
<META NAME="author" CONTENT="webmaster@somesite.com">
<META NAME="keywords" CONTENT="...">
<META NAME="description" CONTENT="...">
<LINK REL=STYLESHEET
      HREF="Site-Styles.css"
      TYPE="text/css">
</HEAD>

<BODY>
<%@ include file="/navbar.html" %>

<!-- Специфический фрагмент этой страницы ... -->

</BODY>
</HTML>

Учтите что поскольку директива include подключает файлы в ходе трансляции страницы, то после внесения изменений в панель навигации вам потребуется повторная трансляция всех использующих ее JSP страниц. Что в данном случае является хорошим компромиссом, поскольку как правило панель навигации меняется достаточно редко и процесс подключения не теряет своей эфективности. Если же подключенные файлы меняются довольно часто, вы можете использовать вместо этого действие jsp:include. Это действие подключает файл в процессе обращения к JSP странице и более подробно рассмотрено в разделе "Действия  JSP" данного руководства.

6. Пример использования элементов скриптов и директив

На этом простейшем примере показано использование различных конструкций JSP: выражений, скриплетов, объявлений и директив. Также вы можете скачать исходный файл или вызвать этот скриплет из Интернет.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Использование JavaServer Pages</TITLE>

<META NAME="author" CONTENT="Marty Hall -- hall@apl.jhu.edu">
<META NAME="keywords"
      CONTENT="JSP,JavaServer Pages,servlets">
<META NAME="description"
      CONTENT="Быстрый пример четырех основных тэгов JSP.">
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY BGCOLOR="#FDF5E6" TEXT="#000000" LINK="#0000EE"
      VLINK="#551A8B" ALINK="#FF0000">

<CENTER>
<TABLE BORDER=5 BGCOLOR="#EF8429">
  <TR><TH CLASS="TITLE">
      Использование JavaServer Pages</TABLE>
</CENTER>
<P>

Некое динамическое содержание созданное с использованием различных механизмов JSP:
<UL>
  <LI><B>Выражение.</B><BR>
      Имя вашего хоста: <%= request.getRemoteHost() %>.
  <LI><B>Scriptlet.</B><BR>
      <% out.println("Дополнительные данные запроса: " +
                     request.getQueryString()); %>
  <LI><B>Объявление (совместно с выражением).</B><BR>
      <%! private int accessCount = 0; %>
      Количество обращений к странице с момента загрузки сервера: <%= ++accessCount %>
  <LI><B>Директива (совместно с выражением).</B><BR>
      <%@ page import = "java.util.*" %>
      Текущая дата: <%= new Date() %>
</UL>


</BODY>
</HTML>

7. Заранее определенные переменные

Для упрощения кода в выражениях JSP и скриплетах, вам предоставлен набор их восьми автоматически определенных переменных, иногда называемых неявными объектами. Доступные переменные это request, response, out, session, application, config, pageContext и page. Далее мы рассмотрим каждую из них в отдельности

7.1 request

Это объект HttpServletRequest, связанный с запросом, который позволяет вам обращаться к параметрам запроса (через метод getParameter), типу запроса (GET, POST, HEAD, и т.д..), и входящим HTTP заголовкам (cookies, Referer, и т.д..). Проще говоря, request является подклассом ServletRequest и может отличаться от HttpServletRequest если используется протокол отличный от HTTP, что на практике практически никогда не встречается.

7.2 response

Это объект типа HttpServletResponse, связанный с ответом на запрос клиента. Обратите внимание что, поскольку поток вывода (см. out далее) буферизован, можно изменять коды состояния HTTP и заголовки ответов, даже если это недопустимо в обычном сервлете, но лишь в том случае если какие-то данные вывода уже были отправлены клиенту.

7.3 out

Это объект типа PrintWriter, используемый для отправки вывода клиенту. Однако, чтобы сделать объект response (см. предыдущий раздел) полезным, следует использовать буферизированный вариант PrintWriter - JspWriter. Помните что вы можете изменять размер буфера и даже отключить буферизацию, изменяя  значение атрибута buffer директивы page. Этот вопрос подробно рассмотрен в Разделе 5. Также обратите внимание что out используется практически исключительно скриплетами, поскольку выражения JSP автоматически помещаются в поток вывода, что избавляет от необходимости явного обращения к out.

7.4 session

Это объект типа HttpSession, связанный с запросом. Сессии создаются автоматически, и эта переменная существует даже если нет ссылок на входящие сессии. Единственным исключением является ситуация, когда вы отключаете использование сессий используя атрибут session директивы page (см. Раздел 5). В этом случае ссылки на переменную session приводят к возникновению ошибок при трансляции JSP страницы в сервлет.

7.5 application

7.6 config

7.7 pageContext

В JSP представлен новый класс PageContext для изолированного использования специфических особенностей сервера, таких как более эффективные JspWriters. Идея заключается в том, что если вы обращаетесь к ним через этот класс  а не непосредственно, ваш код может исполняться на "обычных" движках сервлет/JSP.

7.8 page

По сути является синонимом для this, и не нужен при работе с Java. Эта переменная создавалась с расчетом на перспективу, когда возможно появятся другие языки программированя скриптов, отличные от Java.

8. Действия

Действия JSP используют конструкции с синтаксисом XML для управления работой движка сервлета. Вы можете динамически подключать файл, многократно использовать компоненты JavaBeans, направить пользователя на другую страницу или сгенерировать HTML для Java plugin. Допустимо применение следующих действий:

• jsp:include - Подключает файл в момент запроса страницы. См. Раздел 8.1.
• jsp:useBean - Поиск или создание нового экземпляра JavaBean. См. Раздел 8.2 для обзора и Раздел 8.3 для детального рассмотрения.
• jsp:setProperty - Установка приоритетов JavaBean. См. Раздел 8.4.
• jsp:getProperty - Вставить свойство JavaBean в поток вывода. См. Раздел 8.5.
• jsp:forward - Перенаправляет запрос на другую страницу. См. Раздел 8.6.
• jsp:plugin - Генерирует код (в зависимости от типа используемого броузера), который создает тэг OBJECT или EMBED для Java plugin. См. Раздел 8.7.

8.1  Действие jsp:include

<jsp:include page="относительный URL" flush="true" />

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

WhatsNew.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Новости</TITLE>
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY BGCOLOR="#FDF5E6" TEXT="#000000" LINK="#0000EE"
      VLINK="#551A8B" ALINK="#FF0000">

<CENTER>
<TABLE BORDER=5 BGCOLOR="#EF8429">
  <TR><TH CLASS="TITLE">
      Новости на JspNews.com</TABLE>
</CENTER>
<P>

Вот фрагменты наших четырех самых популярных статей:
<OL>
  <LI><jsp:include page="news/Item1.html" flush="true"/>
  <LI><jsp:include page="news/Item2.html" flush="true"/>
  <LI><jsp:include page="news/Item3.html" flush="true"/>
  <LI><jsp:include page="news/Item4.html" flush="true"/>
</OL>
</BODY>
</HTML>

8.2  Действие jsp:useBean

Это действие позволяет вам загружать JavaBean для последующего использования на JSP странице. Это очень важная возможность, поскольку она позволяет вам использовать многократного использования классов Java не отказываясь при этом от преимуществ, предоставляемых сервлетами JSP. Простейший синтаксис для указания используемого bean:

<jsp:useBean id="имя" class="пакет.class" />

Как правило это означает "создание нового экземпляра объект класса, заданного через class, и его связь с переменной с именем, заданным при помощи id." Однако, как вы скоро убедитесь, можно задать атрибут scope который ассоциирует bean не только с текущей страницей. В таком случае, полезно получить ссылки на существующие beans, и действие jsp:useBean создает  экземпляр нового объекта лишь в том случае если не существует ни одного объекта с теми же значениями id и scope. Теперь, когда у вас есть bean, вы можете изменять его свойства при помощи jsp:setProperty, или используя для этого скриплет и явно вызывая метод объекта с именем переменной заданном ранее через атрибут id. Recall that with beans, когда вы говорите "у этого bean есть свойство типаX с названием foo", вы на самом деле имеете ввиду "у этого класса есть метод getFoo, который возвращает данные типа X, и другой метод setFoo, которому в качестве параметра передается X." Действие jsp:setProperty более подробно рассмотрено в следующем разделе, но сейчас вы должны запомнить что вы можете либо явно задавать value, задавая атрибут param, чтобы получить значение из соответствующего параметра запроса, или просто перечислить свойства, чтобы получить значения из параметров запроса с теми же именами что и свойства. Вы можете получить значения существующих свойств при помощи выражений JSP или скриплетов, вызвав соответствующий метод getXxx, или (чаще всего), воспользовавшись действием jsp:getProperty.

Помните что класс заданный для bean должен находиться в обычном каталоге классов сервера, а не в части, зарезервированной для классов, автоматически пеезагружаемых после редактирования. Например, для Java Web Server, все используемые классы должны размещаться в каталоге classes или в jar файле каталога lib, а не в каталоге servlets.

Ниже приведен очень простой пример, загружающий bean и устанавливающий/получающий простой строковый параметр.

BeanTest.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Многократное использование JavaBeans в JSP</TITLE>
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY>

<CENTER>
<TABLE BORDER=5>
  <TR><TH CLASS="TITLE">
      Многократное использование JavaBeans в JSP</TABLE>
</CENTER>
<P>

<jsp:useBean id="test" class="hall.SimpleBean" />
<jsp:setProperty name="test" 
                 property="message" 
                 value="Привет, WWW" />
             
<H1>Сообщение: <I>
<jsp:getProperty name="test" property="message" />
</I></H1>
             
</BODY>
</HTML>

SimpleBean.java

Здесь приведен исходный код для bean, исппользованного на JSP странице BeanTest. Вы можете также скачать исходники файла.

package hall;

public class SimpleBean {
  private String message = "Текст сообщения не задан";

  public String getMessage() {
    return(message);
  }

  public void setMessage(String message) {
    this.message = message;
  }
}

8.3 Еще несколько деталей о использовании jsp:useBean

Простейший способ использовать bean - это использование конструкции
   <jsp:useBean id="имя" class="пакет.class" />
для загрузки bean, а затем использовать jsp:setProperty и jsp:getProperty для модификации и получения его свойств. Однако существуют еще два других способа. Во-первых, вы можете использовать формат контейнера, а именно:
  <jsp:useBean ...>
    Тело
  </jsp:useBean>
для того чтобы обеспечить выполнение Тела только в том случае, если экземпляр bean создается впервые, а не тогда, когда находится и используется уже существующий bean. Как обсуждается далее, beans могут совместно использоваться, поэтому не каждое выражение jsp:useBean приводит к созданию экземпляра нового bean. Во-вторых, кроме id и class, существуют еще три других атрибута, которые вы можете использовать: scope, type, и beanName. Эти атрибуты описаны в следующей таблице.

Атрибут	Применение
id	Дает имя переменной, которая ссылается на bean. Если удается найти bean с теми же самыми значениями id и scope, то вместо создания нового экземпляра используется ранее созданный объект.
class	Задает полное имя пакета bean.
scope	Задает область, в которой bean должен быть доступен. Может принимать четыре допустимых значения: page, request, session и application. По умолчанию принимает значение page, означающее что bean доступен только на текущей странице (размещается в PageContext текущей страницы). Значение request означает что bean доступен только для текущего запроса клиента (размещается в объекте ServletRequest). Значение session означает что объект доступен всем страницам на протяжении жизни текущей HttpSession. И, наконец, значение application означает что он доступен всем страницам, использующим тот же самый ServletContext. Причина необходимости этого атрибута заключается в том что jsp:useBean приводит к  созданию нового экземпляра объекта в том случае, если нет уже существующего объекта с тем же id и scope. Иначе используется уже существующий объект, и все элементы jsp:setParameter или любые другие между тэгами jsp:useBean игнорируются.
type	Указывает тип переменной, которая ссылается на объект. Долже совпадать с именем класса, суперкласса или реализуемого интерфейса. Запомните что имя переменной задается через атрибут id.
beanName	Дает имя bean, которое будет использовано методом instantiate. Можно задать type и beanName, и опустить атрибут class.

8.4  Действие jsp:setProperty

Вы можете использовать jsp:setProperty для присвоения значений свойствам ранее описанных beans. Вы можете делать это двумя способами. Во-первых, вы можете использовать jsp:setProperty после, но вне элемента jsp:useBean, так как это показано в примере:

<jsp:useBean id="myName" ... />
...
<jsp:setProperty name="myName" 
                 property="someProperty" ... />

В этом случае jsp:setProperty выполняется независимо от того, был ли найден существующий bean или был создан новый экземпляр. Другим вариантом заключается в размещении jsp:setProperty в теле элемента jsp:useBean, как это показано в другом примере:

<jsp:useBean id="myName" ... >
  ...
  <jsp:setProperty name="myName" 
                   property="someProperty" ... />
</jsp:useBean>

При этом jsp:setProperty выполняется лишь в том случае, если был создан новый экземпляр объекта, а не тогда, когда находится уже существующий.

Действие jsp:setProperty допускает применение следующих четырех атрибутов:

Атрибут	Применение
name	Этот обязательный атрибут служит для задания bean, свойства которого будут устанавливаться. Элемент jsp:useBean должен предшествовать использованию элемента jsp:setProperty.
property	Этот обязательный атрибут устанавливает свойство, которое вы хотите установить. Однако существует частный случай: значение "*" означает что все параметры запроса, чьи имена совпадают с именами свойств bean будут переданы соответствующему методу установки свойств.
value	Этот необязательный атрибут устанавливает значение свойства. Строковые значения автоматически преобразуются в числовые, boolean, Boolean, byte, Byte, char и Character с использованием стандартного метода valueOf соответствующего класса. Например, значение "true" для свойства boolean или Boolean будет конвертированно при помощи метода Boolean.valueOf, а значение "42" для свойства int или Integer будет конвертированно при помощи метода Integer.valueOf. Вы не можете одновременно использовать атрибуты value и param, но можете вообще их не использовать. Ознакомьтесь с описанием атрибута param, которое представлено ниже.
param	Этот необязательный атрибут устанавливает параметр запроса, используемый для получения свойства. Если в текущем запросе этот параметр отсутствует, никаких действий не происходит: система не передает значение null методу устанавливающему свойства. Таким образом, допустимо использование в bean свойств по умолчанию, переопределяя их лишь в том случае если этого требуют параметры запроса. Например, следующий фрагмент означает следующее: "установить свойство numberOfItems в соответствии со значением параметра запроса numItems, а если такой параметр в запросе отсутствует - никакие действия не выполняются." <jsp:setProperty name="orderBean" property="numberOfItems" param="numItems" /> Если вы не используете ни value, ни param, это приравнивается к тому, как если бы вы задали имя param совпадающее с именем property. Вы можете применить этот принцип автоматического использования свойств запроса, чьи имена совпадают с именами свойств и пойти далее, задав в качестве имени свойства "*" и опустив параметры value и param. В этом случае сервер обработает допустимые свойства и параметры запроса, на предмет совпадения их с идентичными именами.

Далее приведен пример в котором используется bean для создания таблицы простых чисел. Если существует параметр numDigits в данных запроса, он передается в свойство bean numDigits. Аналогично для numPrimes.

JspPrimes.jsp

Для того чтобы скачать исходник JSP, щелкните правой кнопкой мыши на ссылке на исходный код. Вы можете также скачать исходный код для NumberedPrimes bean на который ссылается элемент jsp:useBean. Просмотрите каталог исходных кодов для других классов Java используемых в NumberedPrimes. Лучший способ опробовать это в сети - начать с HTML страницы, которая является внешним интерфейсом.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Многократное использование JavaBeans в JSP</TITLE>
<LINK REL=STYLESHEET
      HREF="My-Style-Sheet.css"
      TYPE="text/css">
</HEAD>

<BODY>

<CENTER>
<TABLE BORDER=5>
  <TR><TH CLASS="TITLE">
      Многократное использование JavaBeans в JSP</TABLE>
</CENTER>
<P>

<jsp:useBean id="primeTable" class="hall.NumberedPrimes" />
<jsp:setProperty name="primeTable" property="numDigits" />
<jsp:setProperty name="primeTable" property="numPrimes" />

Несколько <jsp:getProperty name="primeTable" property="numDigits" /> 
символьных простых чисел: 
<jsp:getProperty name="primeTable" property="numberedList" />

</BODY>
</HTML>

8.5  Действие jsp:getProperty

Этот элемент определяет значение свойства bean, конвертирует его в строку и направляет в поток вывода. Для выполнения действия требуется задание двух атрибутов: имени bean, которое предварительно задается в действии jsp:useBean, и имя свойства, значение которого должно быть определено. Далее приведен пример использования этого действия. За другими примерами обратитесь к разделам 8.2 и 8.4.

<jsp:useBean id="itemBean" ... />
...
<UL>
  <LI>Количество предметов: 
      <jsp:getProperty name="itemBean" property="numItems" />
  <LI>Цена за штуку:
      <jsp:getProperty name="itemBean" property="unitCost" />
</UL>

8.6  Действие jsp:forward

Это действие позволяет вам передать запрос другой странице. Оно использует один атрибут, page, который должен содержать относительный URL. Ей может быть как статическое значение, так и вычисляемое в процессе запроса, что и показано на следующих двух примерах:

<jsp:forward page="/utils/errorReporter.jsp" />
<jsp:forward page="<%= какое-нибудьВыражениеНаJava %>" />

8.7  Действие jsp:plugin

Это действие позволяет вам вставить элемент OBJECT или EMBED (в зависимости от типа используемого броузера), необходимый для запуска апплетов, использующих plugin Java.

9. Комментарии и символы цитирования

Ниже приведены несколько конструкций, которые вы можете использовать в тех случаях, когда требуется вставить комментарий или использовать символы, зарезервированные для данного тэга:

<%-- комментарий --%>

<!-- комментарий -->

<\%

%\>

\'

\"

%\>

<\%

Это руководство было ранним наброском материалов, позднее вошедших в книгу Core Servlets and JavaServer Pages (Sun Microsystems Press 2000).