构建SpringBoot多模块项目

Spring

Spring Boot Spring Cloud Spring Cloud Data Flow

Spring Boot:由Pivotal团队提供的全新"框架",其设计目的是用来简化Spring应用的初始搭建以及开发过程

特性一:约定优先于配置（能不手动XML配置，就从简)特性二:可基于Maven独立创建Spring应用程序，并打包成可执行的Jar包或者War直接运行起来特性三:内置Tomcat/Jetty等Servlet容器，而不需要外置的Tomcat运行特性四:"起步依赖"(xx-starter依赖），“自动装配"(自动配置Spring容器),也就是说利用了相应的注解

构建maven多模块项目

单模块项目；将所有的东西都集中在单一模块中(Entityr实体/Dao数据库访问层/Controller控制器层/Service业务服务逻辑处理层/自定义的工具类Utils/跟第三方服务通信的服务处理层Others)省事，不要建立那么多个模块，简而小的项目可以如此项目多大时，过分冗余，找某个类/接口时就得一层一层的点开"包"目录~费劲!如果要跟第三方服务进行通信，那可能会跟本身系统的业务逻辑混在一起~混乱

规范化的搭建系统/项目的整体目录结构~建议

创建一个Maven项目，SpringBootTest

再分别创建三个子模块，并创建出相应的包

api(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"> <parent> <artifactId>SpringBootTest</artifactId> <groupId>com.cuihua.boot.middleware</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>api</artifactId> <!-- 需要依赖的Jar的版本号 --> <properties> <hibernate-validator-version>5.2.4.Final</hibernate-validator-version> <javax.validation-version>1.1.0.Final</javax.validation-version> <jackson-annotations-version>2.9.8</jackson-annotations-version> <commons.lang3.version>3.6</commons.lang3.version> <commons.fileupload.version>1.3.1</commons.fileupload.version> <commons.io.version>2.5</commons.io.version> <commons.codec.version>1.10</commons.codec.version> <commons-beanutils.version>1.9.2</commons-beanutils.version> <fastjson.version>1.2.45</fastjson.version> <joda.time.version>2.9.9</joda.time.version> <lombok.version>1.18.4</lombok.version> <joda-time.version>2.9.2</joda-time.version> </properties> <dependencies> <!-- 校验器-hibernate --> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>${hibernate-validator-version}</version> </dependency> <!-- 校验器-javax --> <dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>${javax.validation-version}</version> </dependency> <!-- jackson --> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-annotations</artifactId> <version>${jackson-annotations-version}</version> </dependency> <!-- json解析框架 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>${fastjson.version}</version> </dependency> <!-- commons下的常用框架 --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-lang3</artifactId> <version>${commons.lang3.version}</version> </dependency> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>${commons.fileupload.version}</version> </dependency> <dependency> <groupId>commons-io</groupId> <artifactId>commons-io</artifactId> <version>${commons.io.version}</version> </dependency> <dependency> <groupId>commons-codec</groupId> <artifactId>commons-codec</artifactId> <version>${commons.codec.version}</version> </dependency> <dependency> <groupId>commons-beanutils</groupId> <artifactId>commons-beanutils</artifactId> <version>${commons-beanutils.version}</version> </dependency> <!-- lombok --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>${lombok.version}</version> </dependency> <!-- time --> <dependency> <groupId>joda-time</groupId> <artifactId>joda-time</artifactId> <version>${joda-time.version}</version> </dependency> </dependencies> </project>

pom.xml(model)

<?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"> <parent> <artifactId>SpringBootTest</artifactId> <groupId>com.cuihua.boot.middleware</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>model</artifactId> <properties> <mybatis-spring-boot.version>1.1.1</mybatis-spring-boot.version> <mybatis-pagehelper.version>4.1.2</mybatis-pagehelper.version> </properties> <dependencies> <!-- api --> <dependency> <groupId>com.cuihua.boot.middleware</groupId> <artifactId>api</artifactId> <version>${project.parent.version}</version> </dependency> <!-- spring-mybatis --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>${mybatis-spring-boot.version}</version> </dependency> <!-- for page --> <dependency> <groupId>com.github.pagehelper</groupId> <artifactId>pagehelper</artifactId> <version>${mybatis-pagehelper.version}</version> </dependency> </dependencies> </project>

pom.xml(server)

<?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"> <parent> <artifactId>SpringBootTest</artifactId> <groupId>com.cuihua.boot.middleware</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>server</artifactId> <packaging>jar</packaging> <properties> <start-class>com.cuihua.boot.middleware.server.MainApplication</start-class> <spring-boot.version>2.0.5.RELEASE</spring-boot.version> <druid.version>1.1.13</druid.version> <mysql.version>5.1.38</mysql.version> <guava.version>19.0</guava.version> <gson.version>2.6.1</gson.version> <mail.version>1.5.7.RELEASE</mail.version> <junit.version>4.12</junit.version> <slf4j.version>1.7.13</slf4j.version> <log4j.version>1.2.17</log4j.version> </properties> <!-- 依赖管理 --> <dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>${spring-boot.version}</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <!-- model依赖 --> <dependency> <groupId>com.cuihua.boot.middleware</groupId> <artifactId>model</artifactId> <version>${project.parent.version}</version> </dependency> <!-- mysql驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql.version}</version> </dependency> <!-- 数据库连接池druid --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>${druid.version}</version> </dependency> <!-- guava --> <dependency> <groupId>com.google.guava</groupId> <artifactId>guava</artifactId> <version>${guava.version}</version> </dependency> <!-- gson --> <dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>${gson.version}</version> </dependency> <!-- spring内置核心模块、组件 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <version>${spring-boot.version}</version> <exclusions> <exclusion> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> </exclusion> <exclusion> <groupId>org.slf4j</groupId> <artifactId>log4j-over-slf4j</artifactId> </exclusion> </exclusions> </dependency> <!-- jsp 支持 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <!-- <scope>provided</scope> --> <!-- 如果用provided 意味着将不打包其jar进去项目 --> </dependency> <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> <!-- <scope>provided</scope> --> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> </dependency> <!-- freemarker --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-freemarker</artifactId> </dependency> <!-- email --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> <version>${mail.version}</version> </dependency> <!-- java单元测试 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>${junit.version}</version> <scope>test</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <!-- log --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>${slf4j.version}</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>${slf4j.version}</version> </dependency> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>${log4j.version}</version> </dependency> <!-- 引入热部署/热加载jar包 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <!-- optional=true,依赖不会传递，该项目依赖devtools；之后依赖该项目的项目如果想要使用devtools，需要重新引入 --> <optional>true</optional> </dependency> </dependencies> <build> <finalName>SpringBootMiddleware-${project.parent.version}</finalName> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>${spring-boot.version}</version> <configuration> <executable>true</executable> </configuration> <executions> <execution> <goals> <goal>repackage</goal> </goals> </execution> </executions> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>2.4</version> <configuration> <failOnMissingWebXml>false</failOnMissingWebXml> </configuration> </plugin> </plugins> <resources> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> </resource> </resources> </build> </project>

其中，MainApplication是启动入口类，需要在server的模块jar下创建出对应的类

<start-class>com.cuihua.boot.middleware.server.MainApplication</start-class>

 MainApplication.java

package com.cuihua.boot.middleware.server; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.boot.builder.SpringApplicationBuilder; import org.springframework.boot.web.servlet.support.SpringBootServletInitializer; @SpringBootApplication public class MainApplication extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { return builder.sources(MainApplication.class); } public static void main(String[] args) { SpringApplication.run(MainApplication.class, args); } }

注意:把File encoding改为UTF-8，创建application.properties文件

最基本的企业级多模块项目配置 

#多环境配置 -默认即为本配置文件 #spring.profiles.active=prod #spring.profiles.active=test #应用服务端口 server.port=9099 server.servlet.context-path=/middleware #日志 logging.path=C:\\Users\\Administrator\\IdeaProjects\\SpringBootTest\\server\\logs logging.file=middleware #前端模板引擎 spring.freemarker.cache=false spring.freemarker.charset=UTF-8 spring.freemarker.suffix=.html spring.freemarker.request-context-attribute=request spring.freemarker.template-loader-path=classpath:/templates #限定前端上传文件大小 spring.servlet.multipart.max-file-size=100MB spring.servlet.multipart.max-request-size=100MB spring.servlet.multipart.enabled=true #日志级别 logging.level.org.springframework = INFO logging.level.com.fasterxml.jackson = INFO logging.level.com.debug.boot.middleware = DEBUG #json序列化配置 spring.jackson.date-format=yyyy-MM-dd HH:mm:ss spring.jackson.time-zone=GMT+8 spring.datasource.initialization-mode=never spring.jmx.enabled=false #数据库配置 datasource.url=jdbc:mysql://127.0.0.1:3306/sb_middleware?useUnicode=true&amp;characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true datasource.username=root datasource.password=cuihua4huajie #mybatis配置 mybatis.config-location=classpath:mybatis-config.xml mybatis.checkConfigLocation = true mybatis.mapper-locations=classpath:mappers/*.xml #邮件配置 spring.mail.host=smtp.qq.com spring.mail.username=1974544863@qq.com spring.mail.password=zsnafkzheetqcdbi spring.mail.properties.mail.smtp.auth=true spring.mail.properties.mail.smtp.starttls.enable=true spring.mail.properties.mail.smtp.starttls.required=true mail.send.from=1577153977@qq.com #通用配置 server.tomcat.additional-tld-skip-patterns=jaxb-api.jar,jaxb-core.jar

启动入口类，出现如下错误

错误分析: 在应用程序的配置文件中配置了mysql,但是应用的启动入口类没有去加载任何读取数据源的配置。再server的resources下创建spring文件夹，然后再创建spring-jdbc.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" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd " > <!--主数据源 --> <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close" primary="true" > <!-- 基本属性 url、user、password --> <property name="url" value="${datasource.url}" /> <property name="username" value="${datasource.username}" /> <property name="password" value="${datasource.password}" /> <!-- 配置初始化大小、最小、最大 --> <property name="initialSize" value="10" /> <property name="minIdle" value="10" /> <property name="maxActive" value="20" /> <!-- 配置获取连接等待超时的时间 --> <property name="maxWait" value="60000" /> <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 --> <property name="timeBetweenEvictionRunsMillis" value="60000" /> <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 --> <property name="minEvictableIdleTimeMillis" value="300000" /> <property name="validationQuery" value="SELECT 1 " /> <property name="testWhileIdle" value="true" /> <property name="testOnBorrow" value="false" /> <property name="testOnReturn" value="false" /> <!-- 打开PSCache，并且指定每个连接上PSCache的大小 --> <property name="poolPreparedStatements" value="true" /> <property name="maxPoolPreparedStatementPerConnectionSize" value="20" /> <!-- 配置监控统计拦截的filters，去掉后监控界面sql无法统计 --> <property name="filters" value="stat" /> </bean> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> </beans>

再启动类上添加注解

@ImportResource(value = {"classpath:spring/spring-jdbc.xml"}) //扫描mybatis的配置文件 @MapperScan(basePackages = "com.cuihua.boot.middleware.model.mapper") @EnableScheduling //允许开启调度 @EnableAsync //允许开启异步 @EnableCaching //允许开启缓存

 启动错误一:

解决: 警告:不建议在没有服务器身份验证的情况下建立SSL连接。根据MySQL 5.5.45+、5.6.26+和5.7.6+的要求，如果没有设置显式选项，则默认情况下必须建立SSL连接。您需要通过设置useSSL=false显式禁用SSL，或者设置useSSL=true并为服务器证书验证提供信任存储。在数据库连接后面加上下面一句，即ok

?useSSL=false

启动错误二:数据库连接失败

解决方案:注释掉@ImportResource,然后将mysql的版本修改为8.0以上的，重新在application.properties中配置数据库连接

# DataSourceProperties spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/community?characterEncoding=utf-8&useSSL=false&serverTimezone=Hongkong spring.datasource.username=root spring.datasource.password=cuihua4huajie spring.datasource.type=com.zaxxer.hikari.HikariDataSource spring.datasource.hikari.maximum-pool-size=15 spring.datasource.hikari.minimum-idle=5 spring.datasource.hikari.idle-timeout=30000

启动成功啦~