How api-mayuri/sectoriadb works
SectoriaDB is a Java/Spring S3-compatible object store. An S3 client sends bucket or object operations to the server; object data is chunked, hashed into blob storage, and described by a JSON manifest. The README documents these storage stages and the main capabilities, but no source excerpts were provided, so links between server handlers and internal services are not verified at code level.
Main entry points: S3ObjectController.java Object Operations · BlobFileRestoreService.java Chunk Reads · BlobFileWriteService.java Chunk Writes · S3BucketController.java Bucket Operations
Components 20
S3 API
- Bucket Operations
sectoriadb-server/src/main/java/org/example/sectoriadb/s3/S3BucketController.java - Object Operations
sectoriadb-server/src/main/java/org/example/sectoriadb/s3/S3ObjectController.java - Multipart Operations
sectoriadb-server/src/main/java/org/example/sectoriadb/s3/S3MultipartController.java
Security and Access
- SigV4 Authentication
sectoriadb-server/src/main/java/org/example/sectoriadb/s3/auth/SigV4Filter.java - ACL and Policies
sectoriadb-server/src/main/java/org/example/sectoriadb/s3/access/AccessControlService.java
Storage Engine
- Storage Pools
sectoriadb-core/src/main/java/org/example/sectoriadb/service/PoolService.java - Blob Management
sectoriadb-core/src/main/java/org/example/sectoriadb/service/BlobService.java - File Storage
sectoriadb-core/src/main/java/org/example/sectoriadb/service/FileStorageService.java - Chunking
sectoriadb-core/src/main/java/org/example/sectoriadb/service/impl/DefaultChunkingService.java - Chunk Writes
sectoriadb-core/src/main/java/org/example/sectoriadb/service/impl/BlobFileWriteService.java - Chunk Reads
sectoriadb-core/src/main/java/org/example/sectoriadb/service/impl/BlobFileRestoreService.java - Cuckoo Hash Table
sectoriadb-core/src/main/java/org/example/sectoriadb/service/impl/CuckooHashTable.java - Blob File I/O
sectoriadb-core/src/main/java/org/example/sectoriadb/service/impl/FileChannelStorageIOEngine.java - Blob Data Files
sectoriadb-core/src/main/java/org/example/sectoriadb/model/BlobFile.java
Metadata and Audit
- Manifest Repository
sectoriadb-core/src/main/java/org/example/sectoriadb/repository/JsonManifestRepository.java - Credential Management
sectoriadb-core/src/main/java/org/example/sectoriadb/service/CredentialService.java - Operation Log
sectoriadb-core/src/main/java/org/example/sectoriadb/service/OperationLogService.java
Administration
- Admin Console
sectoriadb-server/src/main/java/org/example/sectoriadb/shell - Automatic Resize
sectoriadb-server/src/main/java/org/example/sectoriadb/scheduler/AutoResizeScheduler.java
Other components
- S3 Client
Connections 21
- S3 Client → Bucket Operations: bucket requests
README.md - S3 Client → Object Operations: object requests
README.md - S3 Client → Multipart Operations: multipart requests
README.md - SigV4 Authentication → Object Operations: authenticates
- ACL and Policies → Bucket Operations: checks access
- ACL and Policies → Object Operations: checks access
- Bucket Operations → Storage Pools: maps to pool
- Object Operations → File Storage: uses storage
- Multipart Operations → File Storage: uses storage
- File Storage → Chunking: chunks files
README.md - Chunking → Chunk Writes: provides chunks
- Chunk Writes → Cuckoo Hash Table: stores chunks
README.md - Cuckoo Hash Table → Blob Data Files: places chunks
README.md - Chunk Writes → Blob File I/O: writes data
- Chunk Reads → Cuckoo Hash Table: looks up chunks
- Chunk Reads → Blob File I/O: reads data
- Chunk Reads → Blob Data Files: reads chunks
- Object Operations → Manifest Repository: uses manifests
- Manifest Repository → Blob Data Files: records chunk keys
README.md - Admin Console → Credential Management: manages keys
- Automatic Resize → Blob Management: expands blobs