CorruptionHandler


public interface CorruptionHandler<T extends Object>

Known direct subclasses
ReplaceFileCorruptionHandler

A corruption handler that attempts to replace the on-disk data with data from produceNewData.


CorruptionHandlers allow recovery from corruption that prevents reading data from the file (as indicated by a CorruptionException).

Summary

Public methods

abstract @NonNull T

This function will be called by DataStore when it encounters corruption.

Public methods

handleCorruption

abstract @NonNullhandleCorruption(@NonNull CorruptionException ex)

This function will be called by DataStore when it encounters corruption. If the implementation of this function throws an exception, it will be propagated to the original call to DataStore. Otherwise, the returned data will be written to disk.

This function should not interact with any DataStore API - doing so can result in a deadlock.

Parameters
@NonNull CorruptionException ex

is the exception encountered when attempting to deserialize data from disk.

Returns
@NonNull T

The value that DataStore should attempt to write to disk.