可用于应用程序的属性列表。Spring Boot中的属性？

Question

Spring Boot文档说我们可以在application.properties文件中设置属性。
但我找不到列出可设置的可用属性的文档。
在哪里可以找到这样的文档？

例如，我想为html" target="_blank">嵌入式Servlet设置documentRoot。
我发现setDocumentRoot（）方法是在AbstractembedDedServletContainerFactory.java中实现的。
但我不知道何时何地调用该方法，也不知道可以在Application.Properties中设置的属性名称。
我认为这应该很容易，因为Spring Boot的目的就是简化配置。

提前道谢。

更新:

正如M.Deinum所建议的，我将'server.document-root:someDirectoryName'添加到application.properties中，但发生了以下错误。

Caused by: org.springframework.beans.NotWritablePropertyException: Invalid property 'document-root' of bean class [org.springframework.boot.context.embedded.properties.ServerProperties]: Bean property 'document-root' is not writable or has an invalid setter method. Does the parameter type of the setter match the return type of the getter?
    at org.springframework.beans.BeanWrapperImpl.setPropertyValue(BeanWrapperImpl.java:1057)
    at org.springframework.beans.BeanWrapperImpl.setPropertyValue(BeanWrapperImpl.java:915)
    at org.springframework.beans.AbstractPropertyAccessor.setPropertyValues(AbstractPropertyAccessor.java:82)
    at org.springframework.validation.DataBinder.applyPropertyValues(DataBinder.java:730)
    at org.springframework.validation.DataBinder.doBind(DataBinder.java:626)
    at org.springframework.boot.bind.RelaxedDataBinder.doBind(RelaxedDataBinder.java:78)
    at org.springframework.validation.DataBinder.bind(DataBinder.java:611)
    at org.springframework.boot.bind.PropertiesConfigurationFactory.doBindPropertiesToTarget(PropertiesConfigurationFactory.java:232)
    at org.springframework.boot.bind.PropertiesConfigurationFactory.bindPropertiesToTarget(PropertiesConfigurationFactory.java:204)
    at org.springframework.boot.context.properties.ConfigurationPropertiesBindingPostProcessor.postProcessAfterInitialization(ConfigurationPropertiesBindingPostProcessor.java:312)
    ... 31 more

package com.sample.server;

import java.io.File;

import org.springframework.boot.context.embedded.ConfigurableEmbeddedServletContainerFactory;
import org.springframework.boot.context.embedded.EmbeddedServletContainerCustomizer;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class SampleConfiguration
{
    @Bean
    public SampleServerProperties sampleServerProperties()
    {
        return new SampleServerProperties();
    }

    @ConfigurationProperties(name = "sample.server")
    public static class SampleServerProperties
        implements EmbeddedServletContainerCustomizer 
    {
        private String documentRoot;
        public String getDocumentRoot()
        {
            return documentRoot;
        }
        public void setDocumentRoot(String documentRoot)
        {
            System.out.println("############## setDocumentRoot");
            this.documentRoot = documentRoot;
        }

        @Override
        public void customize(ConfigurableEmbeddedServletContainerFactory factory)
        {
            if (getDocumentRoot() != null)
            {
                factory.setDocumentRoot(new File(getDocumentRoot()));
            }
        }
    }
}

“#################SetDocumentRoot”被打印到控制台，文档根目录实际上被设置了。

所以，我现在很高兴，但这是正确的做法吗？

Answer 1

目前对原问题最正确的答案是，在一个位置上没有（而且技术上也不可能）一个详尽无遗的列表。我们可以并且将尽可能多地记录它（如果时间允许--感谢接受贡献）。用户指南中有一个手工整理的属性列表，该列表并非详尽无遗，而且可能不准确。最终的列表来自于在源代码中搜索@configurationproperties和@value注释，以及偶尔使用relaxedenvironment（此处为C.F.）。在howto文档中也有一些一般性的建议。