org.dspace.app.xmlui.utils

Class HandleUtil

java.lang.Object

org.dspace.app.xmlui.utils.HandleUtil

public class HandleUtil
extends java.lang.Object

Simple utility class for extracting handles.

Author:

Scott Phillips

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	DSPACE_OBJECT
protected static java.lang.String	HANDLE_PREFIX The URL prefix of all handles

Constructor Summary

Constructors

Constructor and Description
HandleUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static void	buildHandleTrail(DSpaceObject dso, PageMeta pageMeta, java.lang.String contextPath) Build a list of trail metadata starting with the owning collection and ending with the root level parent.
static void	buildHandleTrail(DSpaceObject dso, PageMeta pageMeta, java.lang.String contextPath, boolean linkOriginalObject) Build a list of trail metadata starting with the owning collection and ending with the root level parent.
static boolean	inheritsFrom(DSpaceObject dso, java.lang.String parent) Determine if the given DSO is an ancestor of the the parent handle.
static DSpaceObject	obtainHandle(java.util.Map objectModel) Obtain the current DSpace handle for the specified request.

Methods inherited from class java.lang.Object

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

Field Detail

HANDLE_PREFIX

protected static final java.lang.String HANDLE_PREFIX

The URL prefix of all handles

See Also:

Constant Field Values

DSPACE_OBJECT

protected static final java.lang.String DSPACE_OBJECT

See Also:

Constant Field Values

Constructor Detail

HandleUtil

public HandleUtil()

Method Detail

obtainHandle

public static DSpaceObject obtainHandle(java.util.Map objectModel)
                                 throws java.sql.SQLException

Obtain the current DSpace handle for the specified request.

Parameters:

objectModel - The cocoon model.

Returns:

A DSpace handle, or null if none found.

Throws:

java.sql.SQLException

inheritsFrom

public static boolean inheritsFrom(DSpaceObject dso,
                   java.lang.String parent)
                            throws java.sql.SQLException

Determine if the given DSO is an ancestor of the the parent handle.

Parameters:

dso - The child DSO object.

parent - The Handle to test against.

Returns:

The matched DSO object or null if none found.

Throws:

java.sql.SQLException

buildHandleTrail

public static void buildHandleTrail(DSpaceObject dso,
                    PageMeta pageMeta,
                    java.lang.String contextPath)
                             throws java.sql.SQLException,
                                    WingException

Build a list of trail metadata starting with the owning collection and ending with the root level parent. If the Object is an item, a bundle, or a bitstream, then the object is not included, but its collection and community parents are. However, if the item is a community or collection then it is included along with all parents.

If the terminal object in the trail is the passed object, do not link to it, because that is (presumably) the page at which the user has arrived.

Parameters:

dso - the DSpace who's parents we wil add to the pageMeta

pageMeta - the object to which we link our trial

contextPath - The context path

Throws:

java.sql.SQLException

WingException

buildHandleTrail

public static void buildHandleTrail(DSpaceObject dso,
                    PageMeta pageMeta,
                    java.lang.String contextPath,
                    boolean linkOriginalObject)
                             throws java.sql.SQLException,
                                    WingException

Build a list of trail metadata starting with the owning collection and ending with the root level parent. If the Object is an item, a bundle, or a bitstream, then the object is not included, but its collection and community parents are. However, if the item is a community or collection then it is included along with all parents.

If the terminal object in the trail is the passed object, do not link to it, because that is (presumably) the page at which the user has arrived.

Parameters:

dso - the DSpace who's parents we wil add to the pageMeta

pageMeta - the object to which we link our trial

contextPath - The context path

linkOriginalObject - whether or not to make a link of the original object

Throws:

java.sql.SQLException

WingException