Explication détaillée de la configuration du fichier d'intégration Spring, Spring MVC et MyBatis

J'ai réalisé plusieurs petits projets en utilisant le framework SSM, et ça fait du bien qu'il soit temps de résumer. Résumons d’abord la configuration des fichiers de l’intégration SSM. En fait, il est préférable de lire la documentation officielle pour un usage spécifique.

Printemps : http://spring.io/docs

​MyBatis : http://mybatis.github.io/mybatis-3/

Je n’entrerai pas dans la structure organisationnelle de base et son utilisation. Les blogs et documents officiels précédents sont très complets. Les packages Jar peuvent être organisés et gérés à l’aide de Maven. Regardons le fichier de configuration.

Configuration Web.xml

web.xml devrait être le fichier de configuration le plus important de l'ensemble du projet, mais servlet3.0 prend déjà en charge la configuration des annotations. Avant servlet3.0, chaque servlet doit configurer le servlet et sa relation de mappage dans web.xml. Mais ce n'est pas nécessaire dans le framework Spring, car Spring est une injection de dépendances, également appelée Inversion de contrôle. Mais vous devez également configurer un servlet important, qui est le contrôleur frontal (DispatcherServlet). La méthode de configuration est fondamentalement similaire à une servlet ordinaire.

Le contenu de la configuration est le suivant :

<!-- 配置前端控制器 -->
  <servlet>
      <servlet-name>spring</servlet-name>
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      <init-param>
          <!-- ContextconfigLocation配置springmvc加载的配置文件
          适配器、处理映射器等
           -->
          <param-name>contextConfigLocation</param-name>
          <param-value>WEB-INF/classes/spring/springmvc.xml</param-value>
  </init-param>
  </servlet>
  <servlet-mapping>
      <servlet-name>spring</servlet-name>
      <!-- 1、.action访问以.action结尾的  由DispatcherServlet进行解析
           2、/,所有访问都由DispatcherServlet进行解析
       -->
      <url-pattern>/</url-pattern>
  </servlet-mapping>

Il convient de noter ici que springmvc.xml est le fichier de configuration Spring, qui sera discuté plus tard. Si l'URL dans est .action, le contrôleur frontal interceptera uniquement les requêtes se terminant par .action et ignorera les fichiers statiques. Le contrôle des pages statiques nécessite d'autres moyens. L'utilisation de / comme URL interceptera toutes les requêtes, y compris les requêtes de pages statiques. De cette façon, vous pouvez intercepter toute demande que vous souhaitez traiter, mais il y a un problème. Si toutes les requêtes sont interceptées et si le traitement correspondant n'est pas effectué dans l'intercepteur, tous les js, css et images statiques utilisés dans la page seront inaccessibles et la page ne s'affichera pas normalement. Mais ce problème peut être résolu grâce à la configuration de ressources statiques. Sera mentionné plus tard.

Configurer le conteneur Spring :

<context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>WEB-INF/classes/spring/applicationContext-*.xml</param-value>

</context-param>

Parmi eux, applicationContext-*.xml contient 3 fichiers de configuration, qui sont les configurations spécifiques du conteneur springIoC. Sera mentionné plus tard.

Configurer un écouteur :

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

La configuration complète de web.xml est la suivante :

      
  
  
  
    404
    /error404.jsp
  
  
  
    500
    /error500.jsp
  
  
  
    
        contextConfigLocation
        WEB-INF/classes/spring/applicationContext-*.xml
    
    
        org.springframework.web.context.ContextLoaderListener
    

    
  <!-- 配置前端控制器 -->
  <servlet>
      <servlet-name>spring</servlet-name>
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      <init-param>
          <!-- ContextconfigLocation配置springmvc加载的配置文件
          适配器、处理映射器等
           -->
          <param-name>contextConfigLocation</param-name>
          <param-value>WEB-INF/classes/spring/springmvc.xml</param-value>
  </init-param>
  </servlet>
  <servlet-mapping>
      <servlet-name>spring</servlet-name>
      <!-- 1、.action访问以.action结尾的  由DispatcherServlet进行解析
           2、/,所有访问都由DispatcherServlet进行解析
       -->
      <url-pattern>/</url-pattern>
  </servlet-mapping>
    
  
  
      CharacterEncodingFilter
      org.springframework.web.filter.CharacterEncodingFilter
      
          encoding
          utf-8
      
  
  
      CharacterEncodingFilter
      /*
  
  
    welcome.jsp
    
    

Vérifiez qu'il y a deux autres éléments de contenu dans le fichier de configuration. L'un est la page d'erreur, qui est utilisée pour gérer les erreurs de manière conviviale. Vous pouvez utiliser le code d'erreur pour distinguer et accéder à la page de traitement correspondante. Il est préférable de placer ce code de configuration au premier plan et de le traiter avant que le contrôleur frontal ne l'intercepte.

Un autre élément de contenu est un filtre pour résoudre le problème de publication tronqué. Il intercepte les demandes de publication et les code en utf8.

Configuration de springmvc.xml                                                                                                                   Afficher la configuration du résolveur :

Lors de la définition du nom de la vue dans le contrôleur, le préfixe et le suffixe seront automatiquement ajoutés.

<!-- 配置视图解析器 -->
     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
         <!-- 使用前缀和后缀 -->
         <property name="prefix" value="/"></property>
         <property name="suffix" value=".jsp"></property>
</bean>

Configuration du contrôleur

Le mode d'analyse automatique analyse tous les contrôleurs du package et vous pouvez utiliser des annotations pour spécifier le chemin d'accès.

Vous pouvez également utiliser une seule méthode de configuration et vous devez spécifier le nom complet du contrôleur.

<!-- 使用组件扫描的方式可以一次扫描多个Controller -->
<context:component-scan base-package="com.wxisme.ssm.controller">

Configurez l'adaptateur de processeur annoté et le mappeur de processeur :

<bean name="/queryUser.action" class="com.wxisme.ssm.controller.Controller1"/>

Vous pouvez également utiliser la configuration simplifiée suivante :

<!-- 注解的处理器适配器 -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>
<!-- 注解的处理器映射器 -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>

Configurez l'intercepteur, vous pouvez définir directement pour intercepter toutes les demandes, ou vous pouvez personnaliser le chemin d'interception.

<!-- 配置注解的处理器映射器和处理器适配器 -->
<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

Configurer le gestionnaire d'exceptions global

<mvc:interceptors>
    <!-- 直接定义拦截所有请求 -->
    <bean class="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
        <!-- <mvc:interceptor>
            拦截所有路径的请求   包括子路径
            <mvc:mapping path="/**"/>
            <bean class="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
        </mvc:interceptor> -->
    </mvc:interceptors>

Configurez l'analyseur de données de téléchargement de fichiers, qui doit être configuré lors du téléchargement de fichiers.

<!-- 定义全局异常处理器 -->
    <!-- 只有一个全局异常处理器起作用 -->
    <bean id="exceptionResolver" class="com.wxisme.ssm.exception.OverallExceptionResolver"></bean>

Vous pouvez également configurer certains types de paramètres personnalisés, en prenant comme exemple la liaison de type de date.

<!--配置上传文件数据解析器  -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="maxUploadSize">
            <value>9242880</value>
        </property>
    </bean>

Comme mentionné ci-dessus, si toutes les requêtes sont interceptées lors de la configuration du contrôleur frontal, certaines ressources statiques deviendront inutilisables sans traitement spécial. Si tel est le cas, vous pouvez utiliser la configuration suivante pour accéder aux fichiers de ressources statiques.

<!-- 自定义参数类型绑定 -->
    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
     <property name="converters">
         <list>
             <!-- 日期类型绑定 -->
             <bean class="com.wxisme.ssm.controller.converter.DateConverter"/>
         </list>
     </property>
    </bean>

Vous pouvez également utiliser la valeur par défaut, mais elle doit être configurée dans web.xml.

<mvc:resources mapping="/images/**" location="/images/" />
<mvc:resources mapping="/css/**" location="/css/" />  
<mvc:resources mapping="/js/**" location="/js/" />
<mvc:resources mapping="/imgdata/**" location="/imgdata/" />

Vous pouvez éviter ce problème en ne bloquant pas tous les chemins.

<!-- 访问静态资源文件 -->
    <!-- <mvc:default-servlet-handler/> 需要在web.xml中配置-->

La configuration complète ressemble probablement à ceci. Vous devez faire attention à l'espace de noms du fichier XML, ce qui a parfois un impact.

Configuration ApplicationContext-*.xml

    
    
     
     
         
         
         
     
     
     
     
     
     
    
    
    <!-- 自定义参数类型绑定 -->
    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
     <property name="converters">
         <list>
             <!-- 日期类型绑定 -->
             <bean class="com.wxisme.ssm.controller.converter.DateConverter"/>
         </list>
     </property>
    </bean>
    
    
    <!-- 访问静态资源文件 -->
    <!-- <mvc:default-servlet-handler/> 需要在web.xml中配置-->
    
    
      
    
    
    
    
    <mvc:interceptors>
    <!-- 直接定义拦截所有请求 -->
    <bean class="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
        <!-- <mvc:interceptor>
            拦截所有路径的请求   包括子路径
            <mvc:mapping path="/**"/>
            <bean class="com.wxisme.ssm.interceptor.IdentityInterceptor"></bean>
        </mvc:interceptor> -->
    </mvc:interceptors>
    
    <!--配置上传文件数据解析器  -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="maxUploadSize">
            <value>9242880</value>
        </property>
    </bean>
    
    <!-- 定义全局异常处理器 -->
    <!-- 只有一个全局异常处理器起作用 -->
    <bean id="exceptionResolver" class="com.wxisme.ssm.exception.OverallExceptionResolver"></bean>
    
 

                                              🎜>

　　applicationContext-*.xml包括三个配置文件，分别对应数据层控制、业务逻辑service控制和事务的控制。

　　数据访问层的控制，applicationContext-dao.xml的配置：

　　配置加载数据连接资源文件的配置，把数据库连接数据抽取到一个properties资源文件中方便管理。

　　配置为：

<!-- 加载数据库连接的资源文件 -->
<context:property-placeholder location="/WEB-INF/classes/jdbc.properties"/>

　　其中jdbc.properties文件的内容如下：

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/database
jdbc.username=root
jdbc.password=1234

　　配置数据库连接池，这里使用的是dbcp，别忘了添加jar包！

<!-- 配置数据源   dbcp数据库连接池 -->
<bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource" 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}"/>
</bean>

　　Spring和MyBatis整合配置，jar包由MyBatis提供。

　　配置sqlSessionFactory

<!-- 配置sqlSessionFactory -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <!-- 数据库连接池 -->
    <property name="dataSource" ref="dataSource"/>
    <!-- 加载Mybatis全局配置文件 -->
    <property name="configLocation" value="/WEB-INF/classes/mybatis/SqlMapConfig.xml"/>

</bean>

　　SqlMapConfig.xml文件是MyBatis的配置文件，后面会提到。

　　配置Mapper扫描器，扫描mapper包下的所有mapper文件和类，要求mapper配置文件和类名需要一致。

<!-- 配置mapper扫描器 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <!-- 扫描包路径，如果需要扫描多个包中间用半角逗号隔开 -->
    <property name="basePackage" value="com.wxisme.ssm.mapper"></property>
    <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>

　　整个applicationContext-dao.xml配置文件应该是这样的：

<!-- 加载数据库连接的资源文件 -->
<context:property-placeholder location="/WEB-INF/classes/jdbc.properties"/>

<!-- 配置数据源   dbcp数据库连接池 -->
<bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource" 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}"/>
</bean>



    
    
    
    


<!-- 配置mapper扫描器 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <!-- 扫描包路径，如果需要扫描多个包中间用半角逗号隔开 -->
    <property name="basePackage" value="com.wxisme.ssm.mapper"></property>
    <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>

　　业务逻辑控制，applicationContext-service.xml的配置：

　　这个文件里暂时只需要定义service的实现类即可。

<!-- 定义service -->
<bean id="userService" class="com.wxisme.ssm.service.impl.UserServiceImpl"/>

　　事务控制，applicationContext-transaction.xml的配置

　　配置数据源，使用JDBC控制类。

<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <!-- 配置数据源 -->
    <property name="dataSource" ref="dataSource"/>
</bean>

　　配置通知，事务控制。

<!-- 通知 -->
    <tx:advice id="txAdvice" transaction-manager="transactionManager">
        <tx:attributes>
            <!-- 传播行为 -->
            <tx:method name="save*" propagation="REQUIRED"/>
            <tx:method name="insert*" propagation="REQUIRED"/>
            <tx:method name="update*" propagation="REQUIRED"/>
            <tx:method name="delete*" propagation="REQUIRED"/>
            <tx:method name="find*" propagation="SUPPORTS" read-only="true"/>
            <tx:method name="select*" propagation="SUPPORTS" read-only="true"/>
        </tx:attributes>
    </tx:advice>

　　配置AOP切面

<!-- 配置aop  -->
    <aop:config>
        <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.wxisme.ssm.service.impl.*.*(..))"/>
    </aop:config>

　　整个事务控制的配置是这样的：

    


<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <!-- 配置数据源 -->
    <property name="dataSource" ref="dataSource"/>
</bean>
    
    
    
        
            
            
            
            
            
            
                        
        
    
    
    <!-- 配置aop  -->
    <aop:config>
        <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.wxisme.ssm.service.impl.*.*(..))"/>
    </aop:config>

　　MyBatis的配置                                                                                                                                             

　　SqlMapConfig.xml的配置   全局setting配置这里省略，数据库连接池在spring整合文件中已经配置，具体setting配置参考官方文档。

　　别名的定义：

<typeAliases>
    <!-- 批量定义别名 ，指定包名，自动扫描包中的类，别名即为类名，首字母大小写无所谓-->
    <package name="com.wxisme.ssm.po"/>
</typeAliases>

　　mapper映射文件的配置：

<mappers>
    <!-- 加载映射文件 -->
    <!-- 这里也可以使用class来加载映射文件，前提是：使用mapper代理的方法，遵循规范，
    并且两个文件必须同名且在同一目录
    <mapper class="com.wxisme.mybatis0100.mapper.UserMapper"/>
    基于class加载，可以进行批量加载
    -->
    <!-- 通过扫描包的方式来进行批量加载映射文件 -->
    <package name="com.wxisme.ssm.mapper"/>     
</mappers>

　　整个文件的配置应该是这样的：

<typeAliases>
    <!-- 批量定义别名 ，指定包名，自动扫描包中的类，别名即为类名，首字母大小写无所谓-->
    <package name="com.wxisme.ssm.po"/>
</typeAliases>




    
    

　　具体mapper文件的配置，在使用mapper代理的方法时，命名空间需要是对应的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" >
<mapper namespace="com.wxisme.ssm.mapper.AlbumMapper" >
  
</mapper>

　　以上只是对SSM框架简单使用时的配置文件，如果需要深入使用或者需要理解其内部机理需要参考官方文档和其源代码。

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!