SpringCloud零基础上手（二）——SpringBoot多模块maven项目

本篇接着上一篇的内容，我们要写一个服务生产者，向Eureka注册中心注册服务。为了后面的内容顺利进行，我们创建一个多模块的项目。

编写一个登陆微服务pf-login，并注册到Eureka，先看我创建完的目录结构：

简单分析一下，最外层是pf-login，下面有client、server、dao三个模块：
①、client模块用于注册服务，提供服务的调用接口，是调用login服务的入口。
②、server模块用于处理业务逻辑。
③、dao模块用于数据持久，和数据库打交道。
我们还可以加一些其他的模块，比如common,base之类的用来存放公共工具等等。
模块间的依赖关系：client 依赖 server ，server 依赖 dao。

1、pf-login的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>cn.pw</groupId>    <artifactId>pf-login</artifactId>    <version>1.0-SNAPSHOT</version>    <packaging>pom</packaging>    <properties>        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>        <java.version>1.8</java.version>        <spring-cloud.version>Dalston.SR4</spring-cloud.version>        <fastjson-version>1.2.15</fastjson-version>    </properties>    <parent>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-parent</artifactId>        <version>1.5.8.RELEASE</version>        <relativePath/> <!-- lookup parent from repository -->    </parent>    <dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-eureka</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-test</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-data-jpa</artifactId>        </dependency>        <dependency>            <groupId>mysql</groupId>            <artifactId>mysql-connector-java</artifactId>            <scope>runtime</scope>        </dependency>        <dependency>            <groupId>com.alibaba</groupId>            <artifactId>fastjson</artifactId>            <version>${fastjson-version}</version>        </dependency>    </dependencies>    <dependencyManagement>        <dependencies>            <dependency>                <groupId>org.springframework.cloud</groupId>                <artifactId>spring-cloud-dependencies</artifactId>                <version>${spring-cloud.version}</version>                <type>pom</type>                <scope>import</scope>            </dependency>        </dependencies>    </dependencyManagement>    <modules>        <module>pf-login-client</module>        <module>pf-login-dao</module>        <module>pf-login-server</module>    </modules></project>

所有关于pf-login模块的依赖都统一写在了这里 ，为了方便管理和避免重复依赖。与之前略有不同的是，我们加入了数据库的依赖组件，jpa和mysql。
我们也注意到了pom中引入了阿里巴巴的fastjson，这个与其他依赖写法不同，也就 证明SpringBoot是支持第三方依赖，也支持自定义依赖的。
<modules>是多模块项目的关键，模块简的关系正是通过父pom添加<modules>，子pom添加<parent>来建立的。

2、pf-login-client的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>    <parent>        <groupId>cn.pw</groupId>        <artifactId>pf-login</artifactId>        <version>1.0-SNAPSHOT</version>    </parent>    <artifactId>pf-login-client</artifactId>    <name>pf-login-client</name>    <dependencies>        <dependency>            <groupId>cn.pw</groupId>            <artifactId>pf-login-server</artifactId>            <version>1.0-SNAPSHOT</version>        </dependency>    </dependencies>    <build>        <plugins>            <plugin>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-maven-plugin</artifactId>            </plugin>        </plugins>    </build></project>      

上面我们设计了client 依赖 server，所以pom中添加了对 server的dependency。

3、pf-login-server的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>    <parent>        <groupId>cn.pw</groupId>        <artifactId>pf-login</artifactId>        <version>1.0-SNAPSHOT</version>    </parent>    <artifactId>pf-login-server</artifactId>    <dependencies>        <dependency>            <groupId>cn.pw</groupId>            <artifactId>pf-login-dao</artifactId>            <version>1.0-SNAPSHOT</version>        </dependency>    </dependencies></project>  

4、pf-login-dao的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>    <parent>        <groupId>cn.pw</groupId>        <artifactId>pf-login</artifactId>        <version>1.0-SNAPSHOT</version>    </parent>    <artifactId>pf-login-dao</artifactId></project>  

5、每个模块下都创建一个相同的root包，我这里是cn.pw.platform包，保证每个模块的启动类都在这个root包下。

原因：我们前面说过，springBoot启动类默认扫描当前包及子包，项目打包时，所有依赖的模块以jar的形式打进来，这样做能保证springBoot顺利扫描到所有依赖jar的组件。如果包名完全不一致，或父包、子包混乱，打包编译不会有问题，但项目启动时，会找不到所依赖的jar中的组件。（当然，也可以通过@ComponentScans注解来指定。）

6、分步打包
打包一定从被完全依赖的模块开始，也就是从dao开始，使用 mvn install 命令，maven会在本地仓库生成相关的jar，其他依赖该组件的模块便能从本地仓库找到依赖的jar。
依次install dao 和 server，最后再client 模块package，这样client中就用了dao和 server 的jar。
如果直接打包client 或 server，maven会报错，提示找不到依赖的jar。

7、统一打包
统一打包很简单，在所有模块的父目录下打包，也就是通过pf-login的pom.xml打包，在pf-login下直接使用 mvn package 命令即可。

8、借助idea打包

下一步：

有了这个构建多模块的基础 ，下一篇我们就在这个基础上编写代码，写一个登陆的服务，注册到Eureka注册中心。