[Java优选系列第2弹]SpringMVC入门教程:从零开始搭建一个Web应用程序

想和你们分享我眼里的代码世界️  优选系列持续更新中

一直在等你,你终于来啦

                           绿色代表解释说明                黄色代表重点                红色代表精髓

        SpringMVC是一个基于Java的Web框架,它使用了MVC(模型-视图-控制器)的设计模式,将Web应用程序分为三个层次:模型层负责封装业务逻辑和数据,视图层负责展示用户界面,控制器层负责处理用户请求和调用模型层和视图层。

        本文将详细介绍如何使用SpringMVC来开发一个简单而优雅的Web应用程序。我们将从创建一个Maven项目开始,然后配置SpringMVC所需的依赖和文件,接着编写控制器类和视图页面,最后运行我们的应用程序。通过本文,你将能够快速入门和掌握SpringMVC的核心概念和功能。


目录

一、Maven简介及安装

二、 SpringMVC的基本使用

(一)SpringMVC简介

(二)SpringMVC项目的基础搭建

1.引入坐标

2.编写一个初始化类

3.编写配置类,SpringConfig.java

4.编写配置类,WebConfig.java

5.编写Controller类

三、SpringMVC框架提供的高效功能

(一)请求参数及其属性

(二)bean对象自动生成get、set、构造器

(三)数据校验

(四)异常处理

(五)拦截器

1️⃣常用注解大全

2️⃣常用配置文件方法大全

3️⃣常用坐标配置大全


一、Maven简介及安装

        maven是用于管理项目所依赖的jar包。以前我们用到别人开发的jar包,需要自己去找jar包,并且手动导入到项目中。通过Maven,我们只需要在Web项目中的pom.xml文件中导入坐标(告诉Maven这个包在哪),就会自动导入jar包。使用maven的jar包时,maven先中本地仓库中去查找,如果找不到,再去中央仓库中去查找。

        坐标格式如下:


    commons-dbutils
    commons-dbutils
    1.7

        maven配置和安装非本文重点,可以参考这个博客:史上最全安装Maven教程_mvnw 按照_小Du猿的博客-CSDN博客

二、 SpringMVC的基本使用

(一)SpringMVC简介

        SpringMVC是一个表现层(Servlet层)框架,主要用于处理前端发来的请求。它代替了第1弹中([Java优选系列第1弹]如何优化Java三层架构开发效率?三个实用技巧分享_高垚淼的博客-CSDN博客),我们所说的使用单纯Servlet来进行开发的模型,极大的提高了开发效率。

       使用SpringMVC有以下几个优点:

        它与Spring框架完美集成,可以利用Spring的依赖注入、事务管理、安全等特性。

        它支持多种视图技术,如JSP、Thymeleaf、Freemarker等,可以灵活地选择适合的视图渲染方式。

        它提供了丰富的注解和接口,可以方便地实现请求映射、参数绑定、数据校验、异常处理等功能。

        它采用前端控制器模式,通过一个DispatcherServlet来统一处理所有的HTTP请求,并将它们分发给相应的处理器,从而简化了Web开发流程。(将在第三弹专门发布一篇文章,解析SpringMVC的底层实现机制

        在实际开发中,使用注解进行SpringMVC项目的创建更广泛,因此,本文基于注解开发的方式进行讲解,基于xml方式不进行赘述。

(二)SpringMVC项目的基础搭建

1.引入坐标

打开pom.xml文件,并添加以下语句,引入构建SpringMVC项目的jar包。

		
			org.springframework
			spring-webmvc
			5.3.24
		

2.编写一个初始化类

        单独新建一个类,继承AbstractAnnotationConfigDispatcherServletInitializer类并实现其三个默认方法。

public class WebInit extends AbstractAnnotationConfigDispatcherServletInitializer {
	/**
	 * 配置spring的配置类
	 * @return
	 */
	@Override
	protected Class[] getRootConfigClasses() {
		return new Class[]{SpringConfig.class};
	}

	/**
	 * 配置一个springmvc的配置类
	 * @return
	 */
	@Override
	protected Class[] getServletConfigClasses() {
		return new Class[]{WebConfig.class};
	}

	/**
	 * 配置一个路径,告诉tomcat哪些请求要交给springmvc来处理
	 * /  所有的请求都交给springmvc处理
	 * @return
	 */
	@Override
	protected String[] getServletMappings() {
		return new String[]{"/"};
	}
}

3.编写配置类,SpringConfig.java

创建一个config包,在包中编写配置类,SpringConfig.java(名字可以随便取)。

//@Configuration标识这是一个配置类
@Configuration
public class SpringConfig {
}

4.编写配置类,WebConfig.java

在config包中编写配置类,WebConfig.java。

//@Configuration标识这是一个配置类
@Configuration
//配置一个要扫描的包
@ComponentScan("com.woniu.springmvc")
public class WebConfig {
}

5.编写Controller类

创建一个controller包,编写处理请求的Controller类。

//这是一个控制器类,用于处理前端发来的请求
@Controller
public class HelloController {

	//把返回的内容直接返回给浏览器(默认情况下,会去找相应的文件)
	@ResponseBody
	//指定处理哪个路径的请求
	@RequestMapping("/test")
	public String test(){
		System.out.println("请求来了");
		return "woniu蜗牛";
	}

}

        这样我们就完成了一个最基本的SpringMVC项目的创建,只需要在 Controller类中编写接收请求的各种方法即可。

三、SpringMVC框架提供的高效功能

(一)请求参数及其属性

@RequestParam注解标识获取前端传过来的参数

@ResponseBody注解标识直接返回数据的内容给前端(不加,默认是返回网页资源)

@ResponseBody
@RequestMapping("/test")
public String test(
    //@RequestParam指定要获取哪一个参数
    //value/name指定参数名称
    //required是否为必须传的参数,默认是true
    //defaultValue在没传参数的情况下,指定一个默认值。
    @RequestParam(value = "name",required = false) String name,
				   @RequestParam(value = "age",required = false,defaultValue = "100") Integer age){
	System.out.println(name+":"+age);
	return "woniu蜗牛";
}

//大多数情况下
@ResponseBody
@RequestMapping("/test1")
public String test1(String name,Integer age){//简写,要求形参名必须和参数名一样
	System.out.println(name);
	System.out.println(age);
	return "test1";
}

(二)bean对象自动生成get、set、构造器

  • 导入坐标,lombok

	
		org.projectlombok
		lombok
		1.18.26
	

  • 给bean对象加上注释@get、@set、@ToString、@NoArgsConsturctor(以上可以用@Data替换)、@AllArgsConsturctor

(三)数据校验

  • 引入坐标
  • 在验证的实体类的属性上,标注相应注解如@min(value = 10)
  • 在方法的参数中为要验证的实体类,标注相应注解@valid

  • 获取错误消息,添加参数BindingResault,这个参数必须放在验证类参数的后面一个

[Java优选系列第2弹]SpringMVC入门教程:从零开始搭建一个Web应用程序_第1张图片

  •  可以自定义错误信息,在注解中写  

[Java优选系列第2弹]SpringMVC入门教程:从零开始搭建一个Web应用程序_第2张图片

(四)异常处理

  • 加上注解@EsceptionHandler,处理当前类。出异常会自动运行

[Java优选系列第2弹]SpringMVC入门教程:从零开始搭建一个Web应用程序_第3张图片

 

  • 全局异常处理:单独创建一个处理异常类并加上@RestControlleAdvice注解标识,放入同一个异常处理方法(别忘记注解)

  • 全局异常和局部异常处理,依旧遵循就近原则

(五)拦截器

  • 编写拦截器类实现HandlerInterceptor接口,并实现其中的三个方法 

[Java优选系列第2弹]SpringMVC入门教程:从零开始搭建一个Web应用程序_第4张图片

        PreHandle() 返回true才会继续执行postHandl()和afterCompletion();postHandl()执行完才会继续执行afterCompletion()。可以用于进行登录检查、权限验证等操作

        PostHandl() 可以给请求绑定数据。可以用于对模型数据或视图进行处理或修改。该方法的参数modelAndView是一个模型和视图对象,包含了控制器方法返回的数据和视图名称。 

[Java优选系列第2弹]SpringMVC入门教程:从零开始搭建一个Web应用程序_第5张图片

        afterCompletion() ,可以接收异常。用于进行一些资源清理、性能监控等操作。该方法的参数ex是一个异常对象,表示控制器方法或视图渲染过程中抛出的异常,如果没有异常,则为null。

  • 在配置类中,添加拦截器

[Java优选系列第2弹]SpringMVC入门教程:从零开始搭建一个Web应用程序_第6张图片

附录:

1️⃣常用注解大全

  1. @AllArgsConstructor 标识bean对象生成全参构造器
  2. @NoArgsConstructor 标识bean对象生成无参构造器
  3. @Configuration 标识是配置类
  4. @Controller 标识是控制层
  5. @ComponentScan("全类名") 标识作用的控制层
  6. @Data 标识bean对象自动生成get、set、toStirng、无参构造器方法(注意:如果@Data和@AllArgsConstructor一起使用,无参构造器会被覆盖,需要手动再创建一次@NoArgsConstructor)
  7. @ExceptionHandler 用于处理控制器中发生的异常,可以指定异常类型和返回值
  8. @RestControllerAdvice 标识该类中的异常方法作用于全局(类似于RestController,等价于@ResponseBody+ControllerAdvice)
  9. @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss") 标识自动转成指定格式(注意,前端的格式需要与此对应,可用value-format)
  10. @ModelAttribute 用于绑定请求参数到模型属性上,可以在方法或参数上使用
  11. @PathVariable 标识将(形如:/xx/1 )请求中的参数绑定到方法参数上
  12. @RequestBody 标识将接收的Json字符串转为Java对象
  13. @RequestMapping(value = "路径" , Method = RequestMethod.post) 标识访问的url路径(使用@getMapping、@postMapping代替)
  14. @ResponseBody 标识将该变量直接返回给页面
  15. @RestController 作用等于@ResponseBody+@Controller
  16. @RequestParam 标识将(形如:/xx?name=1 )请求中的参数绑定到方法参数上(如果请求参数和方法参数相同,可以省略)
  17. @SessionAttributes(value = "xx") 标识存储数据到Map(Request请求域)中时,同时放入到Session域中

2️⃣常用配置文件方法大全

  1. 打开页面网页资源的访问权限
@Override
    protected void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }

     2.添加自定义格式化器和转换器

protected void addFormatters(FormatterRegistry registry) {
        super.addFormatters(registry);
        registry.addConverter(new DateConverter());
    }

    3. 后端中,将对象转为Json字符串。用于扩展或修改已有的消息转换器列表

protected void extendMessageConverters(List> converters) {
        //添加一个消息转换器,可以把对象自动转换成json
        converters.add(new MappingJackson2HttpMessageConverter());
    }

(这里想和大家分享的是,前端使用Axios发送携带对象的请求,会自动转为Json字符串发送;接收携带Json字符串的相应,会自动转为对象。这真的很好用,都不用转来转去了) 

3️⃣常用坐标配置大全

   1.使用SpringMVC框架


			org.springframework
			spring-webmvc
			5.3.24
		

   2.后端对象转为Json字符串


    com.fasterxml.jackson.core
    jackson-databind
    2.14.1

    3.Bean对象生成set、get等方法

	
		org.projectlombok
		lombok
		1.18.26
	

   4.处理LocalDateTime

	
		com.fasterxml.jackson.datatype
		jackson-datatype-jsr310
		2.14.2
	

   5.数据校验

		
			org.hibernate.validator
			hibernate-validator
			6.2.5.Final
		

   6.文件上传

		
			commons-fileupload
			commons-fileupload
			1.3.3
		

                                以上就是本文的全部内容啦,确定不来个点赞和收藏嘛~ 

 

你可能感兴趣的:(Java,java,开发语言,SpringMVC,mvc,spring)