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

Факультет «Информатика и системы управления»

Методические указания к лабораторной работе

по курсу «Распределенные системы обработки информации»

"Разработка Web‑приложений с применением Java Servlet Технологии"

Москва 2004 г.

Цель работы

Получить знания о Java Servlet технологии, сервере Jakarta Tomcat, его настройке для работы с сервлетами.

Ознакомиться с материалом, предоставленным в приложении к данным методическим указаниям. Ознакомиться с текстом задания к лабораторной работе. Написать Web – приложение.

Написать пользовательский интерфейс online форума.

Отчет должен содержать:

Постановку задачи, решаемой отлаженных программ.

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

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

Преимущества 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

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

Сервлеты расширяют функциональность 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.

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

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

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

Сервер загружает и инициализирует сервлет

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

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

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

Для вызова сервлета с браузера достаточно набрать запрос – URL сервлета. URL сервлета имеет следующую форму:

http://machine-name:port/servlet/servlet-name

где servlet-name относится к имени, данному этому сервлету. Например

http://localhost:8080/servlet/bookstore

URL сервлетов может содержать запросы, такие как HTTP GET‑запросы. Например

http://localhost:8080/servlet/bookdetails? bookId=203

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

<a href=«http://localhost:8080/servlet/cashier>Calls the servlet</a>

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

<form action= «http://localhost:8080/servlet/receipt» method= «post»>

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

<meta http-equiv= «refresh» content= «4; url=http://localhost:8080/servlet/bookstore;»>

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

Когда сервер загружает сервлет, он запускает init‑метод сервлета.

public void init (ServletConfig config) throws ServletException

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

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

public void destroy()

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

После инициализации сервлет способен обрабатывать запросы клиентов. Cервлет работает с запросами клиентов с помощью метода service.

public void service (ServletRequest req, ServletResponse res)

throws ServletException, IOException

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

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

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

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

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

ServletRequest интерфейс позволяет сервлету получить доступ:

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

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

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

ServletResponse интерфейс обеспечивает сервлет методами, необходимыми для ответа клиенту. Этот интерфейс:

позволяет сервлету установить длину содержимого и MIME‑тип ответа.

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

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

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

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

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

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

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

Метод init(), объявленный интерфейсом Servlet, принимает объект ServletConfig в качестве его параметра;

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

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

Пакет javax.servlet содержит ряд интерфейсов и классов, облегчающих построение сервлетов, которые работают с 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 Server, который можно скачать на web‑узле http://java.sun.com. Установите дистрибутив. Объявите переменные среды JAVA_HOME = «<path>/jdk…» и CATALINA_HOME =»<path>\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 расположенный в этом каталоге вызывается: http://localhost:8080/servlet/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 («<html>»);

out.println («<body>»);

out.println («<head>»);

out.println («<title>Hello World!</title>»);

out.println («</head>»);

out.println («<body>»);

out.println («<h1>Hello World!</h1>»);

out.println («</body>»);

out.println («</html>»);

}

}

Как вы видите, сервлет обрабатывает Get – запрос браузера.

response.setContentType («text/html»); – устанавливаем тип ответа

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

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

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

<form action= «RequestParamExample» method=POST>

First Name:

<input type=text size=20 name=firstname>

<br>

Last Name:

<input type=text size=20 name=lastname>

<br>

<input type=submit>

</form>

 // 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);