Какова роль DefaultServletHttpRequestHandler в контексте обработки HTTP-запросов?

Правильно ли я понимаю, что DefaultServletHttpRequestHandler используется для обработки статических ресурсов, если путь к ним не задан через ResourceHandlerRegistry? <br/> <br/> Как настроить его для работы? <br/> <br/> Я уже добавил изображение в проект.
  • 20 апреля 2025 г. 15:25
Ответы на вопрос 2
Да, вы правильно понимаете, что `DefaultServletHttpRequestHandler` в Spring используется для обработки HTTP-запросов к статическим ресурсам (например, изображениям, CSS или JavaScript файлам) по умолчанию. Этот компонент обрабатывает запросы, которые не совпадают с определёнными маршрутами вашего приложения (например, с @Controller или @RequestMapping) и не обрабатываются другими обработчиками.

Если вы не настроили обработку статических ресурсов через `ResourceHandlerRegistry`, то Spring будет использовать `DefaultServletHttpRequestHandler` для передачи запросов к статическим файлам через встроенный Web-сервер (например, Tomcat, Jetty). 

### Настройка DefaultServletHttpRequestHandler

Чтобы вы могли использовать `DefaultServletHttpRequestHandler`, выполните следующие шаги:

1. **Добавление статических ресурсов**: Убедитесь, что ваши статические ресурсы (например, изображения) находятся в правильных директориях вашего проекта. Обычно статические ресурсы помещаются в папки, которые находятся в `src/main/resources/static`, `src/main/resources/public`, `src/main/resources/resources` или `src/main/resources/META-INF/resources`.

2. **Настройки приложения**: Убедитесь, что в вашем приложении есть компоненты, позволяющие Spring обрабатывать статические ресурсы. Это обычно происходит автоматически, но вы также можете явно включить его следующим образом:

   ```java
   @Configuration
   public class WebConfig implements WebMvcConfigurer {
       @Override
       public void addResourceHandlers(ResourceHandlerRegistry registry) {
           registry.addResourceHandler("/**")
                   .addResourceLocations("classpath:/static/");
       }
   }
   ```

   В этом примере все запрашиваемые ресурсы будут обрабатываться из папки `static` в вашем classpath.

3. **Обработка запросов**: Теперь, если вы отправляете запрос к статическому ресурсу (например, `/images/myImage.png`), `DefaultServletHttpRequestHandler` будет отвечать на запрос, если не было других обработчиков, которые смогли бы его обработать.

### Пример

Предположим, у вас есть изображение, которое вы разместили в папке `src/main/resources/static/images/myImage.png`. Теперь, когда вы запускаете приложение и переходите по адресу `http://localhost:8080/images/myImage.png`, Spring будет использовать `DefaultServletHttpRequestHandler` для обработки этого запроса и выдаст вам изображение.

Таким образом, если вы удовлетворительно разместили свои ресурсные файлы и добавили нужную конфигурацию (если требуется), `DefaultServletHttpRequestHandler` сможет обрабатывать запросы к статическим ресурсам автоматом.
Чтобы разобраться в каком-то вопросе, нужно его декомпозировать и очистить изучаемую область от лишних элементов. Поэтому делаем минимальный проект с голым Spring MVC, без всяких там Boot'ов и Thymeleaf'ов. 
Структура каталогов:
.
│   pom.xml
│
└───src
    └───main
        ├───java
        │   └───com
        │       └───example
        │               Config.java
        │               DumbInitializer.java
        │
        └───webapp
                test.txt

pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>q1395400</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>jakarta.servlet</groupId>
            <artifactId>jakarta.servlet-api</artifactId>
            <version>6.1.0</version>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>6.2.6</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.4.0</version>
            </plugin>
            <plugin>
                <groupId>org.eclipse.jetty</groupId>
                <artifactId>jetty-maven-plugin</artifactId>
                <version>11.0.25</version>
                <configuration>
                    <webApp>
                        <contextPath>/</contextPath>
                    </webApp>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Config.java
package com.example;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
@EnableWebMvc
public class Config implements WebMvcConfigurer {
    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }
}

DumbInitializer.java
package com.example;

import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;

public class DumbInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return null;
    }

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[] { Config.class };
    }

    @Override
    protected String[] getServletMappings() {
        return new String[] { "/" };
    }
}

Запускаем командой mvn jetty:run-war , открываем в браузере адрес http://localhost:8080/test.txt и видим содержимое файла test.txt. Без строки configurer.enable() получили бы 404.

Обычно трогать DefaultServletHttpRequestHandler вообще не приходится. Во-первых, Boot автоматически конфигурирует обслуживание статики подходящим для большинства случаев образом. Во-вторых, если уж лезть в это, то следует задать явные маппинги адресов на пути, а не разрешать дефолтному сервлету обслуживать любой запрос, для которого нет обработчика, как запрос к статике.
Похожие вопросы