元数据格式 (Metadata Format) _ Spring Boot 3.3.1 中文文档(官方文档中文翻译) —

配置元数据文件位于 jar 下的 jar 中。它们使用 JSON 格式，其中项目分类在“组”或“属性”下，其他值提示分类在“提示”下，如以下示例所示：META-INF/spring-configuration-metadata.jsonSpring中文文档

{"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."
			}
		]
	}
]}

每个“属性”都是用户使用给定值指定的配置项。例如，可以在 / 中指定 and，如下所示：server.portserver.addressapplication.propertiesapplication.yamlSpring中文文档

PropertiesSpring中文文档
YAMLSpring中文文档

server.port=9090
server.address=127.0.0.1

server:
  port: 9090
  address: 127.0.0.1

“组”是更高级别的项目，它们本身不指定值，而是为属性提供上下文分组。例如，和属性是组的一部分。server.portserver.addressserverSpring中文文档

并不要求每个“属性”都有一个“组”。某些属性可能以自身权利存在。

最后，“提示”是用于帮助用户配置给定属性的附加信息。例如，当开发人员配置属性时，工具可以使用提示为、、、和值提供一些自动完成帮助。spring.jpa.hibernate.ddl-autononevalidateupdatecreatecreate-dropSpring中文文档

并不要求每个“属性”都有一个“组”。某些属性可能以自身权利存在。

组属性

数组中包含的 JSON 对象可以包含下表中显示的属性：groupsSpring中文文档

名字类型目的

名字	类型	目的
`name`Spring中文文档	字符串Spring中文文档	组的全名。此属性是必需的。Spring中文文档
`type`Spring中文文档	字符串Spring中文文档	组的数据类型的类名。例如，如果该组基于用批注的类，则该属性将包含该类的完全限定名称。如果它基于一个方法，它将是该方法的返回类型。如果类型未知，则可以省略该属性。`@ConfigurationProperties@Bean`Spring中文文档
`description`Spring中文文档	字符串Spring中文文档	可以向用户显示的组的简短说明。如果没有可用的描述，则可以省略它。建议描述是简短的段落，第一行提供简明扼要的摘要。描述中的最后一行应以句点（）结尾。`.`Spring中文文档
`sourceType`Spring中文文档	字符串Spring中文文档	贡献此组的源的类名。例如，如果组基于用批注的方法，则此属性将包含包含该方法的类的完全限定名称。如果源类型未知，则可以省略该属性。`@Bean@ConfigurationProperties@Configuration`Spring中文文档
`sourceMethod`Spring中文文档	字符串Spring中文文档	贡献此组的方法的全名（包括括号和参数类型）（例如，带批注的方法的名称）。如果源方法未知，则可以省略它。`@ConfigurationProperties@Bean`Spring中文文档

组属性

属性属性

提示属性

重复的元数据项