服务注册发现

目录

• 目录
• 快速入门
  • 第一步：引入 Polaris 服务端
  • 第二步：引入服务注册与发现依赖
  • 第三步：增加相关配置文件
  • 第四步：启动服务
  • 第五步：服务调用
• 自定义参数

快速入门

本章节将介绍如何在 dubbo 项目中使用 dubbo-java-polaris 的服务注册发现功能。

我们提供了示例项目供您参考：

dubbo 3.2.x：dubbo-example 3.2.x

dubbo 2.7.x：dubbo-example 2.7.x

在本章节中，我们将以示例项目中的dubbo-discovery-example展示我们的服务注册发现功能。

第一步：引入 Polaris 服务端

北极星 PolarisMesh 实现了一站式微服务治理能力，在使用 dubbo-java-polaris 前，您需要准备一套北极星服务端环境。参考安装北极星服务端。

第二步：引入服务注册与发现依赖

dubbo-java-polaris目前支持Dubbo3.x和Dubbo2.x两个版本，对应的版本号为：

• Dubbo2.x：2.0.1.0-2.7.23
• Dubbo3.x：2.0.1.0-3.2.7

如果您正在使用Dubbo3.x，请在pom.xml中添加依赖：

        <dependency>
            <groupId>com.tencent.polaris</groupId>
            <artifactId>dubbo-registry-polaris</artifactId>
            <version>2.0.1.0-3.2.7</version>
        </dependency>

如果您正在使用Dubbo2.x，请在pom.xml中添加依赖：

        <dependency>
            <groupId>com.tencent.polaris</groupId>
            <artifactId>dubbo-registry-polaris</artifactId>
            <version>2.0.1.0-2.7.23</version>
        </dependency>

第三步：增加相关配置文件

在您的Dubbo配置文件中设置注册中心地址：

dubbo.registry.address=polaris://127.0.0.1:8091?namespace=test

第四步：启动服务

应用成功启动后，可以在 Polaris 控制台上查看服务注册信息。

在示例项目dubbo-discovery-example中，dubbo-quickstart-provider的Dubbo应用实现了GreetingService和EchoService两个服务接口。

启动dubbo-quickstart-provider后，Dubbo服务在北极星控制台中显示如下：

Note

由于Dubbo2仅支持接口级服务注册，因此Dubbo2在北极星上注册服务后，控制台上的服务名将显示Dubbo服务接口名。

第五步：服务调用

经过上述步骤后，您可以进行服务调用了。

在示例dubbo-discovery-example中，我们提供了dubbo-quickstart-consumer用于模拟远程调用dubbo-quickstart-provider服务。

您可以通过访问consumer提供的http接口来体验远程服务调用：

curl "http://localhost:15700/echo?value=polaris&method=sayHello"

Consumer会解析URL参数，远程调用GreetingService中的sayHello方法，返回结果如下：

➜  ~ curl "http://localhost:15700/echo?value=polaris&method=sayHello"
hello, polaris%

自定义参数

北极星地址的URL支持通过参数指定可选的配置，目前支持的参数如下：

参数	默认值	是否必填	说明
namespace	default	否	指定服务的命名空间