你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

教程：在 Java Spring 应用中使用动态配置

项目
12/13/2024

应用程序配置包含两个适用于 Spring 的库。

spring-cloud-azure-appconfiguration-config 需要 Spring Boot 并依赖于 spring-cloud-context。
spring-cloud-azure-appconfiguration-config-web 需要 Spring Web 和 Spring Boot，并且还添加了对配置刷新自动检查的支持。

支持手动触发这两个库来检查刷新的配置值。

通过刷新操作，无需重启应用程序即可更新配置值，不过，这会导致在 @RefreshScope 中重新创建所有的 bean。它检查对已配置触发器（包括元数据）的任何更改。默认情况下，更改检查之间的最短时间（刷新间隔）设置为 30 秒。

spring-cloud-azure-appconfiguration-config-web 的自动刷新是基于活动（具体而言，是基于 Spring Web 的 ServletRequestHandledEvent）触发的。如果未触发 ServletRequestHandledEvent，则即使已到缓存过期时间，spring-cloud-azure-appconfiguration-config-web 的自动刷新也不会触发刷新。

使用手动刷新

若要使用手动刷新，请从使用应用程序配置的 Spring Boot 应用（例如，按适用于应用程序配置的 Spring Boot 快速入门创建的应用）着手。

应用程序配置公开了 AppConfigurationRefresh，可用于检查缓存是否已过期。如果已过期，则会触发刷新。

若要使用 AppConfigurationRefresh，请更新 HelloController。

import com.azure.spring.cloud.config.AppConfigurationRefresh;

@RestController
public class HelloController {
    private final MessageProperties properties;

    @Autowired(required = false)
    private AppConfigurationRefresh refresh;

    public HelloController(MessageProperties properties) {
        this.properties = properties;
    }

    @GetMapping
    public String getMessage() throws InterruptedException, ExecutionException {
        if (refresh != null) {
            refresh.refreshConfigurations();
        }
        return "Message: " + properties.getMessage();
    }
}

如果已触发刷新，则 AppConfigurationRefresh 的 refreshConfigurations() 将返回值为 true 的 Mono，否则返回项的值为 false。 False 表示缓存过期时间未过、未发生更改，或者另一线程当前正在检查刷新。

要启用刷新更新 bootstrap.properties，请：

spring.cloud.azure.appconfiguration.stores[0].monitoring.enabled=true
spring.cloud.azure.appconfiguration.stores[0].monitoring.refresh-interval= 30s
spring.cloud.azure.appconfiguration.stores[0].monitoring.triggers[0].key=sentinel

打开 Azure 门户并导航到与应用程序关联的应用程序配置资源。选择“操作”下的“配置资源管理器”，然后通过选择“+ 创建”>“键值”并添加以下参数以创建新的键值对。

密钥值

sentinel 1

暂时将“标签”和“内容类型”保留为空。
选择“应用”。
使用 Maven 生成 Spring Boot 应用程序，然后运行该程序。
```
mvn clean package
mvn spring-boot:run
```
打开浏览器窗口，访问 URL：http://localhost:8080。会显示与密钥关联的消息。

还可以使用 curl 来测试应用程序，例如：
```
curl -X GET http://localhost:8080/
```
若要测试动态配置，请打开与应用程序关联的 Azure 应用程序配置门户。选择“配置资源管理器”，并更新所显示的密钥的值，例如：

键值

/application/config.message Hello - Updated
将之前创建的 sentinel 密钥更新为新值。刷新间隔经过后，此更改将立即触发应用程序来刷新所有配置密钥。

密钥值

sentinel 2
刷新浏览器页面两次，查看显示的新消息。第一次触发刷新，第二次加载更改。

密钥	值
sentinel	1

键	值
/application/config.message	Hello - Updated

密钥	值
sentinel	2

注意

该库仅在刷新间隔过去后检查更改。如果时间尚未过去，则不会显示任何更改。等待该时间段过去，然后触发刷新检查。

使用自动刷新

若要使用自动刷新，请从使用应用程序配置的 Spring Boot 应用（例如，按适用于应用程序配置的 Spring Boot 快速入门创建的应用）着手。

然后，在文本编辑器中打开 pom.xml 文件，并使用以下代码为 spring-cloud-azure-appconfiguration-config-web 添加 <dependency>。

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-appconfiguration-config-web</artifactId>
    <version>5.18.0</version>
</dependency>

要启用刷新更新 bootstrap.properties，请：

spring.cloud.azure.appconfiguration.stores[0].monitoring.enabled=true
spring.cloud.azure.appconfiguration.stores[0].monitoring.refresh-interval= 30s
spring.cloud.azure.appconfiguration.stores[0].monitoring.triggers[0].key=sentinel

打开 Azure 门户并导航到与应用程序关联的应用程序配置资源。选择“操作”下的“配置资源管理器”，然后通过选择“+ 创建”>“键值”并添加以下参数以创建新的键值对。

密钥值

sentinel 1

暂时将“标签”和“内容类型”保留为空。
选择“应用”。
使用 Maven 生成 Spring Boot 应用程序，然后运行该程序。
```
mvn clean package
mvn spring-boot:run
```
打开浏览器窗口，访问 URL：http://localhost:8080。现在你可以看到与密钥关联的消息。

还可以使用 curl 来测试应用程序，例如：
```
curl -X GET http://localhost:8080/
```
若要测试动态配置，请打开与应用程序关联的 Azure 应用程序配置门户。选择“配置资源管理器”，并更新所显示的密钥的值，例如：

键值

/application/config.message Hello - Updated
将之前创建的 sentinel 密钥更新为新值。刷新间隔经过后，此更改将立即触发应用程序来刷新所有配置密钥。

密钥值

sentinel 2
刷新浏览器页面两次，查看显示的新消息。第一次触发刷新，第二次加载更改，因为第一个请求使用原始范围返回。

密钥	值
sentinel	1

键	值
/application/config.message	Hello - Updated

密钥	值
sentinel	2

注意

该库仅在刷新间隔过去后检查更改。如果刷新间隔尚未过去，则不会检查更改。等待间隔时间过去，然后触发刷新检查。

后续步骤

在本教程中，你已启用 Spring Boot 应用，可以通过应用程序配置动态刷新配置设置。有关更多问题，请参阅参考文档，其中包含有关 Spring Cloud Azure 应用程序配置库如何工作的所有详细信息。若要了解如何使用 Azure 托管标识来简化对应用程序配置的访问，请继续学习下一篇教程。

托管标识集成

通过

教程：在 Java Spring 应用中使用动态配置

使用手动刷新

使用自动刷新

后续步骤

反馈

其他资源