com.healthmarketscience.jackcess

Class CryptCodecProvider

java.lang.Object

com.healthmarketscience.jackcess.CryptCodecProvider

All Implemented Interfaces:

com.healthmarketscience.jackcess.impl.CodecProvider, PasswordCallback

public class CryptCodecProvider
extends java.lang.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 has been provided (via the constructor or setPasswordCallback(com.healthmarketscience.jackcess.PasswordCallback)), then PasswordCallback.getPassword() will be invoked to retrieve the necessary password
• If no PasswordCallback 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))

Field Summary

Fields

Modifier and Type	Field and Description
private PasswordCallback	_callback
private java.lang.String	_password

Constructor Summary

Constructors

Modifier	Constructor and Description
	CryptCodecProvider()
	CryptCodecProvider(PasswordCallback callback)
	CryptCodecProvider(java.lang.String password)
private	CryptCodecProvider(java.lang.String password, PasswordCallback callback)

Method Summary

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

Methods inherited from class java.lang.Object

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

Field Detail

_password

private java.lang.String _password

_callback

private PasswordCallback _callback

Constructor Detail

CryptCodecProvider

public CryptCodecProvider()

CryptCodecProvider

public CryptCodecProvider(java.lang.String password)

CryptCodecProvider

public CryptCodecProvider(PasswordCallback callback)

CryptCodecProvider

private CryptCodecProvider(java.lang.String password,
                           PasswordCallback callback)

Method Detail

getPassword

public java.lang.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(java.lang.String newPassword)

getPasswordCallback

public PasswordCallback getPasswordCallback()

setPasswordCallback

public CryptCodecProvider setPasswordCallback(PasswordCallback newCallback)

createHandler

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

Specified by:

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

Throws:

java.io.IOException