Spring Boot中WebMvcConfig配置详解及示例代码

@Override
protected void addResourceHandlers(ResourceHandlerRegistry registry) {
    // 将/doc.html映射到classpath:/META-INF/resources/目录下
    registry.addResourceHandler("doc.html").addResourceLocations("classpath:/META-INF/resources/");
    // 将/webjars/**映射到classpath:/META-INF/resources/webjars/目录下
    registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
    // 将/backend/**映射到classpath:/backend/目录下
    registry.addResourceHandler("/backend/**").addResourceLocations("classpath:/backend/");
    // 将/front/**映射到classpath:/front/目录下
    registry.addResourceHandler("/front/**").addResourceLocations("classpath:/front/");
}

@Override
protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
    // 创建消息转换器对象，这里使用了自定义的JacksonObjectMapper
    MappingJackson2HttpMessageConverter messageConverter = new MappingJackson2HttpMessageConverter();
    messageConverter.setObjectMapper(new JacksonObjectMapper()); // 假设JacksonObjectMapper是自定义的ObjectMapper实现类
    // 将自定义的消息转换器添加到转换器列表的最前面，这样它会优先被使用
    converters.add(0, messageConverter);
}

@Bean
public Docket createRestApi() {
    return new Docket(DocumentationType.SWAGGER_2) // 指定文档类型为Swagger2
            .apiInfo(apiInfo()) // 设置API文档的基本信息
            .select() // 构建一个ApiSelectorBuilder实例,用来控制哪些接口暴露给Swagger来展现
            .apis(RequestHandlerSelectors.basePackage("com.itheima.reggie.controller")) // 指定扫描的包路径
            .paths(PathSelectors.any()) // 所有路径都被扫描
            .build(); // 构建Docket实例
}

private ApiInfo apiInfo() {
    return new ApiInfoBuilder() // 创建ApiInfoBuilder实例,用来构建ApiInfo对象(API文档的基本信息)
            .title("瑞吉外卖") // 设置标题
            .version("1.0") // 设置版本号
            .description("瑞吉外卖接口文档") // 设置描述信息
            .build(); // 构建ApiInfo实例并返回
}