maven搭建多模块springboot项目微服务

目录

1.模块化概念

2.搭建模块

2.1 创建父项目

2.1.1 创建新项目

2.2 添加子模块

2.3 修改父项目pom依赖

2.3.1 父项目pom依赖说明

2.4 修改子项目pom依赖

 2.4.1 子模块pom依赖说明

3. 功能测试

3.1 简单的接口测试

3.1.1 控制层

3.1.2 服务层 

3.1.3 持久层 

3.1.4 mapper文件sql语句

3.1.5 表数据

3.1.6 查询不存在的数据

3.1.7 查询存在的数据 

3.遇到的问题


1.模块化概念

2.搭建模块

2.1 创建父项目

由于我是测试写完后写的这篇文章,所以这里面有些模板已经创建好了,可以参考下项目结构

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_spring

2.1.1 创建新项目

 

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_spring_02

 选择Maven项目

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_03

 修改信息后直接点击Finish

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_xml_04

 目录结构可以只保留pom.xml文件

2.2 添加子模块

在父项目上面右键,参照下图选择 

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_05

这里可以有两种选择,我一般选择Spring Initializr方式,然后修改信息后删除不用的目录和文件,尝试过Maven方式但是会出问题,可能是我IDEA的问题

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_06

2.3 修改父项目pom依赖

父项目pom.xml文件更改如下

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_spring_07

2.3.1 父项目pom依赖说明

        1.packaging: 指定这是一个pom项目

        2.module: 定义子项目

完整父项目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 https://maven.apache.org/xsd/maven-4.0.0.xsd">

 


    <modelVersion>4.0.0</modelVersion>


 


    <parent>


 


        <groupId>org.springframework.boot</groupId>


 


        <artifactId>spring-boot-starter-parent</artifactId>


 


        <version>2.6.2</version>


 


        <relativePath/> <!-- lookup parent from repository -->


 


    </parent>


 


 

 


    <packaging>pom</packaging>


 


 

 


    <modules>


 


        <module>web</module>


 


        <module>service</module>


 


        <module>dao</module>


 


        <module>model</module>


 


        <module>utils</module>


 


    </modules>


 


 

 


    <groupId>com.huachun</groupId>


 


    <artifactId>demo-projects</artifactId>


 


    <version>0.0.1</version>


 


 

 


    <properties>


 


        <java.version>1.8</java.version>


 


    </properties>


 


 

 


    <dependencies>


 


        <dependency>


 


            <groupId>org.springframework.boot</groupId>


 


            <artifactId>spring-boot-starter-web</artifactId>


 


        </dependency>


 


 

 


    </dependencies>


 


 

 


    <build>


 


        <plugins>


 


            <plugin>


 


                <groupId>org.springframework.boot</groupId>


 


                <artifactId>spring-boot-maven-plugin</artifactId>


 


                <version>2.6.1</version>


 


            </plugin>


 


        </plugins>


 


    </build>


 


 

 


</project>

2.4 修改子项目pom依赖

以web模块为例

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_spring_08

        1.parent: 指定依赖的父项目

        2.packaging: 指定打包类型为jar

        3.指定需要导入service模块

完整pom可参考

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">

 


    <modelVersion>4.0.0</modelVersion>


 


    <parent>


 


        <groupId>com.huachun</groupId>


 


        <artifactId>demo-projects</artifactId>


 


        <version>0.0.1</version>


 


    </parent>


 


    <packaging>jar</packaging>


 


 

 


    <groupId>com.huachun</groupId>


 


    <artifactId>web</artifactId>


 


    <version>0.0.1</version>


 


 

 


    <dependencies>


 


 

 


        <dependency>


 


            <groupId>com.huachun</groupId>


 


            <artifactId>service</artifactId>


 


            <version>0.0.1</version>


 


        </dependency>


 


 

 


        <dependency>


 


            <groupId>com.huachun</groupId>


 


            <artifactId>model</artifactId>


 


            <version>0.0.1</version>


 


        </dependency>


 


 

 


        <dependency>


 


            <groupId>org.springframework.boot</groupId>


 


            <artifactId>spring-boot-starter</artifactId>


 


        </dependency>


 


 

 


        <dependency>


 


            <groupId>org.springframework.boot</groupId>


 


            <artifactId>spring-boot-starter-test</artifactId>


 


            <scope>test</scope>


 


        </dependency>


 


    </dependencies>


 


 

 


</project>

service模块pom依赖示例

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">

 


    <modelVersion>4.0.0</modelVersion>


 


    <parent>


 


        <groupId>com.huachun</groupId>


 


        <artifactId>demo-projects</artifactId>


 


        <version>0.0.1</version>


 


    </parent>


 


 

 


    <packaging>jar</packaging>


 


 

 


    <groupId>com.huachun</groupId>


 


    <artifactId>service</artifactId>


 


    <version>0.0.1</version>


 


 

 


    <dependencies>


 


 

 


        <dependency>


 


            <groupId>com.huachun</groupId>


 


            <artifactId>dao</artifactId>


 


            <version>0.0.1</version>


 


        </dependency>


 


 

 


        <dependency>


 


            <groupId>org.springframework.boot</groupId>


 


            <artifactId>spring-boot-starter</artifactId>


 


        </dependency>


 


 

 


        <dependency>


 


            <groupId>org.springframework.boot</groupId>


 


            <artifactId>spring-boot-starter-test</artifactId>


 


            <scope>test</scope>


 


        </dependency>


 


    </dependencies>


 


 

 


</project>

其他模块都是大致一样,只是引入的依赖不同,在不同模块根据业务功能去引入相应依赖

        dao模块依赖model模块

        service模块依赖dao模块

        web模块依赖service模块

3. 功能测试

3.1 简单的接口测试

3.1.1 控制层

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_09

3.1.2 服务层 

 

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_10

3.1.3 持久层 

 

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_11

3.1.4 mapper文件sql语句

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_12

3.1.5 表数据

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_xml_13

3.1.6 查询不存在的数据

 

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_14

3.1.7 查询存在的数据 

 

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_spring_15

项目参考地址:https://gitee.com/huachun_w/demo-project/tree/maven-init-0.0.1

4.遇到的问题

4.1 找不到实体类

Consider defining a bean of type 'com.hhmt.service.OCPXService' in your conf

RROR] Failed to execute goal on project service: Could not resolve dependencies for project 

问题原因:模块没有很清晰的规划有以下几个包

                com.hhmt.controller        

                        Controller.java

                        Start.java

                com.hhmt.service

                        xxxService.java                        

                com.hhmt.dao

基于这个目录结构发现Start.java最终打包在com.hhmt.controller包里面,而启动类会自动扫描当前包下面的类,所以不能扫描到com.hhmt.service下面的类也是正常,想通了这一点,其实就有两个解决办法。

解决办法:

        1.添加扫描注解,指定扫描同一个包

@ComponentScan("多模块的情况下指定到父包")

        2.整理好项目模块(推荐这种,这样会让模块更加清晰)

2.no main manifest attribute

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_16

解决方法:在pom文件中添加下面插件

<!-- 原文链接: -->

 


<build>

 


        <plugins>


 


            <plugin>


 


                <groupId>org.springframework.boot</groupId>


 


                <artifactId>spring-boot-maven-plugin</artifactId>


 


                <configuration>


 


                    <executable>true</executable>


 


                </configuration>


 


            </plugin>


 


        </plugins>


 


</build>

添加完之后重新打包运行,正常启动,接口调用正常

java 微服务项和 maven多模块有什么区别 maven多模块与微服务_maven_17

2.编译模块提示不能找到父模块

详细:Could not find artifact com.hhmt:delivery:pom:0.0.1-SNAPSHOT

[ERROR] Failed to execute goal on project commons: Could not resolve dependencies for project com.hhmt:commons:jar:0.0.1-SNAPSHOT: Failed to collect dependencies at com.hhmt:model:jar:0.0.1-SNAPSHOT: Failed to read artifact descriptor for com.hhmt:model:jar:0.0.1-SNAPSHOT: Could not find artifact com.hhmt:delivery:pom:0.0.1-SNAPSHOT -> [Help 1]

未完待续...

无法自动注入依赖

模块中可以引入其他模块的类,但是工具提示找不到

@Autowired private TestService testService;

解决方法:在启动类添加扫描包

@SpringBootApplication(scanBasePackages = "com.huachun")