org.linguafranca.pwdb

Interface Database<D extends Database<D,G,E,I>,G extends Group<D,G,E,I>,E extends Entry<D,G,E,I>,I extends Icon>

All Known Implementing Classes:

AbstractDatabase

public interface Database<D extends Database<D,G,E,I>,G extends Group<D,G,E,I>,E extends Entry<D,G,E,I>,I extends Icon>

Interface for a password database consisting of Groups, sub-Groups and Entries. A database is arranged as a tree starting from the root group, with entries allowed as children of any group.

A database is a factory for new Groups and Entries. Groups and entries belonging to one database cannot in general be added to another database, they need to be imported using newGroup(Group) and newEntry(Entry), or implicitly imported using Group.addGroup(Group) which automatically create Groups and Entries (as well as importing sub groups and their entries). Group.addEntry(Entry) allows arbitrary importing from other databases.

Databases may be navigated directly from the root getRootGroup(), or using a Visitor and visit(Visitor) or visit(Group, Visitor) to start the visit at a particular group.

A list of entries that match a string or some custom criteria may be obtained using the findEntries(Entry.Matcher) and findEntries(String) methods.

To match (optionally recursively) entries in a Group use Group.findEntries(String, boolean) or Group.findEntries(Entry.Matcher, boolean).

All Lists provided returned by methods of all interfaces may be modified by the caller without affecting the underlying database structure, however changes to the Groups and Entries contained in the lists do modify the database.

Method Summary

Modifier and Type	Method and Description
List<? extends E>	findEntries(Entry.Matcher matcher) Find all entries that match the criteria
List<? extends E>	findEntries(String find) Find all entries that match Entry.match(String)
String	getDescription() Gets the database description, if there is one
String	getName() Gets the name of the database or null if not supported
G	getRootGroup() get the root group for the database
boolean	isDirty() True if database been modified
E	newEntry() Create a new Entry
E	newEntry(Entry<?,?,?,?> entry) Create a new Entry copying the details of the supplied entry
E	newEntry(String title) Create a new Entry with a title
G	newGroup() Create a new Group
G	newGroup(Group group) Create a new Group copying the details of the supplied group, but not copying its children
G	newGroup(String name) Create a new named Group
I	newIcon() Create a new default icon
I	newIcon(Integer i) Create a new icon with a specified index
void	save(Credentials credentials, OutputStream outputStream) Save the database to a stream
void	setDescription(String description) Sets the database description if it is supported
void	setName(String name) Set the name of the database if this is supported
boolean	shouldProtect(String propertyName) Properties to encrypt
void	visit(G group, Visitor visitor) Visit all entries starting from a group
void	visit(Visitor visitor) Visit all entries

Method Detail

getRootGroup

G getRootGroup()

get the root group for the database

Returns:

the root group

newGroup

G newGroup()

Create a new Group

Returns:

the group created

newGroup

G newGroup(String name)

Create a new named Group

Parameters:

name - the name of the group

Returns:

the group created

newGroup

G newGroup(Group group)

Create a new Group copying the details of the supplied group, but not copying its children

Used for copying a group from one database to another

Parameters:

group - the group to copy

Returns:

the group created

newEntry

E newEntry()

Create a new Entry

Returns:

the entry created

newEntry

E newEntry(String title)

Create a new Entry with a title

Returns:

the entry created

newEntry

E newEntry(Entry<?,?,?,?> entry)

Create a new Entry copying the details of the supplied entry

Used for copying an entry from one database to another

Parameters:

entry - the entry to copy

Returns:

the entry created

newIcon

I newIcon()

Create a new default icon

Returns:

the created icon

newIcon

I newIcon(Integer i)

Create a new icon with a specified index

Parameters:

i - the index of the icon to create

Returns:

the created icon

visit

void visit(Visitor visitor)

Visit all entries

Parameters:

visitor - the visitor to use

visit

void visit(G group,
           Visitor visitor)

Visit all entries starting from a group

Parameters:

group - the group to start at

visitor - the visitor to use

findEntries

List<? extends E> findEntries(Entry.Matcher matcher)

Find all entries that match the criteria

Parameters:

matcher - the matcher to use

Returns:

a list of entries

findEntries

List<? extends E> findEntries(String find)

Find all entries that match Entry.match(String)

Parameters:

find - string to find

Returns:

a list of entries

getName

String getName()

Gets the name of the database or null if not supported

Returns:

a database name

setName

void setName(String name)

Set the name of the database if this is supported

Parameters:

name - the name

getDescription

String getDescription()

Gets the database description, if there is one

Returns:

the description or null if not supported

setDescription

void setDescription(String description)

Sets the database description if it is supported

Parameters:

description - a description of the database

isDirty

boolean isDirty()

True if database been modified

save

void save(Credentials credentials,
          OutputStream outputStream)
   throws IOException

Save the database to a stream

Throws:

IOException

shouldProtect

boolean shouldProtect(String propertyName)

Properties to encrypt

Parameters:

propertyName - the property of interest

Returns:

true if it should be encrypted