全部产品
Search
文档中心

企业级分布式应用服务 EDAS:使用Spring Boot开发Dubbo微服务应用

更新时间:Jul 08, 2024

Spring Boot简化了微服务应用的配置和部署,您可以自行选择注册中心和配置管理。本文介绍如何使用Spring Boot注解的方式基于Nacos开发一个Dubbo微服务示例应用。如果您已有Spring Boot开发的Dubbo应用,可以跳过本文内容,直接部署到EDAS。

前提条件

在使用Spring Boot开发Dubbo微服务应用前,请先完成以下工作:

  • 下载Maven并设置环境变量。

  • 下载最新版本的Nacos Server

  • 启动Nacos Server。

    1. 解压下载的Nacos Server压缩包

    2. 进入nacos/bin目录,启动Nacos Server。

      • Linux/Unix/Mac系统:执行命令sh startup.sh -m standalone

      • Windows系统:修改startup.cmd,配置参数set MODE="standalone",然后执行。

示例工程

您可以按照本文的逐步搭建工程,也可以选择直接下载本文对应的示例工程,或者使用Git来clone:git clone https://github.com/aliyun/alibabacloud-microservice-demo.git

该项目包含了众多的示例工程,本文对应的示例工程位于alibabacloud-microservice-demo/microservice-doc-demo/dubbo-samples-spring-boot

创建服务提供者

  1. 创建命名为spring-boot-dubbo-provider的Maven工程。

  2. pom.xml文件中添加所需的依赖。

    这里以Spring Boot 2.0.6.RELEASE为例。

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>2.0.6.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-actuator</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
            <version>2.7.3</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
            <version>1.1.1</version>
        </dependency>
    </dependencies>                   
  3. 开发Dubbo服务提供者。

    Dubbo中服务都是以接口的形式提供的。

    1. src/main/java路径下创建一个packagecom.alibaba.edas.boot

    2. com.alibaba.edas.boot下创建一个接口(interface)IHelloService,里面包含一个SayHello方法。

      package com.alibaba.edas.boot;
      public interface IHelloService {
      String sayHello(String str);
      }                                
    3. com.alibaba.edas.boot下创建一个类IHelloServiceImpl,实现此接口。

      package com.alibaba.edas.boot;
      import com.alibaba.dubbo.config.annotation.Service;
      @Service
      public class IHelloServiceImpl implements IHelloService {
      public String sayHello(String name) {
        return "Hello, " + name + " (from Dubbo with Spring Boot)";
       }
      }                                
      说明

      这里的Service注解是Dubbo提供的一个注解类,类的全名称为:com.alibaba.dubbo.config.annotation.Service

  4. 配置Dubbo服务。

    1. src/main/resources路径下创建application.propertiesapplication.yaml文件并打开。

    2. application.propertiesapplication.yaml中添加如下配置。

      # Base packages to scan Dubbo Components (e.g @Service , @Reference)
      dubbo.scan.basePackages=com.alibaba.edas.boot
      dubbo.application.name=dubbo-provider-demo
      dubbo.registry.address=nacos://127.0.0.1:8848                                
      说明
      • 以上三个配置没有默认值,必须要给出具体的配置。

      • dubbo.scan.basePackages的值是开发的代码中含有com.alibaba.dubbo.config.annotation.Servicecom.alibaba.dubbo.config.annotation.Reference注解所在的包。多个包之间用逗号隔开。

      • dubbo.registry.address的值前缀必须以nacos://开头,后面的IP地址和端口指的是Nacos Server的地址。代码示例中为本地地址,如果您使用EDAS托管的注册中心,无需额外调整,EDAS在运行时会自动调整为正确的注册中心地址。如果您使用自建的Nacos注册中心,需将dubbo.registry.address的参数值修改为正确的Nacos地址。

  5. 开发并启动Spring Boot入口类DubboProvider

        package com.alibaba.edas.boot;
    
        import org.springframework.boot.SpringApplication;
        import org.springframework.boot.autoconfigure.SpringBootApplication;
    
        @SpringBootApplication
        public class DubboProvider {
    
            public static void main(String[] args) {
                SpringApplication.run(DubboProvider.class, args);
            }
    
        }                        
  6. 登录Nacos控制台http://127.0.0.1:8848,在左侧导航栏中单击服务列表,查看提供者列表。

    可以看到服务提供者里已经包含了com.alibaba.edas.boot.IHelloService,且可以查询该服务的服务分组和提供者IP。

创建服务消费者

  1. 创建一个Maven工程,命名为spring-boot-dubbo-consumer

  2. pom.xml文件中添加相关依赖。

    这里以Spring Boot 2.0.6.RELEASE为例。

        <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>2.0.6.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-actuator</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
            <version>2.7.3</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
            <version>1.1.1</version>
        </dependency>
    
    </dependencies>                        

    如果您需要选择使用Spring Boot 1.x的版本,请使用Spring Boot 1.5.x版本,对应的com.alibaba.boot:dubbo-spring-boot-starter版本为0.1.0。

    说明

    Spring Boot 1.x版本的生命周期已于2019年08月结束,推荐使用新版本开发您的应用。

  3. 开发Dubbo消费者。

    1. src/main/java路径下创建packagecom.alibaba.edas.boot

    2. com.alibaba.edas.boot下创建一个接口(interface)IHelloService,里面包含一个SayHello方法。

      package com.alibaba.edas.boot;
      
      public interface IHelloService {
       String sayHello(String str);
      }                                
  4. 开发Dubbo服务调用。

    例如需要在Controller中调用一次远程Dubbo服务,开发的代码如下所示。

    package com.alibaba.edas.boot;
    
    import com.alibaba.dubbo.config.annotation.Reference;
    import org.springframework.web.bind.annotation.PathVariable;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
        public class DemoConsumerController {
    
            @Reference
            private IHelloService demoService;
    
            @RequestMapping("/sayHello/{name}")
            public String sayHello(@PathVariable String name) {
                return demoService.sayHello(name);
            }
        }                        
    说明

    这里的Reference注解是com.alibaba.dubbo.config.annotation.Reference。

  5. application.properties/application.yaml配置文件中新增以下配置。

    dubbo.application.name=dubbo-consumer-demo
    dubbo.registry.address=nacos://127.0.0.1:8848                        
    说明
    • 以上两个配置没有默认值,必须给出具体的配置。

    • dubbo.registry.address的值前缀必须以nacos://开头,后面的IP地址和端口为Nacos Server的地址。代码示例中为本地地址,如果您将Nacos Server部署在其它机器上,请修改为实际的IP地址。

  6. 开发并启动Spring Boot入口类DubboConsumer

    package com.alibaba.edas.boot;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class DubboConsumer {
    
        public static void main(String[] args) {
            SpringApplication.run(DubboConsumer.class, args);
        }
    
    }                        
  7. 登录Nacos控制台http://127.0.0.1:8848,在左侧导航栏中单击服务列表,再在服务列表页面查看调用者服务。

    可以看到包含了com.alibaba.edas.boot.IHelloService,且可以查看该服务的服务分组和调用者IP。

结果验证

`curl http://localhost:8080/sayHello/EDAS`

`Hello, EDAS (from Dubbo with Spring Boot)`            

部署到EDAS

说明

EDAS集成的ACM即Nacos的正式商用版本。当您将应用部署到EDAS的时候,EDAS会自动替换您本地Nacos Server的地址和服务端口(127.0.0.1:8848),您无需修改。

您可以根据实际需求选择部署的集群类型(主要为ECS集群或容器服务Kubernetes集群)和部署途径(控制台或工具),请参见如下文档:

如果您使用控制台部署,在部署前,需要在本地应用程序中完成以下操作:

  1. pom.xml文件中添加以下打包插件的配置。

    • Provider

      <build>
       <plugins>
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <executions>
                     <execution>
                         <goals>
                             <goal>repackage</goal>
                         </goals>
                         <configuration>
                             <classifier>spring-boot</classifier>
                             <mainClass>com.alibaba.edas.boot.DubboProvider</mainClass>
                         </configuration>
                     </execution>
                 </executions>
             </plugin>
       </plugins>
      </build>                                
    • Consumer

      <build>
       <plugins>
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <executions>
                     <execution>
                         <goals>
                             <goal>repackage</goal>
                         </goals>
                         <configuration>
                             <classifier>spring-boot</classifier>
                             <mainClass>com.alibaba.edas.boot.DubboConsumer</mainClass>
                         </configuration>
                     </execution>
                 </executions>
             </plugin>
       </plugins>
      </build>                                
  2. 执行mvn clean package将本地的程序打成JAR包。

更多信息

如果您使用了edas-dubbo-extension,由于edas-dubbo-extension的方式不能使用EDAS提供的相关功能,如Dubbo服务治理,所以不推荐使用,建议您迁移到Nacos。