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.

Нет.Метод и описание
1String encodeRedirectURL(String url)
Кодирует указанный URL, используемый в методе sendRedirect, или возвращает URL без изменений, если кодирование не требуется.
2String encodeURL(String url)
Кодирует указанный URL, содержащий идентификатор сессии, или возвращает URL без изменений, если кодирование не требуется.
3boolean containsHeader(String name)
Возвращает значение boolean, указывающее, был ли уже установлен заголовок ответа с указанным именем.
4boolean isCommitted()
Возвращает значение boolean, указывающее, был ли ответ уже зафиксирован.
5void addCookie(Cookie cookie)
Добавляет указанный cookie в ответ.
6void addDateHeader(String name, long date)
Добавляет заголовок ответа с заданным именем и значением даты.
7void addHeader(String name, String value)
Добавляет заголовок ответа с заданным именем и значением.
8void addIntHeader(String name, int value)
Добавляет заголовок ответа с заданным именем и целочисленным значением.
9void flushBuffer()
Принудительно записывает всё содержимое буфера клиенту.
10void reset()
Очищает все данные, присутствующие в буфере, включая код состояния и заголовки.
11void resetBuffer()
Очищает содержимое базового буфера в ответе, не очищая код состояния и заголовки.
12void sendError(int sc)
Отправляет клиенту ответ об ошибке с использованием указанного кода состояния и очищает буфер.
13void sendError(int sc, String msg)
Отправляет клиенту ответ об ошибке с использованием указанного статуса.
14void sendRedirect(String location)
Отправляет клиенту временный ответ перенаправления с использованием указанного URL местоположения перенаправления.
15void setBufferSize(int size)
Устанавливает предпочтительный размер буфера для тела ответа.
16void setCharacterEncoding(String charset)
Устанавливает кодировку символов (MIME-кодировку) ответа, отправляемого клиенту, например, UTF-8.
17void setContentLength(int len)
Задаёт длину тела содержимого в ответе HTTP-сервлета. Этот метод устанавливает заголовок HTTP Content-Length.
18void setContentType(String type)
Если ответ ещё не зафиксирован, устанавливает тип содержимого ответа, отправляемого клиенту.
19void setDateHeader(String name, long date)
Устанавливает заголовок ответа с заданными именем и значением даты.
20void setHeader(String name, String value)
Устанавливает заголовок ответа с заданными именем и значением.
21void setIntHeader(String name, int value)
Устанавливает заголовок ответа с заданными именем и целочисленным значением.
22void setLocale(Locale loc)
Если ответ ещё не зафиксирован, устанавливает локаль ответа.
23void 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 и подождите немного, и вы увидите следующий результат:

Другие расширения