版权声明
- 本文原创作者:谷哥的小弟
- 作者博客地址:http://blog.csdn.net/lfdfhl
教程概述
本教程以图文形式详细讲解IDEA整合SSM框架的流程以及具体步骤及其注意事项。
数据准备
在此,准备本教程所需的数据库、数据表及其数据;详情如下:
-- 假若panda存在则删除DROPDATABASEIFEXISTS panda;-- 创建pandaDB数据库CREATEDATABASE panda;-- 使用panda数据库use panda;-- 创建user表CREATETABLEuser(-- 自动增长主键id
id INTprimarykeyauto_increment,-- 用户名
username VARCHAR(50),-- 密码
password VARCHAR(50));-- 向user表中插入数据INSERTINTOuser(username,password)VALUES('admin','admin');-- 查询user表中的数据SELECT*FROMuser;
创建Maven项目
在此,详细介绍在IDEA中使用Maven创建JavaWeb项目的过程及其主要步骤。
创建项目,图示如下:
设定SDK版本并选择Maven模板,图示如下:
填写项目基本信息,图示如下:
配置Maven,图示如下:
点击Finish后IDEA开始创建项目,图示如下:
至此,项目已经创建;但是,还缺失Web项目所必须的文件夹。所以,接下来,我们来完善该项目。
完善Maven项目
Maven项目的标准目录结构如下:
- src/main/java
- src/main/resources
- src/test/java
- src/test/resources
在此,按照该Maven项目结构完善本项目的结构。
请在main下创建java文件夹,再将java文件夹设置为Sources Root;图示如下:
请在main下创建resources 文件夹,再将resources 文件夹设置为Resources Root;图示如下:
请在src下创建test文件夹,再在test中创建java文件夹;接下来,将java文件夹设置为Test Sources Root;图示如下:
请在test文件中创建resources文件夹,再将resources 文件夹设置为Test Resources Root;图示如下:
至此,关于项目结构的完善就基本完成,图示如下:
配置Tomcat
接下来,开始为项目添加本地Tomcat服务器,图示如下:
选择本地Tomcat服务器,再点击OK,图示如下:
本地Tomcat服务器已经添加完毕,接下来对其进行配置;图示如下:
点击Configure选择本地已经安装的Tomcat并配置端口号和默认浏览器,图示如下:
配置与项目发布相关的信息,图示如下:
运行项目,图示如下:
浏览器显示页面,图示如下:
至此,成功完成了Tomcat的配置。
整合SSM框架
在之前的操作中,我们完成了在IDEA中使用Maven创建JavaWeb项目。接下来,我们在此基础上整合SSM三大框架。
添加依赖
在项目初始化之后pom.xml文件中自带部分依赖,图示如下:
在此,我们需要将SSM项目中常用的依赖添加至< dependencies ></ dependencies >中。常见的有:servlet、spring-webmvc、mybatis、mysql、mybatis-spring、pagehelper、spring-jdbc、c3p0、log4j、jackson、jstl、fileupload等等;详情如下:
<dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.3.14</version></dependency><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.9</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.27</version></dependency><dependency><groupId>org.mybatis</groupId><artifactId>mybatis-spring</artifactId><version>2.0.6</version></dependency><dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper</artifactId><version>5.0.0</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>5.3.14</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-oxm</artifactId><version>5.3.14</version></dependency><dependency><groupId>com.mchange</groupId><artifactId>c3p0</artifactId><version>0.9.5.5</version></dependency><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-log4j12</artifactId><version>1.7.30</version></dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.13.1</version></dependency><dependency><groupId>org.aspectj</groupId><artifactId>aspectjweaver</artifactId><version>1.9.6</version></dependency><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version></dependency><dependency><groupId>javax.servlet</groupId><artifactId>jstl</artifactId><version>1.2</version></dependency><dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.4</version></dependency>
图示如下:
创建包
在此,提前准备好项目中可能用到的包。
创建与Java代码相关的包
首先,请在java包下创建com.cn.panda包;再在com.cn.panda中创建与Java代码相关的包;常见的有:controller、entity、service、mapper、config、interceptor等,图示如下:
创建与resources代码相关的包
请在resources下以com/cn/panda/mapper的方式创建com.cn.panda.mapper包用于存放mapper的映射文件。
注意事项:
- 1、请勿以com.cn.panda.mapper的方式创建mapper包
- 2、mapper映射文件的包名需与mapper的接口文件所在包的包名保持一致
图示如下:
创建与webapp相关的文件夹
请在webapp下创建与项目页面资源相关的文件夹,常见的有:css、fonts、imgs、js等;图示如下:
创建与WEB-INF相关的文件夹
请在WEB-INF下创建与项目页面相关的文件夹。在此,先创建jsp文件夹再在jsp下创建back文件夹用于存放后台页面,再在jsp下创建front文件夹用于存放前端页面;图示如下:
编写各层代码
接下来,我们按照分层思想以用户查询为例完成代码的编写工作。
User类
请在entity包下创建User类。
User类作为JavaBean,其属性名应尽量与数据库中user表的字段保持一致。
packagecom.cn.panda.entity;/**
* 本文作者:谷哥的小弟
* 博客地址:http://blog.csdn.net/lfdfhl
*/publicclassUser{privateString username;privateString password;publicUser(){}publicUser(String username,String password){this.username = username;this.password = password;}publicStringgetUsername(){return username;}publicvoidsetUsername(String username){this.username = username;}publicStringgetPassword(){return password;}publicvoidsetPassword(String password){this.password = password;}@OverridepublicStringtoString(){return"User{"+"username='"+ username +'\''+", password='"+ password +'\''+'}';}}
UserMapper接口文件
请在java中的mapper包下创建UserMapper接口文件UserMapper.java。
要点概述:
- 1、在该接口中定义方法findUserById( )
- 2、在UserMapper接口上使用@Repository注解
packagecom.cn.panda.mapper;importcom.cn.panda.entity.User;importorg.springframework.stereotype.Repository;/**
* 本文作者:谷哥的小弟
* 博客地址:http://blog.csdn.net/lfdfhl
*/@RepositorypublicinterfaceUserMapper{UserfindUserById(int id);}
UserMapper映射文件
请在resources中的mapper包下创建UserMapper映射文件UserMapper.xml。
要点概述:
- 1、映射文件名与映射接口名保持一致,均为UserMapper;但是,后缀不同
- 2、映射文件中的namespace属性值为接口文件UserMapper.java的全路径名
- 3、select标签的id属性值为接口文件UserMapper.java中的方法名findUserById
- 4、select标签的parameterType属性值为findUserById方法的输入参数类型
- 5、select标签的resultType属性值为findUserById方法的返回值类型;但是,其首字母小写。此时,xml文件提醒user报错;别急,稍后通过配置统一解决。
- 6、select标签中使用占位符编写SQL语句
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPEmapperPUBLIC"-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mappernamespace="com.cn.panda.mapper.UserMapper"><selectid="findUserById"parameterType="int"resultType="user">
select * from user where id = #{id}
</select></mapper>
UserService
请在service包下创建UserService接口。
请在service包下创建impl子包并在impl包下创建UserService接口的实现类UserServiceImpl。
要点概述:
- 1、在UserService接口中声明queryUser()方法
- 2、在UserServiceImpl类上使用@Service注解
- 3、在UserServiceImpl类中使用@Autowired注入UserMapper
- 4、在UserServiceImpl类中实现queryUser()方法
- 5、在UserServiceImpl类的queryUser()方法中调用UserMapper的findUserById()方法
UserService接口如下:
packagecom.cn.panda.service;importcom.cn.panda.entity.User;/**
* 本文作者:谷哥的小弟
* 博客地址:http://blog.csdn.net/lfdfhl
*/publicinterfaceUserService{UserqueryUser(int id);}
UserServiceImpl类如下:
packagecom.cn.panda.service.impl;importcom.cn.panda.entity.User;importcom.cn.panda.mapper.UserMapper;importcom.cn.panda.service.UserService;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.stereotype.Service;/**
* 本文作者:谷哥的小弟
* 博客地址:http://blog.csdn.net/lfdfhl
*/@ServicepublicclassUserServiceImplimplementsUserService{@AutowiredprivateUserMapper userMapper;publicUserqueryUser(int id){return userMapper.findUserById(id);}}
UserController
请在controller包下创建UserController。
要点概述:
- 1、在UserController类上使用@Controller注解和@RequestMapping注解
- 2、在UserController类中使用@Autowired注入UserService
- 3、在UserController类中定义getUser()方法
- 4、在getUser()方法上使用@GetMapping注解
- 5、在getUser()方法中调用UserService的queryUser()方法
- 6、getUser()方法的返回值为跳转页面的路径
packagecom.cn.panda.controller;importcom.cn.panda.entity.User;importcom.cn.panda.service.UserService;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.stereotype.Controller;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.RequestMapping;/**
* 本文作者:谷哥的小弟
* 博客地址:http://blog.csdn.net/lfdfhl
*/@Controller@RequestMapping("user")publicclassUserController{@AutowiredprivateUserService userService;@GetMapping("getUser")publicStringgetUser(int id){User user = userService.queryUser(id);System.out.println(user);return"front/user";}}
user.jsp
请在front包下创建user.jsp页面。
<html><body><h2>This is user page</h2></body></html>
LoginInterceptor
请在interceptor下创建登陆拦截器LoginInterceptor。
要点概述:
- 1、LoginInterceptor类实现HandlerInterceptor接口
- 2、HandlerInterceptor接口中的preHandle()方法返回true表示不拦截
- 3、请在项目中依据实际情况完善preHandle()方法
packagecom.cn.panda.interceptor;importorg.springframework.web.servlet.HandlerInterceptor;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;/**
* 本文作者:谷哥的小弟
* 博客地址:http://blog.csdn.net/lfdfhl
*/publicclassLoginInterceptorimplementsHandlerInterceptor{@OverridepublicbooleanpreHandle(HttpServletRequest request,HttpServletResponse response,Object handler)throwsException{returntrue;}}
编写配置文件
在此,完善项目各个配置文件的编写。
请在resources包下创建以下配置文件:
- Spring配置文件applicationContext.xml
- 数据库配置文件db.properties
- 日志配置文件log4j.properties
- MyBatis配置文件mybatis-config.xml
- Spring MVC配置文件springmvc-config.xml
另外,还需配置WEB-INF中的web.xml
要点概述:
- 1、请务必注意各配置文件中的包名,请依据项目实际情况设置
- 2、请务必注意各配置文件中的路径,请依据项目实际情况设置
- 3、请务必注意各配置文件中的配置信息,请依据项目实际情况设置
- 4、请务必注意各配置文件截图的红色标记,请依据项目实际情况设置
log4j.properties
# Global logging configuration
log4j.rootLogger=ERROR, stdout
# MyBatis logging configuration...
log4j.logger.com.cn.panda=DEBUG
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%5p [%t]-%m%n
db.properties
jdbc.url=jdbc:mysql://localhost:3306/panda
jdbc.driver=com.mysql.jdbc.Driver
jdbc.user=root
jdbc.password=root
jdbc.initialPoolSize=5
jdbc.maxPoolSize=10
mybatis-config.xml
<?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><!-- 配置PageHelper插件 --><plugins><plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin></plugins></configuration>
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: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
https://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
https://www.springframework.org/schema/mvc/spring-mvc.xsd"><!-- 开启对Controller层的组件自动扫描--><context:component-scan base-package="com.cn.panda.controller"><context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/></context:component-scan><!-- 配置默认处理器handler --><mvc:default-servlet-handler/><!-- 开启SpringMVC注解驱动 --><mvc:annotation-driven/><!-- 配置视图解析器 --><bean id="viewResolver"class="org.springframework.web.servlet.view.InternalResourceViewResolver"><!-- 指定视图所在位置 --><property name="prefix" value="/WEB-INF/jsp/"/><!-- 指定视图的类型 --><property name="suffix" value=".jsp"/></bean><!-- 配置文件上传 --><bean id="multipartResolver"class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="maxUploadSize" value="52428800"/><property name="maxInMemorySize" value="40960"/><property name="defaultEncoding" value="UTF-8"/></bean><!-- 配置拦截器 --><mvc:interceptors><mvc:interceptor><mvc:mapping path="/**"/><bean class="com.cn.panda.interceptor.LoginInterceptor"/></mvc:interceptor></mvc:interceptors></beans>
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:context="http://www.springframework.org/schema/context"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
https://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
https://www.springframework.org/schema/aop/spring-aop.xsd"><!-- 开启组件自动扫描 --><context:component-scan base-package="com.cn.panda"><!-- 对使用了@Controller注解的组件不开启(排除)自动扫描 --><context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/></context:component-scan><!-- 读取db.properties配置文件 --><context:property-placeholder location="classpath:db.properties"/><!-- 配置数据源 --><bean id="c3p0DataSource"class="com.mchange.v2.c3p0.ComboPooledDataSource"><property name="user" value="${jdbc.user}"/><property name="password" value="${jdbc.password}"/><property name="driverClass" value="${jdbc.driver}"/><property name="jdbcUrl" value="${jdbc.url}"/><property name="initialPoolSize" value="${jdbc.initialPoolSize}"/><property name="maxPoolSize" value="${jdbc.maxPoolSize}"/></bean><!-- 配置事务管理器 --><bean id="dataSourceTransactionManager"class="org.springframework.jdbc.datasource.DataSourceTransactionManager"><!-- 设置数据源 --><property name="dataSource" ref="c3p0DataSource"/></bean><!-- 开启事务注解驱动 --><tx:annotation-driven transaction-manager="dataSourceTransactionManager"/><!-- 配置事务增强 --><tx:advice id="advice" transaction-manager="dataSourceTransactionManager"><tx:attributes><!-- 配置事务传播行为 --><tx:method name="save*" propagation="REQUIRED"/><tx:method name="insert*" propagation="REQUIRED"/><tx:method name="add*" propagation="REQUIRED"/><tx:method name="create*" propagation="REQUIRED"/><tx:method name="delete*" propagation="REQUIRED"/><tx:method name="update*" propagation="REQUIRED"/><tx:method name="find*" propagation="SUPPORTS" read-only="true"/><tx:method name="query*" propagation="SUPPORTS" read-only="true"/><tx:method name="select*" propagation="SUPPORTS" read-only="true"/><tx:method name="get*" propagation="SUPPORTS" read-only="true"/><!--其它方法使用默认事务策略 --><tx:method name="*"/></tx:attributes></tx:advice><!-- 配置AOP--><aop:config><aop:pointcut id="pointcut" expression="execution(* com.cn.panda.service.*.*(..))"/><aop:advisor advice-ref="advice" pointcut-ref="pointcut"/></aop:config><!-- 配置Mapper扫描器扫描包中的Mapper接口 --><bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"><property name="basePackage" value="com.cn.panda.mapper"/></bean><!-- 配置sqlSessionFactory --><bean id="sqlSessionFactory"class="org.mybatis.spring.SqlSessionFactoryBean"><!-- 指定MyBatis配置文件路径 --><property name="configLocation" value="classpath:mybatis-config.xml"/><!-- 指定数据源 --><property name="dataSource" ref="c3p0DataSource"/><!-- 指定映射文件Mapper.xml的路径 --><property name="mapperLocations" value="classpath:com/cn/panda/mapper/*.xml"/><!-- 设置类型别名 --><property name="typeAliasesPackage" value="com.cn.panda.entity"/></bean></beans>
web.xml
<?xml version="1.0" encoding="UTF-8"?><web-appxmlns="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"><!-- 配置context-param --><!-- needed for ContextLoaderListener --><context-param><param-name>contextConfigLocation</param-name><!-- 指定Spring配置文件路径和名称 --><param-value>classpath:applicationContext.xml</param-value></context-param><!-- 配置监听器ContextLoaderListener --><!-- Bootstraps the root web application context before servlet initialization --><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><!-- 配置Spring MVC前端控制器DispatcherServlet --><servlet><servlet-name>dispatcherServlet</servlet-name><servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class><init-param><param-name>contextConfigLocation</param-name><!-- 指定Spring MVC配置文件路径和名称 --><param-value>classpath:springmvc-config.xml</param-value></init-param><!-- 指定Tomcat启动时加载该Servlet,值越小优先级越高 --><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>dispatcherServlet</servlet-name><!-- 拦截所有请求 --><url-pattern>/</url-pattern></servlet-mapping></web-app>
部署与测试
请点击绿色按钮运行项目,图示如下:
项目启动后在浏览器中自动展示index页面,图示如下:
请在浏览器中输入 http://localhost:8080/user/getUser?id=1 并回车,图示如下:
控制台打印信息,图示如下:
至此,完成了SSM框架整合。
总结
总体而言,利用IDEA搭建Maven工程并整合SSM框架的技术难度不大;但是需要注意的细节之处较多。所以,在整合过程中务必细致周到,考虑周全,富有耐心。
版权归原作者 谷哥的小弟 所有, 如有侵权,请联系我们删除。