Servlet HTTP-ответ сервера
Как обсуждалось в предыдущих главах, когда веб-сервер отвечает на HTTP-запрос, ответ обычно включает строку состояния, несколько заголовков ответа, пустую строку и документ. Типичный ответ показан ниже:
HTTP/1.1 200 OK Content-Type: text/html Header2: ... ... HeaderN: ... (Blank Line) <!doctype ...> <html> <head>...</head> <body> ... </body> </html>
Строка состояния включает версию HTTP (в данном случае HTTP/1.1), код состояния (в данном случае 200) и короткое сообщение, соответствующее коду состояния (в данном случае OK).
В следующей таблице перечислены наиболее полезные заголовки ответа HTTP 1.1, возвращаемые веб-сервером браузеру. Вы будете часто использовать их в веб-программировании:
| Заголовок | Описание |
|---|---|
| Allow | Этот заголовок указывает методы запроса (GET, POST и т. д.), поддерживаемые сервером. |
| Cache-Control | Этот заголовок определяет, при каких обстоятельствах документ ответа можно безопасно кэшировать. Возможные значения:public、privateилиno-cacheи т. д. Public означает, что документ можно кэшировать, Private означает, что документ является приватным документом одного пользователя и может храниться только в приватном (неразделяемом) кэше, а no-cache означает, что документ не следует кэшировать. |
| Соединение | Этот заголовок указывает, использует ли браузер постоянное HTTP-соединение. Значениеcloseуказывает, что браузер не использует постоянное HTTP-соединение, а значениеkeep-aliveозначает использование постоянного соединения. |
| Content-Disposition | Этот заголовок позволяет попросить браузер предложить пользователю сохранить ответ на диск как файл с заданным именем. |
| Content-Encoding | Во время передачи этот заголовок задаёт кодировку страницы. |
| Content-Language | Этот заголовок указывает язык, на котором написан документ. Например, en, en-us, ru и т. д. |
| Content-Length | Этот заголовок указывает количество байтов в ответе. Эта информация нужна только тогда, когда браузер использует постоянное (keep-alive) HTTP-соединение. |
| Content-Type | Этот заголовок предоставляет MIME-тип (Multipurpose Internet Mail Extension) документа ответа. |
| Expires | Этот заголовок задаёт время, когда содержимое истекает, после чего содержимое больше не кэшируется. |
| Last-Modified | Этот заголовок указывает время последнего изменения документа. Затем клиент может кэшировать файл и в последующих запросах передавать дату черезIf-Modified-Sinceзаголовок запроса. |
| Расположение | Этот заголовок следует включать во все ответы с кодом состояния. В диапазоне 300-х он сообщает браузеру адрес документа. Браузер автоматически переподключится к этому местоположению и получит новый документ. |
| Обновить | Этот заголовок задаёт, как скоро браузер должен запросить обновлённую страницу. Вы можете указать количество секунд до обновления страницы. |
| Retry-After | Этот заголовок можно использовать с ответом 503 (Service Unavailable), чтобы сообщить клиенту, сколько ему следует ждать перед повторением запроса. |
| Set-Cookie | Этот заголовок задаёт cookie, связанный со страницей. |
Методы установки заголовков HTTP-ответа
Следующие методы можно использовать для установки заголовков HTTP-ответа в программе Servlet. Эти методы доступны через объектHttpServletResponse.
| Нет. | Метод и описание |
|---|---|
| 1 | String encodeRedirectURL(String url) Кодирует указанный URL, используемый в методе sendRedirect, или возвращает URL без изменений, если кодирование не требуется. |
| 2 | String encodeURL(String url) Кодирует указанный URL, содержащий идентификатор сессии, или возвращает URL без изменений, если кодирование не требуется. |
| 3 | boolean containsHeader(String name) Возвращает значение boolean, указывающее, был ли уже установлен заголовок ответа с указанным именем. |
| 4 | boolean isCommitted() Возвращает значение boolean, указывающее, был ли ответ уже зафиксирован. |
| 5 | void addCookie(Cookie cookie) Добавляет указанный cookie в ответ. |
| 6 | void addDateHeader(String name, long date) Добавляет заголовок ответа с заданным именем и значением даты. |
| 7 | void addHeader(String name, String value) Добавляет заголовок ответа с заданным именем и значением. |
| 8 | void addIntHeader(String name, int value) Добавляет заголовок ответа с заданным именем и целочисленным значением. |
| 9 | void flushBuffer() Принудительно записывает всё содержимое буфера клиенту. |
| 10 | void reset() Очищает все данные, присутствующие в буфере, включая код состояния и заголовки. |
| 11 | void resetBuffer() Очищает содержимое базового буфера в ответе, не очищая код состояния и заголовки. |
| 12 | void sendError(int sc) Отправляет клиенту ответ об ошибке с использованием указанного кода состояния и очищает буфер. |
| 13 | void sendError(int sc, String msg) Отправляет клиенту ответ об ошибке с использованием указанного статуса. |
| 14 | void sendRedirect(String location) Отправляет клиенту временный ответ перенаправления с использованием указанного URL местоположения перенаправления. |
| 15 | void setBufferSize(int size) Устанавливает предпочтительный размер буфера для тела ответа. |
| 16 | void setCharacterEncoding(String charset) Устанавливает кодировку символов (MIME-кодировку) ответа, отправляемого клиенту, например, UTF-8. |
| 17 | void setContentLength(int len) Задаёт длину тела содержимого в ответе HTTP-сервлета. Этот метод устанавливает заголовок HTTP Content-Length. |
| 18 | void setContentType(String type) Если ответ ещё не зафиксирован, устанавливает тип содержимого ответа, отправляемого клиенту. |
| 19 | void setDateHeader(String name, long date) Устанавливает заголовок ответа с заданными именем и значением даты. |
| 20 | void setHeader(String name, String value) Устанавливает заголовок ответа с заданными именем и значением. |
| 21 | void setIntHeader(String name, int value) Устанавливает заголовок ответа с заданными именем и целочисленным значением. |
| 22 | void setLocale(Locale loc) Если ответ ещё не зафиксирован, устанавливает локаль ответа. |
| 23 | void setStatus(int sc) Устанавливает код состояния для этого ответа. |
Пример HTTP-заголовка ответа
Вы уже видели метод setContentType() в предыдущих примерах. В следующем примере также используется тот же метод. Кроме того, мы будем использовать методsetIntHeader(), чтобы установить заголовокRefresh.
//导入必需的 java 库
import java.io.IOException;
import java.io.PrintWriter;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/Refresh")
//扩展 HttpServlet 类
public class Refresh extends HttpServlet {
// 处理 GET 方法请求的方法
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置刷新自动加载时间为 5 秒
response.setIntHeader("Refresh", 5);
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
//使用默认时区和语言环境获得一个日历
Calendar cale = Calendar.getInstance();
//将Calendar类型转换成Date类型
Date tasktime=cale.getTime();
//设置日期输出的格式
SimpleDateFormat df=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
//格式化输出
String nowTime = df.format(tasktime);
PrintWriter out = response.getWriter();
String title = "自动刷新 Header 设置 - Example实例";
String docType =
"<!DOCTYPE html>\n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n"+
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1 align=\"center\">" + title + "</h1>\n" +
"<p>当前时间是:" + nowTime + "</p>\n");
}
// 处理 POST 方法请求的方法
public void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
Приведённый выше тестовый пример находится в проекте TomcatTest, а соответствующая конфигурация web.xml выглядит так:
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<!-- 类名 -->
<servlet-name>Refresh</servlet-name>
<!-- 所在的包 -->
<servlet-class>com.example.test.Refresh</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Refresh</servlet-name>
<!-- 访问的网址 -->
<url-pattern>/TomcatTest/Refresh</url-pattern>
</servlet-mapping>
</web-app>
Теперь вызов указанного выше Servlet будет отображать текущее системное время каждые 5 секунд. Просто запустите Servlet и подождите немного, и вы увидите следующий результат:
