Использование класса HttpServlet для задания обработчика на Java

Вы можете задать обработчик на Java, переопределив выбранные методы класса HttpServlet.

Сервис Cloud Functions будет автоматически перенаправлять каждый HTTP-запрос в ваш обработчик, в зависимости от HTTP-метода, с которым этот запрос был инициирован. Например, GET-запрос будет перенаправлен в метод doGet вашего обработчика, а POST — в doPost. Для успешного перенаправления соответствующие методы обработчика должны существовать, иначе ответом функции будет сообщение HTTP method XXX is not supported by this URL с кодом 405.

Неподдерживаемые методы

При использовании данной модели, обратите внимание на то, что некоторые методы классов HttpServletRequest и HttpServletResponse не поддерживаются сервисом Cloud Functions.

HttpServletRequest:

• getAuthType
• getCookies
• upgrade
• authenticate
• login
• logout
• getContextPath
• getServletPath
• getPathTranslated
• getRealPath
• getRemotePort
• getLocalAddr
• getLocalPort
• getServerPort
• isUserInRole
• getUserPrincipal
• getRequestedSessionId
• getSession
• changeSessionId
• isRequestedSessionIdValid
• isRequestedSessionIdFromCookie
• isRequestedSessionIdFromURL
• isRequestedSessionIdFromUrl

HttpServletResponse:

• encodeURL
• encodeRedirectURL
• encodeUrl
• encodeRedirectUrl

Пример: моделирование различного поведения функции при вызове с разными HTTP-методами

Файл Handler.java:

import java.io.IOException;

import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class Handler extends HttpServlet {
  @Override
  protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
    // выставив значение Content-Type в text/html, позволяем браузеру рендерить html код
    response.setContentType("text/html");
    // отобразится в виде полужирной строки при вызове функции из браузера
    response.getOutputStream().print("<b>Hello, world. In bold.</b>");
  }

  @Override
  protected void doPost(HttpServletRequest request, HttpServletResponse response) throws IOException {
    var name = request.getParameter("name");
    response.getWriter().println("Hello, " + name);
    // printWriter, возвращаемый методом getWriter, нужно обязательно закрывать
    response.getWriter().close();
  }
}

Примеры запросов:

Метод: GET:

<b>Hello, world. In bold.</b>

Метод POST, параметр запроса name=Anonymous:

Hello, Anonymous

Метод PUT:

HTTP method PUT is not supported by this URL