Migrates chat history from the old v1 MVStore file to the new v2 repository.

Old format (v1): Stored in "chat-history.mv" file. Map keys like "bibDatabasePath-entry-citationKey" or "bibDatabasePath-group-groupName" containing Map<Integer, ChatHistoryRecord> where ChatHistoryRecord was a private inner class of MVStoreChatHistoryStorage (full name: org.jabref.logic.ai.chatting.chathistory.storages.MVStoreChatHistoryStorage$ChatHistoryRecord).

New format (v2): Stored via repository using ChatIdentifier(libraryId, chatType, chatName).

Problem: The old inner class no longer exists, so MVStore's ObjectDataType fails with ClassNotFoundException before our code can intercept.

Solution: Open the map with a custom RawBytesDataType that returns the raw Java-serialized bytes for each value without invoking standard Java deserialization. Then a ClassRemappingObjectInputStream deserializes those bytes while remapping the deleted inner class name to the current ChatHistoryRecord.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	ChatHistoryMigrationV1.ClassRemappingObjectInputStream Custom ObjectInputStream that remaps the deleted old inner class name to the current `ChatHistoryRecord` class.
private static class	ChatHistoryMigrationV1.RawBytesDataType Reads raw Java-serialized bytes from MVStore's binary page format without invoking Java deserialization.

Field Summary

Modifier and Type	Field and Description
private static final String	ENTRY_CHAT_HISTORY_INFIX
private static final String	GROUP_CHAT_HISTORY_INFIX
private static final Logger	LOGGER
private static final String	OLD_CHAT_HISTORY_FILE_NAME
private static final String	OLD_CHAT_HISTORY_RECORD_CLASS Old inner class full name that is no longer in the classpath.

Constructor Summary

Access	Constructor and Description
private	ChatHistoryMigrationV1()

Method Summary

Modifier and Type	Method and Description
private static ChatMessage	convertToNewChatMessage(ChatHistoryRecord oldRecord, Instant timestamp)
private static ChatHistoryRecord	deserializeOldRecord(byte[] data) Deserializes old ChatHistoryRecord bytes using a remapping ObjectInputStream.
private static boolean	isOldChatHistoryMap(String mapName)
public static void	migrate(BibDatabaseContext The database context containing the AI library ID bibDatabaseContext, ChatHistoryRepository The new v2 chat history repository to migrate to repository, NotificationService Service for notifying user of errors notificationService) Migrates old chat history data from v1 file to v2 repository.
public static void	migrate(Path oldFilePath, String libraryId, BibDatabaseContext bibDatabaseContext, ChatHistoryRepository repository, NotificationService notificationService)
private static boolean	migrateOldMap(String oldMapName, String libraryId, BibDatabaseContext bibDatabaseContext, ChatHistoryRepository repository, MVStore oldMvStore)
private static boolean	pathMatchesCurrentLibrary(String pathPrefix, BibDatabaseContext bibDatabaseContext) Returns `true` if `pathPrefix` (extracted from an old map name) refers to the same file as the current library.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ENTRY_CHAT_HISTORY_INFIX	back to summary
private static final String ENTRY_CHAT_HISTORY_INFIX

GROUP_CHAT_HISTORY_INFIX	back to summary
private static final String GROUP_CHAT_HISTORY_INFIX

LOGGER	back to summary
private static final Logger LOGGER

OLD_CHAT_HISTORY_FILE_NAME	back to summary
private static final String OLD_CHAT_HISTORY_FILE_NAME

OLD_CHAT_HISTORY_RECORD_CLASS	back to summary
private static final String OLD_CHAT_HISTORY_RECORD_CLASS Old inner class full name that is no longer in the classpath. Was: private record ChatHistoryRecord inside MVStoreChatHistoryStorage.

Constructor Detail

ChatHistoryMigrationV1	back to summary
private ChatHistoryMigrationV1()

Method Detail

convertToNewChatMessage	back to summary
private static ChatMessage convertToNewChatMessage(ChatHistoryRecord oldRecord, Instant timestamp)

deserializeOldRecord	back to summary
private static ChatHistoryRecord deserializeOldRecord(byte[] data) Deserializes old ChatHistoryRecord bytes using a remapping ObjectInputStream. Remaps the deleted inner class name to the current `ChatHistoryRecord`.

isOldChatHistoryMap	back to summary
private static boolean isOldChatHistoryMap(String mapName)

migrate	back to summary
public static void migrate(BibDatabaseContext bibDatabaseContext, ChatHistoryRepository repository, NotificationService notificationService) Migrates old chat history data from v1 file to v2 repository. Parameters bibDatabaseContext:BibDatabaseContext The database context containing the AI library ID repository:ChatHistoryRepository The new v2 chat history repository to migrate to notificationService:NotificationService Service for notifying user of errors

migrate

back to summary

public static void migrate(BibDatabaseContext bibDatabaseContext, ChatHistoryRepository repository, NotificationService notificationService)

Migrates old chat history data from v1 file to v2 repository.

Parameters

bibDatabaseContext:BibDatabaseContext: The database context containing the AI library ID
repository:ChatHistoryRepository: The new v2 chat history repository to migrate to
notificationService:NotificationService: Service for notifying user of errors

migrate	back to summary
public static void migrate(Path oldFilePath, String libraryId, BibDatabaseContext bibDatabaseContext, ChatHistoryRepository repository, NotificationService notificationService)

migrateOldMap	back to summary
private static boolean migrateOldMap(String oldMapName, String libraryId, BibDatabaseContext bibDatabaseContext, ChatHistoryRepository repository, MVStore oldMvStore)

pathMatchesCurrentLibrary back to summary

pathMatchesCurrentLibrary	back to summary
private static boolean pathMatchesCurrentLibrary(String pathPrefix, BibDatabaseContext bibDatabaseContext) Returns `true` if `pathPrefix` (extracted from an old map name) refers to the same file as the current library. If the prefix is an absolute path, it is compared after normalization. If the prefix is a relative path, the current library's absolute path is checked with `Path#endsWith(Path)`, so `a/lib1.bib` matches `D:/my/a/lib1.bib`.

private static boolean pathMatchesCurrentLibrary(String pathPrefix, BibDatabaseContext bibDatabaseContext)

Returns true if pathPrefix (extracted from an old map name) refers to the same file as the current library.

If the prefix is an absolute path, it is compared after normalization.
If the prefix is a relative path, the current library's absolute path is checked with Path#endsWith(Path), so a/lib1.bib matches D:/my/a/lib1.bib.

org.jabref.logic.ai.chatting.migrations back to summary

private Class ChatHistoryMigrationV1.ClassRemappingObjectInputStream

Class Inheritance

extends ObjectInputStream

java.lang.Object
java.io.InputStream
java.io.ObjectInputStream
org.jabref.logic.ai.chatting.migrations.ChatHistoryMigrationV1.ClassRemappingObjectInputStream

Custom ObjectInputStream that remaps the deleted old inner class name to the current ChatHistoryRecord class.

The old and new records have identical components (className: String, content: String), so Java record deserialization will call the canonical constructor successfully.

Constructor Summary

Access	Constructor and Description
public	ClassRemappingObjectInputStream(InputStream in)

Method Summary

Modifier and Type	Method and Description
protected ObjectStreamClass	readClassDescriptor() Overrides java.io.ObjectInputStream.readClassDescriptor. Read a class descriptor from the serialization stream.

Constructor Detail

ClassRemappingObjectInputStream	back to summary
public ClassRemappingObjectInputStream(InputStream in) throws IOException

Method Detail

readClassDescriptor back to summary

readClassDescriptor	back to summary
protected ObjectStreamClass readClassDescriptor() throws IOException, ClassNotFoundException Overrides java.io.ObjectInputStream.readClassDescriptor. Doc from java.io.ObjectInputStream.readClassDescriptor. Read a class descriptor from the serialization stream. This method is called when the ObjectInputStream expects a class descriptor as the next item in the serialization stream. Subclasses of ObjectInputStream may override this method to read in class descriptors that have been written in non-standard formats (by subclasses of ObjectOutputStream which have overridden the `writeClassDescriptor` method). By default, this method reads class descriptors according to the format defined in the Object Serialization specification. Annotations @Override Exceptions IOException: If an I/O error has occurred. ClassNotFoundException: If the Class of a serialized object used in the class descriptor representation cannot be found

protected ObjectStreamClass readClassDescriptor() throws IOException, ClassNotFoundException

Overrides java.io.ObjectInputStream.readClassDescriptor.

Doc from java.io.ObjectInputStream.readClassDescriptor.

Read a class descriptor from the serialization stream. This method is called when the ObjectInputStream expects a class descriptor as the next item in the serialization stream. Subclasses of ObjectInputStream may override this method to read in class descriptors that have been written in non-standard formats (by subclasses of ObjectOutputStream which have overridden the writeClassDescriptor method). By default, this method reads class descriptors according to the format defined in the Object Serialization specification.

Annotations

@Override

Exceptions

IOException:: If an I/O error has occurred.
ClassNotFoundException:: If the Class of a serialized object used in the class descriptor representation cannot be found

org.jabref.logic.ai.chatting.migrations back to summary

private Class ChatHistoryMigrationV1.RawBytesDataType

Class Inheritance

extends BasicDataType<byte[]>

java.lang.Object
org.h2.mvstore.type.BasicDataType
org.jabref.logic.ai.chatting.migrations.ChatHistoryMigrationV1.RawBytesDataType

Reads raw Java-serialized bytes from MVStore's binary page format without invoking Java deserialization. MVStore's ObjectDataType stores each serializable value as:

1 byte: type identifier — 19 (TYPE_SERIALIZED_OBJECT in H2 2.3.232)
VarInt: byte length of the serialized payload
N bytes: the raw Java-serialized payload

Field Summary

Modifier and Type	Field and Description
private static final int	TYPE_SERIALIZED_OBJECT

Constructor Summary

Access	Constructor and Description
private	RawBytesDataType()

Method Summary

Modifier and Type	Method and Description
public byte[][]	createStorage(int size) Implements org.h2.mvstore.type.DataType.createStorage. Create storage object of array type to hold values
public int	getMemory(byte[] obj) Implements abstract org.h2.mvstore.type.BasicDataType.getMemory. Implements org.h2.mvstore.type.DataType.getMemory. Calculates the amount of used memory in bytes.
public byte[]	read(ByteBuffer buff) Implements abstract org.h2.mvstore.type.BasicDataType.read. Implements org.h2.mvstore.type.DataType.read. Read an object.
private static int	readVarInt(ByteBuffer buff)
public void	write(WriteBuffer buff, byte[] obj) Implements abstract org.h2.mvstore.type.BasicDataType.write. Implements org.h2.mvstore.type.DataType.write. Write an object.

Inherited from org.h2.mvstore.type.BasicDataType:: binarySearch cast compare equals hashCode isMemoryEstimationAllowed read write

Field Detail

TYPE_SERIALIZED_OBJECT	back to summary
private static final int TYPE_SERIALIZED_OBJECT

Constructor Detail

RawBytesDataType	back to summary
private RawBytesDataType()

Method Detail

createStorage	back to summary
public byte[][] createStorage(int size) Implements org.h2.mvstore.type.DataType.createStorage. Doc from org.h2.mvstore.type.DataType.createStorage. Create storage object of array type to hold values Annotations @Override

createStorage

back to summary

public byte[][] createStorage(int size)

Implements org.h2.mvstore.type.DataType.createStorage.

Doc from org.h2.mvstore.type.DataType.createStorage.

Create storage object of array type to hold values

Annotations

@Override

getMemory	back to summary
public int getMemory(byte[] obj) Implements abstract org.h2.mvstore.type.BasicDataType.getMemory. Implements org.h2.mvstore.type.DataType.getMemory. Doc from org.h2.mvstore.type.DataType.getMemory. Calculates the amount of used memory in bytes. Annotations @Override

getMemory

back to summary

public int getMemory(byte[] obj)

Implements abstract org.h2.mvstore.type.BasicDataType.getMemory.

Implements org.h2.mvstore.type.DataType.getMemory.

Doc from org.h2.mvstore.type.DataType.getMemory.

Calculates the amount of used memory in bytes.

Annotations

@Override

read	back to summary
public byte[] read(ByteBuffer buff) Implements abstract org.h2.mvstore.type.BasicDataType.read. Implements org.h2.mvstore.type.DataType.read. Doc from org.h2.mvstore.type.DataType.read. Read an object. Annotations @Override

read

back to summary

public byte[] read(ByteBuffer buff)

Implements abstract org.h2.mvstore.type.BasicDataType.read.

Implements org.h2.mvstore.type.DataType.read.

Doc from org.h2.mvstore.type.DataType.read.

Read an object.

Annotations

@Override

readVarInt	back to summary
private static int readVarInt(ByteBuffer buff)

write	back to summary
public void write(WriteBuffer buff, byte[] obj) Implements abstract org.h2.mvstore.type.BasicDataType.write. Implements org.h2.mvstore.type.DataType.write. Doc from org.h2.mvstore.type.DataType.write. Write an object. Annotations @Override

write

back to summary

public void write(WriteBuffer buff, byte[] obj)

Implements abstract org.h2.mvstore.type.BasicDataType.write.

Implements org.h2.mvstore.type.DataType.write.

Doc from org.h2.mvstore.type.DataType.write.

Write an object.

Annotations