Spring+mybatis+maven+多模块框架搭建姿势

tech2022-10-17 130

猿实战是一个原创系列文章，通过实战的方式，采用前后端分离的技术结合SpringMVC Spring Mybatis,手把手教你撸一个完整的电商系统，跟着教程走下来，变身猿人找到工作不是问题。想要一起实战吗？，关注公主号猿人工厂，获取基础代码，手把手带你开发属于自己的电商系统。从今天开始，我们将进入猿实战的阶段，实现一个前后端分离的电商系统，没有开发框架怎么行？今天是第一个系列，猿人君将带你搭建后端开发框架。创建应用父模块

父模块负责控制整个应用的结构,因为pzmall-basic作为父项目的存在，无需编写代码,记得在创建完成后，删除项目下的src目录

考虑到我们需要构建一个B2C(兼容商家端的应用)我们的应用按照代码职责的划分，我们的应用暂时涉及到一下几个模块。 pzmall-basic-common:负责编写项目公用的一些内容，比如工具类。 pzmall-basic-domain:负责项目涉及的实体内容编写。 pzmall-basic-dao:负责数据持久层的内容编写。 pzmall-basic-service：负责业务逻辑层的内容编写。 pzmall-basic-search-util：负责项目搜索引擎工具相关的内容编写。 pzmall-basic-web:负责项目网站端业务内容编写。 pzmall-basic-manweb:负责项目运营管理端业务内容编写。接下来我们一起来创建子项目pzmall-basic-common。

接下来，以葫芦画瓢，建立pzmall-basic-domain、pzmall-basic-dao、pzmall-basic-service、pzmall-basic-search-util几个子模块，最后得到如下结果。由于pzmall-basic-web和pzmall-basic-manweb属于web应用，在创建时有所区别，在选择maven项目类型时记得选择正确的archetype,org.apache.maven.archetypes:maven-archetype-webapp.

完成后，并在模块的src/main目录下建立java和resources两个目录。最后项目的整体结果效果如下，为了测试下效果，编译下项目。

调整项目依赖

就项目模块之间的依赖关系而言，pzmall-basic-common和pzmall-basic-serch-util由于编写的是工具类，相对独立，不依赖于其它模块。pzmall-basic-domain、pzmall-basic-dao、pzmall-basic-service、三者的依赖是存在关联关系的，pzmall-basic-service依赖pzmall-basic-dao，pzmall-basic-dao依赖pzmall-basic-domain。而之前提及的pzmall-basic-common和 pzmall-basic-serch-util更多的会在service层被使用。所以，pzmall-basic-service会依赖pzmall-basic-common和pzmall-basic-serch-util。注意哈，pzmall-basic-domain要尽量保持干净，不要和工具类扯上什么关系，否则对今后的架构方面的扩展，是不友好的。而pzmall-basic-web和pzmall-basic-manweb作为项目最终要部署的war包，依赖pzmall-basic-service就可以了。

接下来我们调整引入各个层面所需要的依赖，搭建我们项目开发所需要的框架。

修改父项目pzmall-basic下pom.xml内容为：

<?xmlversion="1.0" encoding="UTF-8"?> <projectxmlns="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.0http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.pz</groupId> <artifactId>pzmall-basic</artifactId> <packaging>pom</packaging> <version>1.0-SNAPSHOT</version>  <properties> <junit.version>4.12</junit.version> <spring.version>4.2.4.RELEASE</spring.version> <servlet-api.version>2.5</servlet-api.version> <mybatis.version>3.2.8</mybatis.version> <mybatis.spring.version>1.2.2</mybatis.spring.version> <mysql.version>5.1.32</mysql.version> <druid.version>1.0.9</druid.version> <commons-fileupload.version>1.3.1</commons-fileupload.version> <freemarker.version>2.3.23</freemarker.version> <security.version>3.2.3.RELEASE</security.version> </properties> <modules> <module>pzmall-basic-common</module> <module>pzmall-basic-domain</module> <module>pzmall-basic-dao</module> <module>pzmall-basic-service</module> <module>pzmall-basic-search-util</module> <module>pzmall-basic-web</module> <module>pzmall-basic-manweb</module> </modules> <dependencyManagement> <dependencies>  <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-aspects</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jms</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context-support</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.9</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.29</version> </dependency> <dependency> <groupId>javassist</groupId> <artifactId>javassist</artifactId> <version>3.11.0.GA</version> </dependency> <dependency> <groupId>commons-codec</groupId> <artifactId>commons-codec</artifactId> <version>1.10</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>${servlet-api.version}</version> <scope>provided</scope> </dependency>  <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>${mybatis.version}</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>${mybatis.spring.version}</version> </dependency>  <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql.version}</version> </dependency>  <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>${druid.version}</version> </dependency>  <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>${commons-fileupload.version}</version> </dependency> <dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> <version>${freemarker.version}</version> </dependency>  <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-web</artifactId> <version>4.1.0.RELEASE</version> </dependency> <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-config</artifactId> <version>4.1.0.RELEASE</version> </dependency> <dependency> <groupId>com.github.penggle</groupId> <artifactId>kaptcha</artifactId> <version>2.3.2</version> <exclusions> <exclusion> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-cas</artifactId> <version>4.1.0.RELEASE</version> </dependency> <dependency> <groupId>org.jasig.cas.client</groupId> <artifactId>cas-client-core</artifactId> <version>3.3.3</version>  <exclusions> <exclusion> <groupId>org.slf4j</groupId> <artifactId>log4j-over-slf4j</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpcore</artifactId> <version>4.4.4</version> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5.3</version> </dependency> <dependency> <groupId>dom4j</groupId> <artifactId>dom4j</artifactId> <version>1.6.1</version> </dependency> <dependency> <groupId>xml-apis</groupId> <artifactId>xml-apis</artifactId> <version>1.4.01</version> </dependency> </dependencies> </dependencyManagement> </project>

修改pzmall-basic-common下pom.xml内容为：

修改pzmall-basic-domain下pom.xml内容为：

修改pzmall-basic-dao下pom.xml内容为：

修改pzmall-basic-service下pom.xml内容为：

修改pzmall-basic-search-util下pom.xml内容为：

修改pzmall-basic -web下pom.xml内容为：

修改pzmall-basic -manweb下pom.xml内容为：

调整完成后，记得maven编译下，验证项目成功构建。

搭建开发框架

1.在pzmall-basic-dao模块的src/main目录下建立resources/mybatis目录,并在mybaits目录下建立SqlMapConfig.xml文件以及mapper目录。

SqlMapConfig.xml下用于配置mybatis全局相关的一些属性，以及加载哪些mapper配置文件，mapper目录下未来将按模块存放相干的mapper文件。

2.在pzmall-basic-manweb目录的resources目录下分别建立spring和config两个目录。并在resources目录下建立applicationContext.xml文件。如下图所示。

3.整合mybatis，在spring目录中建立文件，spring-dao.xml并输入如下内容。

<?xmlversion="1.0" encoding="UTF-8"?> <beansxmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context"xmlns:p="http://www.springframework.org/schema/p" xmlns:aop="http://www.springframework.org/schema/aop"xmlns:tx="http://www.springframework.org/schema/tx" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans-4.2.xsd http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/aophttp://www.springframework.org/schema/aop/spring-aop.xsd http://www.springframework.org/schema/txhttp://www.springframework.org/schema/tx/spring-tx.xsd http://www.springframework.org/schema/utilhttp://www.springframework.org/schema/util/spring-util.xsd"default-autowire="byName">  <bean id="dataSource"class="com.alibaba.druid.pool.DruidDataSource" destroy-method="close"> <property name="url"value="${jdbc.url}" /> <propertyname="username" value="${jdbc.username}" /> <propertyname="password" value="${jdbc.password}" /> <propertyname="driverClassName" value="${jdbc.driver}" /> <propertyname="maxActive" value="10" /> <propertyname="minIdle" value="5" /> </bean>  <beanid="mybatisSqlSessionFactory"class="org.mybatis.spring.SqlSessionFactoryBean">  <propertyname="dataSource" ref="dataSource" />  <propertyname="configLocation"value="classpath:mybatis/SqlMapConfig.xml" /> </bean> <beanclass="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="sqlSessionFactoryBeanName"value="mybatisSqlSessionFactory"/> <propertyname="basePackage" value="com.pz.basic.mall.dao" /> </bean> </beans>

4.配置事务相关的内容，在spring目录中建立文件，spring-tx.xml并输入如下内容。

5.配置SpringMVC相关内容，先在spring目录中建立文件spring-service.xml备用，然后再建立一个springmvc.xml文件，并在文件中输入如下内容。

<?xmlversion="1.0" encoding="UTF-8"?> <beansxmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context"xmlns:mvc="http://www.springframework.org/schema/mvc" xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd"default-autowire="byName"> <mvc:annotation-driven> <mvc:message-converters register-defaults="true"> <beanclass="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter"> <propertyname="supportedMediaTypes"> <list> <value>text/html;charset=UTF-8</value> <value>application/json</value> <value>application/xml;charset=UTF-8</value> </list> </property> <propertyname="features"> <list>   <value>WriteMapNullValue</value> <value>WriteNullNumberAsZero</value> <value>WriteNullListAsEmpty</value> <value>WriteNullStringAsEmpty</value> <value>WriteNullBooleanAsFalse</value> <value>WriteDateUseDateFormat</value> </list> </property> </bean> </mvc:message-converters> </mvc:annotation-driven>  <bean id="multipartResolver"class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <propertyname="defaultEncoding" value="UTF-8"></property>  <propertyname="maxUploadSize" value="5242880"></property> </bean>  <mvc:interceptors> <mvc:interceptor> <mvc:mappingpath="/**" /> <beanclass="com.pz.basic.mall.interceptor.CommonInterceptor"> <propertyname="excludedUrls"> <list> <value>/</value> </list> </property> </bean> </mvc:interceptor> </mvc:interceptors> </beans>

6.由于我们打算使用前后端分离的方式来开发项目，需要解决跨域问题，我们使用了拦截器的方式来处理这个问题，也在springMVC中做了相应的配置。在pzmall-basic-manweb模块中编写代码。

package com.pz.basic.mall.interceptor; import org.springframework.web.servlet.HandlerInterceptor; import org.springframework.web.servlet.ModelAndView; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.util.List; /** * 处理跨域请求 */ public classCommonInterceptor implements HandlerInterceptor { private List<String> excludedUrls; public List<String> getExcludedUrls(){ return excludedUrls; } public voidsetExcludedUrls(List<String> excludedUrls) { this.excludedUrls = excludedUrls; } /** * * 在业务处理器处理请求之前被调用如果返回false * 从当前的拦截器往回执行所有拦截器的afterCompletion(), * 再退出拦截器链, 如果返回true 执行下一个拦截器, * 直到所有的拦截器都执行完毕再执行被拦截的Controller * 然后进入拦截器链, * 从最后一个拦截器往回执行所有的postHandle() * 接着再从最后一个拦截器往回执行所有的afterCompletion() * * @param request * * @param response */ public boolean preHandle(HttpServletRequestrequest, HttpServletResponse response, Object handler)throws Exception { response.setHeader("Access-Control-Allow-Origin","*"); response.setHeader("Access-Control-Allow-Methods", "POST,GET, PUT, OPTIONS, DELETE, PATCH"); response.setHeader("Access-Control-Max-Age","3600"); response.setHeader("Access-Control-Allow-Headers","X-Token, Origin, X-Requested-With, Content-Type, Accept"); response.setHeader("Access-Control-Allow-Credentials","true"); response.setHeader("XDomainRequestAllowed","1"); return true; } // 在业务处理器处理请求执行完成后,生成视图之前执行的动作 public void postHandle(HttpServletRequestrequest, HttpServletResponse response, Object handler, ModelAndViewmodelAndView) throws Exception { } /** * * 在DispatcherServlet完全处理完请求后被调用 * 当有拦截器抛出异常时, * 会从当前拦截器往回执行所有的拦截器的afterCompletion() * * @param request * * @param response * * @param handler * */ public voidafterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler,Exception ex) throws Exception { } }

7.修改pzmall-basic-manweb模块中的resources/config目录下增加db.properties文件，加入数据库相关的配置。

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://127.0.0.1:3306/pz_mall_basic?useUnicode=true&characterEncoding=UTF-8 jdbc.username=root jdbc.password=123456

8.在resources目录下新增log4j.properties文件，增加日志相关配置。

log4j.rootLogger=trace,console logging.level.com.pz.mall.dao=DEBUG log4j.appender.console= org.apache.log4j.ConsoleAppender log4j.appender.console.Target= System.out log4j.appender.console.layout= org.apache.log4j.PatternLayout log4j.appender.console.layout.ConversionPattern=[%-5p][%d{yyyy-MM-dd HH:mm:ss}]%m%n log4j.logger.com.ibatis=DEBUG log4j.logger.com.ibatis.common.jdbc.SimpleDataSource=DEBUG log4j.logger.com.ibatis.common.jdbc.ScriptRunner=DEBUG log4j.logger.com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate=DEBUG log4j.logger.Java.sql.Connection=DEBUG log4j.logger.java.sql.Statement=DEBUG log4j.logger.java.sql.PreparedStatement=DEBUG

9.修改pzmall-basic-manweb模块中的web.xml文件，增加应用启动相关配置：

<?xmlversion="1.0" encoding="UTF-8"?> <web-appxmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">  <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>  <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>/*</url-pattern> </servlet-mapping> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </context-param> </web-app>

到此为止，我们项目的开发框架搭建完毕。如学习过程中遇到疑难杂症，自己实在搞不定，可以加我的微信，帮你解决。

最新回复(0)