配置元数据文件位于 META-INF/spring-configuration-metadata.json 下的 jar 中。它们使用一种简单的 JSON 格式，其中项目被归类在 “groups” 或 “properties” 之下，其他值被归类在 "hints" 之下，如下面的示例所示：

{"groups": [
	{
		"name": "server",
		"type": "org.springframework.boot.autoconfigure.web.ServerProperties",
		"sourceType": "org.springframework.boot.autoconfigure.web.ServerProperties"
	},
	{
		"name": "spring.jpa.hibernate",
		"type": "org.springframework.boot.autoconfigure.orm.jpa.JpaProperties$Hibernate",
		"sourceType": "org.springframework.boot.autoconfigure.orm.jpa.JpaProperties",
		"sourceMethod": "getHibernate()"
	}
	...
],"properties": [
	{
		"name": "server.port",
		"type": "java.lang.Integer",
		"sourceType": "org.springframework.boot.autoconfigure.web.ServerProperties"
	},
	{
		"name": "server.address",
		"type": "java.net.InetAddress",
		"sourceType": "org.springframework.boot.autoconfigure.web.ServerProperties"
	},
	{
		  "name": "spring.jpa.hibernate.ddl-auto",
		  "type": "java.lang.String",
		  "description": "DDL mode. This is actually a shortcut for the \"hibernate.hbm2ddl.auto\" property.",
		  "sourceType": "org.springframework.boot.autoconfigure.orm.jpa.JpaProperties$Hibernate"
	}
	...
],"hints": [
	{
		"name": "spring.jpa.hibernate.ddl-auto",
		"values": [
			{
				"value": "none",
				"description": "Disable DDL handling."
			},
			{
				"value": "validate",
				"description": "Validate the schema, make no changes to the database."
			},
			{
				"value": "update",
				"description": "Update the schema if necessary."
			},
			{
				"value": "create",
				"description": "Create the schema and destroy previous data."
			},
			{
				"value": "create-drop",
				"description": "Create and then destroy the schema at the end of the session."
			}
		]
	}
]}

每个属性是用户用给定值指定的配置项。例如，可以在 application.properties 中指定 server.port 和 server.address，如下：

server.port=9090
server.address=127.0.0.1

“groups” 是较高级别的项，它们本身不指定值，而是为属性提供上下文分组。例如，server.port 和 server.address 属性是 server group 的一部分。

最后，“hints” 是用来帮助用户配置给定属性的附加信息。例如，当开发人员配置 spring.jpa.hibernate.ddl-auto 属性时，工具可以使用这些提示为 none、validate、update、create, 和 create-drop 的值提供一些自动完成帮助。

为了改善用户体验并进一步帮助用户配置给定属性，可以提供附加元数据：

通过使用 spring-boot-configuration-processor jar，你可以很容易地从 @ConfigurationProperties 注解的项生成你自己的配置元数据文件。jar 包含一个 Java 注解处理器，它在你的项目被编译时调用。要使用处理器，需要包含对 spring-boot-configuration-processor 的依赖项。

在 Maven 中，依赖项应该声明为可选的，如下面的示例所示：

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-configuration-processor</artifactId>
	<optional>true</optional>
</dependency>

对于 Gradle 4.5 和更早版本，依赖关系应该在 compileOnly 配置中声明，如下面的示例所示：

dependencies {
	compileOnly "org.springframework.boot:spring-boot-configuration-processor"
}

对于 Gradle 4.6 以及更高版本，依赖关系应该在 annotationProcessor 配置中声明，如下面的示例所示：

dependencies {
	annotationProcessor "org.springframework.boot:spring-boot-configuration-processor"
}

如果你使用的是 additional-spring-configuration-metadata.json 文件，那么 compileJava 任务应该被配置为依赖于 processResources 任务，如下面的示例所示：

compileJava.dependsOn(processResources)

这种依赖性确保在编译过程中注解处理器运行时附加元数据可用。

处理器选择用 @ConfigurationProperties 注解的类和方法。配置类中的字段值的 Javadoc 用于填充描述属性。

属性是通过标准 getter 和 setter 的存在来发现的，它们具有对集合类型的特殊处理（即使只存在 getter 也会检测到）。注解处理器还支持使用 @Data、@Getter 和 @Setter lombok 注解。