Package com.privatechain.storage.fs

package com.privatechain.storage.fs

File-system storage backend — persists each block as an individual JSON file in a configurable directory (FR-STOR-05).

FileSystemStorage writes block index n to <dir>/block-<n>.json using BlockSerializer. It requires no native libraries and is therefore portable across all JDK 17+ platforms.

All file path inputs are sanitized before use; SpotBugs PATH_TRAVERSAL_IN findings are suppressed with documented justification where the sanitization cannot be expressed in a form the interprocedural analyzer can verify statically.

Thread safety: writes are serialized via a ReentrantLock; reads use a shared ReadLock (FR-STOR-06).

Since:

1.0.0

Related Packages

Package	Description
com.privatechain.storage	BlockchainStorage implementations and chain export utilities for the private-blockchain library.
com.privatechain.storage.leveldb	LevelDB persistent storage backend — crash-safe block persistence via the leveldbjni native library (FR-STOR-03, NFR-REL-01).
com.privatechain.storage.memory	In-memory storage backend — ephemeral, zero-dependency block storage backed by a LinkedHashMap (FR-STOR-02).
com.privatechain.storage.rocksdb	RocksDB persistent storage backend — high-throughput block persistence via the rocksdbjni native library (FR-STOR-04).

Classes

Class	Description
FileSystemStorage	File system backed BlockchainStorage implementation that stores each block as a separate JSON file.