org.dspace.app.webui.jsptag

Class ItemTag

java.lang.Object

javax.servlet.jsp.tagext.TagSupport

org.dspace.app.webui.jsptag.ItemTag

All Implemented Interfaces:

Serializable, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

public class ItemTag
extends javax.servlet.jsp.tagext.TagSupport

JSP tag for displaying an item.

The fields that are displayed can be configured in dspace.cfg using the webui.itemdisplay.(style) property. The form is

 
 <schema prefix>.<element>[.<qualifier>|.*][(date)|(link)], ...
 
 

For example:

 
 dc.title = Dublin Core element 'title' (unqualified)
 dc.title.alternative = DC element 'title', qualifier 'alternative'
 dc.title.* = All fields with Dublin Core element 'title' (any or no qualifier)
 dc.identifier.uri(link) = DC identifier.uri, render as a link
 dc.date.issued(date) = DC date.issued, render as a date
 dc.identifier.doi(doi) = DC identifier.doi, render as link to http://dx.doi.org
 dc.identifier.hdl(handle) = DC identifier.hanlde, render as link to http://hdl.handle.net
 dc.relation.isPartOf(resolver) = DC relation.isPartOf, render as link to the base url of the resolver 
                                  according to the specified urn in the metadata value (doi:xxxx, hdl:xxxxx, 
                                  urn:issn:xxxx, etc.)
 
 

When using "resolver" in webui.itemdisplay to render identifiers as resolvable links, the base URL is taken from webui.resolver..baseurl where webui.resolver..urn matches the urn specified in the metadata value. The value is appended to the "baseurl" as is, so the baseurl need to end with slash almost in any case. If no urn is specified in the value it will be displayed as simple text.

 
 webui.resolver.1.urn = doi
 webui.resolver.1.baseurl = http://dx.doi.org/
 webui.resolver.2.urn = hdl
 webui.resolver.2.baseurl = http://hdl.handle.net/
 
 

For the doi and hdl urn defaults values are provided, respectively http://dx.doi.org/ and http://hdl.handle.net/ are used.
If a metadata value with style: "doi", "handle" or "resolver" matches a URL already, it is simply rendered as a link with no other manipulation.

 
 

 If an item has no value for a particular field, it won't be displayed. The
 name of the field for display will be drawn from the current UI dictionary,
 using the key:
 
 
 
 
 "metadata.<style.>.<field>"
 
 e.g. "metadata.thesis.dc.title" "metadata.thesis.dc.contributor.*"
 "metadata.thesis.dc.date.issued"
 
 
 if this key is not found will be used the more general one
 
 "metadata.<field>"
 
 e.g. "metadata.dc.title" "metadata.dc.contributor.*"
 "metadata.dc.date.issued"
 
 
 
 

 You need to specify which strategy use for select the style for an item.
 
 
 
 
 plugin.single.org.dspace.app.webui.util.StyleSelection = \
                      org.dspace.app.webui.util.CollectionStyleSelection
                      #org.dspace.app.webui.util.MetadataStyleSelection
 
 
 
 

 With the Collection strategy you can also specify which collections use which
 views.
 
 
 
 
 webui.itemdisplay.<style>.collections = <collection handle>, ...
 
 
 
 

 FIXME: This should be more database-driven
 
 
 
 
 webui.itemdisplay.thesis.collections = 123456789/24, 123456789/35
 
 
 
 

 With the Metadata strategy you MUST specify which metadata use as name of the
 style.
 
 
 
 
 webui.itemdisplay.metadata-style = schema.element[.qualifier|.*]
 
 e.g. "dc.type"
 
 

Version:

$Revision$

Author:

Robert Tansley

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.servlet.jsp.tagext.TagSupport

id, pageContext

Fields inherited from interface javax.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface javax.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

Constructors

Constructor and Description
ItemTag()

Method Summary

Methods

Modifier and Type	Method and Description
int	doStartTag()
Collection[]	getCollections() Get the collections this item is in
Item	getItem() Get the item this tag should display
String	getStyle() Get the style this tag should display
void	release()
void	setCollections(Collection[] collectionsIn) Set the collections this item is in
void	setItem(Item itemIn) Set the item this tag should display
void	setStyle(String styleIn) Set the style this tag should display

Methods inherited from class javax.servlet.jsp.tagext.TagSupport

doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue

Methods inherited from class java.lang.Object

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

Constructor Detail

ItemTag

public ItemTag()

Method Detail

doStartTag

public int doStartTag()
               throws javax.servlet.jsp.JspException

Specified by:

doStartTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doStartTag in class javax.servlet.jsp.tagext.TagSupport

Throws:

javax.servlet.jsp.JspException

getItem

public Item getItem()

Get the item this tag should display

Returns:

the item

setItem

public void setItem(Item itemIn)

Set the item this tag should display

Parameters:

itemIn - the item to display

getCollections

public Collection[] getCollections()

Get the collections this item is in

Returns:

the collections

setCollections

public void setCollections(Collection[] collectionsIn)

Set the collections this item is in

Parameters:

collectionsIn - the collections

getStyle

public String getStyle()

Get the style this tag should display

Returns:

the style

setStyle

public void setStyle(String styleIn)

Set the style this tag should display

Parameters:

styleIn - the Style to display

release

public void release()

Specified by:

release in interface javax.servlet.jsp.tagext.Tag

Overrides:

release in class javax.servlet.jsp.tagext.TagSupport