de.uni_koblenz.aggrimm.icp.crypto.sign.graph

Class Triple

java.lang.Object

de.uni_koblenz.aggrimm.icp.crypto.sign.graph.Triple

All Implemented Interfaces:

Comparable<Triple>

public class Triple
extends Object
implements Comparable<Triple>

A (RDF) triple or statement consists of a subject, a predicate and an object. A hash value and an annotation can be saved as well (used by some but not all algorithms). Properties of subject/predicate/object: - Subjects and objects can either be IRIs, blank nodes or literals - Predicates can only be IRIs or "a" ("a" equals "") - IRIs always start with "<" and end with ">" unless they are using a prefix - Prefixed IRIs start with a prefix string followed by a colon (":") and a suffix string (no whitespaces in any of those) - Prefixed IRIs may have no prefix and/or no suffix (so the shortest possible prefixed IRI is just a colon) - Prefixed IRIs are commonly resolved after loading a graph and applied again before saving it - Blank nodes start with _: followed by an identifier string (no whitespaces in the identifier string) - Literals always start with double quotes - Literals end with double quotes but may have one language ("^^") and/or one datatype ("@") attachment - Language attachments are introduced with "^^" directly after the ending double quotes or data type attachments (no whitespaces) - Data type attachments are introduced with "@" directly after the ending double quotes or language attachments (no whitespaces) - Language and data type attachments cannot contain any whitespaces (whitespaces are used during parsing to end them)

Author:

Peter Schauß

Field Summary

Fields

Modifier and Type	Field and Description
static int	annotation
static int	object
static int	predicate
static int	subject

Constructor Summary

Constructors

Constructor and Description
Triple(String subject, String predicate, String object) Constructor: Create new triple from subject/predicate/object strings (annotation will be empty)
Triple(String subject, String predicate, String object, String annotation) Constructor: Create new triple from subject/predicate/object/annotation strings

Method Summary

Modifier and Type	Method and Description
void	applyPrefixes(LinkedList<Prefix> pre) Apply Prefixes to triple - replaces IRIs with prefixes
int	compareTo(Triple t) Compare this triple with another triple used for sorting, lexicographic order, ignores annotations
boolean	equals(Object o) Checks if this triple is equal to another triple
String	getAnnotation()
String	getByIndex(int index) Get subject/predicate/object/annotation by integer index
BigInteger	getHash()
String	getObject()
String	getPredicate()
String	getSubject()
boolean	isSPOequal(String[] triple) Are subject, predicate and object equal (don't check the annotation)?
boolean	isSPOequal(Triple t) Are subject, predicate and object equal (don't check the annotation)?
boolean	isValid() Checks if tripel is well-formed
void	resolvePrefixes(LinkedList<Prefix> pre) Resolve Prefixes in triple - replaces prefixes with IRIs
void	setAnnotation(String annotation)
void	setByIndex(int index, String value) Set subject/predicate/object/annotation by integer index
void	setHash(BigInteger hash)
void	setObject(String object)
void	setPredicate(String predicate)
void	setSubject(String subject)
String	toString() Converts triple to a string (used for printing and debugging)

Methods inherited from class java.lang.Object

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

Field Detail

subject

public static final int subject

See Also:

Constant Field Values

predicate

public static final int predicate

See Also:

Constant Field Values

object

public static final int object

See Also:

Constant Field Values

annotation

public static final int annotation

See Also:

Constant Field Values

Constructor Detail

Triple

public Triple(String subject,
              String predicate,
              String object)

Constructor: Create new triple from subject/predicate/object strings (annotation will be empty)

Parameters:

subject -

predicate -

object -

Triple

public Triple(String subject,
              String predicate,
              String object,
              String annotation)

Constructor: Create new triple from subject/predicate/object/annotation strings

Parameters:

subject -

predicate -

object -

annotation -

Method Detail

getSubject

public String getSubject()

setSubject

public void setSubject(String subject)

getPredicate

public String getPredicate()

setPredicate

public void setPredicate(String predicate)

getObject

public String getObject()

setObject

public void setObject(String object)

getAnnotation

public String getAnnotation()

setAnnotation

public void setAnnotation(String annotation)

getByIndex

public String getByIndex(int index)

Get subject/predicate/object/annotation by integer index

Parameters:

index - 0=subject, 1=predicate, 2=object, 3=annotation

Returns:

subject/predicate/object/annotation as string

setByIndex

public void setByIndex(int index,
                       String value)

Set subject/predicate/object/annotation by integer index

Parameters:

index -

value -

getHash

public BigInteger getHash()

setHash

public void setHash(BigInteger hash)

isSPOequal

public boolean isSPOequal(Triple t)

Are subject, predicate and object equal (don't check the annotation)?

Parameters:

t - Triple which is compared with this triple

Returns:

true if subject, predicate and object of both triples are equal, false otherwise

isSPOequal

public boolean isSPOequal(String[] triple)

Are subject, predicate and object equal (don't check the annotation)?

Parameters:

triple - Triple (specified as string array) which is compared with this triple

Returns:

true if subject, predicate and object of both triples are equal, false otherwise

isValid

public boolean isValid()
                throws Exception

Checks if tripel is well-formed

Returns:

true if triple is well-formed

Throws:

Exception - if triple is malformed

resolvePrefixes

public void resolvePrefixes(LinkedList<Prefix> pre)

Resolve Prefixes in triple - replaces prefixes with IRIs

Parameters:

pre -

applyPrefixes

public void applyPrefixes(LinkedList<Prefix> pre)

Apply Prefixes to triple - replaces IRIs with prefixes

Parameters:

pre -

toString

public String toString()

Converts triple to a string (used for printing and debugging)

Overrides:

toString in class Object

Returns:

string representation

compareTo

public int compareTo(Triple t)

Compare this triple with another triple used for sorting, lexicographic order, ignores annotations

Specified by:

compareTo in interface Comparable<Triple>

Parameters:

t - triple to compare with

Returns:

value expressing relation of the triples

equals

public boolean equals(Object o)

Checks if this triple is equal to another triple

Overrides:

equals in class Object

Parameters:

o - Triple to compare with

Returns:

true if equal, false otherwise