应用级服务发现迁移示例

应用级服务发现是应用之间服务发现的协议。因此，要使用应用级服务发现，消费者和服务器都必须升级到 Dubbo 3.0 并启用新功能（默认启用），才能在链接中使用应用级服务发现。利用应用级服务发现。

开启方法

服务器端

应用升级到 Dubbo 3.0 后，服务器端会自动开启接口级 + 应用级双注册功能，开发者默认无需修改任何配置

消费端

应用升级到 Dubbo 3.0 后，消费端会自动开启接口级 + 应用级双订阅功能，开发者默认无需修改任何配置。建议服务器升级到 Dubbo 3.0 并启用应用级注册后，配置消费端通过规则关闭接口级订阅，以释放相应的内存空间。

详细说明

服务器配置

1. 全局开关

应用配置（可以通过配置文件或 -D 指定）`dubbo.application.register-mode` 启用实例的全局注册开关（仅注册应用级）和全部（接口级和应用级注册）。配置此开关后，默认情况下，应用级地址将注册到所有注册中心，以便在消费端进行服务发现。

示例：[https://github.com/apache/dubbo-samples/blob/master/dubbo-samples-cloud-native/dubbo-servicediscovery-migration/dubbo-servicediscovery-migration-provider2/src/main/resources/ dubbo.properties](https://github.com/apache/dubbo-samples/blob/master/2-advanced/dubbo-samples-service-discovery/dubbo-servicediscovery-migration/dubbo-servicediscovery-migration-provider2/src /main/resources/dubbo.properties)

# double registration
dubbo.application.register-mode=all

# Application-level registration only
dubbo.application.register-mode=instance

2. 注册中心地址参数配置

可以在注册中心的地址上配置 registry-type=service，以显示将注册中心指定为应用级服务发现的注册中心，并且具有此配置的注册中心将仅执行应用级服务发现。

示例：[https://github.com/apache/dubbo-samples/blob/master/dubbo-samples-cloud-native/dubbo-demo-servicediscovery-xml/servicediscovery-provider/src/main/resources/spring/ dubbo-provider.xml](https://github.com/apache/dubbo-samples/blob/master/2-advanced/dubbo-samples-service-discovery/dubbo-demo-servicediscovery-xml/servicediscovery-provider/src /main/resources/spring/dubbo-provider.xml)

<dubbo:registry address="nacos://${nacos.address:127.0.0.1}:8848?registry-type=service"/>

消费者订阅模式

FORCE_INTERFACE：仅接口级订阅，行为与 Dubbo 2.7 及以前版本一致。APPLICATION_FIRST：接口级 + 应用级多订阅，如果应用级可以订阅地址，则使用应用级订阅，如果无法订阅地址，则使用接口级订阅，从而在迁移过程中保证最大的兼容性。（注意：由于同时订阅行为，此模式下的内存使用量会有一定程度的增加，因此在所有服务器都升级到 Dubbo 3.0 后，建议迁移到 FORCE_APPLICATION 模式以减少内存使用量）FORCE_APPLICATION：仅应用级订阅将仅使用新的服务发现模型。

消费者配置

1. 默认配置（无需配置）

升级到 Dubbo 3.0 后，默认行为是接口级 + 应用级多订阅。如果可以在应用级别订阅地址，则将使用应用级别订阅。如果无法订阅地址，则将使用接口级别订阅以确保最大兼容性。

2. 订阅参数配置

应用配置（可以通过配置文件或 -D 指定）`dubbo.application.service-discovery.migration` 为 `APPLICATION_FIRST` 以启用多订阅模式，配置为 `FORCE_APPLICATION` 可以强制仅使用应用级订阅模式。可以在 `ReferenceConfig` 中的 `parameters` 中配置具体的接口订阅，Key 为 `migration.step`，Value 为 `APPLICATION_FIRST` 或 `FORCE_APPLICATION` 键值对以配置单个订阅。

示例：[https://github.com/apache/dubbo-samples/blob/master/dubbo-samples-cloud-native/dubbo-servicediscovery-migration/dubbo-servicediscovery-migration-consumer/src/test/java/ org/apache/dubbo/demo/consumer/DemoServiceConfigIT.java](https://github.com/apache/dubbo-samples/blob/master/2-advanced/dubbo-samples-service-discovery/dubbo-servicediscovery-migration /dubbo-servicediscovery-migration-consumer/src/test/java/org/apache/dubbo/demo/consumer/DemoServiceConfigIT.java)

System.setProperty("dubbo.application.service-discovery.migration", "APPLICATION_FIRST");

ReferenceConfig<DemoService> referenceConfig = new ReferenceConfig<>(applicationModel. newModule());
referenceConfig.setInterface(DemoService.class);
referenceConfig.setParameters(new HashMap<>());
referenceConfig.getParameters().put("migration.step", mode);
return referenceConfig.get();

3. 动态配置（优先级最高，配置可在运行时修改）

此配置需要根据配置中心推送，Key 为应用名 + .migration（例如 demo-application.migraion），Group 为 DUBBO_SERVICEDISCOVERY_MIGRATION。规则体配置详情请参考 接口级服务发现迁移至应用级服务发现指南。

示例: [https://github.com/apache/dubbo-samples/blob/master/dubbo-samples-cloud-native/dubbo-servicediscovery-migration/dubbo-servicediscovery-migration-consumer/src/main/java/ org/apache/dubbo/demo/consumer/UpgradeUtil.java](https://github.com/apache/dubbo-samples/blob/master/2-advanced/dubbo-samples-service-discovery/dubbo-servicediscovery-migration /dubbo-servicediscovery-migration-consumer/src/main/java/org/apache/dubbo/demo/consumer/UpgradeUtil.java)

step: FORCE_INTERFACE