整合SSM框架必备基础—SpringMVC(下)
在上一篇文章《整合SSM框架必备基础—SpringMVC(上)》中,胖达介绍了关于SpringMVC的诞生、优势以及执行流程等理论知识点,这篇文章打算在实操中加深一下对SpringMVC的认识,毕竟实践才是学习技术最有效的方法嘛,Let's Go!
一、 首先来创建一个Web小项目吧
JDK版本:jdk1.7.0_07
开发环境:Intellij IDEA v2018.03
首先需要在IDEA的项目列表页面新建一个Web项目,这里IDEA给我们提供了众多的项目模板,只要选择了相应的模板就可以快速新建一个项目骨架,在这里,我们可以首先通过一个webapp模板新建Web项目,步骤如下:
1.创建新项目
2.通过Maven模板选择,新建项目骨架
3.为组织和项目新建唯一标志符
4.选择本地或者默认的Maven及其版本
5.确定项目名称以及项目新建的位置即可
6.生成的Web项目目录
在上述步骤完成后,点击Finish,即可成功利用模板生成了一个简易的Web项目骨架,其生成的项目目录如下图所示:
二、SpringMVC的配置要经历哪些过程呢?
1.在pom.xml中配置Maven依赖
配置SpringMVC首先需要添加该框架所需的Maven依赖(即jar文件),思考一下SpringMVC的运行需要哪些jar包的支持呢?我们需要把这些依赖都添加到pom.xml文件中,才可进行SpringMVC项目的构建,下面我整理了一份,虽然不是很全但是够用。
添加依赖之前,首先需要在pom.xml中的properties标签属性中标记一下Spring的版本,如果像我一样额外引入了Hibernate,顺便标记一下Hibernate的版本哈,配置如下:
<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>1.7</maven.compiler.source> <maven.compiler.target>1.7</maven.compiler.target> <spring.version>4.2.6.RELEASE</spring.version> <hibernate.version>5.1.0.Final</hibernate.version> </properties>
然后在这个文件中添加dependency依赖,依赖文件的配置如下:
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>4.2.5.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework.data</groupId> <artifactId>spring-data-jpa</artifactId> <version>1.10.1.RELEASE</version> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-entitymanager</artifactId> <version>${hibernate.version}</version> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-c3p0</artifactId> <version>${hibernate.version}</version> </dependency> <dependency> <groupId>com.mchange</groupId> <artifactId>c3p0</artifactId> <version>0.9.5.2</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.39</version> </dependency>
另外,如果你pom.xml文件中build属性标签中没有关于maven编译打包的插件maven-compiler-plugin这一项,你还需要添加一个关于它的配置,因为没有它你的Maven是没办法给你编译项目源代码的,但是如果有的话你可以自动忽略掉,配置内容如下:
<build> <finalName>springmvcdemo</finalName> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build>
2.web.xml文件的配置
对于一个Web项目,web.xml是这个项目的整体配置文件,需要在这个文件中添加相关的一些配置,例如DispatcherServlet配置、字符集编码设置过滤器、错误跳转页面等等,其中DispatcherServlet做为框架的入口,是使用SpringMVC必需的配置;encodingFilter过滤器是为了处理请求中的中文,防止出现乱码。
配置代码如下:
<?xml version="1.0" encoding="UTF-8"?> <web-app> <display-name>Archetype Created Web Application</display-name> <!--根目录跳转-欢迎页面--> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <!--编码过滤器--> <filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> <init-param> <param-name>forceEncoding</param-name> <param-value>true</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!--错误页面跳转--> <error-page> <!-- 路径不正确 --> <error-code>404</error-code> <location>/WEB-INF/errorpage/404.jsp</location> </error-page> <error-page> <!-- 没有访问权限,访问被禁止 --> <error-code>405</error-code> <location>/WEB-INF/errorpage/405.jsp</location> </error-page> <error-page> <!-- 内部错误 --> <error-code>500</error-code> <location>/WEB-INF/errorpage/500.jsp</location> </error-page> <!--SpringMVC入口配置--> <servlet> <servlet-name>spring-mvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <!--此处后面会有说明--> <!--<init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/springmvc-servlet.xml</param-value> </init-param>--> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>spring-mvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
3.SpringMVC自身xml文件配置
SprignMVC自身也存在一个配置文件,如果你的项目中不包含这个配置文件,可以通过IDEA自带的方式去生成,步骤如下图所示:
(1)在WEB-INF根目录下点击右键
(2)点击New在右侧找到XML Configuration File
(3)点击后找到Spring Config
(4)为XML配置文件命名,例如:XXX-servlet.xml即可,命名时需要注意SpringMVC会默认去找/WEB-INF/XXX-servlet.xml这个XML,其中XXX是上述Web.xml中所配置的servlet-name名称,如果不想用这个作为配置文件的名称,且不想用-servlet为后缀,就需要在Web.xml中配置contextConfigLocation来指定文件路径,例如:
<!--SpringMVC入口配置--> <servlet> <servlet-name>spring-mvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <!--此处就必须添加了--> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/springmvc-servlet.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>spring-mvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>
新建了配置文件,IDEA并不会默认生成所有配置,我们最终还是看到一个空空的XML文件,需要对其配置进行手动添加,添加之前首先搞清楚这个配置文件到底能有啥用途呢?
(1)配置自动扫描的包路径,通过这项配置,自动扫描某个包下的Controller控制器,方便管理Bean,并在请求的时候快速定位Controller并访问。
(2)注解映射支持配置即注解开关,只有配置了这一项,注解才能有效果。
(3)配置视图解析器,通过视图解析器可以给请求页面添加前缀和后缀,而不用每次SpringMVC返回视图的时候再去单独指定前缀、后缀,例如:
<bean id="viewResolver" class="org.springframework.web.servlet.view.UrlBasedViewResolver"> <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/> <property name="prefix" value="/WEB-INF/pages/"/> <property name="suffix" value=".jsp"/> </bean>
(4)配置静态资源文件的访问,如果 DispatcherServlet 拦截了所有的请求,同时对.js,.jpg的访问也会被拦截,导致运行时跳转后的页面无法加载静态资源文件,这时需要对静态资源文件的访问进行配置。
(5)配置上传文件数据解析器,方便管理上传数据的信息,包括文件的格式、最大最小数据量等等,例如:
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="maxUploadSize" value="10485760"/> <property name="defaultEncoding" value="UTF-8"/> </bean>
(6)配置全局异常处理器,针对异常处理做统一的处理和维护,并对一些特殊异常做特殊处理,例如:
<!-- 全局异常处理器,实现HandlerExceptionResolver接口就是全局异常处理器--> <bean class="com.eurasia.exception.CustomExceptionResolver"></bean>
(7)自定义参数类型绑定,SpringMVC框架可以实现传参到Controller请求方法中返回视图和参数的功能,在Controller中可以完成对于参数的处理,例如你的参数是一个实体类,其中的某个字段需要转换为Date,这时可以通过配置自定义转换器来实现参数转换,例如:
<bean id="objectMapper" class="com.fasterxml.jackson.databind.ObjectMapper"> <property name="dateFormat"> <bean class="java.text.SimpleDateFormat"> <constructor-arg type="java.lang.String" value="yyyy-MM-dd HH:mm:ss" /> </bean> </property> </bean>
明确了这些用途,在来看看文件中应该如何具体的进行配置,配置内容如下(上述某些用途的配置在当前小项目中没有用到,所以未提供相关配置):
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:mvc="http://www.springframework.org/schema/mvc" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd"> <!--指明 controller 所在包,并扫描其中的注解--> <context:component-scan base-package="hello"/> <!-- 静态资源(js、image等)的访问 --> <mvc:default-servlet-handler/> <!-- 开启注解 --> <mvc:annotation-driven/> <!--ViewResolver 视图解析器--> <!--用于支持Servlet、JSP视图解析--> <bean id="jspViewResolver" class="org.springframework.web.servlet.view.UrlBasedViewResolver" <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/> <property name="prefix" value="/WEB-INF/pages/"/> <property name="suffix" value=".jsp"/> </bean> </beans>
注意:如果你生成的配置文件在加入这些标签时报错,记得检查你的xmlns:mvc和xmlns:context头信息,把它们补全即可
4.创建我们的Controller控制器
在src/main目录下新建包名,例如com.hello这样,然后在下面新建一个java文件HiController.java,这个就是我们新建的第一个Contrller控制器,通过这个控制器,就可以向前台传递ModelAndView,当然你也可以指定view路径最终呈现给用户一个展示的界面。
前面我们已经启用了SpringMVC提供的注解功能,那我们在这里就可以直接用注解来注释我们的控制器,这样才能识别到这个控制器,代码呈上:
@Controller @RequestMapping("/hello") public class HiController { /** * 测试返回指定的view文件名 * @return */ @RequestMapping("/welcome") public String helloWorld() { return "welcome"; } /** * 测试返回带有数据的ModelAndView对象 * @return */ @RequestMapping("/view") public ModelAndView getView() { String message = "<br><div style='text-align:center;'>" + "<h3>我叫胖达,来自HiController.java(公众号:Java知识共享)</h3>"; return new ModelAndView("welcome", "message", message); } }
这里Controller最终是要向前台的界面返回数据或者调起某个界面的,所以必须在前台也要指定一个页面,我在webapp下的WEB-INF中创建了一个pages文件夹专门存放前台的页面,这里暂时先放一个welcome.jsp页面,给大家打个招呼,页面内容如下:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> Hi! ${message}</body> </html>
根据前台和后台的这两段代码,看懂的小伙伴应该知道了我的演示效果,等我启动起来项目再展示哈。
5.配置Tomcat,启动小项目
我已经迫不及待的要启动我的项目了,IDEA中配置tomcat的步骤其实很简单,如果你pom.xml中引入maven-tomcat插件,可能会更简单,这里我用传统外部tomcat的方式吧。
首先点击右上角的edit Configurations按钮:
这样就打开了run/debug Configurations窗口,在这个窗口继续操作如下:
特别注意:第四个步骤是为了选择本地的tomcat路径哈,直接选择自己的外部tomcat,选择根路径即可。
然后还有一步就是需要选择tomcat启动的时候需要Deployment也就是要发布的应用,按照下述步骤1-6即可:
到此,tomcat配置成功,直接点击右上角,启动我们的小项目即可。
由于前面配置了欢迎界面,当系统启动成功后我会自动访问index.jsp欢迎页面,并成功展示HelloWorld字样,接下来我们要依次访问一下我们控制器中写的两个方法:
第一个方法
访问路径:
http://localhost:8088/SpringMVCStarter/hello/welcome
访问结果:
结论:在上面后端的代码中会发现,我只是指定了一个view的路径welcome,结果会自动跳转出welcome.jsp的原有内容,说明我们的调用成功了
第二个方法
访问路径:
http://localhost:8088/SpringMVCStarter/hello/view
访问结果:
结论:与第一个不同的是,这个方法会跳转同一个界面welcome.jsp,但是后台我返回的是ModelAndView对象,这样的话,后台会将数据和视图经过渲染后一并呈现给用户,如上图黑色字体为后台传递到前台的数据。
三、 SpringMVC的几种注解
提及SpringMVC,不得不顺便啰嗦一下它的注解,确实非常好用,常用的几个重要注解如下:
1.Controller
这个可以说是最重要的一个注解了,主要用于标识是Controller处理器类.表示把我的控制器对象交给Spring来创建。
2.RequestMapping
请求映射的注解,也就是标记请求路径名的重要注解,就比如我们小项目中的hello和welcome用法,当然还有指定其他参数的用法,例如请求方式是post还是get,都可以在这个注解中标明。
3.RequestParam
这个注解的功能主要是给参数设置默认值,或者给参数定义别名,只要别名和页面传递参数匹配即可传递成功,例如:
@RequestParam(defaultValue="1",value="myid")
它的配置项主要包含:
(1) value:参数名字,即入参的请求参数名字,如value=“studentid”表示请求的参数区中的名字为studentid的参数的值将传入;
(2) required:是否必须,默认是true,表示请求中一定要有相应的参数,否则将报400错误码;
(3) defaultValue:默认值,表示如果请求中没有同名参数时的默认值
4.Redirect
通过这个注解,Contrller方法返回结果重定向到一个url地址,例如redirect:/user/add.do即可跳转到这个add.do指定的相应页面。
5.Forward
利用这个注解,Controller方法执行后还会继续执行另一个controller方法,例如return “forward:/user/userlist.do”;,就会去执行其他的userlist这个方法
6.RequestBody/ResponseBody
如果要用到json传递数据,那这个注解是非常重要的,其实也是日常开发必须的一个注解。
其中@RequestBody注解用于读取http请求的内容(字符串),通过springmvc提供的HttpMessageConverter接口将读到的内容转换为json、xml等格式的数据并绑定到controller方法的参数上。
@RequestBody注解实现接收http请求的json数据,将json数据转换为java对象,但是@RequestBody/@ResponseBody一般要依赖Jackson使用。
四、总结
关于SpringMVC的整个访问流程在上篇文章中简单介绍了一下,这篇文章也通过搭建流程、创建配置文件的方式做了一个简单的介绍,假想我们从访问一个Controller控制器的url出发,首先通过web.xml中的入口DispatchServlet进入了SpringMVC这个框架的流程,再通过框架内的HandlerMapping、HandlerAdapter找到我们提前通过注解注入的Controller方法,执行完成后返回带着数据的ModelAndView对象,在通过我们配置的ViewResolver给我们view路径添加上前缀后缀,最终做一些数据和视图的渲染工作,就可以将一个期待的效果页面展现给我们了,这个过程是不是很清晰?其实虽然写了那么多,但是对于SpringMVC内部的处理情况还是有一点点疑问,以后有机会我会带着疑问跟大家一起去撸一遍源码,或许通过源码才能更加深入的了解到SpringMVC这个神奇的框架,期待ING!!!
- 整合SSM框架必备基础—SpringMVC(上)
- 最基础SSM(spring springmvc mybatis)框架整合入门解析
- springmvc整合mybatis框架源码 bootstrap html5 mysql oracle maven SSM
- SpringMVC的架构的执行流程和ssm框架的整合
- maven整合:最新ssm框架实现spring4.2,springmvc4.2,mybatis3.2
- SpringMVC详解(四)------SSM三大框架整合之登录功能实现
- SSM框架(一)之SSM框架整合(Spring,SpringMVC,MyBatis)
- 学习淘淘商城第十课(SSM框架整合之springmvc整合及父子容器的关系)
- springmvc整合mybatis框架源码 有代码生成器 bootstrap html5 mysql oracle maven SSM
- ssm(springmvc4+spring4+mybatis3)整合实战-个人博客系统-整合各大框架
- SpringMVC详解(四)------SSM三大框架整合之登录功能实现
- SSM 框架 Maven项目 项目整合 SpringMVC
- SSM框架整合( Spring 、 SpringMVC 和 Mybatis )
- maven整合:最新ssm框架实现spring4.2,springmvc4.2,mybatis3.2
- ssm框架的整合(spring ,springMvc,MyBatis)
- SSM框架之SpringMVC(1)--Mybatis和SpringMVC的整合
- 【SSM】SpringMVC、Spring(5.0.3)、MyBatis(3.4.5)三大框架的整合项目入门示例
- springmvc整合mybatis框架源码 bootstrap html5 mysql oracle maven SSM
- SSM基础整合(spring-springMVC-mybatis)
- SSM整合---SpringMVC、Spring、MyBatis三个框架的整合步骤