Разработка Web–приложений с применением Java Servlet-технологии - Лабораторная работа

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

Java in a Nutshell Дэвид Флэнэген Киев 1998 http://faq.realcoding.net/index.php http://java.sun.com/j2ee/learning/tutorial/index.html http://egor.spb.ru/doc/db/mysql/14.html#_ftnref1

http://www.coreservlets.com/Apache-Tomcat-Tutorial/ http://gcc.gnu.org/ml/java-patches/2000-q4/index.html#00245 http://www-ucs.usc.edu/~toms/jakartafaq.html http://jakarta.apache.org/faq

Теоретическая часть

Сервлеты Java

Сервлеты расширяют функциональность Web-серверов и являются мощным средством программирования. Сервлеты - это модули, расширяющие возможности серверов типа запрос-ответ, таких как Java-совместимые web-сервера. Сервлеты для серверов то же самое, что и апплеты для браузеров, но в отличие от апплетов, у сервлетов нет графического интерфейса пользователя. Сервлеты могут быть встроены в различные серверы, так как API сервлетов, который используется для их написания, не предполагает никакого знания ни об окружении сервера, ни о его протоколе. Сервлеты наиболее широко используются с HTTP-серверами; многие web-сервера поддерживают API сервлетов. Они обеспечивают такой способ генерирования динамических документов, который позволяет облегчить их написание и ускорить выполнение. Сервлеты также решают проблему программирования на стороне сервера с платформо-зависимыми API, которые разрабатываются с использованием Java Servlet API, стандартного расширения Java. Характерной особенностью сервлетов является то, что они не требуют создания новых процессов при каждом новом запросе. Множество сервлетов выполняются параллельно в рамках одного процесса на сервере.

Java Servlet Development Kit (JSDK)

Набор инструментов разработки Java - сервлетов(JSDK) содержит библиотеки классов, которые нужны для создания сервлетов. Он включает также утилиту, известную как servletrunner, которая дает возможность проверить некоторые из создаваемых сервлетов. Начиная с JSDK Version 2 пакет Jsdk2.0 встроен в JDK.

Servlet API.

Коды, требующиеся для построения сервлетов, содержат два пакета: javax.servlet и javax.servlet.http. Вместе они представляют Servlet API.

Интерфейс сервлета

Центральной абстракцией в API сервлета является Servlet API-интерфейс. Все сервлеты реализуют этот интерфейс либо прямо, либо, чаще, путем расширения класса, который реализует этот интерфейс, например класса HTTPSERVLET API. Servlet-интерфейс объявляет, но не реализует методы, управляющие сервлетом и его связью с клиентами. Разработчики сервлетов обеспечивают реализацию отдельных (или всех) методов в процессе разработки сервлета.

Жизненный цикл сервлета

Все сервлеты имеют одинаковый жизненный цикл: § Сервер загружает и инициализирует сервлет

§ Сервлет обрабатывает ноль или более запросов клиентов

§ Сервер выгружает сервлет

Вызов сервлетов с браузеров

Для вызова сервлета с браузера достаточно набрать запрос - URL сервлета. URL сервлета имеет следующую форму: где servlet-name относится к имени, данному этому сервлету. Например http://localhost:8080/servlet/bookstore

URL сервлетов может содержать запросы, такие как HTTP GET-запросы. Например http://localhost:8080/servlet/bookdetails? BOOKID=203

Вызов сервлетов с HTML-страницы

Для вызова сервлета с HTML-страницы достаточно использовать URL сервлета с соответствующей HTML-меткой. Метки, поддерживающие URL, включают те, с которых начинаются якоря и формы, а также meta-метки. Например

Calls the servlet

Также для вызова сервлета можно использовать атрибут action в теге form в HTML-странице, указав URL сервлета. Например

Для вызова сервлета также можно использовать тег meta в HTML-странице, указав URL сервлета. Например

Пакет javax.servlet

Пакет javax.servlet содержит ряд интерфейсов и классов, устанавливающих обрамление, в котором работают сервлеты.

Интерфейс Описание

Servlet Объявляет методы цикла жизни для сервлета.

SERVLETCONFIG Позволяет сервлетам получать параметры инициализации.

SERVLETCONTEXT Активизирует возможности сервлетов для регистрации событий и доступа к информации об их среде.

SERVLETREQUEST Используется для чтения данных из запроса клиента.

SERVLETRESPONSE Используется для записи данных в ответ клиенту.

SINGLETHREADMODEL Указывает, что сервлет защищен от многопоточности.

Класс Описание

GENERICSERVLET Реализует интерфейс Servlet и SERVLETCONFIG

SERVLETINPUTSTREAM Обеспечивает входной поток для чтения запросов от клиента.

SERVLETOUTPUTSTREAM Обеспечивает выходной поток для записи ответов клиенту.

SERVLETEXCEPTION Указывает, что произошла ошибка сервлета.

UNAVAILABLEEXCEPTION Указывает, что сервлет постоянно или временно недоступен.

Инициализация сервлета

Когда сервер загружает сервлет, он запускает init-метод сервлета. public void init (SERVLETCONFIG config) throws SERVLETEXCEPTION

Инициализация завершается до начала обработки запрос клиента и до удаления сервлета. Сервер вызывает метод init только один раз при загрузке сервлета. В дальнейшем, метод init больше не вызывается, если только сервер не перезагружает сервлет. Сервер не может перезагрузить сервлет до тех пор, пока он не удалит сервлет, вызвав метода destroy.

Удаление сервлета

Сервлеты работают до тех пор, пока сервер не удалит их. Когда сервер удаляет сервлет, он запускает метод destroy сервлета. public void destroy()

Этот метод запускается один раз; сервер не будет запускать сервлет снова до тех пор, пока сервер не перезагрузит и переинициализирует сервлет.

Взаимодействие с клиентами

После инициализации сервлет способен обрабатывать запросы клиентов. Сервлет работает с запросами клиентов с помощью метода service. public void service (SERVLETREQUEST req, SERVLETRESPONSE res) throws SERVLETEXCEPTION, IOEXCEPTION

Метод service поддерживает стандартные HTTP-запросы клиентов, отсылая каждый полученный запрос тому методу, который создан для работы с запросом данного вида.

Когда сервлет принимает вызов клиента, он получает два объекта: · SERVLETREQUEST, который инкапсулирует связь клиента с сервером.

· SERVLETRESPONSE, инкапсулирующий обратную связь сервера с клиентом.

SERVLETREQUEST и SERVLETRESPONSE являются интерфейсами, определенными пакетом javax.servlet.

SERVLETREQUEST интерфейс

SERVLETREQUEST интерфейс позволяет сервлету получить доступ: · к следующей информации: имена параметров, введенных клиентом; протокол (схема), используемый клиентом; имя удаленного хоста, пославшего запрос; имя сервера, получившего этот запрос.

· к входному потоку SERVLETINPUTSTREAM для получения данных от клиентов, использующих такие входные протоколы, как HTTP POST- и PUT-методы.

Интерфейсы, расширяющие SERVLETREQUEST интерфейс, позволяют сервлету получить и другие данные конкретного протокола. Например, HTTPSERVLETREQUEST интерфейс содержит методы, позволяющие получить доступ к информации HTTP-заголовка.

SERVLETRESPONSE интерфейс

SERVLETRESPONSE интерфейс обеспечивает сервлет методами, необходимыми для ответа клиенту. Этот интерфейс: · позволяет сервлету установить длину содержимого и MIME-тип ответа.

· обеспечивает выходной поток SERVLETOUTPUTSTREAM и Writer, посредством которых сервлет может послать данные ответа.

Интерфейсы, расширяющие SERVLETRESPONSE интерфейс, предоставляют сервлету возможности конкретного протокола.

Чтение параметров сервлета и формирование ответа клиенту

Класс SERVLETREQUEST включает методы, позволяющие читать имена и значения параметров, которые включены в запрос клиента.

String GETPARAMETER (String pname) - возвращает значение параметра с именем pname.

Enumeration GETPARAMETERNAMES() - возвращает перечисление имен параметров этого запроса.

String[] GETPARAMETERVALUES() - возвращает перечисление значений параметров этого запроса.

Чтение параметров инициализации

Параметры инициализации могут использоваться для открытия файлов, создания подключений базы данных или выполнения других действий. К этой информации можно обращаться двумя способами: · Метод init(), объявленный интерфейсом Servlet, принимает объект SERVLETCONFIG в качестве его параметра;

· Метод GETSERVLETCONFIG(), объявленный интерфейсом Servlet, возвращает объект SERVLETCONFIG.

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

Пакет javax.servlet.http

Пакет javax.servlet содержит ряд интерфейсов и классов, облегчающих построение сервлетов, которые работают с HTTP - запросами и ответами.

Интерфейс Описание

HTTPSERVLETREQUEST Используется для чтения данных из HTTP - запроса клиента.

HTTPSERVLETRESPONSE Используется для записи данных в HTTP - ответ клиенту.

HTTPSESSION Позволяет читать и записывать данные сеанса

HTTPSESSIONBINDINGLISTENER Информирует объект о том, что он связан или не связан с сеансом.

HTTPSESSIONCONTEXT Обеспечивает управляемость сеансов

Класс Описание

Cookie Позволяет сохранять информацию состояния на машине клиента

HTTPSERVLET Обеспечивает методы для обработки запросов и ответов HTTP

HTTPSESSIONBINDINGEVENT Указывает на наличие или отсутствие связи блока прослушивания с сеансовым значением

HTTPUTILS Обеспечивает методы утилит для сервлетов.

Класс HTTPSERVLET. Работа с HTTP - запросами

Методы, которым метод service передает HTTP-запросы: · DOGET, для работы с GET-, условными GET-, и HEAD-запросами

· DOPOST, для работы с POST-запросами

· DOPUT, для работы с PUT-запросами

· DODELETE, для работы с DELETE-запросами

По умолчанию, эти методы возвращают ошибку BAD_REQUEST (400). Сервлет должен переопределить либо метод service, либо методы для работы с теми HTTP-запросами, которые он поддерживает. Метод service, принадлежащий HTTPSERVLET, также вызывает метод DOOPTIONS, когда сервлет получает OPTIONS-запрос и метод DOTRACE, когда сервлет получает TRACE-запрос. По умолчанию, реализация метода DOOPTIONS автоматически определяет какие HTTP-опции поддерживаются и возвращает эту информацию. По умолчанию, реализация метода DOTRACE выдает ответ с сообщением, содержащим все заголовки, посланные в TRACE-запросе. Эти методы, как правило, не переопределяются.

Практическая часть

Сервер Jakarta Tomcat

Перейдем к практической части лабораторной работы. Для ее выполнения вам понадобится сервер Jakarta Tomcat Server, который можно скачать на web-узле http://java.sun.com. Установите дистрибутив. Объявите переменные среды JAVA_HOME = «/jdk…» и CATALINA_HOME =»\jakarta-tomcat…» (Control Panel / System / Advanced / Environment Variables). Теперь Вы имеет установленный tomcat. Если вам надо чтобы какие-то библиотеки подключались в CLASSPATH - положите их в каталог lib. По умолчанию сервер использует порт 8080. Для запуска Tomcat используйте bin\startup.bat, для остановки - bin\shutdown.bat. Корневым каталогом для Ваших докуметов будет webapps/ROOT/

Для классов - webapps/ROOT/WEB-INF/classes/. Например, класс MYSERVLET расположенный в этом каталоге вызывается: . Класс MYPACKAGE.MYSERVLET (расположенный в пакете MYPACKAGE и соответственно в каталге webapps/ROOT/WEB-INF/classes/MYPACKAGE/) вызывается: http://localhost:8080/servlet/MYPACKAGE.MYSERVLET

Примеры

Приведем несколько примеров сервлетов.

// HELLOWORLD.java выводит на браузер надпись HELLOWORLD import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;

public class HELLOWORLD extends HTTPSERVLET { public void DOGET (HTTPSERVLETREQUEST request, HTTPSERVLETRESPONSE response) throws IOEXCEPTION, SERVLETEXCEPTION

{ response.SETCONTENTTYPE («text/html»);

PRINTWRITER out = response.GETWRITER();

out.println («»);

out.println («»);

out.println («»);

out.println («Hello World!»);

out.println («»);

out.println («»);

out.println («Hello World!»);

out.println («»);

out.println («»);

}

}

Как вы видите, сервлет обрабатывает Get - запрос браузера. response.SETCONTENTTYPE («text/html»); - устанавливаем тип ответа

PRINTWRITER out = response.GETWRITER(); - открываем поток, при помощи которого происходит запись выходных данных на браузер.

Приведем пример сервлета, обрабатывающего входные параметры.

// код HTML-страницы, вызывающей сервлет

First Name:

Last Name:

// REQUESTPARAMEXAMPLE.java получает входные параметры и выводит на браузер их значения import java.io.*;

import java.util.*;

import javax.servlet.*;

import javax.servlet.http.*;

public class REQUESTPARAMEXAMPLE extends HTTPSERVLET { public void DOPOST (HTTPSERVLETREQUEST request, HTTPSERVLETRESPONSE res) throws IOEXCEPTION, SERVLETEXCEPTION

{

Enumeration e = request.GETPARAMETERNAMES();

PRINTWRITER out = res.GETWRITER ();

while (e.HASMOREELEMENTS()) {

String name = (String) e.NEXTELEMENT();

String value = request.GETPARAMETER(name);

out.println (name «=» value);

}

}

}

Здесь мы из вызывающей страницы получаем параметры firstname и lastname. В сервлете: Enumeration e = request.GETPARAMETERNAMES(); - получаем имена всех параметров запроса, затем открываем поток записи н браузер, и до тех пор, пока множество имен не исчерпано, получаем имя параметра

String name = (String) e.NEXTELEMENT();

Получаем, значение параметра, зная имя

String value = request.GETPARAMETER(name);

Выводим его на брузер out.println (name «=» value);

Приведем пример работы с сессиями: import java.io.*;

import java.util.*;

import javax.servlet.*;

import javax.servlet.http.*;

public class SESSIONEXAMPLE extends HTTPSERVLET { public void DOGET (HTTPSERVLETREQUEST request, HTTPSERVLETRESPONSE response) throws IOEXCEPTION, SERVLETEXCEPTION

{ response.SETCONTENTTYPE («text/html»);

PRINTWRITER out = response.GETWRITER();

HTTPSESSION session = request.GETSESSION(true);

// добавить атрибут в сессию

String DATANAME = request.GETPARAMETER («DATANAME»);

String DATAVALUE = request.GETPARAMETER («DATAVALUE»);

session.SETATTRIBUTE (DATANAME, DATAVALUE);

// вывести значения атрибутов сессии

Enumeration e = session.GETATTRIBUTENAMES();

while (e.HASMOREELEMENTS()) {

String name = (String) e.NEXTELEMENT();

String value = session.GETATTRIBUTE(name).TOSTRING();

out.println (name «=» value);

}

}

}

Сервлет обрабатывает Get-запрос, извлекает значение параметра

String DATANAME = request.GETPARAMETER («DATANAME»);

String DATAVALUE = request.GETPARAMETER («DATAVALUE»);

И добавляет его в сессию session.SETATTRIBUTE (DATANAME, DATAVALUE);

Затем получаем имена всех атрибутов сессии: Enumeration e = session.GETATTRIBUTENAMES();

И пишем на браузер их значения

String value = session.GETATTRIBUTE(name).TOSTRING();

out.println (name «=» value);