手把手：Spring Cloud Alibaba项目搭建

分类：Java

Spring Cloud Alibaba是Spring Cloud下面的一个子项目，它致力于提供分布式服务开发的一站式解决方案。关于Spring相关框架的关系和基础知识介绍，可以参考之前的文章：春天的故事：Spring框架的入门级知识。

今天，我们就从零开始搭建一个Spring Cloud Alibaba的入门项目，重点演示项目的创建过程。开发工具使用Idea，并使用Maven来进行项目构建。

创建父工程。父工程用于整个项目的版本依赖和子模块管理。

在IDEA中选择File->New Project，选择Maven，不用勾选archetype（原型）：

然后输入项目名称、位置、GroupId、ArtifactId、版本等信息：

删除src目录，编辑pom.xml文件，指定Spring Cloud Alibaba等框架的版本，这些版本的对应关系可以查看官网上关于版本说明的wiki：

生成的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>com.fullstack</groupId>
    <artifactId>fs-parent</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!-- 父工程打包的形式为pom -->
    <packaging>pom</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.13</version>
        <relativePath/>
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <java.version>1.8</java.version>
        <spring.cloud.version>2021.0.5</spring.cloud.version>
        <spring.cloud.alibaba.version>2021.0.5.0</spring.cloud.alibaba.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring.cloud.alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <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>
</project>

选中父项目，点击右键，选择New->Module，用于创建一个子模块，还是选中Maven，并确认GroupId，ArtifactId等信息（会自动带出）：

编辑子模块fs-user的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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>fs-parent</artifactId>
        <groupId>com.fullstack</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>fs-user</artifactId>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

    <!-- JDK构建版本 -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

在这个fs-user子模块中，创建一个Spring Boot启动类：

package com.fullstack.commerce.user;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

然后再创建一个简单的Controller，只是为了测试项目搭建成功，所以没有任何业务逻辑，只返回了Hello World（噢，熟悉的配方，熟悉的味道）：

package com.fullstack.commerce.user.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("hello")
public class HelloController {

    @GetMapping("test")
    public String test(){
        return "Hello World";
    }
}