Spring Boot簡化了微服務應用的配置和部署,您可以自行選擇注冊中心和配置管理。本文介紹如何使用Spring Boot注解的方式基于Nacos開發一個Dubbo微服務示例應用。如果您已有Spring Boot開發的Dubbo應用,可以跳過本文內容,直接部署到EDAS。
前提條件
在使用Spring Boot開發Dubbo微服務應用前,請先完成以下工作:
下載Maven并設置環境變量。
下載最新版本的Nacos Server。
啟動Nacos Server。
解壓下載的Nacos Server壓縮包
進入
nacos/bin
目錄,啟動Nacos Server。Linux/Unix/Mac系統:執行命令
sh startup.sh -m standalone
。Windows系統:修改
startup.cmd
,配置參數set MODE="standalone"
,然后執行。
可選:
您可以使用云原生腳手架創建Spring Boot項目,可參見詳情。
在本地開發應用時,可以使用Alibaba Cloud Toolkit插件實現本地應用和部署在EDAS中的應用的相互調用,即端云互聯,而無需搭建VPN,幫助您提升開發效率。更多信息,請參見端云互聯簡介。
示例工程
您可以按照本文的逐步搭建工程,也可以選擇直接下載本文對應的示例工程,或者使用Git來clone:git clone https://github.com/aliyun/alibabacloud-microservice-demo.git
該項目包含了眾多的示例工程,本文對應的示例工程位于alibabacloud-microservice-demo/microservice-doc-demo/dubbo-samples-spring-boot
。
創建服務提供者
創建命名為
spring-boot-dubbo-provider
的Maven工程。在
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>
開發Dubbo服務提供者。
Dubbo中服務都是以接口的形式提供的。
在
src/main/java
路徑下創建一個packagecom.alibaba.edas.boot
。在
com.alibaba.edas.boot
下創建一個接口(interface)IHelloService
,里面包含一個SayHello
方法。package com.alibaba.edas.boot; public interface IHelloService { String sayHello(String str); }
在
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。
配置Dubbo服務。
在
src/main/resources
路徑下創建application.properties
或application.yaml
文件并打開。在
application.properties
或application.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.Service
和com.alibaba.dubbo.config.annotation.Reference
注解所在的包。多個包之間用逗號隔開。dubbo.registry.address
的值前綴必須以nacos://開頭,后面的IP地址和端口指的是Nacos Server的地址。代碼示例中為本地地址,如果您使用EDAS托管的注冊中心,無需額外調整,EDAS在運行時會自動調整為正確的注冊中心地址。如果您使用自建的Nacos注冊中心,需將dubbo.registry.address的參數值修改為正確的Nacos地址。
開發并啟動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); } }
登錄Nacos控制臺
http://127.0.0.1:8848
,在左側導航欄中單擊服務列表,查看提供者列表。可以看到服務提供者里已經包含了
com.alibaba.edas.boot.IHelloService
,且可以查詢該服務的服務分組和提供者IP。
創建服務消費者
創建一個Maven工程,命名為
spring-boot-dubbo-consumer
。在
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月結束,推薦使用新版本開發您的應用。
開發Dubbo消費者。
在
src/main/java
路徑下創建packagecom.alibaba.edas.boot
。在
com.alibaba.edas.boot
下創建一個接口(interface)IHelloService
,里面包含一個SayHello
方法。package com.alibaba.edas.boot; public interface IHelloService { String sayHello(String str); }
開發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。
在
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地址。
開發并啟動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); } }
登錄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集群)和部署途徑(控制臺或工具),請參見如下文檔:
如果您使用控制臺部署,在部署前,需要在本地應用程序中完成以下操作:
在
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>
執行mvn clean package將本地的程序打成JAR包。
更多信息
如果您使用了edas-dubbo-extension
,由于edas-dubbo-extension
的方式不能使用EDAS提供的相關功能,如Dubbo服務治理,所以不推薦使用,建議您遷移到Nacos。