SSM项目整合纪实

一  前 言

  本来是为了探究一些功能性问题,需要一套完整的项目架构,本以为SSM用过那么多了,轻松搭建不在话下,但是过程中还是遇到一些问题,踩到一些未曾料想的坑。博文以搭建极简架构为目的,附带一些关键阐述,既是备忘,也是分享。

二  Maven奠基

  IDEA中用 Maven 的方式搭建 web 项目的时候如果你选择了 web 项目骨架,那么最终生成的项目目录结构是很不标准的一个目录结构,而如果不选择 web 项目骨架,产生的项目目录标准但却少了 web 目录。当然,基于IDEA的强大,肯定不至于让你手动去整理包结构,请按以下简单步骤操作即可:

  没有选择骨架的Maven项目结构如下——

  然后项目右键 Add Frameworks Support 添加 web 支持——

三  Java 配置集成 Spring+Spring MVC

  通常的做法是需要在 web.xml 中配置 Spring 初始化上下文的监听器 ContextLoaderListener 和 Spring MVC的核心 DispatcherServlet,它们会加载各自路径中的xml配置文件来产生各自的上下文对象。不过博主并不想这么做,而是采用纯 Java 配置的方式,所以本项目示例中没有 web.xml的存在。通过Java配置的方式,我们需要两个配置类,一个配置类扩展 WebApplicationInitializer 接口的派生类 AbstractAnnotationConfigDispatcherServletInitializer ,其会同时创建 ContextLoaderListener 和 DispatcherServlet 的上下文,并根据需要配置 DispatcherServlet 的映射路径和相关配置类:

public class BluesInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    //给定的Java 配置类将定义 ContextLoaderListener 上下文中的 bean 实例 本示例中没有给出根配置类
    protected Class<?>[] getRootConfigClasses() {
        return new Class[0];
    }

    // 给定的Java 配置类将定义 DispatcherServlet 上下文的bean 实例
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{WebConfig.class};
    }

    // 配置一个或多个 映射路径
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

  另一个就是MVC的基础配置类——

@Configuration
@ComponentScan(basePackages = {"net"})
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {

    //配置视图解析器
    @Bean
    public ViewResolver viewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/pages/");
        resolver.setSuffix(".jsp");
        return resolver;
    }

    /**
     * 通过继承 WebMvcConfigurerAdapter 类的方式配置静态资源请求
     * 将对静态资源的访问交由容器中默认的 Servlet 处理
     */
    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        /** 相当于 xml 配置中的 <mvc:default-servlet-handler /> 配置 */
        configurer.enable();
    }
}

  完成两个配置类后其实Spring和Spring MVC就已经配置完了,你可以编写控制器做页面跳转测试,这里限于篇幅博主不再贴出。想要知道为什么能用以上的Java配置取代经常用的 web.xml中的配置 ,首先你必须得清楚 web.xml 中的 ContextLoaderListener 和 DispatcherServlet 的作用。关于这两者的深层理解,可参考一位博友的源码分析,这里博主还是按照己的理解来叙述:      

  ContextLoaderListener 是Spring的一个监听器,当其监听到容器启动会根据定义文件(可以理解为创建 bean 实例及维护bean依赖关系的图纸,默认是WEB-INF下的applicationContext.xml文件)创建Spring的上行下对象,也即容器对象,有了该容器对象程序运行时才能从容器中获取到bean; DispatcherServlet 本质就是一个Servlet ,所以,Servlet容器启动时自然会将其初始化(<load-on-startup>配置为正数),关键这家伙是 Spring 的,功能很强大,也能够根据自己的 xml定义文件(默认 WEB-INF下的【servlet-name】-servlet.xml)产生一个上下文对象,这个上下文容器对象负责管理维护Spring MVC生态体系中的 控制器啊,视图解析器,处理映射器等bean;这两个容器对象有关系吗,当然有关系,可以粗浅的理解为父子关系,前者是整个应用的根容器对象,是全局的,后者只是管理应用于Servlet相关组件。

    而为什么扩展了AbstractAnnotationConfigDispatcherServletInitializer 类就能完成上述相同的功能呢?因为在Servlet 3.0 规范中,为第三方组件提供了一个叫 ServletContainerInitializer 的接口用来做一些初始化相关的工作,第三方组件只要实现此接口就可以完成自己的一些初始化操作。在Spring中提供的实现类叫 SpringServletContainerInitializer ,追踪源码,你可以发现,真正的初始化配置其实是交给 WebApplicationInitializer 接口的子类来完成的,而上面代码中的 AbstractAnnotationConfigDispatcherServletInitializer 就是WebApplicationInitializer 接口的子类,所以,我们可以继承该类,根据业务需求重写相应的方法,来完成我们初始化Spring 和Spring MVC 上下文的相关配置。至此,我想你应该能看懂上面的配置是什么意思以及和web.xml中的配置的对应关系了。

四  整合Mybatis

  持久层的整合无需多说,在资源文件夹下新建 spring-mybatis.xml 和 db.properties文件,依次配置连接数据库的数据源(应该从 db.properties中获取数据库连接信息 )、生成SqlSession 的 SqlSessionFactory定义(其依赖于数据源和mapper.xml文件路径)以及映射器配置类 MapperScannerConfigurer。spring-mybatis.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"
       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 ">

    <!--加载数据库配置文件 -->
    <context:property-placeholder location="classpath:db.properties"/>

    <!--配置数据源 这里是配置的druid 连接池-->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
        <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="1" />
        <property name="minIdle" value="1" />
        <property name="maxActive" value="3" />
        <!--超时设置-->
        <property name="maxWait" value="10000" />
    </bean>

    <!--配置 SqlSessionFactory 全局单例 一个数据库应该只对应一个 SqlSessionFactory-->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="mapperLocations" value="classpath:mapper/*.xml"/>
    </bean>
    <!--配置 MapperScannerConfigurer 来配置映射器,通过扫描相应包下的接口生成动态代理对象交由Spring 管理-->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="net.dao"/>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    </bean>

</beans>

  现在这个配置文件Spring容器是不知道的,需要在上面的Java配置类WebConfig上标注 @ImportResource("classpath:spring-mybatis.xml") 进行引入。然后,来一个mapper.xml配置示例:

<?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">
<mapper namespace="net.dao.ProductDao">
    <select id="queryProducts" resultType="net.entity.Product">
            select * from products
    </select>
</mapper>

五  避坑指南

  ① IDEA编译问题

  有时候我们可能会将mapper.xml文件写在dao下面的mapper包里,但是在IDEA的Maven项目中,编译器只会对java包下面.java文件进行编译处理,而忽略掉其中的资源文件,在运行时就会找不到相应的配置文件。所以资源文件最好直接放在resources目录中,如果确实需要放在java目录中,需在pom.xml中配置(配置链接)。

  ② 缺少 jdbc 支持异常

  ③ 返回参数类型错误

附 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.buyi</groupId>
    <artifactId>blues</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <spring.version>4.3.7.RELEASE</spring.version>
    </properties>

    <dependencies>
        <!--spring mvc 依赖引入,因为相互依赖的关系,实际上也就引入了 Spring 的几大核心包,不需要单独的引入 core beans之类的依赖-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!--spring-jdbc 支持-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!--Mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.2</version>
        </dependency>
        <!--spring-mybatis整合包-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>1.3.1</version>
        </dependency>

        <!--数据库驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.25</version>
            <scope>runtime</scope>
        </dependency>
        <!--数据库连接池-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.0.12</version>
        </dependency>

        <!--测试支持-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>${spring.version}</version>
        </dependency>
    </dependencies>
</project>


原文地址:https://www.cnblogs.com/chenbenbuyi/p/10804672.html

时间: 2024-11-06 20:55:45

SSM项目整合纪实的相关文章

SSM项目整合基本步骤

SSM项目整合 1.基本概念 1.1.Spring Spring 是一个开源框架, Spring 是于 2003  年兴起的一个轻量级的 Java  开发框架,由 Rod Johnson  在其著作 Expert One-On-One J2EE Development and Design 中阐述的部分理念和原型衍生而来.它是为了解决企业应用开发的复杂性而创建的. Spring 使用基本的 JavaBean 来完成以前只可能由 EJB 完成的事情.然而, Spring 的用途不仅限于服务器端的开

SSM项目整合

SSM项目整合基本步骤 SSM项目整合 1.基本概念 1.1.Spring Spring 是一个开源框架, Spring 是于 2003  年兴起的一个轻量级的 Java  开发框架,由 Rod Johnson  在其著作 Expert One-On-One J2EE Development and Design 中阐述的部分理念和原型衍生而来.它是为了解决企业应用开发的复杂性而创建的. Spring 使用基本的 JavaBean 来完成以前只可能由 EJB 完成的事情.然而, Spring 的

SSM 框架 ---项目整合

一.SSM框架理解 Spring(业务层) Spring就像是整个项目中装配bean的大工厂,在配置文件中可以指定使用特定的参数去调用实体类的构造方法来实例化对象. Spring的核心思想是IoC(控制反转),即不再需要程序员去显式地`new`一个对象,而是让Spring框架帮你来完成这一切. Spring IOC:负责创建对象.管理对象(通过依赖注入).整合对象.配置对象以及管理这些对象的生命周期.IOC主要来解决对象之间的依赖问题,把所有的bean的依赖关系通过配置文件或者注解关联起来,降低

(转)shiro权限框架详解06-shiro与web项目整合(下)

http://blog.csdn.net/facekbook/article/details/54962975 shiro和web项目整合,实现类似真实项目的应用 web项目中认证 web项目中授权 shiro缓存 sessionManager使用 验证码功能实现 记住我功能实现 web项目中认证 实现方式 修改CustomRealm 的 doGetAuthenticationInfo 方法,从数据库中获取用户信息,CustomRealm 返回查询到的用户信息,包括(加密后的密码字符串和salt

(转) shiro权限框架详解06-shiro与web项目整合(上)

http://blog.csdn.net/facekbook/article/details/54947730 shiro和web项目整合,实现类似真实项目的应用 本文中使用的项目架构是springMVC+mybatis,所以我们是基于搭建好的项目进行改造的. 将shiro整合到web应用中 登录 退出 认证信息在页面展现,也就是显示菜单 shiro的过滤器 将shiro整合到web应用中 数据库脚步 sql脚步放到项目中,项目上传到共享的资源中,文章最后给出共享url. 去除项目中不使用shi

SSM框架整合详细教程(Spring+SpringMVC+Mabatis)

当前最火热的SSM框架整合教程,超级详细版 直接到正题,利用了最新稳定的框架 需要自己在Maven下搭建web工程 项目结构图: spring-mvc.xml <?xml version="1.0" encoding="UTF-8"?>   <beans xmlns="http://www.springframework.org/schema/beans"       xmlns:xsi="http://www.w3.

ssm+redis整合(通过cache方式)

这几天的研究ssm redis 终于进入主题了,今天参考了网上一些文章搭建了一下ssm+redis整合,特别记录下来以便以后可以查询使用,有什么不足请大牛们提点 项目架构 1.pom.xml <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http:/

SpringMVC与ssm的整合

1.SpringMVC的框架原理图: 第一步:发起请求到前端控制器(DispatcherServlet) 第二步:前端控制器请求HandlerMapping查找 Handler 可以根据xml配置.注解进行查找 第三步:处理器映射器HandlerMapping向前端控制器返回Handler 第四步:前端控制器调用处理器适配器去执行Handler 第五步:处理器适配器去执行Handler 第六步:Handler执行完成给适配器返回ModelAndView 第七步:处理器适配器向前端控制器返回Mod

简单搭建一个SSM项目

简单搭建一个用户管理的SSM项目框架,虽然也能用servlet+jdbc搭建更简单的,不过个人感觉工作中更多用的ssm框架项目,这里就简单用ssm来搭建需要的项目吧. 准备工具:eclipse.jdk1.7.Mysql.maven.tomcat.(请先确定计算机本身已安装好前面几个工具,myeclipse自动集成maven,eclipse需要自己先配置,具体配置请自行百度) 这里先把项目的目录结构显示下 好的,现在开始 File->new->other->maven project Ne