1602 lines
61 KiB
Java
1602 lines
61 KiB
Java
package io.nanachiyo0721.shiroha.data;
|
||
|
||
import ca.spottedleaf.concurrentutil.util.ConcurrentUtil;
|
||
import ca.spottedleaf.moonrise.patches.chunk_system.io.MoonriseRegionFileIO;
|
||
import com.github.luben.zstd.Zstd;
|
||
import com.github.luben.zstd.ZstdInputStream;
|
||
import io.nanachiyo0721.shiroha.utils.BufferedLinearRegionFileFlusher;
|
||
import net.jpountz.lz4.LZ4Compressor;
|
||
import net.jpountz.lz4.LZ4Factory;
|
||
import net.jpountz.lz4.LZ4FastDecompressor;
|
||
import net.jpountz.xxhash.XXHash32;
|
||
import net.jpountz.xxhash.XXHashFactory;
|
||
import net.minecraft.nbt.CompoundTag;
|
||
import net.minecraft.world.level.ChunkPos;
|
||
import net.minecraft.world.level.chunk.storage.RegionFile;
|
||
import net.minecraft.world.level.chunk.storage.RegionFileStorage;
|
||
import net.openhft.hashing.LongHashFunction;
|
||
import org.apache.commons.lang3.Validate;
|
||
import org.jetbrains.annotations.Contract;
|
||
import org.jetbrains.annotations.NotNull;
|
||
import org.jetbrains.annotations.Nullable;
|
||
import org.jspecify.annotations.NonNull;
|
||
|
||
import java.io.*;
|
||
import java.lang.invoke.VarHandle;
|
||
import java.nio.ByteBuffer;
|
||
import java.nio.channels.FileChannel;
|
||
import java.nio.file.Files;
|
||
import java.nio.file.Path;
|
||
import java.nio.file.StandardCopyOption;
|
||
import java.nio.file.StandardOpenOption;
|
||
import java.util.concurrent.atomic.AtomicLong;
|
||
import java.util.concurrent.locks.ReadWriteLock;
|
||
import java.util.concurrent.locks.ReentrantReadWriteLock;
|
||
|
||
/**
|
||
* Lock hierarchy (always acquire top to bottom, never the reverse):
|
||
* <ol>
|
||
* <li>{@code syncLock} — serializes master file syncs against close</li>
|
||
* <li>{@code Bucket.lock} — per-bucket lazy-load guard</li>
|
||
* <li>{@code masterFileLock} — master file read / append / replace</li>
|
||
* <li>{@code regionObjectLock} — in-memory sector table + swap file channel</li>
|
||
* </ol>
|
||
* The atomic flags (closed / synced / beingSynced / lastWritten) and the bucket
|
||
* epochs are lock-free and may be touched while holding any (or no) lock.
|
||
*/
|
||
public class BufferedLinearRegionFile implements io.nanachiyo0721.shiroha.data.RegionFile {
|
||
private static final double SWAP_FILE_AUTO_COMPACT_PERCENT = 3.0 / 5.0; // 60 %
|
||
private static final long SWAP_FILE_AUTO_COMPACT_SIZE = 1024 * 1024; // 1 MiB
|
||
|
||
// master file WAL appends leave the replaced bucket records behind as garbage; once
|
||
// it piles up past this threshold the next sync compacts via a full tmp-file rewrite
|
||
private static final double MASTER_FILE_AUTO_COMPACT_PERCENT = SWAP_FILE_AUTO_COMPACT_PERCENT;
|
||
private static final long MASTER_FILE_AUTO_COMPACT_SIZE = SWAP_FILE_AUTO_COMPACT_SIZE;
|
||
|
||
private static final long SWAP_FILE_SUPER_BLOCK = 0x1145141919810L;
|
||
private static final int SWAP_FILE_HASH_SEED = 0x0721; // ～(∠・ω< )⌒★
|
||
private static final byte SWAP_FILE_VERSION = 0x02; // ver 2.0
|
||
|
||
private static final long MASTER_FILE_SUPER_BLOCK = -0x200812250269L;
|
||
private static final byte MASTER_FILE_VERSION = 0x02; // ver 2.0
|
||
private static final byte MASTER_FILE_VERSION_BUCKET = 0x03; // ver 3.0
|
||
|
||
private static final long LINEAR_FILE_SUPER_BLOCK = 0xc3ff13183cca9d9aL;
|
||
|
||
private static final int BUCKET_SHIFT = 6;
|
||
private static final int BUCKET_SIZE = 1 << BUCKET_SHIFT;
|
||
private static final int BUCKET_COUNT = 1024 / BUCKET_SIZE;
|
||
|
||
private static final long MAX_SIZE_PER_CHUNK = RegionFile.MAX_CHUNK_SIZE;
|
||
|
||
private static final StandardOpenOption[] SWAP_FILE_CHANNEL_OPTIONS = new StandardOpenOption[]{
|
||
StandardOpenOption.CREATE,
|
||
StandardOpenOption.WRITE,
|
||
StandardOpenOption.READ,
|
||
StandardOpenOption.DELETE_ON_CLOSE
|
||
};
|
||
|
||
private static final class Bucket {
|
||
private final Object lock = new Object();
|
||
|
||
private final AtomicLong writeEpoch = new AtomicLong();
|
||
private final AtomicLong syncedEpoch = new AtomicLong();
|
||
private volatile boolean loaded = false;
|
||
}
|
||
|
||
private final Bucket[] buckets = new Bucket[BUCKET_COUNT];
|
||
|
||
private final Path masterFilePath;
|
||
private final Path swapFilePath;
|
||
|
||
// outermost lock: serializes syncToMasterFile() against closeInternal(), so the
|
||
// swap channel can never be torn down while a sync is still reading from it
|
||
private final Object syncLock = new Object();
|
||
|
||
private final ReadWriteLock regionObjectLock = new ReentrantReadWriteLock();
|
||
private final XXHash32 xxHash32 = XXHashFactory.fastestInstance().hash32();
|
||
private Sector[] sectors = new Sector[1024];
|
||
private long currentAcquiredIndex = this.headerSize();
|
||
private int xxHash32Seed = SWAP_FILE_HASH_SEED;
|
||
private FileChannel swapFileChannel;
|
||
|
||
private final byte compressionLevel;
|
||
private final LinearMasterFileParser masterFileParser = new LinearMasterFileParser();
|
||
private final CompressingOps compressingOps = new CompressingOps();
|
||
|
||
// managed by VarHandles following
|
||
private boolean closed = false;
|
||
private boolean beingSynced = false;
|
||
private boolean synced = false;
|
||
private long lastWritten = System.nanoTime();
|
||
|
||
private static final VarHandle CLOSED_HANDLE = ConcurrentUtil.getVarHandle(BufferedLinearRegionFile.class, "closed", boolean.class);
|
||
private static final VarHandle SYNCED_HANDLE = ConcurrentUtil.getVarHandle(BufferedLinearRegionFile.class, "synced", boolean.class);
|
||
private static final VarHandle BEING_SYNCED_HANDLE = ConcurrentUtil.getVarHandle(BufferedLinearRegionFile.class, "beingSynced", boolean.class);
|
||
private static final VarHandle LAST_WRITTEN_HANDLE = ConcurrentUtil.getVarHandle(BufferedLinearRegionFile.class, "lastWritten", long.class);
|
||
|
||
private final BufferedLinearRegionFileFlusher flusher;
|
||
|
||
public BufferedLinearRegionFile(Path masterFilePath, int compressionLevel, @NotNull BufferedLinearRegionFileFlusher flusher) throws IOException {
|
||
this.masterFilePath = masterFilePath;
|
||
this.swapFilePath = Path.of(this.masterFilePath.toString() + ".swp");
|
||
|
||
Validate.inclusiveBetween(1, 22, compressionLevel);
|
||
|
||
for (int i = 0; i < this.buckets.length; i++) {
|
||
this.buckets[i] = new Bucket();
|
||
}
|
||
|
||
this.compressionLevel = (byte) compressionLevel;
|
||
|
||
this.cleanUpSwapFile();
|
||
this.initSwapFile();
|
||
this.tryLoadOldBlinearMasterFileData();
|
||
|
||
this.flusher = flusher;
|
||
this.flusher.addFile(this);
|
||
}
|
||
|
||
private static void writeFullyAt(FileChannel channel, @NonNull ByteBuffer buf, long startOffset) throws IOException {
|
||
long offset = startOffset;
|
||
while (buf.hasRemaining()) {
|
||
offset += channel.write(buf, offset);
|
||
}
|
||
}
|
||
|
||
private static void readFullyAt(FileChannel channel, @NonNull ByteBuffer buf, long startOffset) throws IOException {
|
||
long offset = startOffset;
|
||
while (buf.hasRemaining()) {
|
||
final int read = channel.read(buf, offset);
|
||
if (read < 0) throw new EOFException("Unexpected EOF at offset " + offset);
|
||
offset += read;
|
||
}
|
||
}
|
||
|
||
private static void transferFully(FileChannel source, long sourceOffset, long count, FileChannel target, long targetOffset) throws IOException {
|
||
target.position(targetOffset);
|
||
|
||
long transferred = 0;
|
||
while (transferred < count) {
|
||
transferred += source.transferTo(sourceOffset + transferred, count - transferred, target);
|
||
}
|
||
}
|
||
|
||
// replaces target with source, deleting source if both attempts fail
|
||
private static void atomicReplace(Path source, Path target) throws IOException {
|
||
try {
|
||
Files.move(source, target, StandardCopyOption.REPLACE_EXISTING, StandardCopyOption.ATOMIC_MOVE);
|
||
} catch (Throwable e) {
|
||
// atomic move might be unsupported on some file systems, so give it an attempt to retry without atomic move
|
||
try {
|
||
Files.move(source, target, StandardCopyOption.REPLACE_EXISTING);
|
||
} catch (Throwable ex) {
|
||
e.addSuppressed(ex);
|
||
|
||
// delete file that failed to replace
|
||
Files.deleteIfExists(source);
|
||
|
||
throw new IOException("Failed to replace " + target + "!", e);
|
||
}
|
||
}
|
||
}
|
||
|
||
private void cleanUpSwapFile() throws IOException {
|
||
Files.deleteIfExists(this.swapFilePath);
|
||
}
|
||
|
||
private void ensureBucketLoaded(int chunkIndex) throws IOException {
|
||
final int bucketIndex = chunkIndex >> BUCKET_SHIFT;
|
||
final Bucket bucket = this.buckets[bucketIndex];
|
||
|
||
if (bucket.loaded) { // volatile fast path
|
||
return;
|
||
}
|
||
|
||
// bucket lock -> master read lock -> swap write lock
|
||
synchronized (bucket.lock) {
|
||
if (bucket.loaded) {
|
||
return;
|
||
}
|
||
|
||
this.masterFileParser.loadBucketsFor(this.masterFilePath, bucketIndex);
|
||
bucket.loaded = true;
|
||
}
|
||
}
|
||
|
||
// used by the legacy parsers: their data goes through the write path directly,
|
||
// so the bucket must be flagged loaded first to avoid a recursive lazy-load
|
||
private void markBucketLoaded(int chunkIndex) {
|
||
final Bucket bucket = this.buckets[chunkIndex >> BUCKET_SHIFT];
|
||
|
||
synchronized (bucket.lock) {
|
||
bucket.loaded = true;
|
||
}
|
||
}
|
||
|
||
private void markBucketDirty(int chunkIndex) {
|
||
this.buckets[chunkIndex >> BUCKET_SHIFT].writeEpoch.incrementAndGet();
|
||
}
|
||
|
||
private long getBucketWriteEpoch(int bucketIndex) {
|
||
return this.buckets[bucketIndex].writeEpoch.get();
|
||
}
|
||
|
||
private void markBucketSynced(int bucketIndex, long syncedEpoch) {
|
||
this.buckets[bucketIndex].syncedEpoch.accumulateAndGet(syncedEpoch, Math::max);
|
||
}
|
||
|
||
private boolean isBucketDirty(int bucketIndex) {
|
||
final Bucket bucket = this.buckets[bucketIndex];
|
||
|
||
return bucket.writeEpoch.get() != bucket.syncedEpoch.get();
|
||
}
|
||
|
||
public boolean markAsBeingSynced() {
|
||
return BEING_SYNCED_HANDLE.compareAndSet(this, false, true);
|
||
}
|
||
|
||
|
||
public long getLastWritten() {
|
||
return (long) LAST_WRITTEN_HANDLE.getVolatile(this);
|
||
}
|
||
|
||
public boolean shouldSync() {
|
||
return !((boolean) SYNCED_HANDLE.getVolatile(this));
|
||
}
|
||
|
||
public boolean softReadLock() {
|
||
// not done close logic yet
|
||
return this.regionObjectLock.readLock().tryLock();
|
||
}
|
||
|
||
public void releaseReadLock() {
|
||
this.regionObjectLock.readLock().unlock();
|
||
}
|
||
|
||
public boolean isClosedRaw() {
|
||
return (boolean) CLOSED_HANDLE.getVolatile(this);
|
||
}
|
||
|
||
public boolean isClosed() {
|
||
this.regionObjectLock.readLock().lock();
|
||
try {
|
||
return (boolean) CLOSED_HANDLE.getVolatile(this);
|
||
} finally {
|
||
this.regionObjectLock.readLock().unlock();
|
||
}
|
||
}
|
||
|
||
public void syncIfNeeded() throws IOException {
|
||
try {
|
||
this.syncToMasterFile();
|
||
} finally {
|
||
BEING_SYNCED_HANDLE.setVolatile(this, false); // mark as not being synced
|
||
}
|
||
}
|
||
|
||
private void syncToMasterFile() throws IOException {
|
||
// serialized against close: the swap channel cannot go away under a running sync
|
||
synchronized (this.syncLock) {
|
||
// skip if closed already
|
||
if (this.isClosedRaw()) {
|
||
return;
|
||
}
|
||
|
||
// fast skip when there is nothing to sync; writers flip the flag back
|
||
// via markAsToSync() which triggers the next round
|
||
if (!SYNCED_HANDLE.compareAndSet(this, false, true)) {
|
||
return;
|
||
}
|
||
|
||
try {
|
||
this.masterFileParser.sync(this.masterFilePath);
|
||
} catch (Throwable e) {
|
||
// set back
|
||
SYNCED_HANDLE.setVolatile(this, false);
|
||
|
||
throw new IOException("Failed to sync to master file!", e);
|
||
}
|
||
}
|
||
}
|
||
|
||
private void tryLoadOldBlinearMasterFileData() throws IOException {
|
||
this.masterFileParser.tryParseMainFileOld(this.masterFilePath);
|
||
}
|
||
|
||
private void initSwapFile() throws IOException {
|
||
this.swapFileChannel = FileChannel.open(
|
||
this.swapFilePath,
|
||
SWAP_FILE_CHANNEL_OPTIONS
|
||
);
|
||
|
||
// fill default sectors
|
||
for (int i = 0; i < 1024; i++) {
|
||
this.sectors[i] = new Sector(i, this.headerSize(), 0);
|
||
}
|
||
}
|
||
|
||
private void recalculateAcquiredIndex() {
|
||
long newValue = this.headerSize();
|
||
|
||
for (Sector sector : this.sectors) {
|
||
if (sector.hasData()) {
|
||
newValue = Math.max(newValue, sector.offset + sector.length);
|
||
}
|
||
}
|
||
|
||
this.currentAcquiredIndex = newValue;
|
||
}
|
||
|
||
private void writeSwapFileHeaders(boolean forceFile, boolean forceMeta) throws IOException {
|
||
final ByteBuffer buffer = ByteBuffer.allocate(this.headerSize());
|
||
|
||
buffer.putLong(SWAP_FILE_SUPER_BLOCK); // Magic
|
||
buffer.put(SWAP_FILE_VERSION); // Version
|
||
buffer.putInt(this.xxHash32Seed); // XXHash32 seed
|
||
buffer.putLong(this.currentAcquiredIndex); // Acquired index
|
||
|
||
for (Sector sector : this.sectors) {
|
||
// encode each sector
|
||
buffer.put(sector.getEncoded());
|
||
}
|
||
|
||
buffer.flip();
|
||
|
||
writeFullyAt(this.swapFileChannel, buffer, 0);
|
||
|
||
if (forceFile) {
|
||
this.swapFileChannel.force(forceMeta);
|
||
}
|
||
}
|
||
|
||
private int sectorSize() {
|
||
return this.sectors.length * Sector.sizeOfSingle();
|
||
}
|
||
|
||
private int headerSize() {
|
||
int result = 0;
|
||
|
||
result += Long.BYTES; // Magic
|
||
result += Byte.BYTES; // Version
|
||
result += Integer.BYTES; // XXHash32 seed
|
||
result += Long.BYTES; // Acquired index
|
||
result += this.sectorSize(); // Sectors
|
||
|
||
return result;
|
||
}
|
||
|
||
private void flushInternal() throws IOException {
|
||
boolean initiallySyncRequired;
|
||
|
||
this.regionObjectLock.writeLock().lock();
|
||
try {
|
||
if (this.isClosedRaw()) {
|
||
return;
|
||
}
|
||
|
||
long liveSize = 0;
|
||
for (Sector sector : this.sectors) {
|
||
// skip no data sectors
|
||
if (!sector.hasData()) {
|
||
continue;
|
||
}
|
||
|
||
liveSize += sector.length;
|
||
}
|
||
|
||
// everything acquired but not covered by a live sector is garbage
|
||
final long spareSize = this.currentAcquiredIndex - this.headerSize() - liveSize;
|
||
|
||
final boolean compactRequested = spareSize > SWAP_FILE_AUTO_COMPACT_SIZE && (double) spareSize > ((double) liveSize) * SWAP_FILE_AUTO_COMPACT_PERCENT;
|
||
|
||
// try auto compact to clean the garbage area
|
||
if (compactRequested) {
|
||
// do compact
|
||
this.compactSwapFile();
|
||
}
|
||
|
||
// prevent syncing after compact because it could be time costing sometimes
|
||
initiallySyncRequired = !Files.exists(this.masterFilePath) && !compactRequested;
|
||
} finally {
|
||
this.regionObjectLock.writeLock().unlock();
|
||
}
|
||
|
||
if (initiallySyncRequired) {
|
||
this.syncToMasterFile();
|
||
}
|
||
}
|
||
|
||
private void closeInternal() throws IOException {
|
||
synchronized (this.syncLock) {
|
||
if (this.isClosedRaw()) {
|
||
// already closed (possibly by a compact disaster path): just make sure
|
||
// both channels are really gone — close is idempotent
|
||
this.regionObjectLock.writeLock().lock();
|
||
try {
|
||
this.swapFileChannel.close();
|
||
} finally {
|
||
this.regionObjectLock.writeLock().unlock();
|
||
}
|
||
|
||
this.masterFileParser.close();
|
||
return;
|
||
}
|
||
|
||
// final sync so no buffered data is lost; holding syncLock also guarantees no
|
||
// concurrent flusher sync is still running when we tear down below.
|
||
// if this throws we deliberately stay open: the flusher can retry the sync
|
||
// later, and the not-yet-synced swap data is not dropped on the floor
|
||
this.syncToMasterFile();
|
||
|
||
IOException failure = null;
|
||
|
||
this.regionObjectLock.writeLock().lock();
|
||
try {
|
||
this.markClosed();
|
||
|
||
this.swapFileChannel.close();
|
||
} catch (IOException e) {
|
||
failure = e;
|
||
} finally {
|
||
this.regionObjectLock.writeLock().unlock();
|
||
}
|
||
|
||
try {
|
||
// acquired after the region lock is fully released, never inside it (lock hierarchy)
|
||
this.masterFileParser.close();
|
||
} catch (IOException e) {
|
||
if (failure == null) failure = e; else failure.addSuppressed(e);
|
||
}
|
||
|
||
if (failure != null) {
|
||
throw failure;
|
||
}
|
||
}
|
||
}
|
||
|
||
private void markClosed() {
|
||
// lenient CAS: the disaster path of compactSwapFile() may have closed us already
|
||
if (CLOSED_HANDLE.compareAndSet(this, false, true)) {
|
||
this.flusher.removeFile(this);
|
||
}
|
||
}
|
||
|
||
private void compactSwapFile() throws IOException {
|
||
this.writeSwapFileHeaders(true, true); // save headers for compact
|
||
|
||
final Sector[] newSectorsToBeReplaced = new Sector[this.sectors.length];
|
||
|
||
for (int i = 0; i < this.sectors.length; i++) {
|
||
final Sector old = this.sectors[i];
|
||
|
||
if (old.hasData()) {
|
||
newSectorsToBeReplaced[i] = old;
|
||
continue;
|
||
}
|
||
|
||
// note:
|
||
// we reset length to 0 and this would make length <= newLength(which is >= 0) is always true.
|
||
// so that the following write operation wouldn't override the data of other sectors
|
||
// see the write method in Sector class
|
||
newSectorsToBeReplaced[i] = new Sector(i, 0, 0);
|
||
}
|
||
|
||
long newAcquiredIndex;
|
||
|
||
final Path targetTemp = Path.of(this.swapFilePath + ".tmp");
|
||
|
||
try (FileChannel tempChannel = FileChannel.open(
|
||
targetTemp,
|
||
StandardOpenOption.CREATE_NEW,
|
||
StandardOpenOption.WRITE,
|
||
StandardOpenOption.READ,
|
||
StandardOpenOption.TRUNCATE_EXISTING
|
||
)) {
|
||
long offsetPointer = this.headerSize();
|
||
|
||
for (Sector sector : newSectorsToBeReplaced) {
|
||
// skip cleared or no data-contained sectors
|
||
if (!sector.hasData()) {
|
||
continue;
|
||
}
|
||
|
||
// transfer to target
|
||
transferFully(this.swapFileChannel, sector.offset, sector.length, tempChannel, offsetPointer);
|
||
|
||
// recalculate the offset and length
|
||
final Sector newRecalculated = new Sector(sector.index, offsetPointer, sector.length);
|
||
newRecalculated.hasData = true;
|
||
|
||
offsetPointer += sector.length;
|
||
newSectorsToBeReplaced[sector.index] = newRecalculated; // update sector infos
|
||
}
|
||
|
||
tempChannel.force(true);
|
||
|
||
newAcquiredIndex = offsetPointer;
|
||
} catch (Throwable ex) {
|
||
// recalculate acquired index
|
||
this.recalculateAcquiredIndex();
|
||
// delete the target temp file
|
||
Files.deleteIfExists(targetTemp);
|
||
// fast-fail
|
||
// note: we don't block new write operations here as this is recoverable
|
||
throw new IOException("Failed to compact swap file!", ex);
|
||
}
|
||
|
||
this.swapFileChannel.close();
|
||
|
||
// replace swap file
|
||
try {
|
||
atomicReplace(targetTemp, this.swapFilePath);
|
||
} catch (Throwable e) {
|
||
// recalculate acquired index
|
||
this.recalculateAcquiredIndex();
|
||
// reopen closed channel
|
||
this.reopenSwapFileChannel();
|
||
// fast-fail
|
||
this.markClosed(); // prevent new writing & sync operations
|
||
throw new IOException("Failed to replace original swap file!", e);
|
||
}
|
||
|
||
try {
|
||
// reopen file channel
|
||
this.reopenSwapFileChannel();
|
||
|
||
// replace with recalculated file headers
|
||
this.sectors = newSectorsToBeReplaced;
|
||
this.currentAcquiredIndex = newAcquiredIndex;
|
||
|
||
// flush to file
|
||
this.writeSwapFileHeaders(true, true);
|
||
} catch (Throwable ex) {
|
||
// we are totally failed here,
|
||
// directly mark as closed as the swap file is already replaced, and we failed to update the
|
||
// data which is still in the memory
|
||
//
|
||
// which means we might write any data into any incorrect indexed sectors which will blow the whole data
|
||
this.markClosed();
|
||
throw new IOException(ex);
|
||
}
|
||
}
|
||
|
||
private void reopenSwapFileChannel() throws IOException {
|
||
if (this.swapFileChannel.isOpen()) {
|
||
this.swapFileChannel.close();
|
||
}
|
||
|
||
this.swapFileChannel = FileChannel.open(
|
||
this.swapFilePath,
|
||
SWAP_FILE_CHANNEL_OPTIONS
|
||
);
|
||
}
|
||
|
||
private void writeChunkDataRaw(int index, ByteBuffer chunkData, boolean skipSync) throws IOException {
|
||
final ByteBuffer committed = this.compressingOps.compress(chunkData); // run compression out of lock
|
||
|
||
this.regionObjectLock.writeLock().lock();
|
||
try {
|
||
final Sector sector = this.sectors[index];
|
||
|
||
sector.store(committed, this.swapFileChannel);
|
||
if (!skipSync) {
|
||
this.markBucketDirty(index);
|
||
}
|
||
} finally {
|
||
this.regionObjectLock.writeLock().unlock();
|
||
}
|
||
|
||
if (skipSync) {
|
||
return;
|
||
}
|
||
|
||
this.markAsToSync();
|
||
}
|
||
|
||
private @Nullable ByteBuffer readChunkDataRaw(int index) throws IOException {
|
||
final ByteBuffer raw;
|
||
|
||
this.regionObjectLock.readLock().lock();
|
||
try {
|
||
final Sector sector = this.sectors[index];
|
||
|
||
if (!sector.hasData()) {
|
||
return null;
|
||
}
|
||
|
||
raw = sector.read(this.swapFileChannel);
|
||
} finally {
|
||
this.regionObjectLock.readLock().unlock();
|
||
}
|
||
|
||
return this.compressingOps.decompress(raw);
|
||
}
|
||
|
||
private void clearChunkData(int index) throws IOException {
|
||
this.ensureBucketLoaded(index);
|
||
|
||
this.regionObjectLock.writeLock().lock();
|
||
try {
|
||
final Sector sector = this.sectors[index];
|
||
|
||
sector.clear();
|
||
this.markBucketDirty(index);
|
||
} finally {
|
||
this.regionObjectLock.writeLock().unlock();
|
||
}
|
||
|
||
this.markAsToSync();
|
||
}
|
||
|
||
private void markAsToSync() {
|
||
SYNCED_HANDLE.setVolatile(this, false); // mark as unsynced
|
||
LAST_WRITTEN_HANDLE.setVolatile(this, System.nanoTime()); // update last written time
|
||
}
|
||
|
||
private static int getChunkIndex(int x, int z) {
|
||
return (x & 31) + ((z & 31) << 5);
|
||
}
|
||
|
||
private boolean hasData(int index) throws IOException {
|
||
this.ensureBucketLoaded(index);
|
||
|
||
this.regionObjectLock.readLock().lock();
|
||
try {
|
||
return this.sectors[index].hasData();
|
||
} finally {
|
||
this.regionObjectLock.readLock().unlock();
|
||
}
|
||
}
|
||
|
||
private void writeChunk(int x, int z, @NotNull ByteBuffer data) throws IOException {
|
||
final int chunkIndex = getChunkIndex(x, z);
|
||
|
||
this.ensureBucketLoaded(chunkIndex);
|
||
|
||
if (data.remaining() > MAX_SIZE_PER_CHUNK) {
|
||
throw new RegionFileStorage.RegionFileSizeException("Writing too large chunk, limit : " + MAX_SIZE_PER_CHUNK + " but got : " + data.remaining());
|
||
}
|
||
|
||
final int oldPositionOfData = data.position();
|
||
final int xxHash32OfData = this.xxHash32.hash(data, this.xxHash32Seed);
|
||
data.position(oldPositionOfData);
|
||
|
||
// uncompressed length(int) + timestamp(long) + xxhash32(int)
|
||
final ByteBuffer chunkSectionBuilder = ByteBuffer.allocate(data.remaining() + 4 + 8 + 4);
|
||
|
||
chunkSectionBuilder.putInt(data.remaining()); // Length(int)
|
||
chunkSectionBuilder.putLong(System.currentTimeMillis()); // Timestamp(long)
|
||
chunkSectionBuilder.putInt(xxHash32OfData); // xxHash32 of the original data(int)
|
||
chunkSectionBuilder.put(data); // Data(bytes)
|
||
chunkSectionBuilder.flip();
|
||
|
||
this.writeChunkDataRaw(chunkIndex, chunkSectionBuilder, false);
|
||
}
|
||
|
||
private @Nullable ByteBuffer readChunk(int x, int z) throws IOException {
|
||
final int chunkIndex = getChunkIndex(x, z);
|
||
|
||
this.ensureBucketLoaded(chunkIndex);
|
||
|
||
final ByteBuffer data = this.readChunkDataRaw(chunkIndex);
|
||
|
||
if (data == null) {
|
||
return null;
|
||
}
|
||
|
||
final int length = data.getInt(); // compressed length(int)
|
||
final long timestamp = data.getLong(); // TODO use this timestamp(long) for something?
|
||
final int dataXXHash32 = data.getInt(); // XXHash32 for validation(int)
|
||
|
||
final IOException xxHash32CheckFailedEx = this.checkXXHash32(dataXXHash32, data);
|
||
if (xxHash32CheckFailedEx != null) {
|
||
throw xxHash32CheckFailedEx; // prevent from loading
|
||
}
|
||
|
||
return data;
|
||
}
|
||
|
||
private @Nullable IOException checkXXHash32(long originalXXHash32, @NotNull ByteBuffer input) {
|
||
final int oldPositionOfInput = input.position();
|
||
final int currentXXHash32 = this.xxHash32.hash(input, this.xxHash32Seed);
|
||
input.position(oldPositionOfInput);
|
||
|
||
if (originalXXHash32 != currentXXHash32) {
|
||
return new IOException("XXHash32 check failed ! Expected: " + originalXXHash32 + ",but got: " + currentXXHash32);
|
||
}
|
||
|
||
return null;
|
||
}
|
||
|
||
@Override
|
||
public Path getPath() {
|
||
return this.masterFilePath;
|
||
}
|
||
|
||
@Override
|
||
public DataInputStream getChunkDataInputStream(@NotNull ChunkPos pos) throws IOException {
|
||
final ByteBuffer data = this.readChunk(pos.x(), pos.z());
|
||
|
||
if (data == null) {
|
||
return null;
|
||
}
|
||
|
||
return new DataInputStream(new ByteBufferInputStream(data));
|
||
}
|
||
|
||
@Override
|
||
public boolean doesChunkExist(@NotNull ChunkPos pos) throws IOException {
|
||
return this.hasData(getChunkIndex(pos.x(), pos.z()));
|
||
}
|
||
|
||
@Override
|
||
public DataOutputStream getChunkDataOutputStream(ChunkPos pos) {
|
||
return new DataOutputStream(new ChunkBufferHelper(pos));
|
||
}
|
||
|
||
@Override
|
||
public void clear(@NotNull ChunkPos pos) throws IOException {
|
||
this.clearChunkData(getChunkIndex(pos.x(), pos.z()));
|
||
}
|
||
|
||
@Override
|
||
public boolean hasChunk(@NotNull ChunkPos pos) {
|
||
try {
|
||
return this.hasData(getChunkIndex(pos.x(), pos.z()));
|
||
} catch (IOException e) {
|
||
throw new RuntimeException(e);
|
||
}
|
||
}
|
||
|
||
@Override
|
||
public void write(@NotNull ChunkPos pos, ByteBuffer buf) throws IOException {
|
||
this.writeChunk(pos.x(), pos.z(), buf);
|
||
}
|
||
|
||
// MCC 的玩意,这东西也用不上给Linear了()
|
||
@Override
|
||
public CompoundTag getOversizedData(int x, int z) {
|
||
return null;
|
||
}
|
||
|
||
@Override
|
||
public boolean isOversized(int x, int z) {
|
||
return false;
|
||
}
|
||
|
||
@Override
|
||
public boolean recalculateHeader() {
|
||
return false;
|
||
}
|
||
|
||
@Override
|
||
public void setOversized(int x, int z, boolean oversized) {
|
||
|
||
}
|
||
// MCC end
|
||
|
||
@Override
|
||
public MoonriseRegionFileIO.RegionDataController.WriteData moonrise$startWrite(CompoundTag data, ChunkPos pos) {
|
||
final DataOutputStream out = this.getChunkDataOutputStream(pos);
|
||
|
||
return new MoonriseRegionFileIO.RegionDataController.WriteData(
|
||
data, MoonriseRegionFileIO.RegionDataController.WriteData.WriteResult.WRITE,
|
||
out, regionFile -> out.close()
|
||
);
|
||
}
|
||
|
||
@Override
|
||
public void flush() throws IOException {
|
||
this.flushInternal();
|
||
}
|
||
|
||
@Override
|
||
public void close() throws IOException {
|
||
this.closeInternal();
|
||
}
|
||
|
||
public static class ByteBufferInputStream extends InputStream {
|
||
protected final ByteBuffer internal;
|
||
|
||
public ByteBufferInputStream(ByteBuffer buf) {
|
||
this.internal = buf;
|
||
}
|
||
|
||
@Override
|
||
public int available() {
|
||
return this.internal.remaining();
|
||
}
|
||
|
||
@Override
|
||
public int read() throws IOException {
|
||
return this.internal.hasRemaining() ? (this.internal.get() & 0xFF) : -1;
|
||
}
|
||
|
||
@Override
|
||
public int read(byte @NotNull [] bytes, int off, int len) throws IOException {
|
||
if (!this.internal.hasRemaining()) return -1;
|
||
len = Math.min(len, this.internal.remaining());
|
||
this.internal.get(bytes, off, len);
|
||
return len;
|
||
}
|
||
}
|
||
|
||
// here we use this tool to prevent the swap file goes too large
|
||
// sometimes when a region contains all chunks, it might be very huge without any compressions(around 100MiB)
|
||
private static class CompressingOps {
|
||
private final LZ4Compressor lz4Compressor = LZ4Factory.fastestInstance().fastCompressor();
|
||
private final LZ4FastDecompressor lz4Decompressor = LZ4Factory.fastestInstance().fastDecompressor();
|
||
|
||
public @NotNull ByteBuffer compress(@NotNull ByteBuffer in) {
|
||
final int bufferLenToAllocate = this.lz4Compressor.maxCompressedLength(in.remaining());
|
||
final ByteBuffer result = ByteBuffer.allocate(bufferLenToAllocate + 4);
|
||
|
||
result.putInt(in.remaining());
|
||
this.lz4Compressor.compress(in, result);
|
||
|
||
return result.flip();
|
||
}
|
||
|
||
public @NotNull ByteBuffer decompress(@NotNull ByteBuffer flippedIn) {
|
||
final int originalLen = flippedIn.getInt();
|
||
final byte[] raw = new byte[flippedIn.remaining()];
|
||
flippedIn.get(raw);
|
||
|
||
final byte[] decompressed = new byte[originalLen];
|
||
this.lz4Decompressor.decompress(raw, decompressed);
|
||
|
||
return ByteBuffer.wrap(decompressed);
|
||
}
|
||
}
|
||
|
||
public class Sector {
|
||
private final int index;
|
||
private long offset;
|
||
private long length;
|
||
private boolean hasData = false;
|
||
|
||
private Sector(int index, long offset, long length) {
|
||
this.index = index;
|
||
this.offset = offset;
|
||
this.length = length;
|
||
}
|
||
|
||
public @NotNull ByteBuffer read(@NotNull FileChannel channel) throws IOException {
|
||
final ByteBuffer result = ByteBuffer.allocate((int) this.length);
|
||
|
||
readFullyAt(channel, result, this.offset);
|
||
|
||
result.flip();
|
||
return result;
|
||
}
|
||
|
||
public void store(@NotNull ByteBuffer newData, @NotNull FileChannel channel) throws IOException {
|
||
final long oldLength = this.length;
|
||
final long newDataLength = newData.remaining();
|
||
|
||
this.hasData = true;
|
||
this.length = newDataLength;
|
||
|
||
// data is smaller or its length equals to the local buffer we hold, write it directly
|
||
if (newDataLength <= oldLength) {
|
||
writeFullyAt(channel, newData, this.offset);
|
||
|
||
return;
|
||
}
|
||
|
||
// or we will append to the end of file
|
||
this.offset = BufferedLinearRegionFile.this.currentAcquiredIndex;
|
||
|
||
BufferedLinearRegionFile.this.currentAcquiredIndex += this.length;
|
||
|
||
writeFullyAt(channel, newData, this.offset);
|
||
}
|
||
|
||
private @NotNull ByteBuffer getEncoded() {
|
||
final ByteBuffer buffer = ByteBuffer.allocate(sizeOfSingle());
|
||
|
||
buffer.putLong(this.offset);
|
||
buffer.putLong(this.length);
|
||
buffer.put((byte) (this.hasData ? 1 : 0));
|
||
buffer.flip();
|
||
|
||
return buffer;
|
||
}
|
||
|
||
public void restoreFrom(@NotNull ByteBuffer buffer) {
|
||
this.offset = buffer.getLong();
|
||
this.length = buffer.getLong();
|
||
this.hasData = buffer.get() == 1;
|
||
|
||
if (this.length < 0 || this.offset < 0) {
|
||
throw new IllegalStateException("Invalid sector data: " + this);
|
||
}
|
||
}
|
||
|
||
public void clear() {
|
||
this.hasData = false;
|
||
}
|
||
|
||
public boolean hasData() {
|
||
return this.hasData;
|
||
}
|
||
|
||
static int sizeOfSingle() {
|
||
// offset + length hasData
|
||
return Long.BYTES * 2 + 1;
|
||
}
|
||
}
|
||
|
||
private class ChunkBufferHelper extends ByteArrayOutputStream {
|
||
private final ChunkPos pos;
|
||
|
||
private ChunkBufferHelper(ChunkPos pos) {
|
||
this.pos = pos;
|
||
}
|
||
|
||
@Override
|
||
public void close() throws IOException {
|
||
ByteBuffer bytebuffer = ByteBuffer.wrap(this.buf, 0, this.count);
|
||
|
||
BufferedLinearRegionFile.this.writeChunk(this.pos.x(), this.pos.z(), bytebuffer);
|
||
|
||
BufferedLinearRegionFile.this.flushInternal();
|
||
}
|
||
}
|
||
|
||
private class LinearMasterFileParser {
|
||
// V3 bucketed format layout:
|
||
// [0, 14): header — superblock(8) + version(1) + compressionLevel(1) + xxHash32Seed(4)
|
||
// [14, 142): position table — BUCKET_COUNT(16) × long(8) each; 0 = no data for that bucket
|
||
// [142, EOF): bucket records — originalLen(int) + compressedLen(int) + compressedData
|
||
private static final int V3_HEADER_SIZE = 14;
|
||
private static final long V3_POS_TABLE_OFFSET = V3_HEADER_SIZE;
|
||
private static final int V3_POS_TABLE_SIZE = BUCKET_COUNT * Long.BYTES; // 128
|
||
private static final long V3_DATA_AREA_OFFSET = V3_POS_TABLE_OFFSET + V3_POS_TABLE_SIZE; // 142
|
||
private static final int V3_RECORD_HEADER_SIZE = Integer.BYTES * 2; // originalLen + compressedLen
|
||
|
||
private final ReadWriteLock masterFileLock = new ReentrantReadWriteLock();
|
||
|
||
// WAL(append) state, guarded by masterFileLock: null until the first sync after
|
||
// open has fully rewritten the master file; afterwards syncs only append changed
|
||
// buckets to the tail and update the position table in place.
|
||
// recordSizes mirrors positionTable (size of each live record) so the garbage
|
||
// ratio can be computed without touching the disk
|
||
private @Nullable FileChannel appendChannel;
|
||
private long[] positionTable;
|
||
private long[] recordSizes;
|
||
private long appendOffset;
|
||
|
||
// a consistent snapshot of one bucket taken from the swap file;
|
||
// payload == null means the bucket holds no chunks at all
|
||
private record BucketRecord(long epoch, byte @Nullable [] payload) {
|
||
}
|
||
|
||
// must be called under syncLock (see syncToMasterFile)
|
||
public void sync(@NotNull Path mainFile) throws IOException {
|
||
this.masterFileLock.writeLock().lock();
|
||
try {
|
||
// full rewrite on the first sync after open, and afterwards whenever the
|
||
// appended garbage passed the auto-compact threshold: writes a tmp file,
|
||
// then atomically replaces the master file with it
|
||
if (this.appendChannel == null || this.shouldCompactMasterFile()) {
|
||
this.rewriteFully(mainFile);
|
||
} else {
|
||
// WAL-style otherwise: only append the dirty buckets
|
||
this.appendDirtyBuckets();
|
||
}
|
||
} finally {
|
||
this.masterFileLock.writeLock().unlock();
|
||
}
|
||
}
|
||
|
||
// only valid in WAL mode (appendChannel != null); mirrors the swap file heuristic
|
||
private boolean shouldCompactMasterFile() {
|
||
long liveSize = 0;
|
||
for (final long size : this.recordSizes) {
|
||
liveSize += size;
|
||
}
|
||
|
||
final long spareSize = this.appendOffset - V3_DATA_AREA_OFFSET - liveSize;
|
||
|
||
return spareSize > MASTER_FILE_AUTO_COMPACT_SIZE && (double) spareSize > ((double) liveSize) * MASTER_FILE_AUTO_COMPACT_PERCENT;
|
||
}
|
||
|
||
private void rewriteFully(@NotNull Path mainFile) throws IOException {
|
||
// a compacting rewrite replaces the whole file, so drop the old append channel
|
||
// first; if anything below fails, the next sync just retries via this path
|
||
if (this.appendChannel != null) {
|
||
this.appendChannel.close();
|
||
this.appendChannel = null;
|
||
}
|
||
|
||
final Path tmpFilePath = Path.of(mainFile + ".tmp");
|
||
final long[] syncedBucketEpochs = new long[BUCKET_COUNT];
|
||
final long[] newPositionTable = new long[BUCKET_COUNT];
|
||
final long[] newRecordSizes = new long[BUCKET_COUNT];
|
||
final long newAppendOffset;
|
||
|
||
// open the old file to copy the non-dirty buckets over
|
||
try (FileChannel oldChannel = this.openV3MasterFile(mainFile)) {
|
||
final long[] oldPositionTable = oldChannel == null ? null : this.parseOffsetTable(oldChannel);
|
||
|
||
try (FileChannel outChannel = FileChannel.open(tmpFilePath,
|
||
StandardOpenOption.CREATE, StandardOpenOption.WRITE, StandardOpenOption.TRUNCATE_EXISTING)) {
|
||
this.writeV3Header(outChannel);
|
||
|
||
// position table placeholder (all zeros, filled in at the end)
|
||
writeFullyAt(outChannel, ByteBuffer.allocate(V3_POS_TABLE_SIZE), V3_POS_TABLE_OFFSET);
|
||
|
||
long dataOffset = V3_DATA_AREA_OFFSET;
|
||
|
||
for (int bucketIndex = 0; bucketIndex < BUCKET_COUNT; bucketIndex++) {
|
||
if (BufferedLinearRegionFile.this.isBucketDirty(bucketIndex)) {
|
||
final BucketRecord record = this.buildBucketRecord(bucketIndex);
|
||
|
||
if (record.payload() != null) {
|
||
writeFullyAt(outChannel, ByteBuffer.wrap(record.payload()), dataOffset);
|
||
newPositionTable[bucketIndex] = dataOffset;
|
||
newRecordSizes[bucketIndex] = record.payload().length;
|
||
dataOffset += record.payload().length;
|
||
}
|
||
// else: the bucket is empty now, its table entry stays 0
|
||
|
||
syncedBucketEpochs[bucketIndex] = record.epoch();
|
||
} else if (oldPositionTable != null && oldPositionTable[bucketIndex] != 0) {
|
||
// not dirty: copy the record bytes straight from the old file
|
||
final long oldOffset = oldPositionTable[bucketIndex];
|
||
final ByteBuffer lens = this.readRecordLengths(oldChannel, oldOffset);
|
||
lens.getInt(); // skip originalLen
|
||
final long recordSize = V3_RECORD_HEADER_SIZE + (long) lens.getInt();
|
||
|
||
transferFully(oldChannel, oldOffset, recordSize, outChannel, dataOffset);
|
||
newPositionTable[bucketIndex] = dataOffset;
|
||
newRecordSizes[bucketIndex] = recordSize;
|
||
dataOffset += recordSize;
|
||
}
|
||
}
|
||
|
||
// write the finalized position table
|
||
writeFullyAt(outChannel, this.encodePositionTable(newPositionTable), V3_POS_TABLE_OFFSET);
|
||
|
||
outChannel.force(true);
|
||
|
||
newAppendOffset = dataOffset;
|
||
}
|
||
}
|
||
|
||
atomicReplace(tmpFilePath, mainFile);
|
||
|
||
// enter WAL mode: keep the freshly written master file open for appending syncs
|
||
this.appendChannel = FileChannel.open(mainFile, StandardOpenOption.READ, StandardOpenOption.WRITE);
|
||
this.positionTable = newPositionTable;
|
||
this.recordSizes = newRecordSizes;
|
||
this.appendOffset = newAppendOffset;
|
||
|
||
this.markBucketsSynced(syncedBucketEpochs);
|
||
}
|
||
|
||
private void appendDirtyBuckets() throws IOException {
|
||
final FileChannel channel = this.appendChannel;
|
||
final long[] syncedBucketEpochs = new long[BUCKET_COUNT];
|
||
final long[] newPositionTable = this.positionTable.clone();
|
||
final long[] newRecordSizes = this.recordSizes.clone();
|
||
long dataOffset = this.appendOffset;
|
||
boolean anyDirty = false;
|
||
|
||
for (int bucketIndex = 0; bucketIndex < BUCKET_COUNT; bucketIndex++) {
|
||
if (!BufferedLinearRegionFile.this.isBucketDirty(bucketIndex)) {
|
||
continue;
|
||
}
|
||
|
||
final BucketRecord record = this.buildBucketRecord(bucketIndex);
|
||
|
||
if (record.payload() != null) {
|
||
writeFullyAt(channel, ByteBuffer.wrap(record.payload()), dataOffset);
|
||
newPositionTable[bucketIndex] = dataOffset;
|
||
newRecordSizes[bucketIndex] = record.payload().length;
|
||
dataOffset += record.payload().length;
|
||
} else {
|
||
// the bucket is empty now
|
||
newPositionTable[bucketIndex] = 0;
|
||
newRecordSizes[bucketIndex] = 0;
|
||
}
|
||
|
||
syncedBucketEpochs[bucketIndex] = record.epoch();
|
||
anyDirty = true;
|
||
}
|
||
|
||
if (!anyDirty) {
|
||
return;
|
||
}
|
||
|
||
// make the appended records durable before the position table may point at them
|
||
channel.force(false);
|
||
|
||
// commit the new tail first: even a torn position table write can then never
|
||
// cause a later append to overwrite records the on-disk table already references
|
||
this.appendOffset = dataOffset;
|
||
|
||
writeFullyAt(channel, this.encodePositionTable(newPositionTable), V3_POS_TABLE_OFFSET);
|
||
channel.force(true);
|
||
|
||
this.positionTable = newPositionTable;
|
||
this.recordSizes = newRecordSizes;
|
||
|
||
this.markBucketsSynced(syncedBucketEpochs);
|
||
}
|
||
|
||
// snapshots one bucket under a short read lock (raw sector bytes only);
|
||
// LZ4 decompression and zstd compression both run outside any lock so
|
||
// writers are only blocked while the raw bytes are copied
|
||
private @NotNull BucketRecord buildBucketRecord(int bucketIndex) throws IOException {
|
||
final int baseChunkIndex = bucketIndex << BUCKET_SHIFT;
|
||
final ByteBuffer[] rawSectors = new ByteBuffer[BUCKET_SIZE];
|
||
final long epoch;
|
||
|
||
BufferedLinearRegionFile.this.regionObjectLock.readLock().lock();
|
||
try {
|
||
// the epoch is taken before the data: writes completing afterwards bump
|
||
// it further, so they simply get picked up by the next sync round
|
||
epoch = BufferedLinearRegionFile.this.getBucketWriteEpoch(bucketIndex);
|
||
|
||
for (int i = 0; i < BUCKET_SIZE; i++) {
|
||
final Sector sector = BufferedLinearRegionFile.this.sectors[baseChunkIndex + i];
|
||
|
||
rawSectors[i] = sector.hasData() ? sector.read(BufferedLinearRegionFile.this.swapFileChannel) : null;
|
||
}
|
||
} finally {
|
||
BufferedLinearRegionFile.this.regionObjectLock.readLock().unlock();
|
||
}
|
||
|
||
final ByteArrayOutputStream rawBuf = new ByteArrayOutputStream();
|
||
final DataOutputStream rawOut = new DataOutputStream(rawBuf);
|
||
boolean hasAny = false;
|
||
|
||
for (int i = 0; i < BUCKET_SIZE; i++) {
|
||
final ByteBuffer rawSector = rawSectors[i];
|
||
|
||
// note: null -> no data contained
|
||
if (rawSector == null) {
|
||
rawOut.writeInt(0);
|
||
continue;
|
||
}
|
||
|
||
final ByteBuffer chunkData = BufferedLinearRegionFile.this.compressingOps.decompress(rawSector);
|
||
final byte[] arr = new byte[chunkData.remaining()];
|
||
chunkData.get(arr);
|
||
|
||
rawOut.writeInt(arr.length);
|
||
rawOut.write(arr);
|
||
hasAny = true;
|
||
}
|
||
rawOut.flush();
|
||
|
||
if (!hasAny) {
|
||
return new BucketRecord(epoch, null);
|
||
}
|
||
|
||
final byte[] raw = rawBuf.toByteArray();
|
||
final byte[] compressed = Zstd.compress(raw, BufferedLinearRegionFile.this.compressionLevel);
|
||
|
||
final ByteBuffer payload = ByteBuffer.allocate(V3_RECORD_HEADER_SIZE + compressed.length);
|
||
payload.putInt(raw.length); // original (uncompressed) length
|
||
payload.putInt(compressed.length); // compressed length
|
||
payload.put(compressed);
|
||
|
||
return new BucketRecord(epoch, payload.array());
|
||
}
|
||
|
||
private void markBucketsSynced(long[] syncedBucketEpochs) {
|
||
for (int i = 0; i < syncedBucketEpochs.length; i++) {
|
||
// note: a dirty bucket always has a write epoch >= 1, so 0 = untouched
|
||
if (syncedBucketEpochs[i] != 0L) {
|
||
BufferedLinearRegionFile.this.markBucketSynced(i, syncedBucketEpochs[i]);
|
||
}
|
||
}
|
||
}
|
||
|
||
// opens the master file for reading if it exists and is a valid V3 bucketed file, else null
|
||
private @Nullable FileChannel openV3MasterFile(@NotNull Path mainFile) throws IOException {
|
||
if (!Files.exists(mainFile)) {
|
||
return null;
|
||
}
|
||
|
||
final FileChannel channel = FileChannel.open(mainFile, StandardOpenOption.READ);
|
||
try {
|
||
if (channel.size() >= V3_DATA_AREA_OFFSET) {
|
||
final ByteBuffer header = ByteBuffer.allocate(V3_HEADER_SIZE);
|
||
readFullyAt(channel, header, 0);
|
||
header.flip();
|
||
|
||
if (header.getLong() == MASTER_FILE_SUPER_BLOCK && header.get() == MASTER_FILE_VERSION_BUCKET) {
|
||
return channel;
|
||
}
|
||
}
|
||
} catch (Throwable e) {
|
||
try {
|
||
channel.close();
|
||
} catch (IOException e2) {
|
||
e.addSuppressed(e2);
|
||
}
|
||
|
||
throw e;
|
||
}
|
||
|
||
channel.close();
|
||
return null;
|
||
}
|
||
|
||
private void writeV3Header(@NotNull FileChannel channel) throws IOException {
|
||
final ByteBuffer header = ByteBuffer.allocate(V3_HEADER_SIZE);
|
||
|
||
header.putLong(MASTER_FILE_SUPER_BLOCK);
|
||
header.put(MASTER_FILE_VERSION_BUCKET);
|
||
header.put(BufferedLinearRegionFile.this.compressionLevel);
|
||
header.putInt(BufferedLinearRegionFile.this.xxHash32Seed);
|
||
header.flip();
|
||
|
||
writeFullyAt(channel, header, 0);
|
||
}
|
||
|
||
private @NotNull ByteBuffer encodePositionTable(long[] table) {
|
||
final ByteBuffer buf = ByteBuffer.allocate(V3_POS_TABLE_SIZE);
|
||
|
||
for (final long pos : table) {
|
||
buf.putLong(pos);
|
||
}
|
||
|
||
return buf.flip();
|
||
}
|
||
|
||
private @NotNull ByteBuffer readRecordLengths(@NotNull FileChannel channel, long recordOffset) throws IOException {
|
||
final ByteBuffer lens = ByteBuffer.allocate(V3_RECORD_HEADER_SIZE);
|
||
|
||
readFullyAt(channel, lens, recordOffset);
|
||
|
||
return lens.flip();
|
||
}
|
||
|
||
public void close() throws IOException {
|
||
this.masterFileLock.writeLock().lock();
|
||
try {
|
||
if (this.appendChannel != null) {
|
||
this.appendChannel.close();
|
||
this.appendChannel = null;
|
||
}
|
||
} finally {
|
||
this.masterFileLock.writeLock().unlock();
|
||
}
|
||
}
|
||
|
||
private void loadBucketsFor(@NotNull Path file, int bucketIndex) throws IOException {
|
||
final int beginChunkIndex = bucketIndex << BUCKET_SHIFT;
|
||
|
||
this.masterFileLock.readLock().lock();
|
||
try {
|
||
final ByteBuffer decompressed;
|
||
|
||
if (this.appendChannel != null) {
|
||
// WAL mode: reuse the always-open channel and the cached position table
|
||
decompressed = this.readBucketData(this.appendChannel, this.positionTable[bucketIndex]);
|
||
} else {
|
||
if (!Files.exists(file)) {
|
||
return;
|
||
}
|
||
|
||
try (FileChannel channel = FileChannel.open(file, StandardOpenOption.READ)) {
|
||
if (channel.size() < V3_DATA_AREA_OFFSET) {
|
||
return;
|
||
}
|
||
|
||
this.checkV3Header(channel);
|
||
|
||
decompressed = this.readBucketData(channel, this.parseOffsetTable(channel)[bucketIndex]);
|
||
}
|
||
}
|
||
|
||
if (decompressed != null) {
|
||
this.loadChunksFromBucketData(decompressed, beginChunkIndex);
|
||
}
|
||
} finally {
|
||
this.masterFileLock.readLock().unlock();
|
||
}
|
||
}
|
||
|
||
private void checkV3Header(@NotNull FileChannel channel) throws IOException {
|
||
final ByteBuffer headerBuf = ByteBuffer.allocate(V3_HEADER_SIZE);
|
||
readFullyAt(channel, headerBuf, 0);
|
||
headerBuf.flip();
|
||
|
||
final long superblock = headerBuf.getLong();
|
||
if (superblock != MASTER_FILE_SUPER_BLOCK)
|
||
throw new IOException("Invalid superblock " + superblock + "!");
|
||
|
||
final byte version = headerBuf.get();
|
||
if (version != MASTER_FILE_VERSION_BUCKET)
|
||
throw new IOException("Unknown version: " + version);
|
||
|
||
// compressionLevel and hashSeed are not used here
|
||
}
|
||
|
||
// reads and decompresses one bucket record; null when the table entry is empty
|
||
private @Nullable ByteBuffer readBucketData(@NotNull FileChannel channel, long recordOffset) throws IOException {
|
||
if (recordOffset == 0) {
|
||
return null;
|
||
}
|
||
|
||
final ByteBuffer lens = this.readRecordLengths(channel, recordOffset);
|
||
final int originalLen = lens.getInt();
|
||
final int compressedLen = lens.getInt();
|
||
|
||
final byte[] compressedData = new byte[compressedLen];
|
||
readFullyAt(channel, ByteBuffer.wrap(compressedData), recordOffset + V3_RECORD_HEADER_SIZE);
|
||
|
||
return ByteBuffer.wrap(Zstd.decompress(compressedData, originalLen));
|
||
}
|
||
|
||
private long @NonNull [] parseOffsetTable(FileChannel channel) throws IOException {
|
||
final ByteBuffer buf = ByteBuffer.allocate(V3_POS_TABLE_SIZE);
|
||
readFullyAt(channel, buf, V3_POS_TABLE_OFFSET);
|
||
buf.flip();
|
||
|
||
final long[] table = new long[BUCKET_COUNT];
|
||
|
||
for (int i = 0; i < BUCKET_COUNT; i++) {
|
||
table[i] = buf.getLong();
|
||
}
|
||
|
||
return table;
|
||
}
|
||
|
||
private void loadChunksFromBucketData(ByteBuffer decompressed, int beginChunkIndex) throws IOException {
|
||
for (int chunkIndex = beginChunkIndex; chunkIndex < beginChunkIndex + BUCKET_SIZE; chunkIndex++) {
|
||
final int chunkSectionDataSize = decompressed.getInt();
|
||
if (chunkSectionDataSize <= 0) continue;
|
||
|
||
final byte[] chunkSectionData = new byte[chunkSectionDataSize];
|
||
decompressed.get(chunkSectionData);
|
||
|
||
BufferedLinearRegionFile.this.writeChunkDataRaw(chunkIndex, ByteBuffer.wrap(chunkSectionData), true);
|
||
}
|
||
}
|
||
|
||
private void parseLinearV2(@NonNull DataInputStream ioStream, Path file) throws IOException {
|
||
try (ioStream) {
|
||
ioStream.readLong(); // Skip newestTimestamp (Long)
|
||
|
||
byte gridSize = ioStream.readByte();
|
||
if (gridSize != 1 && gridSize != 2 && gridSize != 4 && gridSize != 8 && gridSize != 16 && gridSize != 32)
|
||
throw new RuntimeException("Invalid grid size: " + gridSize + " file " + file);
|
||
int bucketSize = 32 / gridSize;
|
||
|
||
ioStream.readInt(); // Skip region_x (Int)
|
||
ioStream.readInt(); // Skip region_z (Int)
|
||
|
||
ioStream.skipBytes(128); // Skip existence bitmap
|
||
|
||
// Skip NBT features
|
||
while (true) {
|
||
byte featureNameLength = ioStream.readByte();
|
||
if (featureNameLength == 0) break;
|
||
byte[] featureNameBytes = new byte[featureNameLength];
|
||
ioStream.readFully(featureNameBytes);
|
||
ioStream.readInt(); // featureValue
|
||
}
|
||
|
||
// Read bucket metadata
|
||
int totalBuckets = gridSize * gridSize;
|
||
int[] bucketSizes = new int[totalBuckets];
|
||
byte[] bucketCompressionLevels = new byte[totalBuckets];
|
||
long[] bucketHashes = new long[totalBuckets];
|
||
for (int i = 0; i < totalBuckets; i++) {
|
||
bucketSizes[i] = ioStream.readInt();
|
||
bucketCompressionLevels[i] = ioStream.readByte();
|
||
bucketHashes[i] = ioStream.readLong();
|
||
}
|
||
|
||
// Read and decompress each bucket, load chunks into swap
|
||
for (int bx = 0; bx < gridSize; bx++) {
|
||
for (int bz = 0; bz < gridSize; bz++) {
|
||
int bucketIdx = bx * gridSize + bz;
|
||
|
||
if (bucketSizes[bucketIdx] <= 0) continue;
|
||
|
||
byte[] compressedBucket = new byte[bucketSizes[bucketIdx]];
|
||
ioStream.readFully(compressedBucket);
|
||
|
||
long rawHash = LongHashFunction.xx().hashBytes(compressedBucket);
|
||
if (rawHash != bucketHashes[bucketIdx]) {
|
||
throw new IOException("Region file hash incorrect for bucket " + bucketIdx + " in " + file);
|
||
}
|
||
|
||
ByteArrayInputStream bucketByteStream = new ByteArrayInputStream(compressedBucket);
|
||
ZstdInputStream zstdStream = new ZstdInputStream(bucketByteStream);
|
||
ByteBuffer bucketBuffer = ByteBuffer.wrap(zstdStream.readAllBytes());
|
||
zstdStream.close();
|
||
|
||
for (int cx = 0; cx < bucketSize; cx++) {
|
||
for (int cz = 0; cz < bucketSize; cz++) {
|
||
int chunkX = bx * bucketSize + cx;
|
||
int chunkZ = bz * bucketSize + cz;
|
||
int chunkIndex = chunkX + chunkZ * 32;
|
||
|
||
int chunkSize = bucketBuffer.getInt();
|
||
long timestamp = bucketBuffer.getLong();
|
||
|
||
if (chunkSize > 0) {
|
||
// chunkSize includes the 8 bytes of timestamp already written
|
||
int dataLen = chunkSize - 8;
|
||
byte[] chunkData = new byte[dataLen];
|
||
bucketBuffer.get(chunkData);
|
||
|
||
// Mark bucket as loaded. writeChunk() bumps the bucket epoch so it gets synced to the new master format.
|
||
BufferedLinearRegionFile.this.markBucketLoaded(chunkIndex);
|
||
|
||
// Use writeChunk to go through the full path (adds length + timestamp + xxhash header)
|
||
BufferedLinearRegionFile.this.writeChunk(chunkX, chunkZ, ByteBuffer.wrap(chunkData));
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
// Footer validation
|
||
long footerSuperBlock = ioStream.readLong();
|
||
if (footerSuperBlock != LINEAR_FILE_SUPER_BLOCK) {
|
||
throw new IOException("Footer superblock invalid " + file);
|
||
}
|
||
}
|
||
}
|
||
|
||
private boolean tryParseBlinearV2(@NotNull DataInputStream ioStream, Path file) throws IOException {
|
||
final byte version = ioStream.readByte();
|
||
|
||
// we will parse dynamically (V3)
|
||
if (version == MASTER_FILE_VERSION_BUCKET) {
|
||
ioStream.close();
|
||
return false;
|
||
}
|
||
|
||
if (version != MASTER_FILE_VERSION)
|
||
throw new RuntimeException("Invalid version: " + version + " in " + file);
|
||
|
||
// Skip newestTimestamp (Long) + Compression level (Byte): Unused.
|
||
ioStream.skipBytes(9);
|
||
|
||
try (final ZstdInputStream decompressStream = new ZstdInputStream(ioStream)) {
|
||
// only used as a helper stream
|
||
// the parent stream will be closed in the try-catch block upper
|
||
final DataInputStream decompressedStreamHelper = new DataInputStream(decompressStream);
|
||
|
||
for (int index = 0; index < 1024; index++) {
|
||
int size = decompressedStreamHelper.readInt(); // len
|
||
|
||
if (size > 0) {
|
||
byte[] sectorData = new byte[size];
|
||
decompressedStreamHelper.readFully(sectorData, 0, size); // data
|
||
|
||
final ByteBuffer sectorDataNioBuffer = ByteBuffer.wrap(sectorData);
|
||
|
||
BufferedLinearRegionFile.this.markBucketLoaded(index);
|
||
BufferedLinearRegionFile.this.writeChunkDataRaw(index, sectorDataNioBuffer, false);
|
||
}
|
||
}
|
||
}
|
||
|
||
return true;
|
||
}
|
||
|
||
@Contract(value = "_ -> new", pure = true)
|
||
public static int @NotNull [] coordinatesFromIndex(int chunkIndex) {
|
||
int x = chunkIndex & 31;
|
||
int z = (chunkIndex >> 5) & 31;
|
||
return new int[]{x, z};
|
||
}
|
||
|
||
private void parseLinearV1(@NotNull DataInputStream ioStream) throws IOException {
|
||
// Skip newestTimestamp (Long) + Compression level (Byte) + Chunk count (Short): Unused.
|
||
ioStream.skipBytes(11);
|
||
// Skip chunk data len(Int)(Unused).
|
||
ioStream.skipBytes(4);
|
||
// Skip data hash (Long): Unused.
|
||
ioStream.skipBytes(8);
|
||
|
||
try (final ZstdInputStream decompressedStream = new ZstdInputStream(ioStream)) {
|
||
// only used as a helper stream
|
||
// the parent stream will be closed in the try-catch block upper
|
||
final DataInputStream bufferHelper = new DataInputStream(decompressedStream);
|
||
|
||
final int[] chunkStarts = new int[1024];
|
||
for (int i = 0; i < 1024; i++) {
|
||
chunkStarts[i] = bufferHelper.readInt();
|
||
bufferHelper.skipBytes(4); // Skip timestamps (Int): Unused.
|
||
}
|
||
|
||
for (int i = 0; i < 1024; i++) {
|
||
if (chunkStarts[i] > 0) {
|
||
int size = chunkStarts[i];
|
||
byte[] chunkData = new byte[size];
|
||
bufferHelper.readFully(chunkData);
|
||
|
||
final ByteBuffer chunkDataNioBuffer = ByteBuffer.wrap(chunkData);
|
||
|
||
final int[] posByAxis = coordinatesFromIndex(i);
|
||
|
||
final int x = posByAxis[0];
|
||
final int z = posByAxis[1];
|
||
|
||
BufferedLinearRegionFile.this.markBucketLoaded(i);
|
||
BufferedLinearRegionFile.this.writeChunk(x, z, chunkDataNioBuffer);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
// won't and need not to hold any region locks as we are calling this in a safe point (initially newed)
|
||
public void tryParseMainFileOld(@NotNull Path mainFilePath) throws IOException {
|
||
final File file = mainFilePath.toFile();
|
||
|
||
if (!file.exists() || !file.canRead()) {
|
||
return;
|
||
}
|
||
|
||
// those streams will be closed in the parse logic, or we will close it manually
|
||
final FileInputStream fileStream = new FileInputStream(file);
|
||
final DataInputStream rawDataStream = new DataInputStream(fileStream);
|
||
|
||
boolean oldParsed = false;
|
||
final long superBlock;
|
||
try {
|
||
superBlock = rawDataStream.readLong();
|
||
|
||
if (superBlock == MASTER_FILE_SUPER_BLOCK) {
|
||
oldParsed = this.tryParseBlinearV2(rawDataStream, mainFilePath);
|
||
|
||
// false -> v3 -> closed in parse block
|
||
if (!oldParsed) {
|
||
return;
|
||
}
|
||
}
|
||
|
||
if (superBlock == LINEAR_FILE_SUPER_BLOCK) {
|
||
final byte version = rawDataStream.readByte();
|
||
|
||
if (version == 1 || version == 2) {
|
||
this.parseLinearV1(rawDataStream);
|
||
|
||
oldParsed = true;
|
||
}
|
||
|
||
if (version == 3) {
|
||
this.parseLinearV2(rawDataStream, mainFilePath);
|
||
|
||
oldParsed = true;
|
||
}
|
||
}
|
||
|
||
} catch (Throwable ex) {
|
||
try {
|
||
rawDataStream.close();
|
||
} catch (IOException ex2) {
|
||
ex.addSuppressed(ex2);
|
||
}
|
||
|
||
throw new IOException("Failed to parse master file: " + mainFilePath, ex);
|
||
}
|
||
|
||
// old parsed, remove the original file, and we will recreate it as we sync
|
||
if (oldParsed) {
|
||
// immediately do sync operation
|
||
BufferedLinearRegionFile.this.syncToMasterFile();
|
||
return;
|
||
}
|
||
|
||
// anyone non-matched, close stream and throw the error
|
||
rawDataStream.close();
|
||
|
||
throw new IOException("Unknown or unsupported super block : " + superBlock);
|
||
}
|
||
}
|
||
} |