SpringMVC将Servlet的一些通用功能进行了抽取和封装,代码由两部分组成:前端控制器(由SpringMVC提供,主要负责:接收参数+返回数据)+处理器(调用业务层代码),核心依赖spring-webmvc(springboot中自动配置,用spring-boot-starter-web)
在项目中添加web环境的初始类和核心配置类,其中注解@EnableWebMvc,用以开启springmvc,但利用springboot快速开发项目不写该注解,而是直接定义WebMvcConfig去implements继承WebMvcConfigurer,类里面写一些有关拦截器的代码、设置静态资源映射的代码、消息转换器代码(java对象序列化为json数据),生成接口文档的有关文档
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {// 注册拦截器@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new MyInterceptor()).addPathPatterns("/**");}// 配置静态资源映射@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/");}// 配置消息转换器@Overridepublic void configureMessageConverters(List<HttpMessageConverter<?>> converters) {MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();converter.setObjectMapper(new ObjectMapper().configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false));converters.add(converter);}// 配置Swagger文档生成器@Beanpublic Docket api() {return new Docket(DocumentationType.SWAGGER_2).select().apis(RequestHandlerSelectors.basePackage("com.example.demo.controller")).paths(PathSelectors.any()).build().apiInfo(apiInfo());}private ApiInfo apiInfo() {return new ApiInfoBuilder().title("Spring Boot REST API").description("Demo API文档").version("1.0.0").build();}
}
上述代码中,创建WebMvc的java类,通过实现WebMvcConfiguration接口来配置Spring MVC。
1.在这个类中通过重写addInterceptors方法,注册了一个名为MyInterceptor的拦截器,并将其应用到所有请求路径(即“/**”).
2.重写了addResourceHandler方法,设置了一个静态资源映射,将所有以"/static"开头的请求路径映射到"classpath:/static/"路径下的资源文件
3.重写configureMessageConverters方法:添加一个Jackson消息转换器,将java对象序列化为Json数据
4.api方法与apiInfo方法,使用Swagger定义了一个API文档生成器,并设置了标题、描述、版本等基本信息。(还需要安装springfox-swagger-ui
和springfox-swagger2
依赖库,并将其添加到项目的依赖中。)
springmvc整体的流程就是前端发送请求到前端控制器,前端控制器解析请求,获取访问路径和参数,并根据路径寻找并调用对应的处理器方法,如果发现方法需要参数,就给予传递到处理器代码部分,处理器业务处理后return返回值给前端控制器,前端控制器接收方法的返回值,转换格式后返回给前端。
常用注解有很多,比如:
@RequestMapping 通用注解,可以标注在方法上也可以标注在类上,标注在类上表示所用方法共用的一段URL,该注解会建立请求URL(Uniform Resource Locator)和处理器方法之间的对应关系,value绑定方法,method很少使用用于限制请求类型一般忽略不限制。
@RestController=@Controller+@ResponseBody 返回值类型转换为json数据格式,并在表示层将其返回给浏览器
我们通常还会自定义一个统一的异常处理类来处理异常(springmvc带来的便利,不用三层代码中处理,而是直接抛给框架),实现依靠两个注解
@RestControllerAdvice 标注在类上,声明当前类是一个用于专门处理异常的类
@ExceptionHandler 标注上述类的方法上,声明当前方法可以处理哪些异常。