com.epimorphics.lda.renderers.common

Class DisplayHierarchy

java.lang.Object

com.epimorphics.lda.renderers.common.DisplayHierarchy

public class DisplayHierarchy
extends Object

Represents the resource hierarchy as it is unfolded from the results set graph to form a tree that can be displayed.

Author:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DisplayHierarchy.DisplayHierarchyContext A collection of the state information we keep while expanding the display hierarchy

Constructor Summary

Constructors

Constructor and Description
DisplayHierarchy(Page page) Construct a new display hierarchy for the given page

Method Summary

Methods

Modifier and Type	Method and Description
protected void	annotateNodeList(DisplayHierarchy.DisplayHierarchyContext context, List<DisplayHierarchyNode> nodes, String firstHint)
protected void	annotateNodes(DisplayHierarchy.DisplayHierarchyContext context, DisplayHierarchyNode node) Walk the tree from a node and add display hints
protected void	annotateSiblings(DisplayHierarchy.DisplayHierarchyContext context, DisplayHierarchyNode node)
void	expand() Expand the hierarchy from the given roots
protected void	expandNode(DisplayHierarchy.DisplayHierarchyContext context, DisplayHierarchyNode parent) Expand a hierarchy node by extracting the properties of the node, matching paths to properties, and appending the children to the expansion queue if appropriate.
protected DisplayHierarchy.DisplayHierarchyContext	initialiseContext()
protected boolean	isLiteralValued(DisplayHierarchyNode node)
protected Set<PropertyPath>	matchingPaths(DisplayHierarchy.DisplayHierarchyContext context, com.hp.hpl.jena.rdf.model.Property p, Set<PropertyPath> paths) Select which of the given property paths matches the given property p.
List<DisplayHierarchyNode>	roots()

Methods inherited from class java.lang.Object

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

Constructor Detail

DisplayHierarchy

public DisplayHierarchy(Page page)

Construct a new display hierarchy for the given page

Parameters:

page -

Method Detail

roots

public List<DisplayHierarchyNode> roots()

Returns:

The root nodes (ie. the top-level item or items)

expand

public void expand()

Expand the hierarchy from the given roots

expandNode

protected void expandNode(DisplayHierarchy.DisplayHierarchyContext context,
              DisplayHierarchyNode parent)

Expand a hierarchy node by extracting the properties of the node, matching paths to properties, and appending the children to the expansion queue if appropriate.

Parameters:

context - The current display hierarchy context

parent - The node to be expanded

matchingPaths

protected Set<PropertyPath> matchingPaths(DisplayHierarchy.DisplayHierarchyContext context,
                              com.hp.hpl.jena.rdf.model.Property p,
                              Set<PropertyPath> paths)

Select which of the given property paths matches the given property p. The match is determined by PropertyPath.beginsWith(Property, ShortNameRenderer)

Parameters:

context - The current context, including the short name renderer

p - An RDF property

paths - The paths for consideration

Returns:

A sub-set of paths, possibly empty, which start with the given property or *

initialiseContext

protected DisplayHierarchy.DisplayHierarchyContext initialiseContext()

Returns:

A new context bookkeeping object

annotateNodes

protected void annotateNodes(DisplayHierarchy.DisplayHierarchyContext context,
                 DisplayHierarchyNode node)

Walk the tree from a node and add display hints

Parameters:

context -

node -

annotateSiblings

protected void annotateSiblings(DisplayHierarchy.DisplayHierarchyContext context,
                    DisplayHierarchyNode node)

annotateNodeList

protected void annotateNodeList(DisplayHierarchy.DisplayHierarchyContext context,
                    List<DisplayHierarchyNode> nodes,
                    String firstHint)

isLiteralValued

protected boolean isLiteralValued(DisplayHierarchyNode node)

Returns:

True if the node and all of its siblings are literal-valued