com.healthmarketscience.jackcess.crypt

Class CryptCodecProvider

java.lang.Object

com.healthmarketscience.jackcess.crypt.CryptCodecProvider

All Implemented Interfaces:

PasswordCallback, com.healthmarketscience.jackcess.impl.CodecProvider, Supplier<String>

public class CryptCodecProvider
extends Object
implements com.healthmarketscience.jackcess.impl.CodecProvider, PasswordCallback

Implementation of CodecProvider with support for some forms of Microsoft Access and Microsoft Money file encryption.

Note, not all "encrypted" access databases actually require passwords in order to be opened. Many older forms of access "encryption" ("obfuscation" would be a better term) include the keys within the access file itself. If required, a password can be provided in one of two ways:

• If a PasswordCallback or Supplier has been provided (via the constructor or setPasswordCallback(com.healthmarketscience.jackcess.crypt.PasswordCallback)), then PasswordCallback.getPassword() will be invoked to retrieve the necessary password
• If no password callback has been configured, then getPassword() will be invoked directly on the CryptCodecProvider (which will return the password configured via the constructor or setPassword(java.lang.String))

Author:

Vladimir Berezniker

Constructor Summary

Constructors

Constructor and Description
CryptCodecProvider()
CryptCodecProvider(PasswordCallback callback)
CryptCodecProvider(String password)
CryptCodecProvider(Supplier<String> callback)

Method Summary

Modifier and Type	Method and Description
com.healthmarketscience.jackcess.impl.CodecHandler	createHandler(com.healthmarketscience.jackcess.impl.PageChannel channel, Charset charset)
String	getPassword() Invoked by CryptCodecProvider when a password is necessary to open an access database.
PasswordCallback	getPasswordCallback()
Supplier<String>	getPasswordSupplier()
CryptCodecProvider	setPassword(String newPassword)
CryptCodecProvider	setPasswordCallback(PasswordCallback newCallback)
CryptCodecProvider	setPasswordSupplier(Supplier<String> newCallback)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.healthmarketscience.jackcess.crypt.PasswordCallback

get

Constructor Detail

CryptCodecProvider

public CryptCodecProvider()

CryptCodecProvider

public CryptCodecProvider(String password)

CryptCodecProvider

public CryptCodecProvider(PasswordCallback callback)

CryptCodecProvider

public CryptCodecProvider(Supplier<String> callback)

Method Detail

getPassword

public String getPassword()

Description copied from interface: PasswordCallback

Invoked by CryptCodecProvider when a password is necessary to open an access database.

Specified by:

getPassword in interface PasswordCallback

Returns:

the required password

setPassword

public CryptCodecProvider setPassword(String newPassword)

getPasswordCallback

public PasswordCallback getPasswordCallback()

getPasswordSupplier

public Supplier<String> getPasswordSupplier()

setPasswordCallback

public CryptCodecProvider setPasswordCallback(PasswordCallback newCallback)

setPasswordSupplier

public CryptCodecProvider setPasswordSupplier(Supplier<String> newCallback)

createHandler

public com.healthmarketscience.jackcess.impl.CodecHandler createHandler(com.healthmarketscience.jackcess.impl.PageChannel channel,
                                                                        Charset charset)
                                                                 throws IOException

Specified by:

createHandler in interface com.healthmarketscience.jackcess.impl.CodecProvider

Throws:

IOException