public class DatabaseEncryptionException

Thrown when an encrypted database cannot be opened, keyed or converted.

This extends java.io.IOException deliberately: every database method already declares IOException, so existing catch blocks keep compiling and keep working. Code that wants to tell the failure modes apart can catch this type and switch on #getErrorCode().

Example

try {
    db = Database.openOrCreate("secure.db", DatabaseConfig.passphrase(entered));
} catch (DatabaseEncryptionException err) {
    if (err.getErrorCode() == DatabaseEncryptionException.WRONG_KEY) {
        showRetryPrompt();
    } else {
        throw err;
    }
}