org.protempa.proposition

Interface Proposition

All Superinterfaces:

PropositionCheckedVisitable, PropositionVisitable

All Known Subinterfaces:

Parameter

All Known Implementing Classes:

AbstractParameter, AbstractProposition, Constant, Context, Event, PrimitiveParameter, TemporalParameter, TemporalProposition

public interface Proposition
extends PropositionVisitable, PropositionCheckedVisitable

A data element. All implementations of this have property change support methods, but no change events are fired at present. In Proposition, the equals() method is used to compare two instances of Proposition. Two propositions are equal if they have the same datasource backend id, and unique identifier. If either instance has a null datasource backend id, or null unique identifier, a object refernce check is made for equality.

Author:

Andrew Post

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener l) Adds a PropertyChangeListener to the listener list.
Date	getCreateDate() Gets the date this proposition was created in the source system, or for derived propositions, the date it was created through the temporal abstraction process.
Date	getDeleteDate() Gets the date this proposition was deleted from the source system, or for derived propositions, the date it was invalidated due to data changes.
Date	getDownloadDate() Gets the date this proposition was downloaded from the source system.
String	getId() Gets this proposition's data type.
Value	getProperty(String name) Gets the value of the specified property.
String[]	getPropertyNames() Get the property names for the proposition
String[]	getReferenceNames() Get the reference names for the proposition
List<UniqueId>	getReferences(String name) Gets the global unique identifiers for the propositions that have the specified 1:N relationship with this proposition.
SourceSystem	getSourceSystem() Returns the data source type of the Proposition.
UniqueId	getUniqueId() Gets this proposition's global unique identifier.
Date	getUpdateDate() Gets the date this proposition was last updated in the source system, or for derived propositions, the date it was last updated through the temporal abstraction process.
boolean	isEqual(Object prop) Determines if the specified object is a Proposition and has the same field values as this proposition.
void	removePropertyChangeListener(PropertyChangeListener l) Removes a PropertyChangeListener from the listener list.

Methods inherited from interface org.protempa.proposition.visitor.PropositionVisitable

accept

Methods inherited from interface org.protempa.proposition.visitor.PropositionCheckedVisitable

acceptChecked

Method Detail

getId

String getId()

Gets this proposition's data type.

Returns:

the identification String for the type of data represented by this proposition.

getSourceSystem

SourceSystem getSourceSystem()

Returns the data source type of the Proposition.

Returns:

a SourceSystem.

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener l)

Adds a PropertyChangeListener to the listener list. The listener is registered for all bound properties of this class (none at present). If listener is null, no exception is thrown and no action is performed.

Parameters:

l - the PropertyChangeListener to be added.

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener l)

Removes a PropertyChangeListener from the listener list. This method should be used to remove PropertyChangeListeners that were registered for all bound properties of this class. If listener is null, no exception is thrown and no action is performed.

Parameters:

l - the PropertyChangeListener to be removed

isEqual

boolean isEqual(Object prop)

Determines if the specified object is a Proposition and has the same field values as this proposition.

Parameters:

prop - an Object.

Returns:

true if the specified object is a Proposition and has the same field values, false otherwise.

getProperty

Value getProperty(String name)

Gets the value of the specified property.

Parameters:

name - the name String of a valid property. Cannot be null.

Returns:

the Value of the specified property.

getReferences

List<UniqueId> getReferences(String name)

Gets the global unique identifiers for the propositions that have the specified 1:N relationship with this proposition.

Parameters:

name - the name of the relationship. Cannot be null.

Returns:

a List of global unique identifiers. Guaranteed not null.

See Also:

to get the propositions with the specified relationship.

getPropertyNames

String[] getPropertyNames()

Get the property names for the proposition

Returns:

an array containing the names of all the properties contained

getReferenceNames

String[] getReferenceNames()

Get the reference names for the proposition

Returns:

an array containing the names of all the references contained

getUniqueId

UniqueId getUniqueId()

Gets this proposition's global unique identifier.

Returns:

a UniqueIdentifier.

getDownloadDate

Date getDownloadDate()

Gets the date this proposition was downloaded from the source system. If this proposition was derived, gets the date it was derived.

Returns:

a date, null if the proposition was not downloaded from a source system.

getCreateDate

Date getCreateDate()

Gets the date this proposition was created in the source system, or for derived propositions, the date it was created through the temporal abstraction process.

Returns:

a date, null means the create date is not recorded.

getUpdateDate

Date getUpdateDate()

Gets the date this proposition was last updated in the source system, or for derived propositions, the date it was last updated through the temporal abstraction process.

Returns:

a date, null means the proposition has never been updated.

getDeleteDate

Date getDeleteDate()

Gets the date this proposition was deleted from the source system, or for derived propositions, the date it was invalidated due to data changes.

Returns:

a date, or null if the proposition has not been deleted.