tomdesair / tus-java-server / 32178860231

95%

push

github

feat: implement NFS- and SMB-safe lease file locking (LeaseFileLockingService) (#119)

* feat: implement NFS- and SMB-safe lease file locking (LeaseFileLockingService)

- Implement LeaseFileLockingService using atomic directory creation and TTL-based lease metadata
- Implement LeaseFileUploadLock with background heartbeat watchdog renewal
- Decouple DiskStorageService upload metadata I/O from kernel FileLock
- Set LeaseFileLockingService as default in TusFileUploadService.withStoragePath
- Calibrate lock retry budget to 40 iterations (8.0s) for NFS/SMB attribute caching
- Add comprehensive unit tests, integration tests (Tus 1.0.0 & RUFH), and legacy regression tests
- Add docs/DISK_BASED_LOCKING.md and update README.md, docs/LOCKING.md, and CHANGELOG.md

* test: add comprehensive branch and error case coverage for lease file locking

* refactor: reduce constructors in LeaseFileUploadLock to 2 and streamline lease creation

* tests: lower required coverage

* fix(locking): mitigate TOCTOU races in LeaseFileLockingService and S3LockingService

* docs: add TOCTOU race mitigation and atomic directory staging to DISK_BASED_LOCKING.md

* feat: Code review

* feat: make lock acquisition retries configurable via withMaxLockRetries

* fix: Code formatting

2222 of 2496 branches covered (89.02%)

Branch coverage included in aggregate %.

295 of 311 new or added lines in 8 files covered. (94.86%)

4939 of 5062 relevant lines covered (97.57%)

6.5 hits per line