org.openbase.jul.storage.registry.version

Interface GlobalDBVersionConverter

All Superinterfaces:

DBVersionConverter

All Known Implementing Classes:

AbstractGlobalDBVersionConverter

public interface GlobalDBVersionConverter
extends DBVersionConverter

Author:

Divine Threepwood This converter transforms the outdated db entry into a new db version entry. Additionally this global db converter has access to all other databases as well. This allows globally database transfer and modifications during the version upgrade if needed.

Method Summary

Modifier and Type	Method and Description
default com.google.gson.JsonObject	upgrade(com.google.gson.JsonObject outdatedDBEntry, Map<File,com.google.gson.JsonObject> dbSnapshot) This method applies an upgrade transaction on the given entry to push the entry to the next db version.
default com.google.gson.JsonObject	upgrade(com.google.gson.JsonObject outdatedDBEntry, Map<File,com.google.gson.JsonObject> dbSnapshot, Map<String,Map<File,DatabaseEntryDescriptor>> globalDbSnapshots) This method applies an update transaction on the given entry to push the entry to the next db version.

Methods inherited from interface org.openbase.jul.storage.registry.version.DBVersionConverter

getVersionControl

Method Detail

upgrade

default com.google.gson.JsonObject upgrade(com.google.gson.JsonObject outdatedDBEntry,
                                           Map<File,com.google.gson.JsonObject> dbSnapshot,
                                           Map<String,Map<File,DatabaseEntryDescriptor>> globalDbSnapshots)
                                    throws CouldNotPerformException

This method applies an update transaction on the given entry to push the entry to the next db version.

Parameters:

outdatedDBEntry - the outdated db entry where the upgrade should be applied to.

dbSnapshot - all entries of the current database which may are partially upgraded.

globalDbSnapshots - a map of the globally available databases to apply global database transactions. The key of the map is the filename of the global database.

Returns:

the upgraded database entry.

Throws:

CouldNotPerformException - can be thrown in case the upgrade could not be performed.

upgrade

default com.google.gson.JsonObject upgrade(com.google.gson.JsonObject outdatedDBEntry,
                                           Map<File,com.google.gson.JsonObject> dbSnapshot)
                                    throws CouldNotPerformException

Description copied from interface: DBVersionConverter

This method applies an upgrade transaction on the given entry to push the entry to the next db version.

Specified by:

upgrade in interface DBVersionConverter

Parameters:

outdatedDBEntry - the outdated db entry where the upgrade should be applied to.

dbSnapshot - all entries of the current database which may are partially upgraded.

Returns:

the upgraded database entry.

Throws:

CouldNotPerformException - can be thrown in case the upgrade could not be performed.