de.slackspace.openkeepass

Class KeePassDatabase

java.lang.Object

de.slackspace.openkeepass.KeePassDatabase

public class KeePassDatabase
extends Object

A KeePassDatabase is the central API class to read a KeePass database file.

Currently the following KeePass files are supported:

• KeePass Database V2 with password
• KeePass Database V2 with keyfile

A typical use-case should use the following idiom:

 // open database 
 KeePassFile database = KeePassDatabase.getInstance("keePassDatabasePath").openDatabase("secret");
 
 // get password entries 
 List<Entry> entries = database.getEntries();
 ...
 

If the database could not be opened a RuntimeException will be thrown.

See Also:

KeePassFile

Field Summary

Fields

Modifier and Type	Field and Description
protected Decrypter	decrypter
protected KeePassDatabaseXmlParser	keePassDatabaseXmlParser
protected KeyFileXmlParser	keyFileXmlParser
static int	VERSION_SIGNATURE_LENGTH

Method Summary

Modifier and Type	Method and Description
KeePassHeader	getHeader() Gets the KeePassDatabase header.
static KeePassDatabase	getInstance(File keePassDatabaseFile) Retrieves a KeePassDatabase instance.
static KeePassDatabase	getInstance(InputStream keePassDatabaseStream) Retrieves a KeePassDatabase instance.
static KeePassDatabase	getInstance(String keePassDatabaseFile) Retrieves a KeePassDatabase instance.
KeePassFile	openDatabase(File keyFile) Opens a KeePass database with the given password and returns the KeePassFile for further processing.
KeePassFile	openDatabase(InputStream keyFileStream) Opens a KeePass database with the given keyfile stream and returns the KeePassFile for further processing.
KeePassFile	openDatabase(String password) Opens a KeePass database with the given password and returns the KeePassFile for further processing.

Methods inherited from class java.lang.Object

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

Field Detail

VERSION_SIGNATURE_LENGTH

public static final int VERSION_SIGNATURE_LENGTH

See Also:

Constant Field Values

decrypter

protected Decrypter decrypter

keePassDatabaseXmlParser

protected KeePassDatabaseXmlParser keePassDatabaseXmlParser

keyFileXmlParser

protected KeyFileXmlParser keyFileXmlParser

Method Detail

getInstance

public static KeePassDatabase getInstance(String keePassDatabaseFile)

Retrieves a KeePassDatabase instance. The instance returned is based on the given database filename and tries to parse the database header of it.

Parameters:

keePassDatabaseFile - a KeePass database filename, must not be NULL

Returns:

a KeePassDatabase

getInstance

public static KeePassDatabase getInstance(File keePassDatabaseFile)

Retrieves a KeePassDatabase instance. The instance returned is based on the given database file and tries to parse the database header of it.

Parameters:

keePassDatabaseFile - a KeePass database file, must not be NULL

Returns:

a KeePassDatabase

getInstance

public static KeePassDatabase getInstance(InputStream keePassDatabaseStream)

Retrieves a KeePassDatabase instance. The instance returned is based on the given input stream and tries to parse the database header of it.

Parameters:

keePassDatabaseStream - an input stream of a KeePass database, must not be NULL

Returns:

a KeePassDatabase

openDatabase

public KeePassFile openDatabase(String password)

Opens a KeePass database with the given password and returns the KeePassFile for further processing.

If the database cannot be decrypted with the provided password an exception will be thrown.

Parameters:

password - the password to open the database

Returns:

a KeePassFile

See Also:

KeePassFile

openDatabase

public KeePassFile openDatabase(File keyFile)

Opens a KeePass database with the given password and returns the KeePassFile for further processing.

If the database cannot be decrypted with the provided password an exception will be thrown.

Parameters:

keyFile - the password to open the database

Returns:

a KeePassFile the keyfile to open the database

See Also:

KeePassFile

openDatabase

public KeePassFile openDatabase(InputStream keyFileStream)

Opens a KeePass database with the given keyfile stream and returns the KeePassFile for further processing.

If the database cannot be decrypted with the provided keyfile an exception will be thrown.

Parameters:

keyFileStream - the keyfile to open the database as stream

Returns:

a KeePassFile

See Also:

KeePassFile

getHeader

public KeePassHeader getHeader()

Gets the KeePassDatabase header.

Returns:

the database header