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

javax.servlet.http
Класс HttpServlet

java.lang.Object
  javax.servlet.GenericServlet
      javax.servlet.http.HttpServlet

Все Реализованные Интерфейсы:

java.io. Сериализуемый, Сервлет, ServletConfig

public abstract class HttpServlet
расширяет GenericServlet
реализации java.io. Сериализуемый

Обеспечивает абстрактный class, который будет разделен на подклассы, чтобы создать сервлет HTTP, подходящий для Веб-сайта. Подкласс HttpServlet должен переопределить по крайней мере один метод, обычно один из них:

• doGet, если сервлет поддерживает HTTP-запросы GET
• doPost, для запросов POST HTTP
• doPut, для HTTP ПОМЕЩЕННЫЕ запросы
• doDelete, поскольку HTTP УДАЛЯЕТ запросы
• init и destroy, управлять ресурсами, которые сохранены для жизни сервлета
• getServletInfo, который использование сервлета предоставить информацию о себе

Нет почти никакой причины переопределить service метод. service стандарт дескрипторов HTTP запрашивает, диспетчеризируя их методам обработчика для каждого типа запроса HTTP ( doXXX упомянутых выше методов).

Аналогично, нет почти никакой причины переопределить doOptions и doTrace методы.

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

Автор:

Различный

См. Также:

Сериализированная Форма

Сводка конструктора

HttpServlet()
Ничего не делает, потому что это - абстрактный class.

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

protected void	doDelete(HttpServletRequest req, HttpServletResponse resp) Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать УДАЛИТЬ запрос.
protected void	doGet(HttpServletRequest req, HttpServletResponse resp) Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать ПОЛУЧИТЬ запрос.
protected void	doHead(HttpServletRequest req, HttpServletResponse resp) Получает запрос ГОЛОВЫ HTTP от защищенного service метод и дескрипторы запрос.
protected void	doOptions(HttpServletRequest req, HttpServletResponse resp) Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать запрос ОПЦИЙ.
protected void	doPost(HttpServletRequest req, HttpServletResponse resp) Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать запрос POST.
protected void	doPut(HttpServletRequest req, HttpServletResponse resp) Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать ПОМЕЩЕННЫЙ запрос.
protected void	doTrace(HttpServletRequest req, HttpServletResponse resp) Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать запрос ТРАССИРОВКИ.
protected long	getLastModified(HttpServletRequest req) Возвращает время HttpServletRequest объект был последний измененный в миллисекундах с полуночи 1 января 1970 GMT.
protected void	service(HttpServletRequest req, HttpServletResponse resp) Получает стандартные запросы HTTP от общественности service метод и диспетчеризирует их doXXX методов определяются в этом class.
void	service(ServletRequest req, ServletResponse res) Диспетчеризирует клиентские запросы защищенному service метод.

Методы, наследованные от class javax.servlet. GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, init, log, log

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

HttpServlet

public HttpServlet()

Ничего не делает, потому что это - абстрактный class.

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

doGet

protected void doGet(HttpServletRequest req,
                     HttpServletResponse resp)
              throws ServletException,
                     java.io.IOException

Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать ПОЛУЧИТЬ запрос.

Переопределение этого метода, чтобы поддерживать ПОЛУЧИТЬ запрос также автоматически поддерживает запрос ГОЛОВЫ HTTP. ГЛАВНЫЙ запрос является ПОЛУЧИТЬ запросом, который не возвращает тела в ответе, только поля заголовка запроса.

Переопределяя этот метод, считайте данные запроса, запишите заголовки ответа, получите писателя ответа или объект потока вывода, и наконец, запишите данные ответа. Лучше включать тип контента и кодирование. При использовании a PrintWriter возразите, чтобы возвратить ответ, установить тип контента прежде, чем получить доступ PrintWriter объект.

Контейнер сервлета должен записать заголовки прежде, чем фиксировать ответ, потому что в HTTP заголовки должны быть отправлены перед телом ответа.

Где только возможно установите заголовок Длиной до контента (с ServletResponse.setContentLength(int) метод), чтобы позволить контейнеру сервлета использовать персистентное соединение, чтобы возвратить его ответ клиенту, улучшая производительность. Длина контента автоматически устанавливается, если весь ответ соответствует в буфере ответа.

При использовании HTTP 1.1 разделенного на блоки кодирования (что означает, что у ответа есть Кодирующий передачу заголовок), не устанавливайте заголовок Длиной до контента.

Метод GET должен быть безопасным, то есть, без любых побочных эффектов, за которые пользователи считаются ответственные. Например, у большинства запросов формы нет никаких побочных эффектов. Если клиентский запрос предназначается, чтобы изменить хранившие данные, запрос должен использовать некоторый другой метод HTTP.

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

Если запрос неправильно форматируется, doGet возвращается HTTP "Плохо Запрашивают" сообщение.

Параметры:

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

resp - HttpServletResponse объект, который содержит ответ сервлет, передается клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода обнаруживается, когда сервлет обрабатывает ПОЛУЧИТЬ запрос

ServletException - если запрос на ТО, ЧТОБЫ ПОЛУЧАТЬ не мог бы быть обработан

См. Также:

ServletResponse.setContentType(java.lang.String)

getLastModified

protected long getLastModified(HttpServletRequest req)

Возвращает время HttpServletRequest объект был последний измененный в миллисекундах с полуночи 1 января 1970 GMT. Если время неизвестно, этот метод возвращает отрицательное число (значение по умолчанию).

Сервлеты, которые поддерживают HTTP-запросы GET и могут быстро определить их время последнего изменения, должны переопределить этот метод. Это заставляет браузер и кэши прокси-сервера работать эффективнее, уменьшая загрузку на сервере и сетевых ресурсах.

Параметры:

req - HttpServletRequest объект, который отправляется сервлету

Возвраты:

a long целое число, определяющее время HttpServletRequest объект был последний измененный, в миллисекундах с полуночи, 1 января 1970 GMT, или-1, если время не известно

doHead

protected void doHead(HttpServletRequest req,
                      HttpServletResponse resp)
               throws ServletException,
                      java.io.IOException

Получает запрос ГОЛОВЫ HTTP от защищенного service метод и дескрипторы запрос. Клиент отправляет ГЛАВНЫЙ запрос, когда он хочет видеть только заголовки ответа, такие как Тип контента или Длиной до контента. Метод HEAD HTTP считает выходные байты в ответ на набор заголовком Длиной до контента точно.

Если Вы переопределяете этот метод, можно избежать вычислять тело ответа и только установить заголовки ответа непосредственно, чтобы улучшить производительность. Удостоверьтесь что doHead метод, который Вы пишете, является и безопасным и идемпотентным (то есть, защищает себя от того, чтобы быть вызванным многократно для одного запроса ГОЛОВЫ HTTP).

Если запрос ГОЛОВЫ HTTP неправильно форматируется, doHead возвращается HTTP "Плохо Запрашивают" сообщение.

Параметры:

req - объект запроса, который передают к сервлету

resp - объект ответа, что использование сервлета, чтобы возвратить заголовки clien

Броски:

java.io.IOException - если ошибка ввода или вывода происходит

ServletException - если запрос на ГОЛОВУ не мог бы быть обработан

doPost

protected void doPost(HttpServletRequest req,
                      HttpServletResponse resp)
               throws ServletException,
                      java.io.IOException

Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать запрос POST. Метод POST HTTP позволяет клиенту отправлять данные неограниченной длины к веб-серверу единственное время и полезен, размещая информацию, такую как номера кредитной карточки.

Переопределяя этот метод, считайте данные запроса, запишите заголовки ответа, получите писателя ответа или объект потока вывода, и наконец, запишите данные ответа. Лучше включать тип контента и кодирование. При использовании a PrintWriter возразите, чтобы возвратить ответ, установить тип контента прежде, чем получить доступ PrintWriter объект.

Контейнер сервлета должен записать заголовки прежде, чем фиксировать ответ, потому что в HTTP заголовки должны быть отправлены перед телом ответа.

Где только возможно установите заголовок Длиной до контента (с ServletResponse.setContentLength(int) метод), чтобы позволить контейнеру сервлета использовать персистентное соединение, чтобы возвратить его ответ клиенту, улучшая производительность. Длина контента автоматически устанавливается, если весь ответ соответствует в буфере ответа.

При использовании HTTP 1.1 разделенного на блоки кодирования (что означает, что у ответа есть Кодирующий передачу заголовок), не устанавливайте заголовок Длиной до контента.

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

Если запрос POST HTTP неправильно форматируется, doPost возвращается HTTP "Плохо Запрашивают" сообщение.

Параметры:

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

resp - HttpServletResponse объект, который содержит ответ сервлет, передается клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода обнаруживается, когда сервлет обрабатывает запрос

ServletException - если запрос на POST не мог бы быть обработан

См. Также:

ServletOutputStream, ServletResponse.setContentType(java.lang.String)

doPut

protected void doPut(HttpServletRequest req,
                     HttpServletResponse resp)
              throws ServletException,
                     java.io.IOException

Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать ПОМЕЩЕННЫЙ запрос. ПОМЕЩЕННАЯ работа позволяет клиенту помещать файл в сервер и подобна отправке файла FTP.

Переопределяя этот метод, оставьте неповрежденным любые заголовки контента отправленный с запросом (включая Тип контента Длиной до контента, Кодирование передачи контента, Кодирование контента, Основу контента, Язык контента, Расположение контента, Контент-MD5, и Диапазон контента). Если Ваш метод не может обработать заголовок контента, он должен выпустить сообщение об ошибке (HTTP 501 - Не Реализованный) и отбросить запрос. Для получения дополнительной информации по HTTP 1.1, см. RFC 2616.

Этот метод не должен быть или безопасным или идемпотентным. Операции это doPut выполняет может иметь побочные эффекты, за которые пользователь может считаться ответственный. При использовании этого метода может быть полезно сохранить копию URL, на который влияют, во временном хранении.

Если HTTP ПОМЕЩЕННЫЙ запрос неправильно форматируется, doPut возвращается HTTP "Плохо Запрашивают" сообщение.

Параметры:

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

resp - HttpServletResponse объект, который содержит ответ сервлет, возвращается к клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода происходит, в то время как сервлет обрабатывает ПОМЕЩЕННЫЙ запрос

ServletException - если запрос на ПОМЕЩЕННЫЙ не может быть обработан

doDelete

protected void doDelete(HttpServletRequest req,
                        HttpServletResponse resp)
                 throws ServletException,
                        java.io.IOException

Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать УДАЛИТЬ запрос. УДАЛИТЬ работа позволяет клиенту удалять документ или Веб-страницу от сервера.

Этот метод не должен быть или безопасным или идемпотентным. Операции, которые требуют через, УДАЛЯЮТ, может иметь побочные эффекты, за которые пользователи могут считаться ответственные. При использовании этого метода может быть полезно сохранить копию URL, на который влияют, во временном хранении.

Если HTTP УДАЛЯЕТ запрос, неправильно форматируется, doDelete возвращается HTTP "Плохо Запрашивают" сообщение.

Параметры:

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

resp - HttpServletResponse объект, который содержит ответ сервлет, возвращается к клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода происходит, в то время как сервлет обрабатывает УДАЛИТЬ запрос

ServletException - если запрос на УДАЛЕНИЕ не может быть обработан

doOptions

protected void doOptions(HttpServletRequest req,
                         HttpServletResponse resp)
                  throws ServletException,
                         java.io.IOException

Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать запрос ОПЦИЙ. Запрос ОПЦИЙ определяет, какие методы HTTP сервер поддерживает и возвращает соответствующий заголовок. Например, если сервлет переопределяет doGet, этот метод возвращает следующий заголовок:

Allow: GET, HEAD, TRACE, OPTIONS

Нет никакой потребности переопределить этот метод, если сервлет не реализует новые методы HTTP вне реализованных HTTP 1.1.

Параметры:

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

resp - HttpServletResponse объект, который содержит ответ сервлет, возвращается к клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода происходит, в то время как сервлет обрабатывает запрос ОПЦИЙ

ServletException - если запрос на ОПЦИИ не может быть обработан

doTrace

protected void doTrace(HttpServletRequest req,
                       HttpServletResponse resp)
                throws ServletException,
                       java.io.IOException

Вызванный сервером (через service метод), чтобы позволить сервлету обрабатывать запрос ТРАССИРОВКИ. ТРАССИРОВКА Возвращается, заголовки, отправленные с ТРАССИРОВКОЙ, запрашивают клиенту, так, чтобы они могли использоваться в отладке. Нет никакой потребности переопределить этот метод.

Параметры:

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

resp - HttpServletResponse объект, который содержит ответ сервлет, возвращается к клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода происходит, в то время как сервлет обрабатывает запрос ТРАССИРОВКИ

ServletException - если запрос на ТРАССИРОВКУ не может быть обработан

служба

protected void service(HttpServletRequest req,
                       HttpServletResponse resp)
                throws ServletException,
                       java.io.IOException

Получает стандартные запросы HTTP от общественности service метод и диспетчеризирует их doXXX методов определяются в этом class. Этот метод является специфичной для HTTP версией Servlet.service(javax.servlet.ServletRequest, javax.servlet.ServletResponse) метод. Нет никакой потребности переопределить этот метод.

Параметры:

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

resp - HttpServletResponse объект, который содержит ответ сервлет, возвращается к клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода происходит, в то время как сервлет обрабатывает запрос HTTP

ServletException - если запрос HTTP не может быть обработан

См. Также:

Servlet.service(javax.servlet.ServletRequest, javax.servlet.ServletResponse)

служба

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

Диспетчеризирует клиентские запросы защищенному service метод. Нет никакой потребности переопределить этот метод.

Определенный:

service в интерфейсе Servlet

Определенный:

service в class GenericServlet

Параметры:

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

res - HttpServletResponse объект, который содержит ответ сервлет, возвращается к клиенту

Броски:

java.io.IOException - если ошибка ввода или вывода происходит, в то время как сервлет обрабатывает запрос HTTP

ServletException - если запрос HTTP не может быть обработан

См. Также:

Servlet.service(javax.servlet.ServletRequest, javax.servlet.ServletResponse)