org.xbrlapi.aspects
Class LocationLabeller

java.lang.Object
  org.xbrlapi.aspects.LabellerImpl
      org.xbrlapi.aspects.LocationLabeller

All Implemented Interfaces:

Serializable, Labeller

public class LocationLabeller
extends LabellerImpl
implements Labeller

A labeller for the location aspect based upon generic XBRL labels. The label for a location aspect value is the XBRL 2.1 or XBRL generic label for the concept underpinning the fact that is at the location associated with the location aspect value.

This labeller does not make use of label caching systems. XBRL 2.1 and generic XBRL labels are used where possible. Otherwise, the fact's namespace and local name are used.

Author:

Geoff Shuetrim (geoff@galexy.net)

See Also:

Serialized Form

Field Summary

Fields inherited from class org.xbrlapi.aspects.LabellerImpl

logger

Constructor Summary

LocationLabeller(Aspect aspect)

Method Summary

String	getAspectLabelWithoutFallback(String locale, URI resourceRole, URI linkRole)
String	getAspectValueLabelWithoutFallback(AspectValue value, String locale, URI resourceRole, URI linkRole)

Methods inherited from class org.xbrlapi.aspects.LabellerImpl

duplicate, getAspect, getAspectLabel, getAspectValueLabel, getAspectValueLabel, getDomain, getStore

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xbrlapi.aspects.Labeller

duplicate, getAspect, getAspectLabel, getAspectValueLabel, getAspectValueLabel, getDomain, getStore

Constructor Detail

LocationLabeller

public LocationLabeller(Aspect aspect)
                 throws XBRLException

Parameters:

aspect - The aspect to be a labeller for.

Throws:

XBRLException

Method Detail

getAspectLabelWithoutFallback

public String getAspectLabelWithoutFallback(String locale,
                                            URI resourceRole,
                                            URI linkRole)

Specified by:

getAspectLabelWithoutFallback in interface Labeller

Overrides:

getAspectLabelWithoutFallback in class LabellerImpl

Parameters:

locale - The locale (language code etc) of the label. Set to null if the label is not locale dependent.

resourceRole - The resource role of the XLink resource providing the label. Set to null if the label does not depend on the resource role.

linkRole - The link role of the extended link network that is to be analysed to obtain the label. Set to null if the label does not depend on the link role.

Returns:

the label for the aspect based upon the given parameters or null if no such label exists.

See Also:

Labeller.getAspectLabelWithoutFallback(String, URI, URI)

getAspectValueLabelWithoutFallback

public String getAspectValueLabelWithoutFallback(AspectValue value,
                                                 String locale,
                                                 URI resourceRole,
                                                 URI linkRole)

Specified by:

getAspectValueLabelWithoutFallback in interface Labeller

Overrides:

getAspectValueLabelWithoutFallback in class LabellerImpl

Parameters:

value - The aspect value to get a label for.

locale - The locale (language code) of the label. This can be set to null if the label is not locale dependent.

resourceRole - The resource role of the XLink resource providing the label. This can be set to null if the label does not depend on the resource role.

linkRole - The link role of the extended link network that is to be analysed to obtain the label. This can be set to null if the label does not depend on the link role.

Returns:

the label for the aspect value based upon the given parameters, without falling back to the label obtained by the superclass, if no label can be obtained. If no label is obtained, a value of null is returned.

See Also:

LabellerImpl.getAspectValueLabelWithoutFallback(AspectValue, String, URI, URI)