[Java知识库]ssm框架的整合笔记

ssm指是的 Spring Springmvc Mybatis
这三个框架都是 java 学习中必须征服的拦路虎, 然而, 这三个框架, 各自单独使用的话, 基本发挥不了作用, 所以, 只有把它们组合起来运用到项目中, 才能发挥它们的真正威力
下面是我的第一次整合成功的笔记 (又一个第一次没了)

我们要准备的 jar 包 (mvaen 项目)

1. spring-webmvc 这个jar包在引入的时候会自动的引入 spring 相关的 jar 包,

2. javax.servlet-api 和 jsp-api 这两个jar包, tomcat自带的也有, 这里也把它用 maven 引入一下
3. mybatis 这就是 mybatis 的jar包
4. mybatis-spring 这个是mybatis 专为 spring的集成而开发的 jar 包
5. druid 这个是阿里的 druid 数据库连接池所用的jar 包
6. mysql-connector-java 这是mysql 的 jdbc的jar 包
7. spring-tx , spring-jdbc 这是辅助 框架完成 jdbc 数据库 事务处理的 jar 包
8. jackson-databind 这是springmvc默认的 json 数据格式的处理 jar 包, 引入它就可以了, maven 会自动下载它的其它两个依赖

maven pom.xml 文件中部分修改

因为maven 项目默认只编译 java 目录中的 .java 文件, 但是我们有可能会在 java目录中,添加一些 .xml 的文件, 所以我们修改一下 maven pom.xml 中的配置, 让它可以编译我们的 xml , properties的文件到 类路径下, 修改方法如下 在 pom.xml 文件的 <build>标签下 添加

    <resources>
      <resource>
        <directory>src/main/java</directory>
        <includes>
          <include>**/*.properties</include>
          <include>**/*.xml</include>
        </includes>
        <!-- 是否替换资源中的属性-->
        <filtering>false</filtering>
      </resource>
      <resource>
        <directory>src/main/resources</directory>
        <!--
            <includes> 
            	<include>**/*.properties</include>
            	<include>**/*.xml</include> 
            </includes> 
            <filtering>true</filtering>
        -->
      </resource>
    </resources>

项目的目录结构

我们首先把项目的目录结构建好, 因为后面的配置文件会用到这些结构

上面的文件名就可以知道其用处了

编写配置文件

配置文件是这块的重头戏, 我们先来整理一下要有哪几个配置文件
mybatis的配置 它的配置文件有两用, 一个是主配置文件, 一个是mapper 文件
spring的配置 它是要生成bean , 并把 mybatis druid 都创建到容器中的
springmvc的配置文件 这是 web 功能中路由部分不可缺少的
web.xml 配置文件, DispatcherServlet 就是它这里创建的
jdbc.properties　的配置文件, 它的做用是记录 jdbc的连接信息, 方便更改数据库信息

jdbc.properties

	jdbc.Driver = com.mysql.cj.jdbc.Driver
	jdbc.Url = jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf8&serverTimezone=UTC
	jdbc.username = root;
	jdbc.password = 123456

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

<!--配置 DispatcherServlet 这是springmvc的中央调度器, 不能缺少-->
<servlet>
	<servlet-name>dispatcher</servlet-name>
	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	<init-param>  <!--这里用来指定 springmvc 的配置文件的位置 及 配置文件的名称-->
		<param-name>contextConfigLocation</param-name>
		<param-value>classpath:springmvc.xml</parma-vlaue>
	</init-param>
	<load-on-startup>1</load-on-startup>  <!--这里是说启动时就要创建这个servlet-->
</servlet>

<servlet-mapping>
	<servlet-name>dispatcher</servlet-name>
	<url-pattern>*.do</url-pattern>    <!-- 这里配置所有的 .do 结尾的请求, 都有 DispatcherServlet 来处理-->
</servlet-mapping>

<!--为springmvc 配置一个字符集过滤器, 所有的请求 都使用utf-8 编码-->
<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>forceRequestEncoding</param-name>
          <param-value>true</param-value>
     </init-param>
     <init-param>
          <param-name>forceResponseEncoding</param-name>
          <param-value>true</param-value>
     </init-param>
</filter>
<filter-mapping>
    <filter-name>charsetfilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

<!--这里添加一个了监听器, ContextLoaderListener 实现的是 servletContextlistener 接口, 所以
	这个监听器是在 tomact 启动的时候执行的, 只执行一次, 在它执行的时候, 同时也触发了, 创建spring的
	容器, 并在容器中把所有的 bean 注入到容器中, 等等初始化的工作, spring 加载配置文件, 也是在这里面
	完成的, 所以这个监听器背后是做了大量的工作的
-->
    <context-param>
    	<!--这里是指定了 spring 的配置文件的位置, 及配置文件的名称, 这个也不可以少-->
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring.xml</param-value>
    </context-param>

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

</web-app>

springmvc.xml springmvc的配置文件

我们在 web.xml中 指定的springmvc的配置文件的目录,和文件名

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

    <!--springmvc 的配置文件-->
	<!--配置 自动扫瞄 controller 目录下的注解, 生成控制器类-->
    <context:component-scan base-package="com.huang.controller"></context:component-scan>

	<!--这个 mvc:annotation-drivern 有很多作用, 返回json数据可能用到它, 当我们配置
	 dispatcherservlet 的转发 url 为 "/" 时, 也要用它,  所以一般它在 配置文件中不可缺少-->
    <mvc:annotation-driven/>

	<!--这是springmvc 中提供的视图解析器, 用于简化controller中的书写-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

spring.xml spring的配置文件

<?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 https://www.springframework.org/schema/context/spring-context.xsd">


	<!--引入 jdbc.properties 文件, 使用其中的配置-->
	<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="url" value="${jdbc.Url}"></property>
		<property name="username" value="${jdbc.username}"></property>
		<property name="password" value="${jdbc.password}"></property>
	</bean>

	<!-- 在容器中创建 mybatis使用的 sqlSessionFactory 对象-->
	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource"></property>  <!--这里说明一下, name="dataSource" 是指这个类中的一个属性名是叫 dataSource  后面的 ref = "dataSource" 是指赋的值, 指的是上一个 bean中创建的数据库过接池的数据源的 id -->
		<property name="configLocation" value="classpath:mybatis.xml"></property>
		<!--这里指明了 mybatis 配置文件的路径 -->
	</bean>
	
	<!--通过spring 的扫瞄把 dao中的接口 都生成出相应的代理对象, 加载进容器中-->
	<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
		<!--这个属性同样是一个引用类型的, 但这里没有使用 ref="xxxx" 而使用的字符串型的  value="xxxx" 这是一个特殊, 后面来解释  -->
		<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
		<!--这里指定了要生成代理类的文件所在的包 , 也就是 mapper 文件所在的包-->
		<property name="basePackage" value="com.huang.dao"></property>
	</bean>

	<!--这里扫瞄 service 目录, 把所有的 service类加入容器-->
    <context:component-scan base-package="com.huang.service"></context:component-scan>
</beans>

解释一下 为什么 property name=“sqlSessionFactoryBeanName” value=“sqlSessionFactory” 这里是一个引用对象, 却使用了一个value, 而没有使用 ref 我们可以看一下 sqlSessionFactoryBeanName的set 方法 , 它的参数就是一个字符串, 而不是一个引用类型的值

mybatis.xml mybatis的主配置文件

因为我们使用了数据库连接池, 所以mybatis的主配置文件不用再配置数据库的连接信息了

<?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>
    <settings>
    	<!--这里是配置记录日志-->
        <setting name="logImpl" value="STDOUT_LOGGING"></setting>
        <!-- <setting name="mapUnderscoreToCamelCase" value="true"></setting> -->
    </settings>

    <mappers>
        <!-- <mapper resource="org/mybatis/example/BlogMapper.xml"/> -->
        <!--这里如果使用 package的配置方式 就一定要却保  接口名称和 xml文件的名称一至
		比如 com.huang.dao下有一个文件 UserDao.java   
		那么它相对应的 mapper文件的名称就是 UserDao.xml-->
        <package name="com.huang.dao"/>
    </mappers>
</configuration>

mapper.xml mapper文件

mapper.xml文件和 dao接口文件是有很大关联关系的, 所以我们把 mapper和dao接口一起来对比
首先,它们要在同一目录下, 并且文件名是一样的

以上的配置文件中没有配置spring中的事务, 后面再说, 把上面的配置完成之后, 项目基本上就可以跑起来了