org.linqs.psl.database.atom

Class PersistedAtomManager

java.lang.Object

org.linqs.psl.database.atom.AtomManager

org.linqs.psl.database.atom.PersistedAtomManager

Direct Known Subclasses:

LazyAtomManager

public class PersistedAtomManager
extends AtomManager

Implements the AtomManager with a twist: this AtomManager will only return RandomVariableAtoms that were persisted in the Database at instantiation. All other types of Atoms are returned normally. getAtom() is thread-safe.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PersistedAtomManager.PersistedAccessException

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONFIG_PREFIX Prefix of property keys used by this class.
protected Set<RandomVariableAtom>	persistedCache The set of all persisted RandomVariableAtoms at the time of this AtomManager's instantiation.
static boolean	THROW_ACCESS_EXCEPTION_DEFAULT
static String	THROW_ACCESS_EXCEPTION_KEY Whether or not to throw an exception on illegal access.

Fields inherited from class org.linqs.psl.database.atom.AtomManager

db

Constructor Summary

Constructors

Constructor and Description
PersistedAtomManager(Database db) Constructs a PersistedAtomManager with a built-in set of all the database's persisted RandomVariableAtoms.

Method Summary

Modifier and Type	Method and Description
protected void	addToPersistedCache(Set<RandomVariableAtom> atoms)
void	commitPersistedAtoms() Commit all the atoms in this manager's persisted cache.
GroundAtom	getAtom(Predicate predicate, Constant... arguments) Returns the GroundAtom for the given Predicate and GroundTerms.
Set<RandomVariableAtom>	getPersistedRVAtoms()

Methods inherited from class org.linqs.psl.database.atom.AtomManager

executeGroundingQuery, executeQuery, getDatabase, isClosed

Methods inherited from class java.lang.Object

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

Field Detail

CONFIG_PREFIX

public static final String CONFIG_PREFIX

Prefix of property keys used by this class.

See Also:

Constant Field Values

THROW_ACCESS_EXCEPTION_KEY

public static final String THROW_ACCESS_EXCEPTION_KEY

Whether or not to throw an exception on illegal access. Note that in most cases, this indicates incorrectly formed data. This should only be set to true when the user understands why these exceptions are thrown in the first place and the grounding implications of not having the atom initially in the database.

See Also:

Constant Field Values

THROW_ACCESS_EXCEPTION_DEFAULT

public static final boolean THROW_ACCESS_EXCEPTION_DEFAULT

See Also:

Constant Field Values

persistedCache

protected final Set<RandomVariableAtom> persistedCache

The set of all persisted RandomVariableAtoms at the time of this AtomManager's instantiation.

Constructor Detail

PersistedAtomManager

public PersistedAtomManager(Database db)

Constructs a PersistedAtomManager with a built-in set of all the database's persisted RandomVariableAtoms.

Parameters:

db - the Database to query for all getAtom() calls.

Method Detail

getAtom

public GroundAtom getAtom(Predicate predicate,
                          Constant... arguments)

Description copied from class: AtomManager

Returns the GroundAtom for the given Predicate and GroundTerms. This method must call ReadableDatabase.getAtom(Predicate, Constant...) to actually retrieve the GroundAtom.

Specified by:

getAtom in class AtomManager

Parameters:

predicate - the Predicate of the Atom

arguments - the GroundTerms of the Atom

Returns:

the Atom

commitPersistedAtoms

public void commitPersistedAtoms()

Commit all the atoms in this manager's persisted cache.

getPersistedRVAtoms

public Set<RandomVariableAtom> getPersistedRVAtoms()

addToPersistedCache

protected void addToPersistedCache(Set<RandomVariableAtom> atoms)