keyfil/文档/基础组件/20250527-新项目快速初始化教程.md

新项目快速初始化教程

使用 Maven Archetype 初始化项目（建议）

前置配置步骤

添加私服骨架配置文件

• 建议在本地仓库根目录添加
• 存在则增量添加 archetype

<?xml version="1.0" encoding="UTF-8"?>
<archetype-catalog xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0 http://maven.apache.org/xsd/archetype-catalog-1.0.0.xsd"
    xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <archetypes>
    <archetype>
      <groupId>com.yuanmeng.engine</groupId>
      <artifactId>engine-archetype-web</artifactId>
      <version>2.0.0-SNAPSHOT</version>
      <description>Parent pom providing dependency and plugin management for applications built with Maven</description>
    </archetype>
  </archetypes>
</archetype-catalog>

IDEA 新建项目

IDEA 点击 New Project 创建新项目

选择 Maven Archetype 项目

管理添加前置步骤创建的Catalog

• 点击 Manage catalogs
• 1: 点击添加
• 2: 点击 文件夹图标 选择 archetype-catalog.xml 所在目录
• 3: 选择该文件夹
• 4: 点击 Add 添加

填充信息创建项目

• 
  • 1: 项目名称
  • 2: 选择刚刚添加的 catalog
  • 3: 选择骨架项目 engine-archetype-web
  • 4: 配置服务启动类前缀
  • 5: 配置服务基础包名
  • 6: 开始创建

启动项目

• 等待项目创建完成
• 启动类启动
• 使用 test > resources > http > TestUserController.http 测试前两个接口
• 

---

手工方式初始化项目

新建项目

项目结构

• qifu-saas-xxx
  • qifu-saas-xxx-client
  • qifu-saas-xxx-service

引入需要的功能包

qifu-saas-xxx > 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>com.yuanmeng.qifu</groupId>
        <artifactId>qifu-saas-parent</artifactId>
        <version>2.0.0-SNAPSHOT</version>
    </parent>

    <artifactId>qifu-saas-xxx</artifactId>
    <version>${revision}</version>
    <packaging>pom</packaging>
    <name>qifu-saas-xxx</name>

    <modules>
        <module>qifu-saas-xxx-client</module>
        <module>qifu-saas-xxx-service</module>
    </modules>

    <properties>
        <!-- 开发版本管理 -->
        <revision>0.0.1-SNAPSHOT</revision>
        <qifu.saas.xxx.client.version>0.0.1-SNAPSHOT</qifu.saas.xxx.client.version>
    </properties>

    <profiles>
        <profile>
            <id>development</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
            </properties>
        </profile>
        <profile>
            <id>production</id>
            <properties>
                <!-- 发布版本管理 -->
                <revision>0.0.1</revision>
                <qifu.saas.xxx.client.version>0.0.1</qifu.saas.xxx.client.version>
            </properties>
        </profile>
    </profiles>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.yuanmeng.qifu</groupId>
                <artifactId>qifu-saas-xxx-client</artifactId>
                <version>${qifu.saas.xxx.client.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

qifu-saas-xxx-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>com.yuanmeng.qifu</groupId>
        <artifactId>qifu-saas-xxx</artifactId>
        <version>${revision}</version>
    </parent>
    <artifactId>qifu-saas-xxx-client</artifactId>
    <dependencies>
        <dependency>
            <groupId>com.yuanmeng.engine</groupId>
            <artifactId>engine-starter-feign</artifactId>
        </dependency>
    </dependencies>
</project>

qifu-saas-xxx-service > 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>com.yuanmeng.qifu</groupId>
        <artifactId>qifu-saas-xxx</artifactId>
        <version>${revision}</version>
    </parent>

    <artifactId>qifu-saas-xxx-service</artifactId>

    <dependencies>
        <dependency>
            <groupId>com.yuanmeng.qifu</groupId>
            <artifactId>qifu-saas-xxx-client</artifactId>
        </dependency>

        <dependency>
            <groupId>com.yuanmeng.engine</groupId>
            <artifactId>engine-starter-web</artifactId>
        </dependency>
    </dependencies>

</project>

编写启动类

@EnableFeignClients(basePackages = {"com.yuanmeng.*"})
@EnableDiscoveryClient
@SpringBootApplication
public class QifuSaasEgApplication {

    public static void main(String[] args) {
        SpringApplication.run(QifuSaasEgApplication.class, args);
    }

}

编写配置文件

• bootstrap.yml

server:
  port: 10000
spring:
  application:
    name: qifu-saas-xxx

  cloud:
    nacos:
      discovery:
        namespace: qifu-develop
        server-addr: @discovery.server-addr@
        username: @discovery.username@
        password: @discovery.password@
        register-enabled: false
        ip: ${spring.application.name}

启动测试