org.apache.marmotta.kiwi.model.rdf

Class KiWiTriple

java.lang.Object

org.apache.marmotta.kiwi.model.rdf.KiWiTriple

All Implemented Interfaces:

Serializable, org.openrdf.model.Statement

public class KiWiTriple
extends Object
implements org.openrdf.model.Statement, Serializable

KiWiTriples are one of the core concepts of the KiWi system. They correspond to triples in RDF, but extend them with additional information that is useful and/or needed in the KiWi system, for example author information, version information, justifications (in case of inferred triples), etc. Like a KiWiResource, each triple is associated with a single TripleStore. All triples together essentially make up the TripleStore. As with KiWiResources, this means that there is no 1:1 correspondence between RDF triples and KiWi triples. An RDF triple may be represented by several KiWi triples in different KnowledgeSpaces.

Base/inferred flags denote the status of support of a triple:

• base=true, inferred=true means the triple is both explicit and supported by a rule
• base=false, inferred=true means triple is supported by a rule but not explicit
• base=true, inferred=false means triple is only explicit
• base=false, inferred=false does not exist

Only triples where base=true can be deleted using TripleStore.removeTriple; triples with base=false and inferred=true are managed by the reasoner.

Author:

Sebastian Schaffert

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
KiWiTriple()
KiWiTriple(Date created)
KiWiTriple(KiWiResource subject, KiWiUriResource predicate, KiWiNode object, KiWiResource context)
KiWiTriple(KiWiResource subject, KiWiUriResource predicate, KiWiNode object, KiWiResource context, Date created)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object o)
KiWiResource	getContext() Get the unique triple identifier of this extended triple.
Date	getCreated()
KiWiResource	getCreator() Return the author of this extended triple.
Date	getDeletedAt() Return the date the triple has been deleted, or null in case the triple is not deleted
long	getId()
String	getKey() Return a unique key to be used in caches and similar.
KiWiNode	getObject() Get the object of this extended triple.
KiWiUriResource	getPredicate() Get the property of this extended triple.
KiWiResource	getSubject() Get the subject of this extended triple.
int	hashCode()
boolean	isDeleted()
boolean	isInferred()
boolean	isNewTriple()
void	setContext(KiWiResource context) Set the unique triple identifier of this extended triple to the provided KiWiUriResource.
void	setCreated(Date created)
void	setCreator(KiWiResource author) Set the author of this extended triple.
void	setDeleted(boolean deleted)
void	setDeletedAt(Date deletedAt) Set the date the triple has been deleted.
void	setId(long id)
void	setInferred(boolean inferred)
void	setNewTriple(boolean newTriple)
void	setObject(KiWiNode object) Set the object of this extended triple to the given KiWiNode (either a resource or a literal)
void	setPredicate(KiWiUriResource property) Set the property of this extended triple.
void	setSubject(KiWiResource subject) Set the subject of this extended triple to the provided KiWiResource
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

KiWiTriple

public KiWiTriple()

KiWiTriple

public KiWiTriple(Date created)

KiWiTriple

public KiWiTriple(KiWiResource subject,
          KiWiUriResource predicate,
          KiWiNode object,
          KiWiResource context)

KiWiTriple

public KiWiTriple(KiWiResource subject,
          KiWiUriResource predicate,
          KiWiNode object,
          KiWiResource context,
          Date created)

Method Detail

getObject

public KiWiNode getObject()

Get the object of this extended triple.

Specified by:

getObject in interface org.openrdf.model.Statement

Returns:

setObject

public void setObject(KiWiNode object)

Set the object of this extended triple to the given KiWiNode (either a resource or a literal)

Parameters:

object -

getPredicate

public KiWiUriResource getPredicate()

Get the property of this extended triple. Always a KiWiUriResource.

Specified by:

getPredicate in interface org.openrdf.model.Statement

Returns:

setPredicate

public void setPredicate(KiWiUriResource property)

Set the property of this extended triple. Always needs to be a KiWiUriResource

Parameters:

property -

getSubject

public KiWiResource getSubject()

Get the subject of this extended triple. Always a resource.

Specified by:

getSubject in interface org.openrdf.model.Statement

Returns:

setSubject

public void setSubject(KiWiResource subject)

Set the subject of this extended triple to the provided KiWiResource

Parameters:

subject -

getContext

public KiWiResource getContext()

Get the unique triple identifier of this extended triple. Returns a KiWiUriResource identifying this triple.

Specified by:

getContext in interface org.openrdf.model.Statement

Returns:

setContext

public void setContext(KiWiResource context)

Set the unique triple identifier of this extended triple to the provided KiWiUriResource. The caller needs to ensure that the tripleId is unique over the KiWi system; otherwise, the system might not function correctly.

Parameters:

context -

getCreator

public KiWiResource getCreator()

Return the author of this extended triple. Internally, this is determined using the tripleId of the extended triple and looking it up in the database.

Returns:

setCreator

public void setCreator(KiWiResource author)

Set the author of this extended triple. Changes will be persisted as part of the database using the tripleId as unique identifier.

Parameters:

author -

getCreated

public Date getCreated()

Returns:

the created

setCreated

public void setCreated(Date created)

Parameters:

created - the created to set

getDeletedAt

public Date getDeletedAt()

Return the date the triple has been deleted, or null in case the triple is not deleted

Returns:

setDeletedAt

public void setDeletedAt(Date deletedAt)

Set the date the triple has been deleted.

Parameters:

deletedAt -

getId

public long getId()

Returns:

the id

setId

public void setId(long id)

Parameters:

id - the id to set

isDeleted

public boolean isDeleted()

Returns:

the deleted

setDeleted

public void setDeleted(boolean deleted)

Parameters:

deleted - the deleted to set

equals

public boolean equals(Object o)

Specified by:

equals in interface org.openrdf.model.Statement

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface org.openrdf.model.Statement

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

getKey

public String getKey()

Return a unique key to be used in caches and similar.

Returns:

isInferred

public boolean isInferred()

setInferred

public void setInferred(boolean inferred)

isNewTriple

public boolean isNewTriple()

setNewTriple

public void setNewTriple(boolean newTriple)