io.konig.core

Interface Edge

All Superinterfaces:

Cloneable, Serializable, org.openrdf.model.Statement

All Known Implementing Classes:

EdgeImpl

public interface Edge
extends org.openrdf.model.Statement, Cloneable

A reified statement that can have properties of its own. These properties are called annotations.

Author:

Greg McFall

Method Summary

Modifier and Type	Method and Description
Edge	addAnnotation(org.openrdf.model.URI predicate, org.openrdf.model.Value value) Add an annotation value to the Edge.
void	copyAnnotations(Edge edge) Copy the annotation properties from another edge into this Edge.
org.openrdf.model.Value	getAnnotation(org.openrdf.model.URI predicate) Get an annotation property of this edge.
ValueSet	getAnnotationSet(org.openrdf.model.URI predicate) Get the values of a specific annotation property as a ValueSet.
boolean	matches(org.openrdf.model.Value a, org.openrdf.model.Value b) A convenience function which tests whether two values are equal, or one is contained in the other.
org.openrdf.model.Value	removeAnnotation(org.openrdf.model.URI predicate) Remove the specified annotation property from the Edge.
Edge	setAnnotation(org.openrdf.model.URI predicate, org.openrdf.model.Value value) Set an annotation property of this edge.

Methods inherited from interface org.openrdf.model.Statement

equals, getContext, getObject, getPredicate, getSubject, hashCode

Method Detail

getAnnotation

org.openrdf.model.Value getAnnotation(org.openrdf.model.URI predicate)

Get an annotation property of this edge.

Parameters:

predicate - The predicate that identifies the annotation whose value is to be returned.

Returns:

The value of the specified annotation property. If the specified annotation property has multiple values, a ValueSet that contains all of the values will be returned. Otherwise, a single discrete value will be returned, or null if there is no value for the specified annotation.

setAnnotation

Edge setAnnotation(org.openrdf.model.URI predicate,
                   org.openrdf.model.Value value)

Set an annotation property of this edge. This method overwrites any previous value for the annotation property. If the previous value was a ValueSet, then the entire set is replaced with the supplied value.

Parameters:

predicate - The predicate that identifies the annotation property to be set

value - The value of the annotation property to be set.

removeAnnotation

org.openrdf.model.Value removeAnnotation(org.openrdf.model.URI predicate)

Remove the specified annotation property from the Edge. If the current value is a ValueSet, the entire set of values is removed.

Parameters:

predicate - The predicate that names the annotation to be removed

Returns:

The value of the annotation property that was removed, or null if there was no such annotation property.

copyAnnotations

void copyAnnotations(Edge edge)

Copy the annotation properties from another edge into this Edge.

Parameters:

edge - The edge from which annotations will be copied

getAnnotationSet

ValueSet getAnnotationSet(org.openrdf.model.URI predicate)

Get the values of a specific annotation property as a ValueSet.

Parameters:

predicate - The predicate that names the annotation property

Returns:

A ValueSet containing all the values of the specified annotation. If there are no such values an empty set is returned.

addAnnotation

Edge addAnnotation(org.openrdf.model.URI predicate,
                   org.openrdf.model.Value value)

Add an annotation value to the Edge.

Parameters:

predicate - The predicate that names the annotation property

value - The value of the annotation property.

Returns:

This edge.

matches

boolean matches(org.openrdf.model.Value a,
                org.openrdf.model.Value b)

A convenience function which tests whether two values are equal, or one is contained in the other.

Parameters:

a - A discrete Value (Resource or Literal) or a ValueSet

b - Another discrete Value (Resource or Literal) or a ValueSet

Returns:

True if a and b are equal, or a is contained in b, or b is contained in a.