SSM框架的搭建
做项目之前每次都把大量的时间花在搭建框架上非常地浪费时间,在博客上记录一下框架的搭建步骤,方便以后查找。
这个版本的框架搭建没有使用Maven,纯手动添加jar包,将来会使用Maven构建项目。
开发环境说明
- 操作系统win10
- IDE使用Intellij IDEA 2017.3.4 x64
- jdk9.0.4
- 数据库使用MySQL8.0
- Tomcat9.0.8
接下来正式开始项目搭建
1.打开IDEA开发工具
2.选择Create New Project
3.Java Enterprise—>勾选Web Application,点击Next
4.给项目起个名字,这里是ssmFramework,默认保存在IDEA项目路径中,点击Finish
5.创建完成之后的项目结构并不是很完整,可能是IDEA版本的问题,在创建好的项目当中,web目录下没有WEB-INF文件,也缺少了web.xml文件。所以需要自己手动添加。
6.添加部署描述文件web.xml
具体操作是file—>Project Structure,点击左侧列表Project Settings下面的Modules,点击中间列表的ssmFramework下面的Web,点击右侧的绿色加号按钮,输入web.xml的正确路径,这里是Projects\ssmFramework\web\WEB-INF\web.xml,点击OK。
接下来应用之后会发现项目的结构变成了熟悉的样子。
7.为了方便今后的开发,可以先创建好比较完整的项目结构
添加classes,存放的是编译完之后的java.class文件
添加lib,存放的是项目的jar包
这两个重要的文件夹都在WEB-INF目录下
而且在创建完毕后,更改输出文件的路径,确保是输出在了classes目录下。
8.准备所需要的jar包,根据自己的开发环境选择最适合的版本。
一共是29个jar包,简单介绍一下。
Spring框架所需要的jar包
1. aopalliance-1.0.jar
2. aspectjweaver-1.8.10.jar
3. spring-aop-4.3.6.REALEASE.jar
4. spring-aspects-4.3.6.REALEASE.jar
5. spring-beans-4.3.6.REALEASE.jar
6. spring-context-4.3.6.REALEASE.jar
7. spring-core-4.3.6.REALEASE.jar
8. spring-expression-4.3.6.REALEASE.jar
9. spring-jdbc-4.3.6.REALEASE.jar
10. spring-tx-4.3.6.REALEASE.jar
Mybatis框架所需要的jar包
11. ant-1.9.6.jar
12. ant-launcher-1.9.6.jar
13. asm-5.1.jar
14. cglib-3.2.4.jar
15. commons-logging-1.2.jar
16. javassist-3.21.0-GA.jar
17. log4j-1.2.17.jar
18. log4j-api-2.3.jar
19. log4j-core-2.3.jar
20. mybatis-3.4.2.jar
21. ognl-3.1.12.jar
22. slf4j-api-1.7.22.jar
23. slf4j-log4j12-1.7.22.jar
Mybatis与Spring整合的中间jar包
24. mybatis-spring-1.3.1.jar
SpringMVC框架所需要的jar包
25. spring-web-4.3.6.REALEASE.jar
26. spring-webmvc-4.3.6.REALEASE.jar
数据库驱动jar包(MySQL8.0的jar包和之前5.0版本的不同,需要重新下载)
27. mysql-connector-java-8.0.11。jar
数据源所需要的jar包
28. commons-dbcp2-2.1.1.jar
29. commons-pool2-2.4.2.jar
以上为ssm框架搭建所需要的jar包,今后的开发可能会导入其他的jar包,比如处理json格式数据的jackson的jar包等等。
9.导入jar包,点击file—>Project Stucture,点击dependencies,按下绿色的加号按钮,导入29个框架所需要的jar包,点击apply—>OK。
可以看到左边的Problems中显示29个问题,原因是这29个jar包只是导入了项目,但并没有导入部署在Tomcat服务器中的web项目下。点击Artifacts,然后选中这29个jar包,右键Put into /WEB-INF/lib,apply—>OK,问题就解决了。
10.至此可以开始编写配置文件了,ssm框架在开发过程中非常好用,但是代价就是前期的框架配置文件非常庞大,对小白很不友好。首先要建立一个config的源文件夹(Source Folder),这个文件夹的作用就是保存所有的配置文件,方便查找修改。
还是在file–>Project Structure下面的Sources下,创建一个config文件夹,并且将这个文件夹标注成Sources,也就是IDEA中蓝色的样式,和src文件夹属于同一级同一类型即可。
在config文件夹下,编写配置文件。
首先是db.properties,这个文件是数据库的配置文件
下面的各个key和value是适合MySQL8.0版本的,低版本可能还需要修改。
用户名和密码也需要自行配置。
jdbc.url后面的编码格式、时区设置也需要写上,可以避免很多开发中的bug出现。
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/ssmFramework?useUnicode=true&characterEncoding=UTF8&useSSL=false&serverTimezone=Asia/Shanghai
jdbc.username=root
jdbc.password=1234
jdbc.maxTotal=30
jdbc.maxIdle=10
jdbc.initialSize=5
然后是applicationContext.xml,当中的包名根据不同的项目灵活改变即可。
<?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:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!--读取db.properties-->
<context:property-placeholder location="classpath:db.properties" />
<!--配置数据源-->
<bean id="dataSource"
class="org.apache.commons.dbcp2.BasicDataSource">
<!--配置数据库驱动-->
<property name="driverClassName" value="${jdbc.driver}" />
<!--连接数据库的url-->
<property name="url" value="${jdbc.url}" />
<!--连接数据库的用户名-->
<property name="username" value="${jdbc.username}" />
<!--连接数据库的密码-->
<property name="password" value="${jdbc.password}" />
<!--最大连接数-->
<property name="maxTotal" value="${jdbc.maxTotal}" />
<!--最大空闲数-->
<property name="maxIdle" value="${jdbc.maxIdle}" />
<!--初始化连接数-->
<property name="initialSize" value="${jdbc.initialSize}" />
</bean>
<!--事务管理器,依赖于数据源-->
<bean id="transactionManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
<!--开启事务注解-->
<tx:annotation-driven transaction-manager="transactionManager" />
<!--配置mybatis工厂SqlSessionFactory-->
<bean id="sqlSessionFactory"
class="org.mybatis.spring.SqlSessionFactoryBean">
<!--注入数据源-->
<property name="dataSource" ref="dataSource" />
<!--指定核心Mybatis配置文件-->
<property name="configLocation" value="classpath:mybatis-config.xml" />
</bean>
<!--配置mapper扫描器-->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.dhu.dao" />
</bean>
<!--扫描Service-->
<context:component-scan base-package="com.dhu.service" />
</beans>
接着是mybatis-config.xml,配置非常简单,由于在spring的配置文件中已经配置好了数据源等信息,所以只要定义别名,方便后续开发。
包名也是需要根据具体项目灵活改变即可。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--别名定义-->
<typeAliases>
<package name="com.dhu.po" />
</typeAliases>
</configuration>
还有springmvc-congif.xml
<?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:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">
<!--配置包扫描器,扫描@Controller注解的类-->
<context:component-scan base-package="com.dhu.controller" />
<!--加载注解驱动-->
<mvc:annotation-driven />
<!--配置视图解析器-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
</bean>
</beans>
最后是配置web.xml文件
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<!--配置加载Spring文件的监听器-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
<!--编码过滤器-->
<filter>
<filter-name>encoding</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>
</filter>
<filter-mapping>
<filter-name>encoding</filter-name>
<url-pattern>*.action</url-pattern>
</filter-mapping>
<!--配置Spring MVC前端核心控制器-->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc-config.xml</param-value>
</init-param>
<!--配置启动后立即加载Spring MVC配置文件-->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<!--拦截所有请求-->
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
至此,配置文件编码完成,可以进行后续的开发了。