com.ihr.xbrl.om.instance
Class XBRLFact

java.lang.Object
  com.ihr.xbrl.om.XMLFragment
      com.ihr.xbrl.om.instance.XBRLFact

All Implemented Interfaces:

XBRLRelationshipPoint, XMLHasParent, java.lang.Cloneable, javax.xml.namespace.NamespaceContext

Direct Known Subclasses:

XBRLFactItem, XBRLFactTuple

public abstract class XBRLFact
extends XMLFragment

Abstract class to represent a fact item in an instance document or inside a tuple. Concreate classes of this class are: XBRLFactItem and XBRLFactTuple

Author:

Ignacio

Field Summary

static javax.xml.namespace.QName

nil

Fields inherited from class com.ihr.xbrl.om.XMLFragment

CONCEPT_LABEL, CONCEPT_QNAME, EMPTYRELATIONSHIPSITERATORINSTANCE, EMPTYXMLFRAGMENTITERATORINSTANCE, FACT_CONCEPT_DATATYPE, FACT_CONCEPT_LABEL, FACT_QNAME, idQName, NO_POSITION, OrderComparator, PERIOD_TYPE, PERIOD_VALUE, SHORT_TEXT, SOURCE_DOCUMENT, XPATH, XPOINTER

Method Summary

void	clear() Eliminates all this fact content
XBRLFact	clone()
XBRLFact	clone(DTSContainer newDTS) Clone current fact but in a new DTSContainer
static XBRLFact	createItemOrTupleInstance(XBRLFactsList facts, net.sf.saxon.s9api.XdmNode node) Creates a tupleInstance or a itemInstance depending on the node content
static XBRLFact	createItemOrTupleInstance(XBRLFactsList facts, XMLElementDefinition el, XBRLContext ctx, XBRLUnit unit) Creates a tupleInstance of a itemInstance depending on the data type of the el parameter and extra information provided in other parameters
boolean	equals(java.lang.Object obj) Sets a new XPathFunctionResolver for this object
XBRLLocator	generateLocatorToNode(boolean relativize, java.net.URI base) Generates a locator element pointing to the instantiated fact on the instance This is used during serialization of the instance document.
org.jdom.Element	generateNode(boolean relativize, java.net.URI base) Generates the XBRLFact jdom node.
XMLElementDefinition	getElementDefinition() Access to the element definition behind this fact
java.util.Iterator<XMLFragment>	getElements() For complex type resources this returns an iterator with all children XML fragments Tthis method may be overwriten by other classes in the hierarchy
java.lang.String	getFriendlyName() Returns a string description that represents the element content in a form that users can understand.
java.lang.String	getFriendlyName(int modifiers, LabelsProvider lp) Returns a string description that represents the element content in a form that users can understand.
XBRLInstance	getInstance() The instance document where this fact exists
XBRLFactsList	getParent() The parent of a fact is always a facts container.
XBRLTaxonomy	getTaxonomy() The XBRLTaxonomy in which this fact is defined
java.lang.String	getXPathToRoot() Returns an XPath 2.0 expression to locate this document's node starting at this document's root This function updates the local namespace context if nodes in the path requires new namespaces to be declared.
int	hashCode()
void	invalidate(boolean dir) Reset the validation status for this fact.
abstract boolean	isDuplicate(XBRLFact otherFact) Check if two items are duplicates as defined in the XBRL 2.1 specification
boolean	isNil() Return true if the fact is nil it MUST contain a @xsi:nil attribute with value = true
boolean	pEqual(XBRLFact toFact) Implementation of the p-equality as defined in the XBRL 2.1 specification.
void	setId(java.lang.String id) Sets the content of the id attribute of this element the ID MUST not have any space, but null is allowed and removes an id from an XML Fragment.
void	setNil(boolean newValue) Sets the nil attribute to true or false according to the param value
void	setParent(XBRLFactsList parent) Sets the parent of this XBRLFact to be the XBRLFactsList object used as a parameter.
void	setValue(net.sf.saxon.value.AtomicValue value)
void	setValue(net.sf.saxon.s9api.XdmValue value) Sets the value of this node
abstract XBRLValidationReport	validate(XBRLCoreProcessor proc) Validates the item or tuple

Methods inherited from class com.ihr.xbrl.om.XMLFragment

addAttribute, addChild, addFromRelationship, addNamespace, addNamespace, addToRelationship, addXMLChild, changeBase, checkBase, delAttribute, delAttribute, equalXdmValues, evaluateBoolean, evaluateList, evaluateNode, evaluateNumber, evaluateString, generateId, generateNodeNamespacesAndAttributes, generateNodeValue, generatePrefix, getAttribute, getAttributeQNameValue, getAttributes, getAttributes, getAttributeValue, getBase, getBase, getBaseURI, getBooleanValue, getChild, getContainer, getDeclaredNamespaces, getDocument, getFragment, getFromRelationships, getFromRelationships, getFromRelationships, getId, getLang, getNamespaceURI, getNodeName, getNumberOfElements, getNumberOfFromRelationships, getNumberOfToRelationships, getOrGenerateId, getPrefix, getPrefixes, getQNameValue, getRelationshipsBases, getRelationshipsChain, getRelationshipTypes, getStaticNamespace, getStringValue, getToRelationships, getToRelationships, getToRelationships, getValue, getXPathNamespaceContext, getXPathToNode, getXPointerElementScheme, getXPointerElementScheme, getXPointerShorthandScheme, getXPointerToNode, isNamespaceDefined, objEquals, objHashCode, qNameToString, removeAttribute, removeChild, removeChild, removeFromRelationship, removeToRelationship, removeXMLChild, resetElements, resetHash, resolveHRef, resolveHRef, s_equal2, s_equal2, setAttributes, setBase, setDocument, setDocumentAndReload, setElements, setLang, setNamespaceContext, setNamespaces, setNode, setNodeName, setParent, setVariablesDefined, toString, valueEquals, xEqual

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

nil

public static final javax.xml.namespace.QName nil

Method Detail

clone

public XBRLFact clone()

Overrides:

clone in class XMLFragment

clone

public XBRLFact clone(DTSContainer newDTS)

Clone current fact but in a new DTSContainer

Overrides:

clone in class XMLFragment

Parameters:

newDTS -

Returns:

cloned XBRLFact

setParent

public void setParent(XBRLFactsList parent)

Sets the parent of this XBRLFact to be the XBRLFactsList object used as a parameter.

Setting the parent does not adds the fact as child of the parent element. This function do the following steps:

1. if there are no changes (current parent is the same object as the object used as a parameter) then the function does nothing
2. inform the old parent to remove the reference to the children
3. sets parent of this object to be the object submitted as a parameter
4. if the fact was assigned from a different instance document. Then relationships in the original instance document are removed from the new item.

Parameters:

parent -

setId

public void setId(java.lang.String id)
           throws XBRLInconsistentDTSException

Description copied from class: XMLFragment

Sets the content of the id attribute of this element the ID MUST not have any space, but null is allowed and removes an id from an XML Fragment. This method may be overwritten by other classes that require storing an indexed table of elements and IDs in order to prevent duplicate IDs to exist

Overrides:

setId in class XMLFragment

Parameters:

id - the new ID

Throws:

XBRLInconsistentDTSException - if the id is not lexicographically valid

getParent

public XBRLFactsList getParent()

The parent of a fact is always a facts container. The facts container can exist inside a tuple or inside an instance document.

Specified by:

getParent in interface XMLHasParent

Overrides:

getParent in class XMLFragment

Returns:

XBRLFactsList

getXPathToRoot

public java.lang.String getXPathToRoot()

Description copied from class: XMLFragment

Returns an XPath 2.0 expression to locate this document's node starting at this document's root This function updates the local namespace context if nodes in the path requires new namespaces to be declared.

Overrides:

getXPathToRoot in class XMLFragment

Returns:

String

getElementDefinition

public XMLElementDefinition getElementDefinition()

Access to the element definition behind this fact

Returns:

XMLElementDefinition

Throws:

XBRLValidationException

getInstance

public XBRLInstance getInstance()

The instance document where this fact exists

Returns:

XBRLInstance

getTaxonomy

public XBRLTaxonomy getTaxonomy()

The XBRLTaxonomy in which this fact is defined

Returns:

XBRLTaxonomy

pEqual

public boolean pEqual(XBRLFact toFact)

Implementation of the p-equality as defined in the XBRL 2.1 specification.

p-equality means parent-equality. two facts are p-equal if they have the same parent node

Parameters:

toFact - the other fact to compare this fact to

Returns:

boolean value, true means this and toFact are p-equal

createItemOrTupleInstance

public static XBRLFact createItemOrTupleInstance(XBRLFactsList facts,
                                                 net.sf.saxon.s9api.XdmNode node)
                                          throws XBRLValidationException

Creates a tupleInstance or a itemInstance depending on the node content

Parameters:

facts - XBRLFactsContainer

node - NodeInfo

Returns:

XBRLFact

Throws:

XBRLValidationException

createItemOrTupleInstance

public static XBRLFact createItemOrTupleInstance(XBRLFactsList facts,
                                                 XMLElementDefinition el,
                                                 XBRLContext ctx,
                                                 XBRLUnit unit)
                                          throws XBRLInconsistentDTSException

Creates a tupleInstance of a itemInstance depending on the data type of the el parameter and extra information provided in other parameters

Parameters:

facts - XBRLFactsContainer if null, the fact will not be part of any factsList

el - XBRLElementDefinition must be either XBRLTuple or XBRLItem, Cannot be null

ctx - XBRLContext, if element is a tuple this parameter can be null

unit - XBRLUnit, if element is not numeric or is a tuple this parameter can be null

Returns:

a new XBRLFact

Throws:

XBRLValidationException - if the el parameter is not XBRLTuple or XBRLItem

XBRLInconsistentDTSException

validate

public abstract XBRLValidationReport validate(XBRLCoreProcessor proc)

Validates the item or tuple

Parameters:

proc -

Throws:

XBRLValidationException

generateLocatorToNode

public XBRLLocator generateLocatorToNode(boolean relativize,
                                         java.net.URI base)
                                  throws java.net.URISyntaxException

Generates a locator element pointing to the instantiated fact on the instance This is used during serialization of the instance document. The generation of a locator automatically adds an ID on the fact if needed

Parameters:

relativize - boolean

base - URI base uri for relativization of the generated href

Returns:

XBRLLocator object

Throws:

java.net.URISyntaxException

isNil

public boolean isNil()

Return true if the fact is nil it MUST contain a @xsi:nil attribute with value = true

Returns:

boolean

isDuplicate

public abstract boolean isDuplicate(XBRLFact otherFact)

Check if two items are duplicates as defined in the XBRL 2.1 specification

Parameters:

otherFact - the other XBRLFactItem

Returns:

boolean

setNil

public void setNil(boolean newValue)

Sets the nil attribute to true or false according to the param value

Parameters:

newValue -

setValue

public void setValue(net.sf.saxon.value.AtomicValue value)

Overrides:

setValue in class XMLFragment

setValue

public void setValue(net.sf.saxon.s9api.XdmValue value)

Description copied from class: XMLFragment

Sets the value of this node

Overrides:

setValue in class XMLFragment

generateNode

public org.jdom.Element generateNode(boolean relativize,
                                     java.net.URI base)
                              throws XBRLSerializationException

Generates the XBRLFact jdom node. adds the xsi:nil attribute if required

Overrides:

generateNode in class XMLFragment

Parameters:

relativize - boolean indicating if URIs should be relativized to the base URI (see next argument)

base - the URI to which some attributes of this object should be relativided

Returns:

a clone of the surrounding jdom Element so it can be incorporated into multiple trees

Throws:

XBRLSerializationException

getElements

public java.util.Iterator<XMLFragment> getElements()

Description copied from class: XMLFragment

For complex type resources this returns an iterator with all children XML fragments Tthis method may be overwriten by other classes in the hierarchy

Overrides:

getElements in class XMLFragment

Returns:

Iterator

getFriendlyName

public java.lang.String getFriendlyName()

Description copied from class: XMLFragment

Returns a string description that represents the element content in a form that users can understand. This method may be overridden by parent classes.

Remarks, this method may return very long names not suitable for user interface

Overrides:

getFriendlyName in class XMLFragment

Returns:

Non empty String. Internationalization is enabled

getFriendlyName

public java.lang.String getFriendlyName(int modifiers,
                                        LabelsProvider lp)

Description copied from class: XMLFragment

Returns a string description that represents the element content in a form that users can understand. This method may be override by parent classes.

This function accepts flags that are defined as constants in XMLFragment in order to modify the output.

• XMLFragment.XPOINTER includes the element position in the source file using the XPointer specification. Note, if the document is created from objects the value may not be available
• XMLFragment.XPATH includes the element position in the source file using XPATH. Note, if the document is created from objects the value may not be available
• XMLFragment.NO_POSITION does not include the element position in the source file.
• XMLFragment.CONCEPT_QNAME for XBRLItem, XBRLTuple and XMLElementDefinition.
• XMLFragment.CONCEPT_LABEL for XBRLItema and XBRLTuple.
• XMLFragment.FACT_QNAME for facts.
• XMLFragment.FACT_CONCEPT_LABEL for facts.
• XMLFragment.SHORT_TEXT for resources, returns the resource text, id or xlink:label

Overrides:

getFriendlyName in class XMLFragment

Parameters:

modifiers -

Returns:

a String representation of this fact.

clear

public void clear()
           throws java.lang.Throwable

Eliminates all this fact content

Overrides:

clear in class XMLFragment

Throws:

java.lang.Throwable

invalidate

public void invalidate(boolean dir)

Reset the validation status for this fact. If the fact is a tuple the status is propagated down to tuple content.

This method is used by GUI tools that requires to reset validation before a manual validation cycle is started

Parameters:

dir - the direction of the propagation. if this parameter is false and fact is a tuple then the tuple content is recursively invalidated

Since:

2.6.6

hashCode

public int hashCode()

Overrides:

hashCode in class XMLFragment

equals

public boolean equals(java.lang.Object obj)

Description copied from class: XMLFragment

Sets a new XPathFunctionResolver for this object

Overrides:

equals in class XMLFragment