Является ли Servlet интерфейсом?

Является ли Servlet интерфейсом?

Да, Servlet является интерфейсом в Java. Это фундаментальный интерфейс в Java Servlet API, который определяет контракт для компонентов, обрабатывающих HTTP-запросы и генерирующих HTTP-ответы. Servlet не является классом, а интерфейсом с чётко определёнными методами жизненного цикла.

Определение интерфейса Servlet

// Интерфейс Servlet определён в javax.servlet (или jakarta.servlet в новых версиях)
public interface Servlet {
    
    // Инициализация сервлета
    void init(ServletConfig config) throws ServletException;
    
    // Получение конфигурации
    ServletConfig getServletConfig();
    
    // Обработка запроса
    void service(ServletRequest request, ServletResponse response) 
        throws ServletException, IOException;
    
    // Получение информации о сервлете
    String getServletInfo();
    
    // Уничтожение сервлета
    void destroy();
}

Жизненный цикл Servlet

// 1. ЗАГРУЗКА И ИНИЦИАЛИЗАЦИЯ
// Контейнер (Tomcat, Jetty) загружает класс сервлета

// 2. ИНИЦИАЛИЗАЦИЯ - init() вызывается ОДИН раз
public class MyServlet implements Servlet {
    @Override
    public void init(ServletConfig config) throws ServletException {
        System.out.println("Servlet initialized");
        // Инициализация ресурсов (подключение к БД, загрузка конфига)
    }
}

// 3. ОБРАБОТКА ЗАПРОСОВ - service() вызывается для каждого запроса
public class MyServlet implements Servlet {
    @Override
    public void service(ServletRequest request, ServletResponse response) 
        throws ServletException, IOException {
        System.out.println("Processing request");
        // Обработка HTTP запроса
    }
}

// 4. ЗАВЕРШЕНИЕ - destroy() вызывается при выключении контейнера
public class MyServlet implements Servlet {
    @Override
    public void destroy() {
        System.out.println("Servlet destroyed");
        // Освобождение ресурсов
    }
}

Реализация интерфейса Servlet

В практике разработчики редко реализуют Servlet напрямую. Вместо этого используют абстрактный класс HttpServlet, который уже реализует интерфейс Servlet и предоставляет удобные методы для работы с HTTP:

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

// HttpServlet уже реализует Servlet интерфейс
public class UserServlet extends HttpServlet {
    
    // Переопределяем методы для конкретных HTTP методов
    @Override
    protected void doGet(HttpServletRequest request, 
                        HttpServletResponse response) {
        // Обработка GET запроса
        String userId = request.getParameter("id");
        response.setContentType("text/html");
        response.getWriter().println("User ID: " + userId);
    }
    
    @Override
    protected void doPost(HttpServletRequest request, 
                         HttpServletResponse response) {
        // Обработка POST запроса
        String name = request.getParameter("name");
        response.getWriter().println("Received: " + name);
    }
    
    @Override
    protected void doPut(HttpServletRequest request, 
                        HttpServletResponse response) {
        // Обработка PUT запроса
    }
    
    @Override
    protected void doDelete(HttpServletRequest request, 
                           HttpServletResponse response) {
        // Обработка DELETE запроса
    }
}

Прямая реализация Servlet интерфейса

import javax.servlet.*;
import java.io.IOException;

public class CustomServlet implements Servlet {
    private ServletConfig config;
    
    @Override
    public void init(ServletConfig config) throws ServletException {
        this.config = config;
        System.out.println("Servlet name: " + config.getServletName());
    }
    
    @Override
    public ServletConfig getServletConfig() {
        return config;
    }
    
    @Override
    public void service(ServletRequest request, ServletResponse response) 
        throws ServletException, IOException {
        
        // Определяем тип контента
        response.setContentType("text/html; charset=UTF-8");
        
        // Получаем выходной поток
        java.io.PrintWriter out = response.getWriter();
        out.println("<html>");
        out.println("<body>");
        out.println("<h1>Hello from Custom Servlet</h1>");
        out.println("</body>");
        out.println("</html>");
    }
    
    @Override
    public String getServletInfo() {
        return "Custom Servlet v1.0";
    }
    
    @Override
    public void destroy() {
        System.out.println("Servlet is being destroyed");
    }
}

Регистрация Servlet

Способ 1: web.xml (классический)

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    
    <servlet>
        <servlet-name>userServlet</servlet-name>
        <servlet-class>com.example.UserServlet</servlet-class>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>userServlet</servlet-name>
        <url-pattern>/users</url-pattern>
    </servlet-mapping>
    
</web-app>

Способ 2: Аннотация @WebServlet (современный)

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

@WebServlet(
    name = "userServlet",
    urlPatterns = {"/users", "/users/*"},
    loadOnStartup = 1
)
public class UserServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, 
                        HttpServletResponse response) {
        // Обработка
    }
}

HttpServlet vs Servlet

Типичный поток обработки запроса

// 1. Клиент отправляет GET запрос: /users?id=123

// 2. Контейнер находит соответствующий HttpServlet

// 3. Контейнер вызывает service() (определён в HttpServlet)

// 4. service() определяет HTTP метод (GET) и вызывает doGet()

// 5. doGet() обрабатывает запрос:
@Override
protected void doGet(HttpServletRequest request, 
                     HttpServletResponse response) {
    String userId = request.getParameter("id"); // "123"
    response.setContentType("application/json");
    response.getWriter().print("{\"id\":\"123\"}");
}

// 6. Контейнер отправляет ответ клиенту

Примеры использования

// REST API сервлет
@WebServlet("/api/users")
public class UserApiServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, 
                        HttpServletResponse response) throws IOException {
        response.setContentType("application/json");
        response.getWriter().print(
            "[{\"id\":1,\"name\":\"Alice\"}, {\"id\":2,\"name\":\"Bob\"}]"
        );
    }
    
    @Override
    protected void doPost(HttpServletRequest request, 
                         HttpServletResponse response) throws IOException {
        // Создание нового пользователя
        String name = request.getParameter("name");
        response.setStatus(HttpServletResponse.SC_CREATED);
        response.getWriter().print("{\"id\":3,\"name\":\"" + name + "\"}");
    }
}

// Сервлет обработки форм
@WebServlet("/login")
public class LoginServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest request, 
                         HttpServletResponse response) throws IOException {
        String username = request.getParameter("username");
        String password = request.getParameter("password");
        
        if (isValidUser(username, password)) {
            response.sendRedirect("/dashboard");
        } else {
            response.sendRedirect("/login?error=invalid");
        }
    }
    
    private boolean isValidUser(String username, String password) {
        return "admin".equals(username) && "password123".equals(password);
    }
}

Key Takeaway

Servlet — это интерфейс, определяющий контракт для обработки веб-запросов. На практике разработчики используют HttpServlet — абстрактный класс, который реализует интерфейс Servlet и предоставляет удобные методы (doGet, doPost, и т.д.) для работы с HTTP. Понимание интерфейса Servlet критично для знания основ веб-разработки на Java и работы с контейнерами сервлетов (Tomcat, Jetty).