Refactored all synchronizers to deal with some of the chronic issues.
This commit is contained in:
@@ -0,0 +1,124 @@
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using Wino.Core.Domain.Enums;
|
||||
|
||||
namespace Wino.Core.Domain.Models.Synchronization;
|
||||
|
||||
/// <summary>
|
||||
/// Result of synchronizing a single folder.
|
||||
/// Used for partial failure tracking when one folder fails but others succeed.
|
||||
/// </summary>
|
||||
public class FolderSyncResult
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the folder ID.
|
||||
/// </summary>
|
||||
public Guid FolderId { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the folder name for display purposes.
|
||||
/// </summary>
|
||||
public string FolderName { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets whether the folder sync was successful.
|
||||
/// </summary>
|
||||
public bool Success { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the number of messages downloaded/synchronized.
|
||||
/// </summary>
|
||||
public int DownloadedCount { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the number of messages deleted locally (removed from server).
|
||||
/// </summary>
|
||||
public int DeletedCount { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the number of messages whose flags were updated.
|
||||
/// </summary>
|
||||
public int UpdatedCount { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the error message if sync failed.
|
||||
/// </summary>
|
||||
public string ErrorMessage { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the error severity if sync failed.
|
||||
/// </summary>
|
||||
public SynchronizerErrorSeverity? ErrorSeverity { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the error category if sync failed.
|
||||
/// </summary>
|
||||
public SynchronizerErrorCategory? ErrorCategory { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets whether this folder was skipped (e.g., due to configuration).
|
||||
/// </summary>
|
||||
public bool WasSkipped { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the reason the folder was skipped.
|
||||
/// </summary>
|
||||
public string SkipReason { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Creates a successful folder sync result.
|
||||
/// </summary>
|
||||
public static FolderSyncResult Successful(Guid folderId, string folderName, int downloaded = 0, int deleted = 0, int updated = 0)
|
||||
=> new()
|
||||
{
|
||||
FolderId = folderId,
|
||||
FolderName = folderName,
|
||||
Success = true,
|
||||
DownloadedCount = downloaded,
|
||||
DeletedCount = deleted,
|
||||
UpdatedCount = updated
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// Creates a failed folder sync result.
|
||||
/// </summary>
|
||||
public static FolderSyncResult Failed(Guid folderId, string folderName, string errorMessage,
|
||||
SynchronizerErrorSeverity severity = SynchronizerErrorSeverity.Fatal,
|
||||
SynchronizerErrorCategory category = SynchronizerErrorCategory.Unknown)
|
||||
=> new()
|
||||
{
|
||||
FolderId = folderId,
|
||||
FolderName = folderName,
|
||||
Success = false,
|
||||
ErrorMessage = errorMessage,
|
||||
ErrorSeverity = severity,
|
||||
ErrorCategory = category
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// Creates a failed folder sync result from an error context.
|
||||
/// </summary>
|
||||
public static FolderSyncResult Failed(Guid folderId, string folderName, SynchronizerErrorContext errorContext)
|
||||
=> new()
|
||||
{
|
||||
FolderId = folderId,
|
||||
FolderName = folderName,
|
||||
Success = false,
|
||||
ErrorMessage = errorContext?.ErrorMessage ?? "Unknown error",
|
||||
ErrorSeverity = errorContext?.Severity ?? SynchronizerErrorSeverity.Fatal,
|
||||
ErrorCategory = errorContext?.Category ?? SynchronizerErrorCategory.Unknown
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// Creates a skipped folder sync result.
|
||||
/// </summary>
|
||||
public static FolderSyncResult Skipped(Guid folderId, string folderName, string reason)
|
||||
=> new()
|
||||
{
|
||||
FolderId = folderId,
|
||||
FolderName = folderName,
|
||||
Success = true, // Skipping is not a failure
|
||||
WasSkipped = true,
|
||||
SkipReason = reason
|
||||
};
|
||||
}
|
||||
@@ -1,5 +1,6 @@
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Linq;
|
||||
using System.Text.Json.Serialization;
|
||||
using Wino.Core.Domain.Entities.Mail;
|
||||
using Wino.Core.Domain.Enums;
|
||||
@@ -25,6 +26,55 @@ public class MailSynchronizationResult
|
||||
|
||||
public Exception Exception { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the results for each folder that was synchronized.
|
||||
/// Enables partial failure tracking - some folders may succeed while others fail.
|
||||
/// </summary>
|
||||
public List<FolderSyncResult> FolderResults { get; set; } = [];
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether the synchronization had any partial failures.
|
||||
/// True if at least one folder failed but others succeeded.
|
||||
/// </summary>
|
||||
[JsonIgnore]
|
||||
public bool HasPartialFailures => FolderResults.Any(f => !f.Success) && FolderResults.Any(f => f.Success);
|
||||
|
||||
/// <summary>
|
||||
/// Gets the number of folders that were successfully synchronized.
|
||||
/// </summary>
|
||||
[JsonIgnore]
|
||||
public int SuccessfulFolderCount => FolderResults.Count(f => f.Success);
|
||||
|
||||
/// <summary>
|
||||
/// Gets the number of folders that failed to synchronize.
|
||||
/// </summary>
|
||||
[JsonIgnore]
|
||||
public int FailedFolderCount => FolderResults.Count(f => !f.Success);
|
||||
|
||||
/// <summary>
|
||||
/// Gets the total number of messages downloaded across all folders.
|
||||
/// </summary>
|
||||
[JsonIgnore]
|
||||
public int TotalDownloadedCount => FolderResults.Sum(f => f.DownloadedCount);
|
||||
|
||||
/// <summary>
|
||||
/// Gets the total number of messages deleted across all folders.
|
||||
/// </summary>
|
||||
[JsonIgnore]
|
||||
public int TotalDeletedCount => FolderResults.Sum(f => f.DeletedCount);
|
||||
|
||||
/// <summary>
|
||||
/// Gets the total number of messages updated across all folders.
|
||||
/// </summary>
|
||||
[JsonIgnore]
|
||||
public int TotalUpdatedCount => FolderResults.Sum(f => f.UpdatedCount);
|
||||
|
||||
/// <summary>
|
||||
/// Gets the folders that failed to sync for error reporting.
|
||||
/// </summary>
|
||||
[JsonIgnore]
|
||||
public IEnumerable<FolderSyncResult> FailedFolders => FolderResults.Where(f => !f.Success);
|
||||
|
||||
public static MailSynchronizationResult Empty => new() { CompletedState = SynchronizationCompletedState.Success };
|
||||
|
||||
// Mail synchronization
|
||||
@@ -43,6 +93,28 @@ public class MailSynchronizationResult
|
||||
CompletedState = SynchronizationCompletedState.Success
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// Creates a completed result with folder-level results.
|
||||
/// </summary>
|
||||
public static MailSynchronizationResult CompletedWithFolderResults(
|
||||
IEnumerable<MailCopy> downloadedMessages,
|
||||
List<FolderSyncResult> folderResults)
|
||||
{
|
||||
var hasAnyFailure = folderResults.Any(f => !f.Success);
|
||||
var hasAnySuccess = folderResults.Any(f => f.Success);
|
||||
|
||||
return new()
|
||||
{
|
||||
DownloadedMessages = downloadedMessages,
|
||||
FolderResults = folderResults,
|
||||
CompletedState = hasAnyFailure && !hasAnySuccess
|
||||
? SynchronizationCompletedState.Failed
|
||||
: hasAnyFailure
|
||||
? SynchronizationCompletedState.PartiallyCompleted
|
||||
: SynchronizationCompletedState.Success
|
||||
};
|
||||
}
|
||||
|
||||
public static MailSynchronizationResult Canceled => new() { CompletedState = SynchronizationCompletedState.Canceled };
|
||||
public static MailSynchronizationResult Failed(Exception exception) => new()
|
||||
{
|
||||
|
||||
@@ -0,0 +1,95 @@
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using Wino.Core.Domain.Entities.Shared;
|
||||
using Wino.Core.Domain.Enums;
|
||||
using Wino.Core.Domain.Interfaces;
|
||||
|
||||
namespace Wino.Core.Domain.Models.Synchronization;
|
||||
|
||||
/// <summary>
|
||||
/// Contains context information about a synchronizer error
|
||||
/// </summary>
|
||||
public class SynchronizerErrorContext
|
||||
{
|
||||
/// <summary>
|
||||
/// Account associated with the error
|
||||
/// </summary>
|
||||
public MailAccount Account { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the error code
|
||||
/// </summary>
|
||||
public int? ErrorCode { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the error message
|
||||
/// </summary>
|
||||
public string ErrorMessage { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the request bundle associated with the error
|
||||
/// </summary>
|
||||
public IRequestBundle RequestBundle { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets additional data associated with the error
|
||||
/// </summary>
|
||||
public Dictionary<string, object> AdditionalData { get; set; } = new Dictionary<string, object>();
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the exception associated with the error
|
||||
/// </summary>
|
||||
public Exception Exception { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the severity of the error for retry decision making.
|
||||
/// </summary>
|
||||
public SynchronizerErrorSeverity Severity { get; set; } = SynchronizerErrorSeverity.Fatal;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the category of the error for targeted handling.
|
||||
/// </summary>
|
||||
public SynchronizerErrorCategory Category { get; set; } = SynchronizerErrorCategory.Unknown;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the current retry attempt count.
|
||||
/// </summary>
|
||||
public int RetryCount { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the maximum number of retries allowed.
|
||||
/// </summary>
|
||||
public int MaxRetries { get; set; } = 3;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the suggested delay before retrying.
|
||||
/// </summary>
|
||||
public TimeSpan? RetryDelay { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the folder ID associated with the error for partial failure tracking.
|
||||
/// </summary>
|
||||
public Guid? FolderId { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the folder name for display purposes.
|
||||
/// </summary>
|
||||
public string FolderName { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the type of operation that failed.
|
||||
/// Examples: "FolderSync", "MailSync", "RequestExecution", "Idle"
|
||||
/// </summary>
|
||||
public string OperationType { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether this error should be retried based on severity and retry count.
|
||||
/// </summary>
|
||||
public bool ShouldRetry => Severity == SynchronizerErrorSeverity.Transient && RetryCount < MaxRetries;
|
||||
|
||||
/// <summary>
|
||||
/// Gets whether synchronization can continue despite this error.
|
||||
/// </summary>
|
||||
public bool CanContinueSync => Severity == SynchronizerErrorSeverity.Recoverable ||
|
||||
(Severity == SynchronizerErrorSeverity.Transient && RetryCount >= MaxRetries);
|
||||
}
|
||||
Reference in New Issue
Block a user