Optimierung: DefaultBatchRunProcessingUseCase moderat gestrafft

pdf-umbenenner-application/src/main/java/de/gecheckt/pdf/umbenenner/application/usecase/DefaultBatchRunProcessingUseCase.java

@@ -131,7 +131,7 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
         boolean lockAcquired = false;
 
         try {
-            // Step 1: Acquire exclusive run lock (prevents concurrent instances)
+            // Attempt to acquire the exclusive run lock
             try {
                 runLockPort.acquire();
                 lockAcquired = true;
@@ -147,7 +147,24 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
             LOG.info("Batch run started. RunId: {}, Start: {}",
                     context.runId(), context.startInstant());
 
-            // Step 2: Load PDF candidates from source folder
+            // Load and process all candidates
+            return processCandidates(context);
+
+        } catch (Exception e) {
+            LOG.error("Unexpected error during batch processing", e);
+            return BatchRunOutcome.FAILURE;
+        } finally {
+            releaseLockIfAcquired(lockAcquired);
+        }
+    }
+
+    /**
+     * Loads candidates and processes them one by one.
+     *
+     * @param context the current batch run context
+     * @return SUCCESS if all candidates were processed, FAILURE if source access fails
+     */
+    private BatchRunOutcome processCandidates(BatchRunContext context) {
         List<SourceDocumentCandidate> candidates;
         try {
             candidates = sourceDocumentCandidatesPort.loadCandidates();
@@ -157,7 +174,7 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
         }
         LOG.info("Found {} PDF candidate(s) in source folder.", candidates.size());
 
-            // Step 3: Process each candidate through the pipeline
+        // Process each candidate
         for (SourceDocumentCandidate candidate : candidates) {
             processCandidate(candidate, context);
         }
@@ -165,14 +182,17 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
         LOG.info("Batch run completed. Processed {} candidate(s). RunId: {}",
                 candidates.size(), context.runId());
         return BatchRunOutcome.SUCCESS;
+    }
 
-        } catch (Exception e) {
-            LOG.error("Unexpected error during batch processing", e);
-            return BatchRunOutcome.FAILURE;
-        } finally {
-            // Release the run lock only if it was successfully acquired.
-            // If acquire() threw RunLockUnavailableException, the lock belongs to another
-            // instance and must not be deleted by this instance.
+    /**
+     * Releases the run lock if it was previously acquired.
+     * <p>
+     * The lock is only released if it was successfully acquired. If acquire() failed
+     * (another instance holds the lock), this instance must not attempt to release it.
+     *
+     * @param lockAcquired whether the lock was acquired by this instance
+     */
+    private void releaseLockIfAcquired(boolean lockAcquired) {
         if (lockAcquired) {
             try {
                 runLockPort.release();
@@ -182,7 +202,6 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
             }
         }
     }
-    }
 
     /**
      * Processes a single PDF candidate through the complete pipeline.
@@ -213,28 +232,50 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
     private void processCandidate(SourceDocumentCandidate candidate, BatchRunContext context) {
         LOG.debug("Processing candidate: {}", candidate.uniqueIdentifier());
 
-        // Record the attempt start instant before any work begins
         Instant attemptStart = Instant.now();
-
-        // Step 1: Compute fingerprint
         FingerprintResult fingerprintResult = fingerprintPort.computeFingerprint(candidate);
 
         switch (fingerprintResult) {
             case FingerprintTechnicalError fingerprintError -> {
-                // Pre-fingerprint failure: not historised in SQLite
-                LOG.warn("Fingerprint computation failed for '{}': {} — candidate skipped (not historised).",
-                        candidate.uniqueIdentifier(), fingerprintError.errorMessage());
-                return;
+                handleFingerprintError(candidate, fingerprintError);
+            }
+            case FingerprintSuccess fingerprintSuccess -> {
+                handleFingerprintSuccess(candidate, fingerprintSuccess, context, attemptStart);
+            }
+        }
     }
 
-            case FingerprintSuccess fingerprintSuccess -> {
+    /**
+     * Handles a fingerprint computation error by logging it as a non-identifiable event.
+     * No SQLite record is created for this candidate.
+     *
+     * @param candidate the candidate that could not be fingerprinted
+     * @param error the fingerprint error
+     */
+    private void handleFingerprintError(SourceDocumentCandidate candidate, FingerprintTechnicalError error) {
+        LOG.warn("Fingerprint computation failed for '{}': {} — candidate skipped (not historised).",
+                candidate.uniqueIdentifier(), error.errorMessage());
+    }
+
+    /**
+     * Handles a successful fingerprint computation by delegating to the processor.
+     * The processor loads the document master record, checks terminal status, executes
+     * the pipeline as needed, and persists results consistently.
+     *
+     * @param candidate the candidate to process
+     * @param fingerprintSuccess the successful fingerprint result
+     * @param context the batch run context
+     * @param attemptStart the instant when processing started
+     */
+    private void handleFingerprintSuccess(
+            SourceDocumentCandidate candidate,
+            FingerprintSuccess fingerprintSuccess,
+            BatchRunContext context,
+            Instant attemptStart) {
         DocumentFingerprint fingerprint = fingerprintSuccess.fingerprint();
         LOG.debug("Fingerprint computed for '{}': {}",
                 candidate.uniqueIdentifier(), fingerprint.sha256Hex());
 
-                // Delegate the complete processing logic to the processor
-                // The processor handles loading document master record, checking terminal status,
-                // executing pipeline only when needed, and persisting results consistently
         documentProcessingCoordinator.processDeferredOutcome(
             candidate,
             fingerprint,
@@ -242,8 +283,6 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
             attemptStart,
             this::runExtractionPipeline);
     }
-        }
-    }
 
     /**
      * Runs the pipeline (PDF text extraction + pre-checks) for the given candidate.
@@ -259,8 +298,24 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
         PdfExtractionResult extractionResult =
                 pdfTextExtractionPort.extractTextAndPageCount(candidate);
 
-        // Log extraction outcome
-        switch (extractionResult) {
+        logExtractionResult(candidate, extractionResult);
+
+        DocumentProcessingOutcome outcome =
+                DocumentProcessingService.processDocument(candidate, extractionResult, configuration);
+
+        logProcessingOutcome(candidate, outcome);
+
+        return outcome;
+    }
+
+    /**
+     * Logs the PDF extraction result for a candidate.
+     *
+     * @param candidate the candidate being processed
+     * @param result the extraction result to log
+     */
+    private void logExtractionResult(SourceDocumentCandidate candidate, PdfExtractionResult result) {
+        switch (result) {
             case de.gecheckt.pdf.umbenenner.domain.model.PdfExtractionSuccess success -> {
                 LOG.debug("PDF extraction successful for '{}'. Pages: {}, Text length: {} chars.",
                         candidate.uniqueIdentifier(),
@@ -279,11 +334,15 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
                 // Handle any other cases
             }
         }
+    }
 
-        DocumentProcessingOutcome outcome =
-                DocumentProcessingService.processDocument(candidate, extractionResult, configuration);
-
-        // Log outcome
+    /**
+     * Logs the processing outcome for a candidate.
+     *
+     * @param candidate the candidate being processed
+     * @param outcome the processing outcome to log
+     */
+    private void logProcessingOutcome(SourceDocumentCandidate candidate, DocumentProcessingOutcome outcome) {
         switch (outcome) {
             case de.gecheckt.pdf.umbenenner.domain.model.PreCheckPassed passed -> {
                 LOG.info("Pre-checks PASSED for '{}'. Candidate ready for persistence.",
@@ -301,7 +360,5 @@ public class DefaultBatchRunProcessingUseCase implements BatchRunProcessingUseCa
                 // Handle any other cases
             }
         }
-
-        return outcome;
     }
 }

pdf-umbenenner-application/src/test/java/de/gecheckt/pdf/umbenenner/application/usecase/BatchRunProcessingUseCaseTest.java

@@ -290,7 +290,7 @@ class BatchRunProcessingUseCaseTest {
     }
 
     // -------------------------------------------------------------------------
-    // M4-specific: fingerprint failure → not historised
+    // Fingerprint failure handling: not historised
     // -------------------------------------------------------------------------
 
     @Test