映射(映射)

映射端点提供关于应用程序请求映射的信息。spring-doc.cadn.net.cn

获取映射

要获取映射,请获取请求/执行器/映射如以下基于卷度的示例所示:spring-doc.cadn.net.cn

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

最终的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Transfer-Encoding: chunked
Date: Thu, 20 Nov 2025 16:34:06 GMT
Content-Length: 5780

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

响应结构

响应包含应用映射的详细信息。 响应中出现的项目取决于网页应用的类型(响应式或基于Servlet)。 下表描述了反应中共同元素的结构:spring-doc.cadn.net.cn

路径 类型 描述

上下文spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

应用程序上下文由ID键入。spring-doc.cadn.net.cn

上下文。*.映射spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

上下文中的映射,按映射类型键化。spring-doc.cadn.net.cn

contexts.*.mappings.dispatcherServletsspring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

调度员servlet映射(如果有的话)。spring-doc.cadn.net.cn

contexts.*.mappings.servletFiltersspring-doc.cadn.net.cn

数组spring-doc.cadn.net.cn

如果有的话,需要ServletFilter映射。spring-doc.cadn.net.cn

contexts.*.mappings.servletsspring-doc.cadn.net.cn

数组spring-doc.cadn.net.cn

如果有的话,需要servlet映射。spring-doc.cadn.net.cn

contexts.*.mappings.dispatcherHandlersspring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

调度员处理器映射(如果有的话)。spring-doc.cadn.net.cn

contexts.*.parentId(上下文)。*.parentId(亲子身份)spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

如果有,请提供父应用上下文的ID。spring-doc.cadn.net.cn

可在上下文。*.映射以下章节将有详细描述。spring-doc.cadn.net.cn

调度器servlet响应结构

使用Spring MVC时,响应包含任何调度器服务请求映射contexts.*.mappings.dispatcherServlets. 下表描述了本部分回应的结构:spring-doc.cadn.net.cn

路径 类型 描述

*spring-doc.cadn.net.cn

数组spring-doc.cadn.net.cn

调度器servlet映射(如有),由调度器servlet的bean名称键入。spring-doc.cadn.net.cn

*.[].细节spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

关于映射的具体实现细节。自选。spring-doc.cadn.net.cn

*.[]。处理者spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

负责绘制地图的处理员。spring-doc.cadn.net.cn

*.[]。谓词spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

映射的谓词。spring-doc.cadn.net.cn

*.[].details.handler函数spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

如果有处理该映射请求的函数细节(如有)。spring-doc.cadn.net.cn

*.[].details.handlerFunction.classNamespring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

函数类别的完全限定名称。spring-doc.cadn.net.cn

*.[].details.handlerMethodspring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

如果有处理该映射请求的方法细节(如有)。spring-doc.cadn.net.cn

*.[].details.handlerMethod.classNamespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

方法是完全限定的分类名称。spring-doc.cadn.net.cn

*.[].details.handlerMethod.namespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

方法名称。spring-doc.cadn.net.cn

*.[].details.handlerMethod.descriptorspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

该方法的描述符,如 Java 语言规范中规定的。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions(条件)spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

请求映射条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.consumesspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

消费条件的详细信息spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.consumes.[].mediaTypespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

消费媒体类型。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.consumes.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

媒介类型是否被否定。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.头部spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

关于头部条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.headers.[].名称spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

头部名称。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.headers.[].值spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

头部的必要值(如果有的话)。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.headers.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

是否价值被否定。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.methodsspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

HTTP 方法被处理。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.paramsspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

参数条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.params.[].名称spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

参数名称。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.params.[].值spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

参数的必要值(如果有的话)。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.params.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

是否价值被否定。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.patternsspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

识别映射所处理路径的模式。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.producespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

产生条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.produces.[].mediaTypespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

制作媒体类型。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.produces.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

媒介类型是否被否定。spring-doc.cadn.net.cn

Servlets 反应结构

使用Servlet栈时,响应包含任意servlet下方映射contexts.*.mappings.servlets. 下表描述了本部分回应的结构:spring-doc.cadn.net.cn

路径 类型 描述

[].映射spring-doc.cadn.net.cn

数组spring-doc.cadn.net.cn

servlet的映射。spring-doc.cadn.net.cn

[].名称spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

servlet的名字。spring-doc.cadn.net.cn

[].classNamespring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

servlet 的类名spring-doc.cadn.net.cn

Servlet Filter响应结构

使用Servlet栈时,响应包含任意Filter下方映射contexts.*.mappings.servletFilters. 下表描述了本部分回应的结构:spring-doc.cadn.net.cn

路径 类型 描述

[].servletNameMappingsspring-doc.cadn.net.cn

数组spring-doc.cadn.net.cn

Filter映射到的servlet名称。spring-doc.cadn.net.cn

[].urlPatternMappingsspring-doc.cadn.net.cn

数组spring-doc.cadn.net.cn

过滤所映射的URL模式。spring-doc.cadn.net.cn

[].名称spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

过滤器名称。spring-doc.cadn.net.cn

[].classNamespring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

Filter的类名spring-doc.cadn.net.cn

调度处理器响应结构

使用Spring WebFlux时,响应包含任何调度员处理员请求映射contexts.*.mappings.dispatcherHandlers. 下表描述了本部分回应的结构:spring-doc.cadn.net.cn

路径 类型 描述

*spring-doc.cadn.net.cn

数组spring-doc.cadn.net.cn

调度器处理器映射(如有)由调度器处理豆名键入。spring-doc.cadn.net.cn

*.[].细节spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

关于映射的具体实现细节。自选。spring-doc.cadn.net.cn

*.[]。处理者spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

负责绘制地图的处理员。spring-doc.cadn.net.cn

*.[]。谓词spring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

映射的谓词。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions(条件)spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

请求映射条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.consumesspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

消费条件的详细信息spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.consumes.[].mediaTypespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

消费媒体类型。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.consumes.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

媒介类型是否被否定。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.头部spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

关于头部条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.headers.[].名称spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

头部名称。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.headers.[].值spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

头部的必要值(如果有的话)。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.headers.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

是否价值被否定。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.methodsspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

HTTP 方法被处理。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.paramsspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

参数条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.params.[].名称spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

参数名称。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.params.[].值spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

参数的必要值(如果有的话)。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.params.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

是否价值被否定。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.patternsspring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

识别映射所处理路径的模式。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.producespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

产生条件的详细信息。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.produces.[].mediaTypespring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

制作媒体类型。spring-doc.cadn.net.cn

*.[].details.requestMappingConditions.produces.[]。被否定spring-doc.cadn.net.cn

不同spring-doc.cadn.net.cn

媒介类型是否被否定。spring-doc.cadn.net.cn

*.[].details.handlerMethodspring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

如果有处理该映射请求的方法细节(如有)。spring-doc.cadn.net.cn

*.[].details.handlerMethod.classNamespring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

方法是完全限定的分类名称。spring-doc.cadn.net.cn

*.[].details.handlerMethod.namespring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

方法名称。spring-doc.cadn.net.cn

*.[].details.handlerMethod.descriptorspring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

该方法的描述符,如 Java 语言规范中规定的。spring-doc.cadn.net.cn

*.[].details.handler函数spring-doc.cadn.net.cn

对象spring-doc.cadn.net.cn

如果有处理该映射请求的函数细节(如有)。spring-doc.cadn.net.cn

*.[].details.handlerFunction.classNamespring-doc.cadn.net.cn

字符串spring-doc.cadn.net.cn

函数类别的完全限定名称。spring-doc.cadn.net.cn