映射(映射)
这映射端点提供关于应用程序请求映射的信息。
获取映射
要获取映射,请获取请求/执行器/映射如以下基于卷度的示例所示:
$ curl 'http://localhost:39533/actuator/mappings' -i -X GET \
-H 'accept-encoding: gzip' \
-H 'user-agent: ReactorNetty/1.3.0' \
-H 'accept: */*'
最终的响应类似于以下内容:
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)。 下表描述了反应中共同元素的结构:
| 路径 | 类型 | 描述 |
|---|---|---|
|
|
应用程序上下文由ID键入。 |
|
|
上下文中的映射,按映射类型键化。 |
|
|
调度员servlet映射(如果有的话)。 |
|
|
如果有的话,需要ServletFilter映射。 |
|
|
如果有的话,需要servlet映射。 |
|
|
调度员处理器映射(如果有的话)。 |
|
|
如果有,请提供父应用上下文的ID。 |
可在上下文。*.映射以下章节将有详细描述。
调度器servlet响应结构
使用Spring MVC时,响应包含任何调度器服务请求映射contexts.*.mappings.dispatcherServlets.
下表描述了本部分回应的结构:
| 路径 | 类型 | 描述 |
|---|---|---|
|
|
调度器servlet映射(如有),由调度器servlet的bean名称键入。 |
|
|
关于映射的具体实现细节。自选。 |
|
|
负责绘制地图的处理员。 |
|
|
映射的谓词。 |
|
|
如果有处理该映射请求的函数细节(如有)。 |
|
|
函数类别的完全限定名称。 |
|
|
如果有处理该映射请求的方法细节(如有)。 |
|
|
方法是完全限定的分类名称。 |
|
|
方法名称。 |
|
|
该方法的描述符,如 Java 语言规范中规定的。 |
|
|
请求映射条件的详细信息。 |
|
|
消费条件的详细信息 |
|
|
消费媒体类型。 |
|
|
媒介类型是否被否定。 |
|
|
关于头部条件的详细信息。 |
|
|
头部名称。 |
|
|
头部的必要值(如果有的话)。 |
|
|
是否价值被否定。 |
|
|
HTTP 方法被处理。 |
|
|
参数条件的详细信息。 |
|
|
参数名称。 |
|
|
参数的必要值(如果有的话)。 |
|
|
是否价值被否定。 |
|
|
识别映射所处理路径的模式。 |
|
|
产生条件的详细信息。 |
|
|
制作媒体类型。 |
|
|
媒介类型是否被否定。 |
Servlets 反应结构
使用Servlet栈时,响应包含任意servlet下方映射contexts.*.mappings.servlets.
下表描述了本部分回应的结构:
| 路径 | 类型 | 描述 |
|---|---|---|
|
|
servlet的映射。 |
|
|
servlet的名字。 |
|
|
servlet 的类名 |
Servlet Filter响应结构
使用Servlet栈时,响应包含任意Filter下方映射contexts.*.mappings.servletFilters.
下表描述了本部分回应的结构:
| 路径 | 类型 | 描述 |
|---|---|---|
|
|
Filter映射到的servlet名称。 |
|
|
过滤所映射的URL模式。 |
|
|
过滤器名称。 |
|
|
Filter的类名 |
调度处理器响应结构
使用Spring WebFlux时,响应包含任何调度员处理员请求映射contexts.*.mappings.dispatcherHandlers.
下表描述了本部分回应的结构:
| 路径 | 类型 | 描述 |
|---|---|---|
|
|
调度器处理器映射(如有)由调度器处理豆名键入。 |
|
|
关于映射的具体实现细节。自选。 |
|
|
负责绘制地图的处理员。 |
|
|
映射的谓词。 |
|
|
请求映射条件的详细信息。 |
|
|
消费条件的详细信息 |
|
|
消费媒体类型。 |
|
|
媒介类型是否被否定。 |
|
|
关于头部条件的详细信息。 |
|
|
头部名称。 |
|
|
头部的必要值(如果有的话)。 |
|
|
是否价值被否定。 |
|
|
HTTP 方法被处理。 |
|
|
参数条件的详细信息。 |
|
|
参数名称。 |
|
|
参数的必要值(如果有的话)。 |
|
|
是否价值被否定。 |
|
|
识别映射所处理路径的模式。 |
|
|
产生条件的详细信息。 |
|
|
制作媒体类型。 |
|
|
媒介类型是否被否定。 |
|
|
如果有处理该映射请求的方法细节(如有)。 |
|
|
方法是完全限定的分类名称。 |
|
|
方法名称。 |
|
|
该方法的描述符,如 Java 语言规范中规定的。 |
|
|
如果有处理该映射请求的函数细节(如有)。 |
|
|
函数类别的完全限定名称。 |