欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

用idea搭建SSM项目,原来这么简单

程序员文章站 2022-04-23 08:21:44
[toc] 前言 前阵子突发奇想,想学习下SpringMVC的源码,于是打算用idea搭建一个简易的maven版SSM案例,也就是SpringMVC+Spring+MyBatis+Maven,因为之前创建过一些Spring的小demo,相关的软件环境已经搭建完成,本以为搭建一个入门级的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

用idea搭建SSM项目,原来这么简单

找到maven一栏,因为要搭建的springmvc项目,所以选择webapp模板

用idea搭建SSM项目,原来这么简单

填写好groupid和artifactid后,一步步next,最后finish完成

用idea搭建SSM项目,原来这么简单

创建成功后,可以看到项目是这样的目录结构

用idea搭建SSM项目,原来这么简单

除了配置相关依赖的pom.xml,目录中还有一个文件夹src,src的main目录提供了一个webapp文件夹,webapp文件夹下有一个web-inf文件夹,放置的是前端页面的文件,以及web.xml文件。

除了模版提供的目录结构,为了后面项目能成功运行,我们还需要添加一些文件夹,让项目的目录结构变成这样:

用idea搭建SSM项目,原来这么简单

数据库文件

首先,先准备好数据库文件,并初始化一条记录

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...

用idea搭建SSM项目,原来这么简单

选择tomcat server - local,

用idea搭建SSM项目,原来这么简单

编辑好项目的启动信息,包括项目名,jdk版本,tomcat以及端口

用idea搭建SSM项目,原来这么简单

选择deployment,添加atifact,选择第二项,否则tomcat运行会报错

用idea搭建SSM项目,原来这么简单

保存后,启动项目,成功后在浏览器输入,返回结果如下:
用idea搭建SSM项目,原来这么简单

这是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文件的注释符号,然后开启项目,成功后在浏览器输入

用idea搭建SSM项目,原来这么简单

页面成功的返回了user信息,说明,我们成功访问到了数据库的内容。

至此,ssm项目的搭建大功告成,为了方便大家学习,我把源码放在了github上了,有需要的同学可以自行下载,地址:https://github.com/taoxj/mvcdemo