На главную страницу
 

Спецификация
JavaServer Pages (JSP)

Версия: 1.2


Пожалуйста, направляйте комментарии по e-mail:  jsp-spec-comments@eng.sun.com


и переводчику: a_pyramidin@yahoo.com (Александр Пирамидин)



Понедельник, 27 августа, 2001 г.
Редактор: Eduardo Pelegrí-Llopart.

901 San Antonio Road
Palo Alto, CA 94303 USA
650 960-1300 факс: 650 969-9131


Статус: FCS


Релиз: 17 сентября 2001 г.

Copyright 2001 Sun Microsystems, Inc.
901 San Antonio Road, Palo Alto, California 94303, U.S.A.
Все Права Зарезервированы.

ЛИЦЕНЗИЯ

Данная Спецификация защищена авторскими правами, и информация, приведённая здесь, может быть защищена одним или более патентами США, иностранными патентами или задействованными приложениями.

За исключением случаев, указанных в данной лицензии, никакая часть данной Спецификации не может воспроизводиться в любой форме и любым способом без наличия предварительного письменной авторизации Sun Microsystems, Inc. ("Sun") и её лицензоров, если имеются.

Любая часть данной Спецификации и описанной здесь информации управляется терминами и условиями данной лицензии и Export Control Guidelines, как установлено ранее в Terms of Use на сайте Sun.

Просматривая, загружая и копируя данную Спецификацию, Вы соглашаетесь с тем, что Вы прочли, поняли и согласны со всеми терминами и условиями, установленными здесь и далее.

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

(i) полную реализацию текущей версии Спецификации без подразделения или объединения её;
(ii) реализует весь интерфейс и функциональность данной Спецификации без подразделения или объединения её;
(iii) включают полную реализацию всех необязательных компонентов (как определено Спецификацией), которые Вы выбрали для реализации, без подразделения или объединения;
(iv) реализует все интерфейсы и функциональность таких необязательных компонентов без подразделения или объединения;
(v) не добавляют никаких дополнительных пакетов, классов или интерфейсов к пакетам "java.*" или "javax.*" или подпакетам или другим пакетам, определённым в данной Спецификации;
(vi) удовлетворяют всем требованиям тестирования, доступным от Sun, относящимся к самой последней версии данной Спецификации, опубликованной за шесть (6) месяцев до любого релиза реализации такой чисто рабочей реализации или обновления до неё;
(vii) не происходят от какого-либо кода-источника Sun или кодов двоичных материалов; и
(viii) не включает какого-либо первичного кода Sun или кодов двоичных материалов без отдельной соответствующей лицензии Sun. Данная Спецификация содержит информацию о правах собственности Sun и может использоваться только в соответствии с данной лицензией.

Действие данной лицензии оканчивается немедленно без предупреждения от Sun, если Вы не согласны с каким-либо из условий данной лицензии. После окончания или истечения срока действия данной лицензии Вы обязаны исключить использование или уничтожить имеющуюся у Вас Спецификацию.

ТОРГОВЫЕ МАРКИ

Никакие права названия или интересы торговых марок, сервисных марок или торговых имён Sun или лицензоров Sun не передаются по данному соглашению.

Sun, Sun Microsystems, логотип Sun, Java, логотип Java Coffee Cup, JSP и JavaServer Pages являются торговыми марками или зарегистрированными торговыми марками Sun Microsystems, Inc. в США и других странах.

ОГРАНИЧЕННАЯ ГАРАНТИЯ

ДАННАЯ СПЕЦИФИКАЦИЯ ПРЕДОСТАВЛЯЕТСЯ "КАК ЕСТЬ". SUN НЕ ДАЁТ НИКАКИХ ГАРАНТИЙ, ЯВНЫХ ИЛИ КОСВЕННЫХ (ВКЛЮЧАЯ - НО НЕ ОГРАНИЧИВАЯСЬ ИМИ - ГАРАНТИИ РЕАЛИЗУЕМОСТИ), СООТВЕТСТВИЯ ОПРЕДЕЛЁННОМУ НАЗНАЧЕНИЮ ИЛИ НЕНАРУШЕНИЯ УСЛОВИЙ, ЧТО СОДЕРЖИМОЕ ДАННОЙ СПЕЦИФИКАЦИИ ПОДХОДИТ ДЛЯ КАКИХ-ЛИБО ЦЕЛЕЙ ИЛИ ЧТО ЛЮБОЕ ИСПОЛЬЗОВАНИЕ ИЛИ РЕАЛИЗАЦИЯ ТАКОГО СОДЕРЖИМОГО НЕ БУДЕТ НАРУШАТЬ КАКИХ-ЛИБО ПАТЕНТОВ ТРЕТЬЕЙ СТОРОНЫ, АВТОРСКИХ ПРАВ, КОММЕРЧЕСКОЙ ТАЙНЫ ИЛИ ИНЫХ ПРАВ.
 

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


ДАННАЯ СПЕЦИФИКАЦИЯ МОЖЕТ СОДЕРЖАТЬ ТЕХНИЧЕСКИЕ НЕТОЧНОСТИ ИЛИ ТИПОГРАФСКИЕ ОШИБКИ. ИЗМЕНЕНИЯ ПЕРИОДИЧЕСКИ ДОБАВЛЯЮТСЯ К ИМЕЮЩЕЙСЯ ИНФОРМАЦИИ; ЭТИ ИЗМЕНЕНИЯ БУДУТ ВНЕДРЕНЫ В НОВЫЕ ВЕРСИИ ДАННОЙ СПЕЦИФИКАЦИИ, ЕСЛИ ОНИ (ВЕРСИИ) ПОЯВЯТСЯ. SUN МОЖЕТ В ЛЮБОЕ ВРЕМЯ ДЕЛАТЬ УЛУЧШЕНИЯ И/ИЛИ ВНОСИТЬ ИЗМЕНЕНИЯ В ПРОДУКТЫ И/ИЛИ ПРОГРАММЫ, ОПИСАННЫЕ В ДАННОЙ СПЕЦИФИКАЦИИ.

Любое использование таких изменений данной Спецификации регулируется лицензией, существующей в данный момент для данной версии Спецификации.

ОГРАНИЧЕНИЕ ОТВЕТСТВЕННОСТИ

В ДОПОЛНЕНИЕ К НЕ ЗАПРЕЩЁННОМУ ЗАКОНОМ, НИ ПРИ КАКИХ СОБЫТИЯХ SUN ИЛИ ЕЁ ЛИЦЕНЗОРЫ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА ЛЮБОЙ УЩЕРБ, ВКЛЮЧАЯ, БЕЗ ОГРАНИЧЕНИЯ, УПУЩЕННУЮ ВЫГОДУ, ПОТЕРЮ ДАННЫХ ИЛИ ЗА ПРИЧИНЁННЫЙ, КОСВЕННЫЙ, ПОСЛЕДУЮЩИЙ, СЛУЧАЙНЫЙ ИЛИ УМЫШЛЕННЫЙ ВРЕД, НАНЕСЁННЫЙ КАКИМ-ЛИБО ОБРАЗОМ, ВНЕ ЗАВИСИМОСТИ ОТ ПРАВИЛ ОБ ОТВЕТСТВЕННОСТИ, ПРИЧИНЁННЫЙ ИЛИ ОТНОСЯЩИЙСЯ К: ЛЮБОМУ ОБОРУДОВАНИЮ, ИСПОЛЬЗОВАНИЮ, МОДИФИЦИРОВАНИЮ ИЛИ ИНОМУ ИСПОЛЬЗОВАНИЮ ДАННОЙ СПЕЦИФИКАЦИИ, ДАЖЕ ЕСЛИ SUN И/ИЛИ ЕЁ ЛИЦЕНЗОРЫ БЫЛИ УВЕДОМЛЕНЫ О ВОЗМОЖНОСТИ ТАКОГО УЩЕРБА/ВРЕДА.


Вы страхуете и защищаете Sun и её лицензоров от любых претензий, являющихся результатом:

(i) Вашего использования данной Спецификации;
(ii) использования или распространения Ваших Java-приложений, аплетов и/или чисто рабочих реализаций; и/или
(iii) любых претензий, которые могут явиться результатом несовместимости последующих версий или релизов любой Спецификации, использованной Вами, со Спецификацией, предоставленной Вам по данному соглашению.

ОГРАНИЧЕННЫЕ ПРАВА

Правительство США: Если данная Спецификация получена от имени или для Правительства США первичным контрактором или субконтрактором Правительства США (любого уровня), тогда права Правительства в области Программного Обеспечения и сопутствующей документации будут действовать так, как описано ранее в данной лицензии; это действует в соответствии с правилами от 48 C.F.R. 227.7201 до 227.7202-4 (для приобретений Департамента Обороны/Department of Defense (DoD)) и в соответствии с правилами 48 C.F.R. 2.101 и 12.212 (для приобретений не Департамента Обороны).

КУДА СООБЩИТЬ

Вы можете сообщить о какой-либо неоднозначности, неполноте или неточностях в связи с использованием Вами данной Спецификации ("Обратная Связь/Feedback"). В связи с тем, что Вы направляете Sun информацию Feedback, Вы, кроме того:

(i) согласны с тем, что эта информация предоставляется Вами на некоммерческой и неконфиденциальной основе, и
(ii) предоставляете Sun бессрочное, неисключительное, всемирно действующее, неотзываемое разрешение безвозмездно, с правом сублицензирования на несколько уровней сублицензирования, внедрять, публиковать и использовать без ограничений Feedback для любых целей, относящихся к данной Спецификации и её последующим версиям, реализациям, и утилитам тестирования.

Статус


Это спецификация JSP 1.2, разработанная группой экспертов JSR053 как часть процесса Java Community Process (детали - по адресу http://jcp.org/jsr/detail/53.jsp).

JSP.S.1  Процессы Сообщества Java

JCP создаёт спецификации, используя три сообщества: сообщество экспертов (the expert group),  participants\участники JCP и public\публика вообще.

Эксперты является авторами спецификаций, создавая проекты/drafts.

Проекты
проходят путь от экспертов, через участников, к публике, постепенно совершенствуясь в деталях, всегда возвращая комментарии обратно группе экспертов; final draft/окончательный проект отправляется для одобрения в Executive Committee\Исполнительный Комитет.

Лидер группы экспертов
отвечает за облегчение работы группы экспертов, авторизацию спецификации и за организацию reference implementation\справочной реализации и conformance test suite\блока тестирования на соответствие.

JSP.S.2   JCP и Эта Спецификация

JCP разработан как чрезвычайно гибкий процесс, так что каждая группа экспертов может адресовать требования специфического сообщества, обслуживаемого ею. Справочная реализация JSP 1.2 и Servlet 2.3 использует код, который разрабатывается как открытый проект-ресурс по соглашению с Apache Software Foundation.

Данная спецификация содержит главы, которые получены непосредственно из комментариев javadoc в классах API, но там, где имеются расхождения, данная спецификация имеет преимущество над комментариями javadoc.


Процесс JCP предоставляет механизм обновления спецификации в процессе поддержки через Erratas\Списки Ошибок. Если они имеются, эти списки имеют приоритет над данной спецификацией.


Приложения C и D являются нормативными; остальные приложения являются ненормативными.

 

Предисловие


Этот документ является спецификацией JavaServer Pagesтм 1.2 (JSP 1.2).


Данная Спецификация была разработана как часть процесса Java Community Process (JCP). Комментарии от Экспертов, Участников и Публики были рассмотрены, и все изменения были внесены в спецификацию, где это было необходимо.

JSP.P.1 Сравнение с JSP 1.1

JSP 1.2 расширяет Спецификацию JavaServer Pagesтм 1.1 (JSP 1.1) следующим образом:

JSP.P.2  Лицензирование Спецификации

Детали условий, по которым данный документ распространяется, даны в лицензии.

JSP.P.3  Для кого предназначен этот документ

Этот документ является авторизованной спецификацией JSP 1.2. Он предназначен для предоставления требований к реализациям процессинга JSP и поддерживается web-контейнерами в web-серверах и серверами приложений.
Он не является справочником пользователя. Мы ожидаем появления других документов, предназначенных для различных категорий читателей.

JSP.P.4  Родственные Документы

Разработчики контейнеров JSP и авторы страниц JSP могут найти необходимую информацию также в следующих документах:

Таблица  JSP.P-1  Некоторые Родственные Web-Сайты
Домашняя страница JSP: http://java.sun.com/products/jsp
Домашняя страница Servlet:  http://java.sun.com/products/servlet
Java 2 Platform, Standard Edition::  http://java.sun.com/products/jdk/1.3
Java 2 Platform, Enterprise Edition:  http://java.sun.com/j2ee
Домашняя страница XML на платформе Java:  http://java.sun.com/xml
Домашняя страница JavaBeans™:  http://java.sun.com/beans
Домашняя страница XML на W3C:  http://www.w3.org/XML
Домашняя страница HTML на W3C:  http://www.w3.org/MarkUp
Домашняя страница XML.org:  http://www.xml.org

JSP.P.5  Немного Истории

Пионерами, выполнившими начальную работу по платформе Java, относящуюся к данной Спецификации, были: James Gosling, работавший над Web Server в Java в 1994/1995 гг. - основой сервлетов.

Расширенный проект был начат в 1996 г. Pavani Diwanji - ведущим инженером - и многими другими ключевыми участниками, перечисленными ниже. Результатом работы над этим проектом стал продукт Java Web Server компании Sun.

Некоторые проекты начались в 1999 г.. Группа экспертов по сервлетам во главе с James Davidson выпустила спецификации: Servlet 2.1 - в январе и Servlet 2.2 в декабре, а группа JSP во главе с Larry Cable и Eduardo Pelegri-Llopart выпустила JSP 1.0 в июне и JSP 1.1 - в декабре.

Год 2000 ознаменовался большим количеством разработок: многочисленные реализации контейнеров, утилит, книг и тренировочных материалов по JSP 1.1, Servlet 2.2 и платформе Java 2 Enterprise Edition. Интенсивно разрабатывались библиотеки тэгов и различные усовершенствования. Внедрение технологии JSP продолжилось в 2001 году по многим направлениям Web и сервиса JavaOne.

Проследить развитие печатной продукции весьма трудно; лучше всего это сделано на сайте  http://java.sun.com/products/jsp.

JSP.P.6  Благодарности

Успех Java Platform обусловлен деятельностью Java Community Process по её разработке. Этот процесс, вовлёкший в свою орбиту множество людей и корпораций, продвигает разработку высококачественных спецификаций эпохи Internet.


Хотя невозможно перечислить всех участвовавших в разработке этой версии Спецификации, мы хотели бы поблагодарить всех членов нашей экспертной группы. Мы использовали преимущества большой активной группы экспертов, без которой спецификации JSP не были бы созданы.


Мы хотим поблагодарить:

Alex Yiu, Alex Chaffee, Allan Scott, Amit Kishnani, Bill dehOra, Bjorn Carlson, Bob Foster, Chris Hansen, Clement Wong, Craig McClanahan, Dano Ferrin, Danny Coward, Dave Brown, Edwin Smith, Francios Jouaux, Frank Biederich, Govind Seshadri, Hans Bergsten, Howard Melman, James Strachan, Jason McGeee, Jason Hunter, Jeff Mischkinsky, Jon Rousseau, Julie Basu, Karl Avedal, Kevin Jones, Larry Cable, Larry Isaas, Magnus Rydin, Magnus Stenman, Mark Wallace, Miles Sabin, Misha Davidson, Murty Chintalapati, Nathan Abamson, Nic Ferrier, Olli Blackburn, Paul Bonfanti, Peter Petersen, Petr Jiricka, Pier Paolo Fumagalli, Pierre Delisle, Ramesh Mandava, Rod Magnuson, Sam Pullara, Satoshi Kikuchi, Scott Ferguson, Scott Snyder, Simeon Simeonov, Stephanie Bodoff, Stefano Mazzocchi, Tim Ampe, Tom Reilly, Vince Bonfanti.


Мы благодарим всё сообщество, разрабатывавшее пробные реализации, и продавцов, выпускавших утилиты авторизации и библиотеки тэгов.


Отдельно упомянем Scott Ferguson, Bob Foster, Stefano Mazzocchi и Ricardo Rocha и их работу по Главе 5. Bob Foster заслуживает благодарности за ОТД& XSchema, а сообщество Cocoon - за Cocoon & XSP. Наши благодарности Jess Holle за кропотливую работу над статьями в Главе JSP.3.


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


Редактор особо признателен участникам Java Platform Group, в особенности - James, Jon, Mala, Jeff, Connie и Graham.


Наконец, мы благодарим разработчиков программного обеспечения, web-авторов и членов группы public, прочитавших эту спецификацию, использовавших пробную реализацию и поделившихся своим опытом.

Благодаря вам, появилась технология JavaServerPages.
 


Оглавление


Статус
Предисловие

JSP.1 Обзор

JSP.2 Синтаксис Ядра и Семантика

JSP.3 Вопросы Локализации

JSP.4 Стандартные Акции

JSP.5 JSP-Документы

JSP.6 Скриптинг

JSP.7 Расширения Тэгов

JSP.8  JSP-Контейнер

JSP.9   Основной API