手刃SSM(Spring+SpringMVC+Mybatis)--第一弹

@(关键字)[Spring|SpringMVC|Mybatis]


主要框架简介

Spring:Spring官方文档;
SpringMVC:SpringMVC官方文档;
Mybatis:Mybatis官方文档.

动手干起来

一、eclipse中新建Maven项目

  1. 如下图,选择Catalogs中的maven-archetype-webapp;

为什么选择maven-archetype-webapp?
我们需要建的是web工程,所以直接使用这个创建于web项目相关的文件夹和项目目录结构,就是这样子

1_New project_maven.png

  1. 之后Next,输入Group Id和Artifact Id就可以点击Ok了。

Group Id:项目的全球唯一标识符,通常使用全限定的包名区分该项目和其他项目。并且构建时生成的路径也是由此生成, 如com.company.app生成的相对路径为:/com/company/app
Artifact Id:构件的标识符,它和group ID一起唯一标识一个构件。

  1. 等待maven自动构建项目结构,在完成之后,可能会出现以下情况:
  1. 错误:在index.jsp文件中报错:The superclass "javax.servlet.http.HttpServlet" was not found on the Java Build Path
    解决方案:在项目名上点击右键,找到build path->library->add library->Server Runtime->选择你的服务器(tomcat 7/8);
  1. 在完成以上步骤之后,将必要的源码包补全,项目结构如下图:


    5_project_struct.png

二、开始写代码

  1. 根据spring+springMVC+mybatis+Mysql+log4j框架,决定我们此项目所需要哪些依赖。关键几个框架所用到的版本号如下:
<properties> 
  <maven.compiler.target>1.8</maven.compiler.target
  <maven.compiler.source>1.8</maven.compiler.source
  <mysql.version>5.1.38</mysql.version
  <druid.version>1.0.18</druid.version
  <servlet.version>3.1.0</servlet.version
  <jedis.version>2.7.3</jedis.version
  <protostuff.version>1.0.8</protostuff.version
  <spring.version>4.0.2.RELEASE</spring.version
  <mybatis.version>3.2.6</mybatis.version
  <slf4j.version>1.7.7</slf4j.version> <log4j.version>1.2.17</log4j.version
</properties>
  1. 配置web.xml文件,所有配置将添写注释

在web.xml文件中,主要配置servlet及其映射关系、监听器和过滤器。具体可参考源码

<web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
          http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    version="3.0">

    <display-name>Archetype Created Web Application</display-name>
    
    <!-- Log4j配置文件 -->
    <context-param>
        <param-name>log4jConfigLocation</param-name>
        <param-value>classpath:log4j.xml</param-value>
    </context-param>
    <context-param>
        <param-name>log4jRefreshInterval</param-name>
        <param-value>60000</param-value>
    </context-param>
    <listener>
        <listener-class>
            org.springframework.web.util.Log4jConfigListener
        </listener-class>
    </listener>
    
    <servlet>
        <display-name>SpringRain</display-name> <!-- 项目名称 -->
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 配置springMVC需要加载的配置文件 spring-dao.xml,spring-service.xml,spring-web.xml 
            Mybatis - > spring -> springmvc -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring/spring-*.xml</param-value>
        </init-param>
        
         <load-on-startup>1</load-on-startup>  <!-- 容器加载该Servlet的优先级 -->
        <async-supported>true</async-supported><!-- 启动异步支持 -->
    </servlet>
    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <!-- 默认匹配所有的请求 -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!--druid WEB方式监控配置 -->
    <servlet>
        <servlet-name>DruidStatView</servlet-name>
        <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>DruidStatView</servlet-name>
        <url-pattern>/druid/*</url-pattern>
    </servlet-mapping>
    <filter>
        <filter-name>druidWebStatFilter</filter-name>
        <filter-class>com.alibaba.druid.support.http.WebStatFilter</filter-class>
        <init-param>
            <param-name>exclusions</param-name>
            <param-value>/public/*,*.js,*.css,/druid*,*.jsp,*.swf</param-value>
        </init-param>
        <init-param>
            <param-name>principalSessionName</param-name>
            <param-value>sessionInfo</param-value>
        </init-param>
        <init-param>
            <param-name>profileEnable</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>druidWebStatFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    
    <!-- 编码过滤器 -->
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter
        </filter-class>
        <async-supported>true</async-supported>
        <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>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    
    <!-- 默认页面 -->
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
    <!-- 错误页面的处理 -->
    <error-page>
        <exception-type>java.lang.NullPointerException</exception-type>
        <location>/WEB-INF/common/error.html</location>
    </error-page>
    <error-page>
        <exception-type>java.lang.NumberFormatException</exception-type>
        <location>/WEB-INF/common/error.html</location>
    </error-page>
    <error-page>
        <error-code>404</error-code>
        <location>/WEB-INF/common/404.html</location>
    </error-page>
    <error-page>
        <error-code>500</error-code>
        <location>/WEB-INF/common/500.html</location>
    </error-page>
    
</web-app>

3.配置spring-mybatis.xml文件

该文件主要整合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: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">

    <!-- 本文件整合Spring与Mybatis -->
    <!-- 使用数据库配置文件,可以使得配置解耦 -->
    <context:property-placeholder location="classpath:jdbc.properties"/>
    
    <!-- Druid配置 -->
    <!-- 数据库连接池相关 -->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"
            init-method="init" destroy-method="close">
          <!-- 配置连接池属性 -->
          <property name="driverClassName" value="${jdbc.driver}"/>
          <property name="url" value="${jdbc.url}"/>
          <property name="username" value="${jdbc.username}"/>
          <property name="password" value="${jdbc.password}"/>

          <!-- 配置初始化大小、最小、最大 -->
          <property name="initialSize" value="${initialSize}" />
          <property name="maxIdle" value="${maxIdle}" />
          <property name="minIdle" value="${minIdle}" />
          <property name="maxActive" value="${maxActive}" />

          <!-- 配置获取连接等待超时的时间 -->
          <property name="maxWait" value="10000" />

          <!-- 配置间隔多久才进行一次检测,检测需要关闭的空闲连接,单位是毫秒 -->
          <property name="timeBetweenEvictionRunsMillis" value="60000" />

          <!-- 配置一个连接在池中最小生存的时间,单位是毫秒 -->
          <property name="minEvictableIdleTimeMillis" value="300000" />

          <property name="testWhileIdle" value="true" />

          <!-- 这里建议配置为TRUE,防止取到的连接不可用 -->
          <property name="testOnBorrow" value="true" />
          <property name="testOnReturn" value="false" />

          <!-- 打开PSCache,并且指定每个连接上PSCache的大小 -->
          <property name="poolPreparedStatements" value="true" />
          <property name="maxPoolPreparedStatementPerConnectionSize"
                    value="20" />

          <!-- 这里配置提交方式,默认就是TRUE,可以不用配置 -->

          <property name="defaultAutoCommit" value="true" />

          <!-- 验证连接有效与否的SQL,不同的数据配置不同 -->
          <property name="validationQuery" value="select 1 " />
          <property name="filters" value="stat" />
          <property name="proxyFilters">
              <list>
                  <ref bean="logFilter" />
              </list>
          </property>
      </bean>
      
      <bean id="logFilter" class="com.alibaba.druid.filter.logging.Slf4jLogFilter">
          <property name="statementExecutableSqlLogEnable" value="false" />
      </bean>
      
      <!-- 配置SqlSessionFactory对象 -->
      <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
          <!-- 注入数据库连接池 -->
          <property name="dataSource" ref="dataSource"/>
          <!-- 配置Mybatis全局配置文件:mybatis-config.xml -->
          <property name="configLocation" value="classpath:mybatis-config.xml"/>
          <!-- 扫描entity包 使用别名 -->
          <!-- 即项目的GroupId -->
          <property name="typeAliasesPackage" value="com.person.entity"/>
          <!-- 扫描sql配置文件:mapper需要的xml文件 -->
          <property name="mapperLocations" value="classpath:mapper/*.xml"/>
      </bean>
      
      <!-- 配置扫描Dao接口包,动态实现Dao接口,注入到spring容器中 -->
      <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
          <!-- 注入sqlSessionFactory -->
          <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
          <!-- 给出需要扫描Dao接口包 -->
          <property name="basePackage" value="com.person.dao"/>
      </bean>
      
      <!-- none -->
      <!-- 事务管理配置 -->
    <!-- <bean id="transactionManager"
        class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource" />
    </bean> -->
    
    <!-- AOP切面 -->
    <!-- <aop:aspectj-autoproxy /> -->
    <!-- 自动装载aop -->
    <!-- <bean id="logAspect" class="com.person.aop.LogAspect" /> --><!-- 切面定义(采用注解的方式定义及使用) -->
    
      
</beans>

4.配置spring-service.xml文件

该文件主要配合事务处理相关的bean;

<?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"
         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">

      <!-- 扫描service包下所有使用注解的类型 -->
      <!-- package值为"GroupId+存放services的包名 -->
      <context:component-scan base-package="com.person.service" />

      <!-- 配置事务管理器 -->
      <bean id="transactionManager"
            class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
          <!-- 注入数据库连接池 -->
          <property name="dataSource" ref="dataSource" />
      </bean>

      <!-- 配置基于注解的声明式事务 -->
      <tx:annotation-driven transaction-manager="transactionManager" />
  </beans>

5.配置spring-web.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">
    <!-- 配置SpringMVC -->
    <!-- 开启SpringMVC注解模式 -->
    <mvc:annotation-driven/>
    <!-- 静态资源默认servlet配置 -->
     <mvc:resources location="/static/common/" mapping="/common/**"/>
    <mvc:resources  location="/static/css/" mapping="/css/**"/>
    <mvc:resources  location="/static/images/" mapping="/images/**" />
    <mvc:resources  location="/static/view/" mapping="/view/**" />
    <mvc:default-servlet-handler/>

    <!-- 配置jsp 显示ViewResolver -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/WEB-INF/view/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 扫描web相关的bean -->
    <context:component-scan base-package="com.person.controller">
        <!-- 制定扫包规则 ,只扫描使用@Controller注解的JAVA类 -->
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

</beans>

6.在经过以上步骤,基本上已完成了框架的整合,但是在配置过程中,我们在配置文件中又引入了jdbc.properties、log4j.xml、mybatis-config.xml三个文件,故我们需要在src/main/resources目录中新建并配置这几个文件。具体代码参考github项目

7.将项目部署到tomcat中,在浏览器总访问http:localhost:8080/SpringRain,将会访问到index.jsp页面

8.配置结束

9.上传github

有关上传项目到github的教程请参考我的另一篇文章-->"从零开始Git"。

反馈与建议


非常感谢您阅读这份帮助文档。点击分享按钮,分享给更多的人呗。


wechat.jpg

推荐阅读更多精彩内容