快速搭建SSM項目基本手腳架
Maven構建項目
一般我們使用Maven來管理我們的項目：
導入相關依賴配置pom.xml：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.example</groupId>
<artifactId>WebApp</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>war</packaging>
<name>WebApp Maven Webapp</name>
<!-- FIXME change it to the project's website -->
<url>http://www.example.com</url>
<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>5.2.9.RELEASE</spring-version>
<junit-version>4.13</junit-version>
<servlet-api-version>2.5</servlet-api-version>
<spring-core-version>${spring-version}</spring-core-version>
<spring-beans-version>${spring-version}</spring-beans-version>
<spring-context-version>${spring-version}</spring-context-version>
<spring-tx-version>${spring-version}</spring-tx-version>
<spring-aspects-version>${spring-version}</spring-aspects-version>
<spring-jdbc-version>${spring-version}</spring-jdbc-version>
<spring-web-version>${spring-version}</spring-web-version>
<spring-webmvc-version>${spring-version}</spring-webmvc-version>
<mybatis-version>3.5.3</mybatis-version>
<mybatis-spring-version>2.0.3</mybatis-spring-version>
<mysql-version>8.0.23</mysql-version>
<slf4j-log4j12-vsersion>1.7.25</slf4j-log4j12-vsersion>
</properties>
<dependencies>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>${slf4j-log4j12-vsersion}</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit-version}</version>
<scope>compile</scope>
</dependency>
<!-- servlet-api的依賴 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>${servlet-api-version}</version>
<scope>provided</scope>
</dependency>
<!-- spring-core的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring-core-version}</version>
</dependency>
<!-- spring-beans的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>${spring-beans-version}</version>
</dependency>
<!-- spring-context的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring-context-version}</version>
</dependency>
<!-- spring-tx的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>${spring-tx-version}</version>
</dependency>
<!-- spring-aspects的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aspects</artifactId>
<version>${spring-aspects-version}</version>
</dependency>
<!-- spring-jdbc的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>${spring-jdbc-version}</version>
</dependency>
<!-- spring-web的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring-web-version}</version>
</dependency>
<!-- spring-webmvc的依賴 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring-webmvc-version}</version>
</dependency>
<!-- mybatis的核心依賴 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis-version}</version>
</dependency>
<!-- mybatis-spring的依賴 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>${mybatis-spring-version}</version>
</dependency>
<!-- 添加mysql依賴 -->
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql-version}</version>
<scope>provided</scope>
</dependency>
</dependencies>
<build>
<!--
有時候，比如mybatis的mapper.xml文件，我們習慣把它和Mapper.java放一起，都在src/main/java下面，這樣利用maven打包時，
就需要修改pom.xml文件，來把mapper.xml文件一起打包進jar或者war里了，否則，這些文件不會被打包的。
-->
<!-- 資源目錄 -->
<resources>
<resource>
<!-- 設定主資源目錄 -->
<directory>src/main/java</directory>
<!-- 需要讀取的文件 -->
<includes>
<include>**/*.xml</include>
</includes>
</resource>
</resources>
</build>
</project>
配置項目相關文件
在main目錄下的resources下創建配置文件：
- 數據庫相關配置文件：db.properties:
m_driver=com.mysql.cj.jdbc.Driver
m_user=root
m_pwd=root
m_url=jdbc:mysql://localhost:3306/rbac
- Spring IoC容器配置文件：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/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
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd">
<!-- 加載解析jdbc.properties的標簽 -->
<context:property-placeholder location="classpath:db.properties"/>
<!-- service層的注解掃描 -->
<context:component-scan base-package="com.lyl.service.impl"/>
<!-- 配置數據源bean -->
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
<property name="driverClassName" value="${m_driver}"/>
<property name="url" value="${m_url}"/>
<property name="username" value="${m_user}"/>
<property name="password" value="${m_pwd}"/>
</bean>
<!-- 配置SqlSessionFactory -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 配置UserMapper掃描 -->
<bean id="mapper" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.lyl.mapper"/>
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>
<!-- 配置事務管理器 -->
<bean id="tx" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 配置事務管理通知 -->
<tx:advice id="txManager" transaction-manager="tx">
<tx:attributes>
<tx:method name="sel*" read-only="true"/>
<tx:method name="del*"/>
<tx:method name="up*"/>
<tx:method name="ins*"/>
</tx:attributes>
</tx:advice>
<!-- 用AOP將事務管理通知切入方法 -->
<aop:config>
<aop:pointcut id="my" expression="execution(* com.lyl.service.impl.*.*(..))"/>
<aop:advisor advice-ref="txManager" pointcut-ref="my"/>
</aop:config>
</beans>
- 配置Spring MVC容器配置文件：springmvc-config.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"
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">
<context:component-scan base-package="com.lyl.controller"/>
<mvc:annotation-driven/>
<!-- 定義視圖解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/"/>
<property name="suffix" value=".jsp"/>
</bean>
<!-- 靜態文件放行，該文件夾下的文件會放行 -->
<mvc:resources mapping="/static/**" location="/static/"/>
</beans>
- 日志文件：log4g.properties
log4j.rootLogger=error,CONSOLE,LOGFILE
log4j.logger.com.lyl.mapper=debug
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=- %m%n
log4j.appender.LOGFILE=org.apache.log4j.FileAppender
log4j.appender.LOGFILE.File=e:/test1.log
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=[mybatis_study][%p] [%-d{yyyy-MM-dd HH\:mm\:ss}] %C.%M(%L) | %m%n
- 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_4_0.xsd"
version="4.0">
<servlet>
<servlet-name>mvc</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>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>mvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<!-- 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>characterEncodingFilter</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>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
構建項目目錄
當我們配置文件寫完時就開始構建我們的項目目錄結構：
后面添加了log4j.properties配置文件
開始測試SSM項目搭建是否完成
Test代碼：
@Test
public void testMVC(){
ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
String[] beanDefinitionNames = context.getBeanDefinitionNames();
for (String beanDefinitionName : beanDefinitionNames) {
System.out.println(beanDefinitionName);
}
}
打印結果：
org.springframework.context.support.PropertySourcesPlaceholderConfigurer#0
org.springframework.context.annotation.internalConfigurationAnnotationProcessor
org.springframework.context.annotation.internalAutowiredAnnotationProcessor
org.springframework.context.annotation.internalCommonAnnotationProcessor
org.springframework.context.event.internalEventListenerProcessor
org.springframework.context.event.internalEventListenerFactory
dataSource
sqlSessionFactory
mapper
tx
txManager
org.springframework.aop.config.internalAutoProxyCreator
my
org.springframework.aop.support.DefaultBeanFactoryPointcutAdvisor#0
由此可見我們的Spring IoC容器已經搭建完成
開啟tomcat看Spring mvc是否能執行，創建Controller：
@Controller
@RequestMapping("hello")
public class HelloController {
@RequestMapping("say")
public ModelAndView say(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("hello");
modelAndView.addObject("name","張三");
return modelAndView;
}
}
創建兩個jsp頁面
index.jsp里面包含跳轉，到hello.jsp
<html>
<body>
<h2>Hello World!</h2>
</body>
<h1>Hello</h1>
<a href="hello/say">Jump</a>
</html>
hello.jsp
<%
String path = request.getContextPath();
String basePath = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + path + "/";
%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<base href="<%=basePath%>"/>
<title>Title</title>
<script type="text/javascript" src="static/jquery.min.js"></script>
<script type="text/javascript">
</script>
</head>
<body>
<h1>你好啊！！！！！！${name}</h1>
</body>
</html>
跳轉后如下：
證實Spring MVC容器正常運行
到此，我們的SSM基本框架已經搭建完成，我們只需要前面四個步驟即可
用Maven構建項目-->配置相關配置文件-->創建項目目錄結構-->測試是否可以正常運行
關鍵步驟是配置文件，配置文件一定要書寫正確，否則可能出現運行錯誤！
用MyBatis-Plus幫助我們搭建一鍵生成代碼和目錄結構
如果我們在SSM項目中添加了MP工具，則會讓我們對數據庫操作得心應手，簡單明了，MP中有一個插件是代碼生成器——AutoGenerator，可以通過官網了解詳情。
AutoGenerator 是 MyBatis-Plus 的代碼生成器，通過 AutoGenerator 可以快速生成 Entity、Mapper、Mapper XML、Service、Controller 等各個模塊的代碼，極大的提升了開發效率。
首先我們先導入MP的依賴：
<!-- mybatisPlus的依賴 -->
<!-- https://mvnrepository.com/artifact/com.baomidou/mybatis-plus -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus</artifactId>
<version>${mybatisPlus-version}</version>
</dependency>
<!-- MP的代碼生成器依賴 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-generator</artifactId>
<version>${mybatis-plus-generator-version}</version>
</dependency>
<!-- 代碼生成的模板 -->
<dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-core</artifactId>
<version>${velocity-engine-core-version}</version>
</dependency>
</dependencies>
然后開始編寫代碼生成器的代碼，
@Test
public void testCode(){
AutoGenerator ag = new AutoGenerator();
String path = System.getProperty("user.dir");// 動態獲取當前項目路徑
//1. 全局配置
GlobalConfig config = new GlobalConfig();
/*
* GlobalConfig主要配置的屬性有：
* -- 是否支持AR模式
* -- 生成代碼結構的根路徑
* -- 文件是否覆蓋
* -- 主鍵策略
* -- 生成基本的resultMap
* -- 生成基本的SQL片段，也就是xml文件中的sql標簽，包含了表中的字段名
*/
// 是否支持AR模式
config.setActiveRecord(true)
.setAuthor("Clean")
// 生成路徑
.setOutputDir(path+"/src/main/java")
// 文件覆蓋
.setFileOverride(false)
// 主鍵策略
.setIdType(IdType.AUTO)
// 設置日期格式
.setDateType(DateType.ONLY_DATE)
// 去掉Service接口的首字母I，默認Service是以I開頭的
.setServiceName("%sService")
//生成基本的resultMap
.setBaseResultMap(true)
//生成基本的SQL片段
.setBaseColumnList(true);
//2. 數據源配置
/*
* DataSourceConfig的主要屬性配置
* 此處為MP連接數據庫讀取數據庫中表的屬性和字段名，幫我們自動生成項目結構和數據庫中表對應的實體類
* -- 數據庫類型
*/
DataSourceConfig dsConfig = new DataSourceConfig();
// 設置數據庫類型
dsConfig.setDbType(DbType.MYSQL)
.setDriverName("com.mysql.cj.jdbc.Driver")
.setUrl("jdbc:mysql://localhost:3306/spring")
.setUsername("root")
.setPassword("root");
//3. 策略配置globalConfiguration中
/*
* StrategyConfig的主要屬性配置
* -- 全局大寫命名
* -- 數據庫表映射到實體類的命名策略
* -- 生成表（要生成實體類的表名，支持多表·11一起生成，以數組的形式填寫）
* -- 設置表的前綴（TablePrefix）
*/
StrategyConfig stConfig = new StrategyConfig();
//全局大寫命名
stConfig.setCapitalMode(true)
// 數據庫表映射到實體的命名策略
.setNaming(NamingStrategy.underline_to_camel)
// 生成的表, 支持多表一起生成，以數組形式填寫
.setInclude("t_user","t_role","r_menu","t_menu")
// 設置表的前綴
.setTablePrefix("t_","r_");
//4. 包名策略配置
/*
* PackageConfig的主要屬性配置
* 公共包--Parent
*/
PackageConfig pkConfig = new PackageConfig();
pkConfig.setParent("com.lyl")
.setMapper("mapper")
.setService("service")
.setController("controller")
.setEntity("pojo")
.setXml("mapper");
//5. 整合配置
/*
* 整合需要的對象有：
* --> GlobalConfig
* --> DataSourceConfig
* --> StrategyConfig
* --> PackageConfig
*/
ag.setGlobalConfig(config)
.setDataSource(dsConfig)
.setStrategy(stConfig)
.setPackageInfo(pkConfig);
//6. 執行
ag.execute();
System.out.println("======= 代碼生成完畢 ========");
執行前項目結構：
執行后項目如下：
並且我們的mapper層已經繼承了MP的BaseMapper，service層繼承了IService，pojo繼承了Model，所有的基礎代碼已經幫我們寫好了，我們只需要專注的實現業務邏輯代碼即可，其他的基本代碼MP已經幫我們實現了，大部分SQL操作我們都可以借助MP提供的Mapper層或Service層的CRUD接口直接調用即可。
小結
我們每一次搭建SSM框架，一開始都是搭建最基本的SSM項目模型，這個過程大部分代碼和步驟都是相同的，每次搭建SSM框架都需要重復大量基本工作，我們可以將配置文件中的通用代碼用文件保存或直接存在idea中，如果項目中出現了大量的表，mapper，我們就可以借助MP幫我們實現代碼的生成，大大節省了開發的時間，讓我們專心在業務代碼中！