用idea搭建SSM项目,原来这么简单
目录
前言
前阵子突发奇想,想学习下springmvc的源码,于是打算用idea搭建一个简易的maven版ssm案例,也就是springmvc+spring+mybatis+maven,因为之前创建过一些spring的小demo,相关的软件环境已经搭建完成,本以为搭建一个入门级的ssm项目应该不难,谁曾想这个过程中遇到了不少千奇百怪的问题,从开始创建到成功运行花了我整整一个下午的时间(我的午觉啊~~~·),最后项目成功跑起来的时候我长出了一口气,为了以后不在类似的事情上折腾,特此写下这篇文章记录一下搭建过程。
软件环境
先准备好搭建项目的基本环境
intellij idea:2018.1.1
jdk:1.8
maven:3.6.0
tomcat:7.0及以上
下载安装好软件后,在idea软件设置里做好jdk、maven和tomcat的相关环境配置,这方面网上的资料很多,本文就不介绍了。
创建项目
搭建好环境后,打开idea,点击new - project
找到maven一栏,因为要搭建的springmvc项目,所以选择webapp模板
填写好groupid和artifactid后,一步步next,最后finish完成
创建成功后,可以看到项目是这样的目录结构
除了配置相关依赖的pom.xml,目录中还有一个文件夹src,src的main目录提供了一个webapp文件夹,webapp文件夹下有一个web-inf文件夹,放置的是前端页面的文件,以及web.xml文件。
除了模版提供的目录结构,为了后面项目能成功运行,我们还需要添加一些文件夹,让项目的目录结构变成这样:
数据库文件
首先,先准备好数据库文件,并初始化一条记录
drop table if exists `user`; create table `user` ( `id` int(11) not null auto_increment comment '用户id', `email` varchar(255) not null comment '用户邮箱', `username` varchar(255) not null comment '用户昵称', `role` varchar(255) not null comment '用户身份', `mobile` varchar(50) default '' comment '手机号码', primary key (`id`) ) engine=innodb auto_increment=2 default charset=utf-8; -- ---------------------------- -- records of user -- ---------------------------- insert into `user` values ('1', '1589585621@qq.com', 'xjt', 'root', '15678635432');
配置文件
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>com.xjt</groupid> <artifactid>mvcdemo</artifactid> <version>1.0-snapshot</version> <packaging>war</packaging> <name>mvcdemo maven webapp</name> <!-- 用来设置版本号 --> <properties> <srping.version>4.0.2.release</srping.version> <mybatis.version>3.2.8</mybatis.version> <slf4j.version>1.7.12</slf4j.version> <log4j.version>1.2.17</log4j.version> <druid.version>1.0.9</druid.version> </properties> <!-- 用到的jar包 --> <dependencies> <!-- 单元测试 --> <dependency> <groupid>junit</groupid> <artifactid>junit</artifactid> <version>4.11</version> <!-- 表示开发的时候引入,发布的时候不会加载此包 --> <scope>test</scope> </dependency> <!-- spring框架包 --> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-test</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-core</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-oxm</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-tx</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-jdbc</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-aop</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-context</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-context-support</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-expression</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-orm</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-web</artifactid> <version>${srping.version}</version> </dependency> <dependency> <groupid>org.springframework</groupid> <artifactid>spring-webmvc</artifactid> <version>${srping.version}</version> </dependency> <!-- spring框架包 --> <!-- mybatis框架包 --> <dependency> <groupid>org.mybatis</groupid> <artifactid>mybatis</artifactid> <version>${mybatis.version}</version> </dependency> <dependency> <groupid>org.mybatis</groupid> <artifactid>mybatis-spring</artifactid> <version>1.2.2</version> </dependency> <!-- mybatis框架包 --> <!-- 数据库驱动 --> <dependency> <groupid>mysql</groupid> <artifactid>mysql-connector-java</artifactid> <version>5.1.35</version> </dependency> <!-- 导入dbcp的jar包,用来在applicationcontext.xml中配置数据库 --> <dependency> <groupid>commons-dbcp</groupid> <artifactid>commons-dbcp</artifactid> <version>1.4</version> </dependency> <!-- jstl标签类 --> <dependency> <groupid>jstl</groupid> <artifactid>jstl</artifactid> <version>1.2</version> </dependency> <!-- log --> <dependency> <groupid>log4j</groupid> <artifactid>log4j</artifactid> <version>${log4j.version}</version> </dependency> <dependency> <groupid>org.slf4j</groupid> <artifactid>slf4j-api</artifactid> <version>${slf4j.version}</version> </dependency> <dependency> <groupid>org.slf4j</groupid> <artifactid>slf4j-log4j12</artifactid> <version>${slf4j.version}</version> </dependency> <!-- 连接池 --> <dependency> <groupid>com.alibaba</groupid> <artifactid>druid</artifactid> <version>${druid.version}</version> </dependency> </dependencies> <build> <!-- java编译插件,如果maven的设置里配置好jdk版本就不用 --> <plugins> <plugin> <groupid>org.apache.maven.plugins</groupid> <artifactid>maven-compiler-plugin</artifactid> <version>3.2</version> <configuration> <source>1.8</source> <target>1.8</target> <encoding>utf-8</encoding> </configuration> </plugin> </plugins> </build> </project>
注:以下四个配置文件都是放置在resources文件夹下
log4j.properties
#日志输出级别 log4j.rootlogger=debug,stdout,d,e #设置stdout的日志输出控制台 log4j.appender.stdout=org.apache.log4j.consoleappender #输出日志到控制台的方式,默认为system.out log4j.appender.stdout.target = system.out #设置使用灵活布局 log4j.appender.stdout.layout=org.apache.log4j.patternlayout #灵活定义输出格式 log4j.appender.stdout.layout.conversionpattern=%d{yyyy-mm-dd hh:mm:ss,sss} -[%p] method:[%c (%rms)] - %m%n
jdbc.properties
driver=com.mysql.jdbc.driver url=jdbc:mysql://localhost:3306/test?characterencoding=utf8&usessl=false #数据库的用户名 username=root #数据库的密码,别像我一样不设置 password= #定义初始连接数 initialsize=0 #定义最大连接数 maxactive=20 #定义最大空闲 maxidle=20 #定义最小空闲 minidle=1 #定义最长等待时间 maxwait=60000
applicationcontext.xml
这是spring的核心配置文件,包括spring结合mybatis和数据源的配置信息
<?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: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-3.1.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"> <!-- 加载properties文件 --> <bean id="propertyconfigurer" class="org.springframework.beans.factory.config.propertyplaceholderconfigurer"> <property name="location" value="classpath:jdbc.properties"/> </bean> <!-- 配置数据源 --> <bean id="datasource" class="com.alibaba.druid.pool.druiddatasource"> <property name="driverclassname" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </bean> <!-- mybatis和spring完美整合,不需要mybatis的配置映射文件 --> <bean id="sqlsessionfactory" class="org.mybatis.spring.sqlsessionfactorybean"> <property name="datasource" ref="datasource"/> <!-- 扫描model包 --> <property name="typealiasespackage" value="com.xjt.model"/> <!-- 扫描sql配置文件:mapper需要的xml文件--> <property name="mapperlocations" value="classpath:mapper/*.xml"/> </bean> <!-- mapper动态代理开发,扫描dao接口包--> <bean class="org.mybatis.spring.mapper.mapperscannerconfigurer"> <!-- 注入sqlsessionfactory --> <property name="sqlsessionfactorybeanname" value="sqlsessionfactory"/> <!-- 给出需要扫描dao接口包 --> <property name="basepackage" value="com.xjt.dao"/> </bean> <!-- 事务管理 --> <bean id="transactionmanager" class="org.springframework.jdbc.datasource.datasourcetransactionmanager"> <!--数据库连接池--> <property name="datasource" ref="datasource"/> </bean>
spring-mvc.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 http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd"> <!-- 扫描注解,这样com.xjt包下的文件都能被扫描 --> <context:component-scan base-package="com.xjt"/> <!-- 开启springmvc注解模式 --> <mvc:annotation-driven/> <!-- 静态资源默认servlet配置 --> <mvc:default-servlet-handler/> <!-- 配置返回视图的路径,以及识别后缀是jsp文件 --> <bean class="org.springframework.web.servlet.view.internalresourceviewresolver"> <property name="viewclass" value="org.springframework.web.servlet.view.jstlview"/> <property name="prefix" value="/web-inf/jsp/"/> <property name="suffix" value=".jsp"/> </bean> </beans>
web.xml
该文件不是放在resources,而是webapp的web-inf文件夹下,文件内容如下:
<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"> <display-name>mvcdemo</display-name> <!--项目的欢迎页,项目运行起来后访问的页面--> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <!-- 注册servletcontext监听器,创建容器对象,并且将applicationcontext对象放到application域中 --> <listener> <listener-class>org.springframework.web.context.contextloaderlistener</listener-class> </listener> <!-- 指定spring核心配置文件 --> <context-param> <param-name>contextconfiglocation</param-name> <param-value>classpath:applicationcontext.xml</param-value> </context-param> <!-- 解决乱码的过滤器 --> <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> <!-- 配置前端控制器 --> <servlet> <servlet-name>springmvc</servlet-name> <servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-class> <!-- 指定配置文件位置和名称 如果不设置,默认找/web-inf/<servlet-name>-servlet.xml --> <init-param> <param-name>contextconfiglocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> <async-supported>true</async-supported> </servlet> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
运行项目
上面的配置文件编写好之后,其实我们就可以尝试着启动项目了,启动项目前先把applicationcontext.xml的内容都注释了,然后就可以创建运行环境了。
点击idea右上角的 edit configurations...
选择tomcat server - local,
编辑好项目的启动信息,包括项目名,jdk版本,tomcat以及端口
选择deployment,添加atifact,选择第二项,否则tomcat运行会报错
保存后,启动项目,成功后在浏览器输入,返回结果如下:
这是index.jsp文件中的内容,因为index.jsp是启动页,所以项目启动后返回的结果是启动页的内容
<html> <body> <h2>hello world!</h2> </body> </html>
编写代码
项目能跑起来,说明我们前端控制器的配置是成功的,接下来要做的是测试能否访问数据库。首先,把基本的类文件创建并编写好代码。
实体类:user.java
package com.xjt.model; public class user { private long id; private string email; private string mobile; private string username; private string role; public long getid() { return id; } public void setid(long id) { this.id = id; } public string getemail() { return email; } public void setemail(string email) { this.email = email; } public string getmobile() { return mobile; } public void setmobile(string mobile) { this.mobile = mobile; } public string getusername() { return username; } public void setusername(string username) { this.username = username; } public string getrole() { return role; } public void setrole(string role) { this.role = role; } }
dao文件:iuserdao
package com.xjt.dao; import com.xjt.model.user; public interface iuserdao { user selectuser(long id); }
mapper文件:userdao.xml
位于resources - mapper文件夹下
<?xml version="1.0" encoding="utf-8"?> <!doctype mapper public "-//mybatis.org//dtd mapper 3.0//en" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <!-- 设置为iuserdao接口方法提供sql语句配置 --> <mapper namespace="com.xjt.dao.iuserdao"> <select id="selectuser" resulttype="user" parametertype="long"> select * from user where id = #{id} </select> </mapper>
service接口:iuserservice
package com.xjt.service; import com.xjt.model.user; public interface iuserservice { public user selectuser(long userid); }
userserviceimpl
package com.xjt.service.impl; import com.xjt.dao.iuserdao; import com.xjt.model.user; import com.xjt.service.iuserservice; import org.springframework.stereotype.service; import javax.annotation.resource; @service("userservice") public class userserviceimpl implements iuserservice { @resource private iuserdao userdao; public user selectuser(long userid) { return userdao.selectuser(userid); } }
controller文件:usercontroller
package com.xjt.controller; import com.xjt.model.user; import com.xjt.service.iuserservice; import org.springframework.beans.factory.annotation.autowired; import org.springframework.stereotype.controller; import org.springframework.web.bind.annotation.requestmapping; import org.springframework.web.servlet.modelandview; @controller @requestmapping("/user") public class usercontroller { @autowired private iuserservice userservice; @requestmapping("/select") public modelandview selectuser() throws exception { modelandview mv = new modelandview(); user user = userservice.selectuser(1); mv.addobject("user", user); mv.setviewname("user"); return mv; } }
usercontroller定义了一个方法selectuser
,读取id为1的user信息,并返回user.jsp页面,访问的路径是/user/select,user.jsp位于 web-inf 的 jsp 文件夹下,代码如下:
<%@ page contenttype="text/html;charset=utf-8" language="java" %> <html> <head> <title>user</title> </head> <body> id:${requestscope.user.id}<br/> email:${requestscope.user.email}<br/> username:${requestscope.user.username}<br/> role:${requestscope.user.role}<br/> mobile:${requestscope.user.mobile}<br/> </body> </html>
都编写完毕以后,撤销applicationcontext.xml文件的注释符号,然后开启项目,成功后在浏览器输入
页面成功的返回了user信息,说明,我们成功访问到了数据库的内容。
至此,ssm项目的搭建大功告成,为了方便大家学习,我把源码放在了github上了,有需要的同学可以自行下载,地址:https://github.com/taoxj/mvcdemo
上一篇: 漫画图片也有内涵系列,就看你能领悟不能。
下一篇: DIV+CSS初学随记
推荐阅读