How alihmaidi1/easychunckupload works
Project Type and Purpose
• This is a .NET 9.0 class library (“EasyChunkUpload”) that implements a resumable, concurrent chunk-based file-upload service.
• It provides an injectable IChunkUpload API for ASP.NET controllers, uses EF Core to track upload sessions, stores chunk files in a temp folder, merges them atomically, and runs a background cleanup service.
File Structure Analysis
• Top-level solution: EasyChunckUpload.sln
• Library project: EasyChunkUpload/
• ChunkExtension/ holds DTOs and helper logic (ChunkHelper, ChunkResponse)
• Enum/: UploadStatus enum
• Model/: FileModel EF Core entity
• Services/:
– ChunkUpload/ implements IChunkUpload session logic, chunk validation, merging
– Cleanup/ contains CleanupService and BackgroundCleanupHostedService for temp-file GC
– FileHelper/ abstracts file-system operations
– FileService/ wraps higher-level file interactions
• DependencyInjection.cs wires up settings (ChunkUploadSettings) and DI registrations
• Test projects:
• EasyChunkUploadTest/: unit tests with Moq stubs
• EasyChunkUpload.IntegrationTest/: end-to-end tests
Key Architectural Insights from README
• Core interface: IChunkUpload with methods to start session, upload chunks (stream or byte[]), query status, complete/merge, cancel.
• Configurable settings via ChunkUploadSettings (temp folder, cleanup interval).
• Uses SemaphoreSlim for concurrency control.
• EF Core DbContext (user-provided) persists FileModel records.
• Background hosted service performs auto-cleanup on a schedule.