快捷導(dǎo)航

SpringBoot返回所有接口詳細(xì)信息的方法詳解

更新時(shí)間：2025年04月11日 08:42:42 作者：小u

這篇文章主要介紹了SpringBoot返回所有接口詳細(xì)信息的方法,簡(jiǎn)單來(lái)說(shuō)就是我們通過(guò)訪問(wèn)一個(gè)接口能看到我們所有的API接口的數(shù)量,以及路徑和請(qǐng)求方法,文中有詳細(xì)的代碼供大家參考,需要的朋友可以參考下

springboot返回所有接口詳細(xì)信息

簡(jiǎn)單來(lái)說(shuō)

就是我們通過(guò)訪問(wèn)一個(gè)接口能看到我們所有的API接口的數(shù)量。

以及路徑和請(qǐng)求方法。

這個(gè)是我今天再做一個(gè)項(xiàng)目的首頁(yè)的時(shí)候。

前端的設(shè)計(jì)是有一個(gè)這樣的需求

因此這個(gè)數(shù)據(jù)需要我們從后臺(tái)來(lái)進(jìn)行一個(gè)動(dòng)態(tài)的獲取。

這里我們所需要用到的就是

spring-boot-starter-actuator

首先導(dǎo)入依賴(lài)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.mvc.method.RequestMappingInfo;
import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping;

import org.springframework.context.ApplicationContext;

import java.util.*;

@RestController
@RequestMapping("/uapi/api-list")
@Tag(name = "API列表", description = "API列表")
public class ApiListController {

    private final RequestMappingHandlerMapping handlerMapping;

    @Autowired
    public ApiListController(ApplicationContext context) {
        this.handlerMapping = context.getBean("requestMappingHandlerMapping", RequestMappingHandlerMapping.class);
    }

    @GetMapping
    @Operation(summary = "獲取所有API列表")
    public Map<String, Object> listAllApi() {
        Map<RequestMappingInfo, HandlerMethod> handlerMethods = handlerMapping.getHandlerMethods();
        List<Map<String, String>> apiList = new ArrayList<>();

        for (Map.Entry<RequestMappingInfo, HandlerMethod> entry : handlerMethods.entrySet()) {
            RequestMappingInfo info = entry.getKey();
            Set<String> paths = new HashSet<>();

            // ? 只使用 Spring Boot 3 推薦方式
            if (info.getPathPatternsCondition() != null) {
                info.getPathPatternsCondition().getPatterns()
                    .forEach(p -> paths.add(p.getPatternString()));
            }

            Set<RequestMethod> methods = info.getMethodsCondition().getMethods();

            for (String path : paths) {
                if (methods.isEmpty()) {
                    apiList.add(Map.of("method", "ANY", "path", path));
                } else {
                    for (RequestMethod method : methods) {
                        apiList.add(Map.of("method", method.name(), "path", path));
                    }
                }
            }
        }

        Map<String, Object> result = new HashMap<>();
        result.put("count", apiList.size());
        result.put("apis", apiList);
        return result;
    }
}

上面貼出的是springboot3的寫(xiě)法。

這個(gè)代碼的核心原理就是

通過(guò)反射獲取 Spring Boot 項(xiàng)目中所有控制器方法的路徑和請(qǐng)求方式，然后把這些信息組織成一個(gè)列表，返回給用戶(hù)。通過(guò)這種方式，開(kāi)發(fā)者可以查看當(dāng)前 Spring Boot 項(xiàng)目中的所有公開(kāi) API 接口及其支持的請(qǐng)求方法。

這一過(guò)程的核心依賴(lài)是 Spring Boot 的 RequestMappingHandlerMapping 類(lèi)，該類(lèi)負(fù)責(zé)管理所有請(qǐng)求路徑的映射，能夠獲取每個(gè)路徑的具體信息。

Map<RequestMappingInfo, HandlerMethod> handlerMethods = handlerMapping.getHandlerMethods();

handlerMapping.getHandlerMethods() 通過(guò) Spring 的 RequestMappingHandlerMapping 類(lèi)獲取所有已經(jīng)注冊(cè)的請(qǐng)求映射信息。
這里返回的是一個(gè) Map，key 是 RequestMappingInfo（包含了路徑和請(qǐng)求方法的相關(guān)信息），value 是 HandlerMethod（指向處理該請(qǐng)求的控制器方法）。

后面的就是在對(duì)返回的數(shù)據(jù)進(jìn)行一個(gè)處理。

之后就會(huì)返回一個(gè)這樣的json

這樣就完成了我們的需求。

需要注意的是這段代碼

if (info.getPathPatternsCondition() != null) {
    info.getPathPatternsCondition().getPatterns()
        .forEach(p -> paths.add(p.getPatternString()));
}

Spring Boot 3.x 的新方式：使用 getPathPatternsCondition() 獲取路徑集合（Pattern 類(lèi)型），然后轉(zhuǎn)成字符串加到 paths 里。

Spring Boot 2.x 是用 getPatternsCondition()，在 3.x 中已經(jīng)廢棄。

后面我貼了一個(gè)兼容版本，既可以兼容springboot3也可以兼容springboot2

@GetMapping("/api-list")
public Map<String, Object> listAllApi() {
    Map<RequestMappingInfo, HandlerMethod> handlerMethods = handlerMapping.getHandlerMethods();
    List<Map<String, String>> apiList = new ArrayList<>();

    for (Map.Entry<RequestMappingInfo, HandlerMethod> entry : handlerMethods.entrySet()) {
        RequestMappingInfo info = entry.getKey();
        Set<String> paths = new HashSet<>();

        // Spring Boot 2.x
        if (info.getPatternsCondition() != null) {
            paths.addAll(info.getPatternsCondition().getPatterns());
        }

        // Spring Boot 3.x
        if (info.getPathPatternsCondition() != null) {
            info.getPathPatternsCondition().getPatterns()
                .forEach(p -> paths.add(p.getPatternString()));
        }

        Set<RequestMethod> methods = info.getMethodsCondition().getMethods();

        for (String path : paths) {
            if (methods.isEmpty()) {
                apiList.add(Map.of("method", "ANY", "path", path));
            } else {
                for (RequestMethod method : methods) {
                    apiList.add(Map.of("method", method.name(), "path", path));
                }
            }
        }
    }

    Map<String, Object> result = new HashMap<>();
    result.put("count", apiList.size());
    result.put("apis", apiList);
    return result;
}

以上就是SpringBoot返回所有接口詳細(xì)信息的方法詳解的詳細(xì)內(nèi)容，更多關(guān)于SpringBoot返回接口信息的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: