Методы, добавляемые интерфейсом HttpServletResponse
Интерфейс HttpServletResponse расширяет ServletResponse и добавляет некоторые полезные методы, специфичные для протокола HTTP, которые перечислены в табл. А.14. Также в нем определен набор констант, соответствующих кодам состояния ответа, как, например, печально известное сообщение «404 — page not found». Заметим, что методы заголовков, которые начинаются с префикса add, могут добавлять значения в существующий заголовок, формируя список, разделенный запятыми, в то время как методы типа set замещают любой существующий заголовок с тем же именем.
Таблица А.14. Методы интерфейса HttpServletResponse
|
Тип возвращаемого значения |
Метод |
Описание | |||
|
void |
addCookie (Cookie cookie) |
Добавляет cookie в ответ. Этот метод можно вызывать многократно, но заметим, что браузер, возможно, будет способен принять только 20 файлов cookie из данного источника или вообще не принимать cookie | |||
|
void |
addDateHeader (String name, lonf date) |
Добавляет заголовок ответа с указанным именем и значением даты. Значение даты указывается в формате System. currentTimeMillisO, но значение заголовка ответа будет строкой с датой в формате GMT, например Тие, 15 Nov 1994 08:12:31 GMT | |||
|
void |
setDateHeader (String name, lonf date) |
Устанавливает заголовок ответа с указанным именем и значением даты. Любой установленный ранее заголовок с тем же именем будет потерян, поэтому здесь нужно проявить бдительность | |||
|
void |
addHeader (Srting name. String value) |
Добавляет заголовок запроса с указанным именем и значением. Если заголовок уже существует, то после его значения через запятую добавляется новое значение | |||
|
void |
setHeader (Srting name. String value) |
Устанавливает заголовок ответа с указанным именем и значением. Если заголовок с этим именем уже существует, то он заменяется новым | |||
|
void |
addlntHeader (Srting name, String value) |
Добавляет заголовок ответа с указанным именем и значением. Естественно, когда значение присоединяется к заголовку, оно преобразуется к типу String | |||
|
void |
setlntHeader (Srting name. String value) |
Устанавливает заголовок ответа с указанным именем и значением | |||
|
bool ean |
containsHeader(String name) |
Возвращает true, если заголовок с указанным именем уже был установлен | |||
|
void |
sendRedi rect (String location) |
Посылает ответ клиенту, используя указанный URL-адрес нового временного местоположения документа | |||
|
String |
encodeRedi rectURL (String url) |
Преобразует указанный URL-адрес в вид, пригодный для использования в методе sendRedi rect, или, если преобразования не требуется, возвращает тот же URL-адрес | |||
|
String |
encodeURUSrting url) |
Перекодирует указанный URL-адрес, включая в него идентификатор сеанса, или, если перекодировка не требуется, возвращает URL без изменения | |||
|
void |
sendError(int sc) |
Посылает клиенту код ошибки HTTP | |||
|
void |
sendError (int sc. Srting msg) |
Посылает код ошибки с описанием | |||
|
void |
setStatus(int sc) |
Устанавливает код состояния для ответа |