public record ScanResult()

in doc-architect/doc-architect-core/src/main/java/com/docarchitect/core/scanner/ScanResult.java [22:127]
82 lines of code
15 McCabe index (conditional complexity)

public record ScanResult(
    String scannerId,
    boolean success,
    List<Component> components,
    List<Dependency> dependencies,
    List<ApiEndpoint> apiEndpoints,
    List<MessageFlow> messageFlows,
    List<DataEntity> dataEntities,
    List<Relationship> relationships,
    List<String> warnings,
    List<String> errors,
    ScanStatistics statistics
) {
    /**
     * Compact constructor with validation.
     */
    public ScanResult {
        Objects.requireNonNull(scannerId, "scannerId must not be null");
        if (components == null) {
            components = List.of();
        }
        if (dependencies == null) {
            dependencies = List.of();
        }
        if (apiEndpoints == null) {
            apiEndpoints = List.of();
        }
        if (messageFlows == null) {
            messageFlows = List.of();
        }
        if (dataEntities == null) {
            dataEntities = List.of();
        }
        if (relationships == null) {
            relationships = List.of();
        }
        if (warnings == null) {
            warnings = List.of();
        }
        if (errors == null) {
            errors = List.of();
        }
        if (statistics == null) {
            statistics = ScanStatistics.empty();
        }
    }

    /**
     * Creates a successful scan result with no findings.
     *
     * @param scannerId scanner ID
     * @return empty successful result
     */
    public static ScanResult empty(String scannerId) {
        return new ScanResult(
            scannerId,
            true,
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            ScanStatistics.empty()
        );
    }

    /**
     * Creates a failed scan result with errors.
     *
     * @param scannerId scanner ID
     * @param errors error messages
     * @return failed result
     */
    public static ScanResult failed(String scannerId, List<String> errors) {
        return new ScanResult(
            scannerId,
            false,
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            List.of(),
            errors,
            ScanStatistics.empty()
        );
    }

    /**
     * Returns true if this result has any findings.
     *
     * @return true if components, dependencies, APIs, etc. were found
     */
    public boolean hasFindings() {
        return !components.isEmpty()
            || !dependencies.isEmpty()
            || !apiEndpoints.isEmpty()
            || !messageFlows.isEmpty()
            || !dataEntities.isEmpty()
            || !relationships.isEmpty();
    }
}