public ScanResult scan()

in doc-architect/doc-architect-core/src/main/java/com/docarchitect/core/scanner/impl/java/SpringRestApiScanner.java [227:282]
43 lines of code
5 McCabe index (conditional complexity)

    public ScanResult scan(ScanContext context) {
        log.info("Scanning Spring REST APIs in: {}", context.rootPath());

        List<ApiEndpoint> apiEndpoints = new ArrayList<>();
        List<Component> components = new ArrayList<>();
        ScanStatistics.Builder statsBuilder = new ScanStatistics.Builder();

        // Find all Java files
        List<Path> javaFiles = context.findFiles(JAVA_FILE_PATTERN).toList();
        statsBuilder.filesDiscovered(javaFiles.size());

        if (javaFiles.isEmpty()) {
            log.warn("No Java files found in project");
            return emptyResult();
        }

        int skippedFiles = 0;
        for (Path javaFile : javaFiles) {
            // Pre-filter files before attempting to parse
            if (!shouldScanFile(javaFile)) {
                skippedFiles++;
                continue;
            }

            statsBuilder.incrementFilesScanned();

            // Use three-tier parsing with fallback
            FileParseResult<ApiEndpoint> result = parseWithFallback(
                javaFile,
                cu -> extractEndpointsFromAST(cu),
                createFallbackStrategy(),
                statsBuilder
            );

            if (result.isSuccess()) {
                apiEndpoints.addAll(result.getData());
            }
        }

        log.debug("Pre-filtered {} files (not Spring MVC controllers)", skippedFiles);

        ScanStatistics statistics = statsBuilder.build();
        log.info("Found {} REST API endpoints (success rate: {:.1f}%, overall parse rate: {:.1f}%)",
            apiEndpoints.size(), statistics.getSuccessRate(), statistics.getOverallParseRate());

        return buildSuccessResult(
            components,
            List.of(), // No dependencies
            apiEndpoints,
            List.of(), // No message flows
            List.of(), // No data entities
            List.of(), // No relationships
            List.of(), // No warnings
            statistics
        );
    }