优秀的编程知识分享平台

网站首页 > 技术文章 正文

Spring MVC中提供了哪些扩展机制?如何使用这些扩展机制?

nanyue 2024-12-25 14:43:04 技术文章 5 ℃

在Spring MVC中提供了一系列扩展机制,允许开发者根据应用需求进行自定义和增强,它们为处理请求、响应、视图渲染、异常处理、数据转换等提供了各种可插拔的方式来实现扩展操作。这些扩展机制使得Spring MVC既可以应对常见的Web应用场景,也可以根据需要灵活调整。下面我们就来介绍一下如何使用这些扩展机制。

自定义 Handler Mapping

Spring MVC中默认提供了多种HandlerMapping实现,比如RequestMappingHandlerMapping,用于映射@RequestMapping注解的处理器。在实际操作中开发者可以自定义HandlerMapping来处理自定义的请求映射逻辑,如下所示,给出了一个自定义的扩展操作。

import org.springframework.web.servlet.handler.AbstractHandlerMapping;
import javax.servlet.http.HttpServletRequest;

public class CustomHandlerMapping extends AbstractHandlerMapping {

    @Override
    protected Object getHandlerInternal(HttpServletRequest request) throws Exception {
        // 根据自定义逻辑返回对应的处理器
        if (request.getRequestURI().contains("custom")) {
            return new CustomController();
        }
        return null;
    }
}

Handler Adapter(处理器适配器)

Spring MVC提供了不同类型的HandlerAdapter,用于处理不同类型的控制器,例如比较常用的注解控制器、简单的HttpRequestHandler等

开发者可以通过实现HandlerAdapter接口,定义新的处理器调用机制,比如针对特定的控制器类型提供自定义调用逻辑。

import org.springframework.web.servlet.HandlerAdapter;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class CustomHandlerAdapter implements HandlerAdapter {

    @Override
    public boolean supports(Object handler) {
        // 检查是否是自定义处理器
        return handler instanceof CustomController;
    }

    @Override
    public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // 处理自定义逻辑
        ((CustomController) handler).process(request, response);
        return null;
    }

    @Override
    public long getLastModified(HttpServletRequest request, Object handler) {
        return -1;
    }
}

自定义 View Resolver

视图解析器,主要的作用是用于将视图名称解析为实际的视图对象,最终渲染结果返回给客户端。常见的实现包括InternalResourceViewResolver(用于 JSP)、ThymeleafViewResolver(用于 Thymeleaf)等。

开发者可以自定义 ViewResolver 来支持不同的视图技术,或根据特定的业务规则选择视图,如下所示。

public class CustomViewResolver implements ViewResolver {
    @Override
    public View resolveViewName(String viewName, Locale locale) throws Exception {
        if (viewName.startsWith("jsonView")) {
            return new JsonView();
        }
        return null;
    }
}

自定义 Interceptor

过滤器,的作用用于在请求处理流程的不同阶段插入额外的逻辑。类似于Servlet过滤器,使得HTTP请求处理更加灵活。

开发者可以实现HandlerInterceptor接口,创建拦截器,用于处理权限检查、日志记录、性能监控等。

import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class CustomInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // 在请求处理之前执行
        System.out.println("Pre Handle logic");
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        // 在请求处理之后执行
        System.out.println("Post Handle logic");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // 在请求完成后执行(如视图渲染完毕)
        System.out.println("After completion logic");
    }
}

注册拦截器

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

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new CustomInterceptor());
    }
}

自定义 Message Converter

Spring MVC 提供了一系列HttpMessageConverter实现来处理不同的数据格式,用于将请求数据例如 JSON、XML转换为Java对象,或者将Java对象转换为响应数据。比如MappingJackson2HttpMessageConverter(用于 JSON)、Jaxb2RootElementHttpMessageConverter(用于 XML)等。

我们可以通过自定义HttpMessageConverter来处理自定义格式的请求和响应,比如自定义的二进制数据、加密格式等。下面我们创建自定义的HttpMessageConverter 来处理自定义的序列化与反序列化格式。

import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.converter.HttpMessageConverter;
import java.io.IOException;

public class CustomMessageConverter implements HttpMessageConverter<Object> {

    @Override
    public boolean canRead(Class<?> clazz, MediaType mediaType) {
        // 检查是否支持读取
        return mediaType.equals(MediaType.APPLICATION_JSON);
    }

    @Override
    public boolean canWrite(Class<?> clazz, MediaType mediaType) {
        // 检查是否支持写入
        return mediaType.equals(MediaType.APPLICATION_JSON);
    }

    @Override
    public List<MediaType> getSupportedMediaTypes() {
        return Collections.singletonList(MediaType.APPLICATION_JSON);
    }

    @Override
    public Object read(Class<?> clazz, HttpInputMessage inputMessage) throws IOException {
        // 自定义读取逻辑
        return new ObjectMapper().readValue(inputMessage.getBody(), clazz);
    }

    @Override
    public void write(Object o, MediaType contentType, HttpOutputMessage outputMessage) throws IOException {
        // 自定义写入逻辑
        new ObjectMapper().writeValue(outputMessage.getBody(), o);
    }
}

注册MessageConverter

import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import java.util.List;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        converters.add(new CustomMessageConverter());
    }
}

自定义Exception Resolver

Spring MVC提供了几种异常处理机制,如@ExceptionHandler注解用于局部控制器的异常处理,全局异常处理通过实现 HandlerExceptionResolver接口实现。

可以自定义HandlerExceptionResolver来处理全局异常,如日志记录、返回自定义的错误视图或 JSON 格式的错误信息等。

public class CustomExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        ModelAndView mv = new ModelAndView();
        mv.addObject("error", ex.getMessage());
        mv.setViewName("errorView");
        return mv;
    }
}

总结

Spring MVC 提供了多种扩展机制,如HandlerMapping、HandlerAdapter、ViewResolver、Interceptor、MessageConverter 和 ExceptionResolver,这些机制可以帮助开发者根据需求进行高度定制化的开发。每个扩展点都提供了相关接口或类,通过实现这些接口或扩展这些类,可以灵活地实现自定义功能。

最近发表
标签列表