Package com.enhancedechest.migration

Class AxVaultsReader

java.lang.Object

com.enhancedechest.migration.AxVaultsReader

All Implemented Interfaces:

AutoCloseable

public final class AxVaultsReader
extends Object
implements AutoCloseable

Reads an AxVaults (Artillex-Studios) database directly and decodes its vault contents into Bukkit ItemStack arrays, ready to be re-encoded into EnhancedEchest's own storage.

AxVaults stores one row per (player, vault) in axvaults_data(id, uuid, storage, icon). The storage blob is the AxAPI Serializers.ITEM_ARRAY framing — a big-endian int slot count, then per slot a unsigned short byte length (0 = empty) followed by that many bytes. Each item's bytes are gzip-compressed NBT with a DataVersion tag, exactly what Paper's ItemStack.serializeAsBytes() produces, so each one decodes via ItemStack.deserializeBytes(byte[]) (which also runs the DataFixerUpper across versions).

Reads the SQLite backend (data.db) only, opened read-only so it can be read while the source server still holds the file. Installs running AxVaults' default H2 backend (data.mv.db) must switch AxVaults to database.type: sqlite before migrating.

Not thread-safe; create, use and close() on a single thread (the migration runs on the shared DB executor). Item (de)serialization is read-only against the frozen server registries and is safe off the main thread.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	AxVaultsReader.VaultRow	A single AxVaults vault as decoded for migration.

Method Summary

Modifier and Type	Method	Description
String	backend()	The backend name ("SQLite"), for logging.
void	close()
static AxVaultsReader	open(Path axVaultsFolder, org.slf4j.Logger log)	Opens the AxVaults SQLite database (data.db) found in axVaultsFolder (typically plugins/AxVaults).
List<AxVaultsReader.VaultRow>	read(UUID owner)	Reads and decodes a single player's vaults, ordered by vault id.
Map<UUID,List<AxVaultsReader.VaultRow>>	readAll()	Reads and decodes every player's vaults, keyed by owner UUID and ordered by vault id.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

backend

public String backend()

The backend name ("SQLite"), for logging.

open

public static AxVaultsReader open(Path axVaultsFolder,
 org.slf4j.Logger log)
                           throws Exception

Opens the AxVaults SQLite database (data.db) found in axVaultsFolder (typically plugins/AxVaults).

Throws:

IllegalStateException - if no readable AxVaults SQLite database is found in the folder

Exception - if the driver is missing or the connection fails

readAll

public Map<UUID,List<AxVaultsReader.VaultRow>> readAll()
                                                throws Exception

Reads and decodes every player's vaults, keyed by owner UUID and ordered by vault id.

Throws:

Exception

read

public List<AxVaultsReader.VaultRow> read(UUID owner)
                                   throws Exception

Reads and decodes a single player's vaults, ordered by vault id. Empty if the player has none.

Throws:

Exception

close

public void close()

Specified by:

close in interface AutoCloseable