Spec-Zone .ru спецификации, руководства, описания, API

javax.servlet
Сервлет интерфейса

Все Известные Подынтерфейсы:

HttpJspPage, JspPage

Все Известные Классы с реализацией:

FacesServlet, GenericServlet, HttpServlet

public interface Servlet

Определяет методы, которые должны реализовать все сервлеты.

Сервлет является маленькой программой Java, которая работает в пределах веб-сервера. Сервлеты получают и отвечают на запросы от Веб-клиентов, обычно через HTTP, Протокол передачи HyperText.

Чтобы реализовать этот интерфейс, можно записать универсальный сервлет, который расширяется javax.servlet.GenericServlet или сервлет HTTP, который расширяется javax.servlet.http.HttpServlet.

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

1. Сервлет создается, затем инициализируется с init метод.
2. Любые вызовы от клиентов к service метод обрабатывается.
3. Сервлет берется вне обслуживания, затем уничтожается с destroy метод, затем собрал "мусор" и завершил.

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

Автор:

Различный

См. Также:

GenericServlet, HttpServlet

Сводка метода

void	destroy() Вызванный контейнером сервлета, чтобы указать к сервлету, что сервлет берется вне обслуживания.
ServletConfig	getServletConfig() Возвраты a ServletConfig объект, который содержит инициализацию и параметры запуска для этого сервлета.
java.lang.String	getServletInfo() Информация о возвратах о сервлете, таком как автор, версия, и авторское право.
void	init(ServletConfig config) Вызванный контейнером сервлета, чтобы указать к сервлету, что сервлет помещается в службу.
void	service(ServletRequest req, ServletResponse res) Вызванный контейнером сервлета, чтобы позволить сервлету отвечать на запрос.

Деталь метода

init

void init(ServletConfig config)
          throws ServletException

Вызванный контейнером сервлета, чтобы указать к сервлету, что сервлет помещается в службу.

Контейнер сервлета вызывает init метод точно однажды после инстанцирования сервлета. init метод должен завершиться успешно прежде, чем сервлет может получить любые запросы.

Контейнер сервлета не может поместить сервлет в службу если init метод

1. Броски a ServletException
2. Не возвращается в пределах периода времени, определенного веб-сервером

Параметры:

config - a ServletConfig объект, содержащий конфигурацию сервлета и параметры инициализации

Броски:

ServletException - если исключение произошло, который вмешивается в нормальное функционирование сервлета

См. Также:

UnavailableException, getServletConfig()

getServletConfig

ServletConfig getServletConfig()

Возвраты a ServletConfig объект, который содержит инициализацию и параметры запуска для этого сервлета. ServletConfig возвращенный объект является тем, который передают к init метод.

Реализации этого интерфейса ответственны за хранение ServletConfig возразите так, чтобы этот метод мог возвратить это. GenericServlet class, который реализует этот интерфейс, уже делает это.

Возвраты:

ServletConfig объект, который инициализирует этот сервлет

См. Также:

init(javax.servlet.ServletConfig)

служба

void service(ServletRequest req,
             ServletResponse res)
             throws ServletException,
                    java.io.IOException

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

Этот метод только вызывают после сервлета init() метод завершился успешно.

Код состояния ответа всегда должен устанавливаться для сервлета, который бросает или отправляет ошибку.

Сервлеты, обычно выполняемые в многопоточных контейнерах сервлета, которые могут обработать многократные запросы одновременно. Разработчики должны знать, чтобы синхронизировать доступ к любым совместно используемым ресурсам, таким как файлы, сетевые соединения, и так же как class сервлета и переменные экземпляра. Больше информации о многопоточном программировании в Java доступно в учебном руководстве по Java на многопоточном программировании.

Параметры:

req - ServletRequest объект, который содержит запрос клиента

res - ServletResponse объект, который содержит ответ сервлета

Броски:

ServletException - если исключение происходит, который вмешивается в нормальное функционирование сервлета

java.io.IOException - если исключение ввода или вывода происходит

getServletInfo

java.lang.String getServletInfo()

Информация о возвратах о сервлете, таком как автор, версия, и авторское право.

Строка, что этот метод возвраты должен быть простым текстом и не разметкой любого вида (такого как HTML, XML, и т.д.).

Возвраты:

a String содержа информацию о сервлете

уничтожить

void destroy()

Вызванный контейнером сервлета, чтобы указать к сервлету, что сервлет берется вне обслуживания. Этот метод только вызывают однажды все потоки в пределах сервлета service метод вышел или после того, как период тайм-аута передал. После того, как контейнер сервлета вызывает этот метод, он не будет вызывать service метод снова на этом сервлете.

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