protected boolean shouldScanFile()

in doc-architect/doc-architect-core/src/main/java/com/docarchitect/core/scanner/impl/java/RabbitMQScanner.java [124:195]
53 lines of code
33 McCabe index (conditional complexity)

    protected boolean shouldScanFile(Path file) {
        // Priority 1: Filename convention (fastest check, no I/O)
        String fileName = file.getFileName().toString();
        if (fileName.endsWith("Listener.java") ||
            fileName.endsWith("Consumer.java") ||
            fileName.endsWith("Producer.java") ||
            fileName.endsWith("MessageHandler.java") ||
            fileName.contains("RabbitMQ") ||
            fileName.contains("Rabbit") ||
            (fileName.contains("Config") && fileName.endsWith(".java"))) {
            log.debug("Including file by naming convention: {}", fileName);
            return true;
        }

        // Skip test files unless they contain RabbitMQ patterns
        String filePath = file.toString();
        boolean isTestFile = filePath.contains("/test/") || filePath.contains("\\test\\");

        try {
            String content = readFileContent(file);

            // Priority 2: Check for Spring AMQP package imports (loose pattern for wildcards)
            // Matches: org.springframework.amqp.* OR individual imports
            boolean hasSpringAmqpImport =
                (content.contains("springframework") && content.contains("amqp")) ||
                (content.contains("springframework") && content.contains("rabbit"));

            // Priority 3: Check for RabbitMQ package imports
            boolean hasRabbitMQImport =
                content.contains("rabbitmq") ||
                content.contains("com.rabbitmq");

            // Priority 4: Check for direct RabbitMQ annotations
            boolean hasRabbitMQAnnotations =
                content.contains("@RabbitListener") ||
                content.contains("@RabbitHandler") ||
                content.contains("@EnableRabbit") ||
                content.contains("@Queue") ||
                content.contains("@Exchange") ||
                content.contains("@QueueBinding");

            // Priority 5: Check for RabbitMQ classes (catches usage even without annotations)
            boolean hasRabbitMQClasses =
                content.contains("RabbitTemplate") ||
                (content.contains("Queue") && content.contains("amqp")) ||
                (content.contains("Exchange") && content.contains("amqp")) ||
                (content.contains("Binding") && content.contains("amqp")) ||
                content.contains("SimpleMessageListenerContainer") ||
                content.contains("RabbitAdmin");

            boolean hasRabbitMQPatterns = hasSpringAmqpImport || hasRabbitMQImport ||
                                         hasRabbitMQAnnotations || hasRabbitMQClasses;

            if (hasRabbitMQPatterns) {
                log.debug("Including file with RabbitMQ patterns: {} (amqpImport={}, rabbitImport={}, annotations={}, classes={})",
                    fileName, hasSpringAmqpImport, hasRabbitMQImport, hasRabbitMQAnnotations, hasRabbitMQClasses);
            } else {
                log.debug("Skipping file without RabbitMQ patterns: {}", fileName);
            }

            // For test files, require RabbitMQ patterns
            // For non-test files, allow if they have RabbitMQ patterns
            if (isTestFile) {
                return hasRabbitMQPatterns;
            }

            return hasRabbitMQPatterns;
        } catch (IOException e) {
            log.debug("Failed to read file for pre-filtering: {}", file);
            return false;
        }
    }