映射（映射） (Mappings (mappings)) _ Spring Boot 3.3.1 中文文档(官方文档中文翻译) —

终结点提供有关应用程序的请求映射的信息。mappingsSpring中文文档

检索映射

若要检索映射，请向发出请求，如以下基于 curl 的示例所示：GET/actuator/mappingsSpring中文文档

$ curl 'http://localhost:43107/actuator/mappings' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.20' \
    -H 'accept: */*'

生成的响应类似于以下内容：Spring中文文档

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Transfer-Encoding: chunked
Date: Thu, 20 Jun 2024 09:58:06 GMT
Content-Length: 5342

{
  "contexts" : {
    "application" : {
      "mappings" : {
        "dispatcherServlets" : {
          "dispatcherServlet" : [ {
            "handler" : "Actuator root web endpoint",
            "predicate" : "{GET [/actuator], produces [application/vnd.spring-boot.actuator.v3+json || application/vnd.spring-boot.actuator.v2+json || application/json]}",
            "details" : {
              "handlerMethod" : {
                "className" : "org.springframework.boot.actuate.endpoint.web.servlet.WebMvcEndpointHandlerMapping.WebMvcLinksHandler",
                "name" : "links",
                "descriptor" : "(Ljakarta/servlet/http/HttpServletRequest;Ljakarta/servlet/http/HttpServletResponse;)Ljava/util/Map;"
              },
              "requestMappingConditions" : {
                "consumes" : [ ],
                "headers" : [ ],
                "methods" : [ "GET" ],
                "params" : [ ],
                "patterns" : [ "/actuator" ],
                "produces" : [ {
                  "mediaType" : "application/vnd.spring-boot.actuator.v3+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/vnd.spring-boot.actuator.v2+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/json",
                  "negated" : false
                } ]
              }
            }
          }, {
            "handler" : "Actuator web endpoint 'mappings'",
            "predicate" : "{GET [/actuator/mappings], produces [application/vnd.spring-boot.actuator.v3+json || application/vnd.spring-boot.actuator.v2+json || application/json]}",
            "details" : {
              "handlerMethod" : {
                "className" : "org.springframework.boot.actuate.endpoint.web.servlet.AbstractWebMvcEndpointHandlerMapping.OperationHandler",
                "name" : "handle",
                "descriptor" : "(Ljakarta/servlet/http/HttpServletRequest;Ljava/util/Map;)Ljava/lang/Object;"
              },
              "requestMappingConditions" : {
                "consumes" : [ ],
                "headers" : [ ],
                "methods" : [ "GET" ],
                "params" : [ ],
                "patterns" : [ "/actuator/mappings" ],
                "produces" : [ {
                  "mediaType" : "application/vnd.spring-boot.actuator.v3+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/vnd.spring-boot.actuator.v2+json",
                  "negated" : false
                }, {
                  "mediaType" : "application/json",
                  "negated" : false
                } ]
              }
            }
          }, {
            "handler" : "org.springframework.boot.actuate.autoconfigure.endpoint.web.documentation.MappingsEndpointServletDocumentationTests$ExampleController#example()",
            "predicate" : "{POST [/], params [a!=alpha], headers [X-Custom=Foo], consumes [application/json || !application/xml], produces [text/plain]}",
            "details" : {
              "handlerMethod" : {
                "className" : "org.springframework.boot.actuate.autoconfigure.endpoint.web.documentation.MappingsEndpointServletDocumentationTests.ExampleController",
                "name" : "example",
                "descriptor" : "()Ljava/lang/String;"
              },
              "requestMappingConditions" : {
                "consumes" : [ {
                  "mediaType" : "application/json",
                  "negated" : false
                }, {
                  "mediaType" : "application/xml",
                  "negated" : true
                } ],
                "headers" : [ {
                  "name" : "X-Custom",
                  "value" : "Foo",
                  "negated" : false
                } ],
                "methods" : [ "POST" ],
                "params" : [ {
                  "name" : "a",
                  "value" : "alpha",
                  "negated" : true
                } ],
                "patterns" : [ "/" ],
                "produces" : [ {
                  "mediaType" : "text/plain",
                  "negated" : false
                } ]
              }
            }
          }, {
            "handler" : "ResourceHttpRequestHandler [classpath [META-INF/resources/webjars/]]",
            "predicate" : "/webjars/**"
          }, {
            "handler" : "ResourceHttpRequestHandler [classpath [META-INF/resources/], classpath [resources/], classpath [static/], classpath [public/], ServletContext [/]]",
            "predicate" : "/**"
          } ]
        },
        "servletFilters" : [ {
          "servletNameMappings" : [ ],
          "urlPatternMappings" : [ "/*" ],
          "name" : "requestContextFilter",
          "className" : "org.springframework.boot.web.servlet.filter.OrderedRequestContextFilter"
        }, {
          "servletNameMappings" : [ ],
          "urlPatternMappings" : [ "/*" ],
          "name" : "formContentFilter",
          "className" : "org.springframework.boot.web.servlet.filter.OrderedFormContentFilter"
        } ],
        "servlets" : [ {
          "mappings" : [ "/" ],
          "name" : "dispatcherServlet",
          "className" : "org.springframework.web.servlet.DispatcherServlet"
        } ]
      }
    }
  }
}

响应结构

响应包含应用程序映射的详细信息。响应中的项目取决于 Web 应用程序的类型（响应式或基于 Servlet）。下表描述了响应的常见元素的结构：Spring中文文档

路径类型描述

路径	类型	描述
`contexts`Spring中文文档	`Object`Spring中文文档	按 id 键控的应用程序上下文。Spring中文文档
`contexts.*.mappings`Spring中文文档	`Object`Spring中文文档	上下文中的映射，按映射类型键控。Spring中文文档
`contexts.*.mappings.dispatcherServlets`Spring中文文档	`Object`Spring中文文档	调度程序 Servlet 映射（如果有）。Spring中文文档
`contexts.*.mappings.servletFilters`Spring中文文档	`Array`Spring中文文档	Servlet 过滤器映射（如果有）。Spring中文文档
`contexts.*.mappings.servlets`Spring中文文档	`Array`Spring中文文档	Servlet 映射（如果有）。Spring中文文档
`contexts.*.mappings.dispatcherHandlers`Spring中文文档	`Object`Spring中文文档	调度程序处理程序映射（如果有）。Spring中文文档
`contexts.*.parentId`Spring中文文档	`String`Spring中文文档	父应用程序上下文的 ID（如果有）。Spring中文文档

contextsSpring中文文档

ObjectSpring中文文档

按 id 键控的应用程序上下文。Spring中文文档

contexts.*.mappingsSpring中文文档

ObjectSpring中文文档

上下文中的映射，按映射类型键控。Spring中文文档

contexts.*.mappings.dispatcherServletsSpring中文文档

ObjectSpring中文文档

调度程序 Servlet 映射（如果有）。Spring中文文档

contexts.*.mappings.servletFiltersSpring中文文档

ArraySpring中文文档

Servlet 过滤器映射（如果有）。Spring中文文档

contexts.*.mappings.servletsSpring中文文档

ArraySpring中文文档

Servlet 映射（如果有）。Spring中文文档

contexts.*.mappings.dispatcherHandlersSpring中文文档

ObjectSpring中文文档

调度程序处理程序映射（如果有）。Spring中文文档

contexts.*.parentIdSpring中文文档

StringSpring中文文档

父应用程序上下文的 ID（如果有）。Spring中文文档

以下各节介绍了可以在中找到的条目。contexts.*.mappingsSpring中文文档

Dispatcher Servlet 响应结构

使用 Spring MVC 时，响应包含下任何请求映射的详细信息。下表描述了响应的此部分的结构：DispatcherServletcontexts.*.mappings.dispatcherServletsSpring中文文档

路径类型描述

路径	类型	描述
`*`Spring中文文档	`Array`Spring中文文档	调度程序 Servlet 映射（如果有），按调度程序 Servlet Bean 名称键控。Spring中文文档
`*.[].details`Spring中文文档	`Object`Spring中文文档	有关映射的其他特定于实现的详细信息。自选。Spring中文文档
`*.[].handler`Spring中文文档	`String`Spring中文文档	映射的处理程序。Spring中文文档
`*.[].predicate`Spring中文文档	`String`Spring中文文档	映射的谓词。Spring中文文档
`*.[].details.handlerMethod`Spring中文文档	`Object`Spring中文文档	将处理对此映射的请求的方法（如果有）的详细信息。Spring中文文档
`*.[].details.handlerMethod.className`Spring中文文档	`Varies`Spring中文文档	方法类的完全限定名称。Spring中文文档
`*.[].details.handlerMethod.name`Spring中文文档	`Varies`Spring中文文档	方法的名称。Spring中文文档
`*.[].details.handlerMethod.descriptor`Spring中文文档	`Varies`Spring中文文档	Java 语言规范中指定的方法的描述符。Spring中文文档
`*.[].details.requestMappingConditions`Spring中文文档	`Object`Spring中文文档	请求映射条件的详细信息。Spring中文文档
`*.[].details.requestMappingConditions.consumes`Spring中文文档	`Varies`Spring中文文档	消耗条件的详细信息Spring中文文档
`*.[].details.requestMappingConditions.consumes.[].mediaType`Spring中文文档	`Varies`Spring中文文档	使用的媒体类型。Spring中文文档
`*.[].details.requestMappingConditions.consumes.[].negated`Spring中文文档	`Varies`Spring中文文档	是否否定媒体类型。Spring中文文档
`*.[].details.requestMappingConditions.headers`Spring中文文档	`Varies`Spring中文文档	标头条件的详细信息。Spring中文文档
`*.[].details.requestMappingConditions.headers.[].name`Spring中文文档	`Varies`Spring中文文档	标头的名称。Spring中文文档
`*.[].details.requestMappingConditions.headers.[].value`Spring中文文档	`Varies`Spring中文文档	标头的必填值（如果有）。Spring中文文档
`*.[].details.requestMappingConditions.headers.[].negated`Spring中文文档	`Varies`Spring中文文档	该值是否被否定。Spring中文文档
`*.[].details.requestMappingConditions.methods`Spring中文文档	`Varies`Spring中文文档	处理的 HTTP 方法。Spring中文文档
`*.[].details.requestMappingConditions.params`Spring中文文档	`Varies`Spring中文文档	参数条件的详细信息。Spring中文文档
`*.[].details.requestMappingConditions.params.[].name`Spring中文文档	`Varies`Spring中文文档	参数的名称。Spring中文文档
`*.[].details.requestMappingConditions.params.[].value`Spring中文文档	`Varies`Spring中文文档	参数的必填值（如果有）。Spring中文文档
`*.[].details.requestMappingConditions.params.[].negated`Spring中文文档	`Varies`Spring中文文档	该值是否被否定。Spring中文文档
`*.[].details.requestMappingConditions.patterns`Spring中文文档	`Varies`Spring中文文档	标识映射处理的路径的模式。Spring中文文档
`*.[].details.requestMappingConditions.produces`Spring中文文档	`Varies`Spring中文文档	生产条件的详细信息。Spring中文文档
`*.[].details.requestMappingConditions.produces.[].mediaType`Spring中文文档	`Varies`Spring中文文档	生成的媒体类型。Spring中文文档
`*.[].details.requestMappingConditions.produces.[].negated`Spring中文文档	`Varies`Spring中文文档	是否否定媒体类型。Spring中文文档

*Spring中文文档

ArraySpring中文文档

调度程序 Servlet 映射（如果有），按调度程序 Servlet Bean 名称键控。Spring中文文档

*.[].detailsSpring中文文档

ObjectSpring中文文档

有关映射的其他特定于实现的详细信息。自选。Spring中文文档

*.[].handlerSpring中文文档

StringSpring中文文档

映射的处理程序。Spring中文文档

*.[].predicateSpring中文文档

StringSpring中文文档

映射的谓词。Spring中文文档