com.epimorphics.lda.renderers.common

Class PropertyPath

java.lang.Object

com.epimorphics.lda.renderers.common.PropertyPath

public class PropertyPath
extends Object

A basic encapsulation of LDA property paths as represented in the metadata for a page.

Author:

Ian Dickinson, Epimorphics (mailto:ian@epimorphics.com)

Field Summary

Fields

Modifier and Type	Field and Description
static com.hp.hpl.jena.rdf.model.Property	STAR A fake property to denote the star operator in a property path

Constructor Summary

Constructors

Modifier	Constructor and Description
	PropertyPath() Construct the empty path.
protected	PropertyPath(PropertyPath parent, String shortName, com.hp.hpl.jena.rdf.model.Property uri) Construct a new property path by adding a segment to the given path
	PropertyPath(String path) Construct a new path from an encoded path string.
	PropertyPath(String[] segments) Construct a new path from an array of the shortName segments

Method Summary

Methods

Modifier and Type	Method and Description
PropertyPath	append(String shortName, String uri, ShortNameRenderer snr) Return a new property path with a new segment at the end
boolean	beginsWith(com.hp.hpl.jena.rdf.model.Property p, ShortNameRenderer snr) Return true if the given property matches the first segment in the path - either because the path's shortname expands to the property URI, or because the first segment of the path is *.
int	size()
com.hp.hpl.jena.rdf.model.Property	terminal()
String	toHTMLString()
protected String	tokeniseWords(String name) Tokenise the input string into words based on camelCase boundaries and hyphen characters.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

STAR

public static final com.hp.hpl.jena.rdf.model.Property STAR

A fake property to denote the star operator in a property path

Constructor Detail

PropertyPath

public PropertyPath(String path)

Construct a new path from an encoded path string.

Parameters:

path - A path encoded in shortName[.shortName]* form

PropertyPath

public PropertyPath(String[] segments)

Construct a new path from an array of the shortName segments

Parameters:

segments - The segments of the path as an array

Throws:

IllegalArgumentException - if the segments array is null or empty

PropertyPath

public PropertyPath()

Construct the empty path. This is the only sanctioned way to create an empty path - passing null or empty string into other constructors is not allowed.

PropertyPath

protected PropertyPath(PropertyPath parent,
            String shortName,
            com.hp.hpl.jena.rdf.model.Property uri)

Construct a new property path by adding a segment to the given path

Method Detail

toString

public String toString()

Overrides:

toString in class Object

Returns:

A string denoting the path in infix form, with dot separators.

toHTMLString

public String toHTMLString()

Returns:

A string denoting this path in a form suitable for HTML presentation

size

public int size()

Returns:

The number of segments in the path

beginsWith

public boolean beginsWith(com.hp.hpl.jena.rdf.model.Property p,
                 ShortNameRenderer snr)

Return true if the given property matches the first segment in the path - either because the path's shortname expands to the property URI, or because the first segment of the path is *.

Parameters:

p - A property to test

snr - Short name renderer for converting path shortnames to predicate URIs

Returns:

True if the given property matches the start of the path

append

public PropertyPath append(String shortName,
                  String uri,
                  ShortNameRenderer snr)

Return a new property path with a new segment at the end

Parameters:

shortName - The short name for the new segment, or null

uri - The URI for the new segment, or null

snr - The short name service, which may be null if both shortName and uri are non-null

Returns:

A new property path corresponding to this path with the segment .<shortName> appended

terminal

public com.hp.hpl.jena.rdf.model.Property terminal()

Returns:

The last link along this path

tokeniseWords

protected String tokeniseWords(String name)

Tokenise the input string into words based on camelCase boundaries and hyphen characters. If the input string is already tokenised into words (determined by whether it contains a space character or not), return the string unchanged.

Parameters:

name - The input name to tokenise

Returns:

The input string, with camel-case boundaries, hyphens and underscores replaced by spaces.