您现在访问的是微软AZURE全球版技术文档网站，若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站，请访问 https://docs.azure.cn.

快速入门：使用 Azure 应用配置创建 Java Spring 应用

04/18/2020

本文内容

在本快速入门中，会将 Azure 应用程序配置合并到 Java Spring 应用程序中，以集中存储和管理与代码分离的应用程序设置。

先决条件

Azure 订阅 - 创建免费帐户

Apache Maven 版本 3.0 或更高版本。

创建应用配置存储区

若要创建新应用程序配置存储区，请登录 Azure 门户。 在主页的左上角，选择“创建资源” 。 在“搜索市场”框中，输入“应用配置”，然后选择 Enter。

在搜索结果中选择“应用程序配置”，然后选择“创建” 。

在“创建应用配置”窗格中，输入以下设置：

设置

建议的值

说明

订阅

订阅

选择要用来测试应用配置的 Azure 订阅。 如果帐户只有一个订阅，则会自动选择该订阅并且不显示“订阅”列表 。

资源组

AppConfigTestResources

为应用程序配置存储区资源选择或创建资源组。 此组可用于组织多个资源，删除该资源组可以同时删除这些资源。 有关详细信息，请参阅使用资源组管理 Azure 资源。

资源名称

全局唯一名称

输入要用于应用程序配置存储区资源的唯一资源名称。 该名称必须是包含 5 到 50 个字符的字符串，只能包含数字、字母和 - 字符。 该名称的开头或末尾不能是 - 字符。

位置

美国中部

使用“位置”指定在其中托管应用配置存储区的地理位置 。 为获得最佳性能，请在应用程序的其他组件所在的同一区域创建资源。

定价层

免费

选择所需的定价层。 有关详细信息，请参阅应用配置定价页。

选择“查看 + 创建”以验证自己的设置 。

选择“创建”。 部署可能需要几分钟。

部署完成后，导航到“应用程序配置”资源。 选择“设置” > “访问密钥”。 记下只读主密钥连接字符串。 稍后将使用此连接字符串来配置应用程序，以与创建的应用程序配置存储区进行通信。

选择“配置资源管理器” > “+ 创建” > “键-值”来添加以下键值对 ：

密钥

值

/application/config.message

你好

暂时将“标签”和“内容类型”保留为空 。

选择“应用”。

创建 Spring Boot 应用

使用 Spring Initializr 创建一个新 Spring Boot 项目。

指定以下选项：

使用 Java 生成一个 Maven 项目。

指定一个其值大于或等于 2.0 的 Spring Boot 版本。

指定应用程序的“组”和“项目”名称。

添加 Spring Web 依赖项。

指定上述选项后，选择“生成项目” 。 出现提示时，将项目下载到本地计算机中的路径。

连接到应用程序配置存储区

从本地系统提取文件后，即可使用简单的 Spring Boot 应用程序进行编辑。 在应用的根目录中找到 pom.xml 文件 。

在文本编辑器中打开 pom.xml 文件，将 Spring Cloud Azure Config Starter 添加到 列表：

Spring Cloud 1.1.x

com.microsoft.azure

spring-cloud-azure-appconfiguration-config

1.1.5

Spring Cloud 1.2.x

com.microsoft.azure

spring-cloud-azure-appconfiguration-config

1.2.7

在应用的包目录中创建名为 MessageProperties.java 的新 Java 文件 。 添加以下行：

package com.example.demo;

import org.springframework.boot.context.properties.ConfigurationProperties;

@ConfigurationProperties(prefix = "config")

public class MessageProperties {

private String message;

public String getMessage() {

return message;

}

public void setMessage(String message) {

this.message = message;

}

}

在应用的包目录中创建新的名为 HelloController.java 的 Java 文件 。 添加以下行：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController

public class HelloController {

private final MessageProperties properties;

public HelloController(MessageProperties properties) {

this.properties = properties;

}

@GetMapping

public String getMessage() {

return "Message: " + properties.getMessage();

}

}

打开主应用程序 Java 文件，并添加 @EnableConfigurationProperties以启用此功能。

import org.springframework.boot.context.properties.EnableConfigurationProperties;

@SpringBootApplication

@EnableConfigurationProperties(MessageProperties.class)

public class DemoApplication {

public static void main(String[] args) {

SpringApplication.run(DemoApplication.class, args);

}

}

在应用的资源目录下创建名为 bootstrap.properties 的新文件，并将以下行添加到该文件中。 使用应用程序配置存储区的相应属性替换示例值。

spring.cloud.azure.appconfiguration.stores[0].connection-string= ${APP_CONFIGURATION_CONNECTION_STRING}

设置名为“APP_CONFIGURATION_CONNECTION_STRING”的环境变量，并将其设置为应用配置存储的访问密钥 。 在命令行中，运行以下命令并重启命令提示符，以使更改生效：

setx APP_CONFIGURATION_CONNECTION_STRING "connection-string-of-your-app-configuration-store"

如果使用 Windows PowerShell，请运行以下命令：

$Env:APP_CONFIGURATION_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"

如果使用 macOS 或 Linux，则请运行以下命令：

export APP_CONFIGURATION_CONNECTION_STRING='connection-string-of-your-app-configuration-store'

在本地生成并运行应用

使用 Maven 生成 Spring Boot 应用程序，然后运行该程序，例如：

mvn clean package

mvn spring-boot:run

应用程序运行以后，请使用 curl 测试该应用程序，例如 ：

curl -X GET http://localhost:8080/

可看到在应用程序配置存储区中输入的消息。

清理资源

如果不想继续使用本文中创建的资源，请删除此处创建的资源组以避免产生费用。

重要

删除资源组的操作不可逆。 将永久删除资源组以及其中的所有资源。 请确保不要意外删除错误的资源组或资源。 如果在包含要保留的其他资源的资源组中创建了本文的资源，请从相应的窗格中单独删除每个资源，而不是删除该资源组。

登录到 Azure 门户，然后选择“资源组”。

在“按名称筛选”框中，输入资源组的名称。

在结果列表中，选择资源组名称以查看概述。

选择“删除资源组”。

系统会要求确认是否删除资源组。 重新键入资源组的名称进行确认，然后选择“删除” 。

片刻之后，将会删除该资源组及其所有资源。

后续步骤

本快速入门介绍了如何创建新的应用程序配置存储区，并将其用于 Java Spring 应用。 有关详细信息，请参阅 Azure 上的 Spring。 若要了解如何使 Java Spring 应用能够动态刷新配置设置，请继续学习下一个教程。