01-学成在线项目基础环境模块搭建

基础工程搭建

项目根目录

创建一个空工程xuecheng-plus即项目的根目录,进入Project Structure检查jdk是否配置正确

新增.gitignore文件用来设置工程中不需要向仓库提交的内容

HELP.md
target/
!.mvn/wrapper/maven-wrapper.jar
!**/src/main/**
!**/src/test/**
#### STS ###
.apt_generated
.classpath
.factorypath
.project
.settings
.springBeans
.sts4-cache
#### IntelliJ IDEA ###
.idea
*.iws
*.iml
*.ipr
#### NetBeans ###
/nbproject/private/
/nbbuild/
/dist/
/nbdist/
/.nb-gradle/
build/
logs/
#### VS Code ###
.vscode/

使用Maven来进行项目各大模块的管理和构建,整个项目分为父工程模块、基础工程模块和微服务工程模块三大类,每一种类的工程都有不同的作用

构建父工程模块(parant)

父工程负责对项目中所依赖包的版本进行管理

第一步: 选择Spring Initalizr的方式新建父工程模块,填写模块名xuecheng-plus-parent和包名com.xuecheng等信息

第二步: 创建成功后删除工程中多余的文件

第二步: 依赖管理定义,由于父工程中不用编写代码所以不用去依赖其它的包,它的作用就是限定子工程依赖包的版本

• 确定父工程为一个POM工程,对子工程进行聚合管理

<packaging>pompackaging>

• 确定项目所依赖的包及其版本号

<properties>
    <java.version>1.8java.version>
    <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8project.reporting.outputEncoding>
    <spring-boot.version>2.3.7.RELEASEspring-boot.version>
    <spring-cloud.version>Hoxton.SR9spring-cloud.version>
    <org.mapstruct.version>1.3.1.Finalorg.mapstruct.version>
    <spring-cloud-alibaba.version>2.2.6.RELEASEspring-cloud-alibaba.version>
    <org.projectlombok.version>1.18.8org.projectlombok.version>
    <javax.servlet-api.version>4.0.1javax.servlet-api.version>
    <fastjson.version>1.2.83fastjson.version>
    <druid-spring-boot-starter.version>1.2.8druid-spring-boot-starter.version>
    <mysql-connector-java.version>8.0.30mysql-connector-java.version>
    <mybatis-plus-boot-starter.version>3.4.1mybatis-plus-boot-starter.version>
    <commons-lang.version>2.6commons-lang.version>
    <minio.version>8.4.3minio.version>
    <xxl-job-core.version>2.3.1xxl-job-core.version>
    <swagger-annotations.version>1.5.20swagger-annotations.version>
    <commons-lang3.version>3.10commons-lang3.version>
    <okhttp.version>4.8.1okhttp.version>
    <swagger-spring-boot-starter.version>1.9.0.RELEASEswagger-spring-boot-starter.version>
    <elasticsearch.version>7.12.1elasticsearch.version>
properties>

• 编写dependencyManagement来限定项目中所依赖包的版本,此时并不会真正导入依赖,子工程需要的时候还需要手动导入但时依赖的版本号已经指定了

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloudgroupId>
            <artifactId>spring-cloud-dependenciesartifactId>
            <version>${spring-cloud.version}version>
            <type>pomtype>
            <scope>importscope>
        dependency>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-dependenciesartifactId>
            <version>${spring-boot.version}version>
            <type>pomtype>
            <scope>importscope>
        dependency>
        <dependency>
            <groupId>com.alibaba.cloudgroupId>
            <artifactId>spring-cloud-alibaba-dependenciesartifactId>
            <version>${spring-cloud-alibaba.version}version>
            <type>pomtype>
            <scope>importscope>
        dependency>
        
        <dependency>
            <groupId>org.projectlombokgroupId>
            <artifactId>lombokartifactId>
            <version>${org.projectlombok.version}version>
        dependency>
        
        <dependency>
            <groupId>org.mapstructgroupId>
            <artifactId>mapstruct-jdk8artifactId>
            <version>${org.mapstruct.version}version>
        dependency>
        <dependency>
            <groupId>org.mapstructgroupId>
            <artifactId>mapstruct-processorartifactId>
            <version>${org.mapstruct.version}version>
        dependency>
        <dependency>
            <groupId>io.swaggergroupId>
            <artifactId>swagger-annotationsartifactId>
            <version>${swagger-annotations.version}version>
        dependency>
        
        <dependency>
            <groupId>javax.servletgroupId>
            <artifactId>javax.servlet-apiartifactId>
            <version>${javax.servlet-api.version}version>
            <scope>providedscope>
        dependency>
        
        <dependency>
            <groupId>com.alibabagroupId>
            <artifactId>fastjsonartifactId>
            <version>${fastjson.version}version>
        dependency>
        
        <dependency>
            <groupId>com.alibabagroupId>
            <artifactId>druid-spring-boot-starterartifactId>
            <version>${druid-spring-boot-starter.version}version>
        dependency>
        
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>${mysql-connector-java.version}version>
        dependency>
        
        <dependency>
            <groupId>com.baomidougroupId>
            <artifactId>mybatis-plus-boot-starterartifactId>
            <version>${mybatis-plus-boot-starter.version}version>
        dependency>
        
        <dependency>
            <groupId>com.baomidougroupId>
            <artifactId>mybatis-plus-generatorartifactId>
            <version>${mybatis-plus-boot-starter.version}version>
        dependency>
        
        <dependency>
            <groupId>commons-langgroupId>
            <artifactId>commons-langartifactId>
            <version>${commons-lang.version}version>
        dependency>
        
        <dependency>
            <groupId>io.miniogroupId>
            <artifactId>minioartifactId>
            <version>${minio.version}version>
        dependency>
        
        <dependency>
            <groupId>com.google.guavagroupId>
            <artifactId>guavaartifactId>
            <version>25.0-jreversion>
        dependency>
        
        <dependency>
            <groupId>com.xuxueligroupId>
            <artifactId>xxl-job-coreartifactId>
            <version>${xxl-job-core.version}version>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-testartifactId>
            <version>${spring-boot.version}version>
            <scope>testscope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintagegroupId>
                    <artifactId>junit-vintage-engineartifactId>
                exclusion>
            exclusions>
        dependency>
        <dependency>
            <groupId>com.squareup.okhttp3groupId>
            <artifactId>okhttpartifactId>
            <version>${okhttp.version}version>
        dependency>
        <dependency>
            <groupId>org.apache.commonsgroupId>
            <artifactId>commons-lang3artifactId>
            <version>${commons-lang3.version}version>
        dependency>
        <dependency>
            <groupId>com.spring4allgroupId>
            <artifactId>swagger-spring-boot-starterartifactId>
            <version>${swagger-spring-boot-starter.version}version>
        dependency>
        <dependency>
            <groupId>org.elasticsearch.clientgroupId>
            <artifactId>elasticsearch-rest-high-level-clientartifactId>
            <version>${elasticsearch.version}version>
        dependency>
        <dependency>
            <groupId>org.elasticsearchgroupId>
            <artifactId>elasticsearchartifactId>
            <version>${elasticsearch.version}version>
        dependency>
    dependencies>
dependencyManagement>

• 编辑打包插件

<build>
    <finalName>${project.name}finalName>
    
    <resources>
        <resource>
            <directory>src/main/resourcesdirectory>
            <filtering>truefiltering>
            <includes>
                <include>**/*include>
            includes>
        resource>
        <resource>
            <directory>src/main/javadirectory>
            <includes>
                <include>**/*.xmlinclude>
            includes>
        resource>
    resources>
    <plugins>
        
        <plugin>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-maven-pluginartifactId>
            <version>${spring-boot.version}version>
        plugin>
        <plugin>
            <groupId>org.apache.maven.pluginsgroupId>
            <artifactId>maven-compiler-pluginartifactId>
            <version>3.8.1version>
            <configuration>
                
                <source>1.8source>
                
                <target>1.8target>
                
                <annotationProcessorPaths>
                    
                    <path>
                        <groupId>org.projectlombokgroupId>
                        <artifactId>lombokartifactId>
                        <version>${org.projectlombok.version}version>
                    path>
                annotationProcessorPaths>
            configuration>
        plugin>
        
        <plugin>
            <groupId>org.apache.maven.pluginsgroupId>
            <artifactId>maven-resources-pluginartifactId>
            <version>3.3.0version>
            <configuration>
                <encoding>utf-8encoding>
                
                <useDefaultDelimiters>trueuseDefaultDelimiters>
            configuration>
        plugin>
    plugins>
build>

构建基础工程模块(base)

基础工程的职责是提供一些系统架构所需要的基础类库以及一些工具类库

第一步: 选择Spring Initalizr的方式新建基础工程模块,填写模块名xuecheng-plus-base和包名com.xuecheng.base等信息,最后同样删除多余的文件

第二步: 继承父类工程即,以当前工程的pom.xml文件为起点找到父工程的pom.xml文件

<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.0modelVersion>
    
    <parent>
        <groupId>com.xuechenggroupId>
        <artifactId>xuecheng-plus-parentartifactId>
        <version>0.0.1-SNAPSHOTversion>
        <relativePath>../xuecheng-plus-parentrelativePath>
    parent>
    <artifactId>xuecheng-plus-baseartifactId>
    <properties>
        <java.version>1.8java.version>
    properties>
    <dependencies>
        <dependency>
            <groupId>org.projectlombokgroupId>
            <artifactId>lombokartifactId>
        dependency>
        
        <dependency>
            <groupId>com.alibabagroupId>
            <artifactId>fastjsonartifactId>
        dependency>
        
        <dependency>
            <groupId>javax.servletgroupId>
            <artifactId>javax.servlet-apiartifactId>
            <scope>providedscope>
        dependency>
        
        <dependency>
            <groupId>commons-langgroupId>
            <artifactId>commons-langartifactId>
        dependency>
        <dependency>
            <groupId>commons-codecgroupId>
            <artifactId>commons-codecartifactId>
            <version>1.11version>
        dependency>
        <dependency>
            <groupId>io.swaggergroupId>
            <artifactId>swagger-annotationsartifactId>
        dependency>
        <dependency>
            <groupId>org.springframeworkgroupId>
            <artifactId>spring-webartifactId>
        dependency>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-validationartifactId>
        dependency>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-log4j2artifactId>
        dependency>
        
        <dependency>
            <groupId>com.j256.simplemagicgroupId>
            <artifactId>simplemagicartifactId>
            <version>1.17version>
        dependency>
        <dependency>
            <groupId>org.apache.commonsgroupId>
            <artifactId>commons-lang3artifactId>
        dependency>
        <dependency>
            <groupId>com.google.zxinggroupId>
            <artifactId>coreartifactId>
            <version>3.3.3version>
        dependency>
        <dependency>
            <groupId>com.google.zxinggroupId>
            <artifactId>javaseartifactId>
            <version>3.3.3version>
        dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.modulegroupId>
            <artifactId>jackson-module-parameter-namesartifactId>
        dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.datatypegroupId>
            <artifactId>jackson-datatype-jdk8artifactId>
        dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.datatypegroupId>
            <artifactId>jackson-datatype-jsr310artifactId>
        dependency>
    dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-maven-pluginartifactId>
            plugin>
        plugins>
    build>
project>

微服务工程模块

分别从业务和技术方面划分模块，一般每个模块构建一个微服务,每个微服务工程依赖基础工程，间接继承父工程

• 主要包括内容管理服务、媒资管理服务、搜索服务、订单支付服务等