org.xbrlapi.networks

Class AnalyserImpl

java.lang.Object

org.xbrlapi.networks.AnalyserImpl

All Implemented Interfaces:

java.io.Serializable, Analyser

Direct Known Subclasses:

AllAnalyserImpl, NonProhibitedAnalyserImpl

public class AnalyserImpl
extends java.lang.Object
implements Analyser

This Analyser returns information based upon all active relationships. Set this as the analyser used by a store when you want that store to produce query results where only active relationships are considered.

Author:

Geoff Shuetrim (geoff@galexy.net)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AnalyserImpl(Store store)

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<Relationship>	getAllRelationships()
java.util.Set<java.lang.String>	getArcroles()
java.util.Set<java.lang.String>	getArcroles(java.lang.String linkRole)
java.util.List<Relationship>	getLabelRelationships(java.lang.String sourceIndex)
java.util.List<Relationship>	getLabelRelationshipsByLanguage(java.lang.String sourceIndex, java.lang.String language)
java.util.List<Relationship>	getLabelRelationshipsByLanguageAndRole(java.lang.String sourceIndex, java.lang.String language, java.lang.String role)
java.util.List<Relationship>	getLabelRelationshipsByLanguages(java.lang.String sourceIndex, java.util.List<java.lang.String> languages)
java.util.List<Relationship>	getLabelRelationshipsByRole(java.lang.String sourceIndex, java.lang.String role)
java.util.List<Relationship>	getLabelRelationshipsByRoles(java.lang.String sourceIndex, java.util.List<java.lang.String> roles)
java.util.List<Relationship>	getLabelRelationshipsByRoles(java.lang.String sourceIndex, java.util.List<java.lang.String> languages, java.util.List<java.lang.String> roles)
java.util.Set<java.lang.String>	getLinkRoles()
java.util.Set<java.lang.String>	getLinkRoles(java.lang.String arcrole)
java.util.List<Relationship>	getReferenceRelationships(java.lang.String sourceIndex)
java.util.List<Relationship>	getReferenceRelationshipsByLanguage(java.lang.String sourceIndex, java.lang.String language)
java.util.List<Relationship>	getReferenceRelationshipsByLanguageAndRole(java.lang.String sourceIndex, java.lang.String language, java.lang.String role)
java.util.List<Relationship>	getReferenceRelationshipsByLanguages(java.lang.String sourceIndex, java.util.List<java.lang.String> languages)
java.util.List<Relationship>	getReferenceRelationshipsByRole(java.lang.String sourceIndex, java.lang.String role)
java.util.List<Relationship>	getReferenceRelationshipsByRoles(java.lang.String sourceIndex, java.util.List<java.lang.String> roles)
java.util.List<Relationship>	getReferenceRelationshipsByRoles(java.lang.String sourceIndex, java.util.List<java.lang.String> languages, java.util.List<java.lang.String> roles)
java.util.List<Relationship>	getRelationships(java.util.Set<java.lang.String> arcroles)
java.util.List<Relationship>	getRelationships(java.lang.String arcrole)
java.util.List<Relationship>	getRelationships(java.lang.String linkRole, java.util.Set<java.lang.String> arcroles)
java.util.List<Relationship>	getRelationships(java.lang.String linkRole, java.lang.String arcrole)
java.util.List<Relationship>	getRelationships(java.lang.String sourceIndex, java.lang.String targetIndex, java.lang.String linkRole, java.lang.String arcrole)
java.util.List<Relationship>	getRelationshipsFrom(java.lang.String sourceIndex, java.util.Set<java.lang.String> arcroles)
java.util.List<Relationship>	getRelationshipsFrom(java.lang.String sourceIndex, java.lang.String arcrole)
java.util.List<Relationship>	getRelationshipsFrom(java.lang.String sourceIndex, java.lang.String linkRole, java.util.Set<java.lang.String> arcroles)
java.util.SortedSet<Relationship>	getRelationshipsFrom(java.lang.String sourceIndex, java.lang.String linkRole, java.lang.String arcrole)
java.util.List<Relationship>	getRelationshipsTo(java.lang.String targetIndex, java.util.Set<java.lang.String> arcroles)
java.util.List<Relationship>	getRelationshipsTo(java.lang.String targetIndex, java.lang.String arcrole)
java.util.List<Relationship>	getRelationshipsTo(java.lang.String targetIndex, java.lang.String linkRole, java.util.Set<java.lang.String> arcroles)
java.util.SortedSet<Relationship>	getRelationshipsTo(java.lang.String targetIndex, java.lang.String linkRole, java.lang.String arcrole)
java.util.Set<java.lang.String>	getRootIndices(java.lang.String linkRole, java.lang.String arcrole)
java.util.List<Relationship>	getRootRelationships(java.lang.String linkRole, java.lang.String arcrole)
<F extends Fragment> java.util.Set<F>	getRoots(java.lang.String linkRole, java.lang.String arcrole)
boolean	hasAllRelationships(java.net.URI document) Algorithm involves: Getting all persisted relationships in the document Getting all arc+arcend+arcsource combinations in the document Matching each arc to its persisted relationships Returning false if any arc does not have persisted relationships

Methods inherited from class java.lang.Object

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

Constructor Detail

AnalyserImpl

public AnalyserImpl(Store store)
             throws XBRLException

Parameters:

store - The data store to use.

Throws:

XBRLException - if the store is null.

Method Detail

hasAllRelationships

public boolean hasAllRelationships(java.net.URI document)
                            throws XBRLException

Algorithm involves:

1. Getting all persisted relationships in the document
2. Getting all arc+arcend+arcsource combinations in the document
3. Matching each arc to its persisted relationships
4. Returning false if any arc does not have persisted relationships

Specified by:

hasAllRelationships in interface Analyser

Parameters:

document - The document URI.

Returns:

true if all of the relationships expressed by the arcs in the document have been persisted in the data store and false otherwise.

Throws:

XBRLException

See Also:

Analyser.hasAllRelationships(URI)

getAllRelationships

public java.util.List<Relationship> getAllRelationships()
                                                 throws XBRLException

Specified by:

getAllRelationships in interface Analyser

Returns:

A list of all relationships in the data store that are accepted by the analyser's relationship filtration rules. Note that this can tend to overwhelm available physical resources when the data store is of significant size.

Throws:

XBRLException

See Also:

Analyser.getAllRelationships()

getArcroles

public java.util.Set<java.lang.String> getArcroles()
                                            throws XBRLException

Specified by:

getArcroles in interface Analyser

Returns:

a list of all arcroles for persisted relationships.

Throws:

XBRLException

See Also:

Analyser.getArcroles()

getArcroles

public java.util.Set<java.lang.String> getArcroles(java.lang.String linkRole)
                                            throws XBRLException

Specified by:

getArcroles in interface Analyser

Parameters:

linkRole - the constraining link role value.

Returns:

a list of all arcroles for persisted relationships defined in extended links with the given link role.

Throws:

XBRLException

See Also:

Analyser.getArcroles(String)

getLinkRoles

public java.util.Set<java.lang.String> getLinkRoles()
                                             throws XBRLException

Specified by:

getLinkRoles in interface Analyser

Returns:

a list of all extended link roles for persisted relationships.

Throws:

XBRLException

See Also:

Analyser.getLinkRoles()

getLinkRoles

public java.util.Set<java.lang.String> getLinkRoles(java.lang.String arcrole)
                                             throws XBRLException

Specified by:

getLinkRoles in interface Analyser

Parameters:

arcrole - the constraining arcrole value.

Returns:

a list of all link roles for extended links that contain arcs defining persisted relationships with the given arcrole.

Throws:

XBRLException

See Also:

Analyser.getLinkRoles(String)

getRelationships

public java.util.List<Relationship> getRelationships(java.util.Set<java.lang.String> arcroles)
                                              throws XBRLException

Specified by:

getRelationships in interface Analyser

Parameters:

arcroles - The list of arcroles used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve any one of the specified arcroles.

Throws:

XBRLException

See Also:

Analyser.getRelationships(Set)

getRelationships

public java.util.List<Relationship> getRelationships(java.lang.String linkRole,
                                            java.util.Set<java.lang.String> arcroles)
                                              throws XBRLException

Specified by:

getRelationships in interface Analyser

Parameters:

linkRole - The link role for the extended links that are allowed to contain the arcs defining the active relationships to be returned.

arcroles - The list of arcroles used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve any one of the specified arcroles and that are in networks with the given link role.

Throws:

XBRLException

See Also:

Analyser.getRelationships(String, Set)

getRelationships

public java.util.List<Relationship> getRelationships(java.lang.String linkRole,
                                            java.lang.String arcrole)
                                              throws XBRLException

Specified by:

getRelationships in interface Analyser

Parameters:

linkRole - The link role constraining the set of returned active relationships.

arcrole - The arcrole used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve the specified arcrole and that have the specified link role.

Throws:

XBRLException

See Also:

Analyser.getRelationships(String, String)

getRelationships

public java.util.List<Relationship> getRelationships(java.lang.String arcrole)
                                              throws XBRLException

Specified by:

getRelationships in interface Analyser

Parameters:

arcrole - The arcrole used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve the specified arcrole.

Throws:

XBRLException

See Also:

Analyser.getRelationships(String)

getRelationshipsFrom

public java.util.List<Relationship> getRelationshipsFrom(java.lang.String sourceIndex,
                                                java.util.Set<java.lang.String> arcroles)
                                                  throws XBRLException

Specified by:

getRelationshipsFrom in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get relationships from.

arcroles - The arcroles used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve any of the specified arcroles and that run from the specified source fragment.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsFrom(java.lang.String, Set)

getRelationshipsFrom

public java.util.List<Relationship> getRelationshipsFrom(java.lang.String sourceIndex,
                                                java.lang.String linkRole,
                                                java.util.Set<java.lang.String> arcroles)
                                                  throws XBRLException

Specified by:

getRelationshipsFrom in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get relationships from.

linkRole - The link role constraining the set of returned active relationships.

arcroles - The arcroles used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve any of the specified arcroles and that have the specified link role and that run from the specified source fragment.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsFrom(java.lang.String, String, Set)

getRelationshipsFrom

public java.util.SortedSet<Relationship> getRelationshipsFrom(java.lang.String sourceIndex,
                                                     java.lang.String linkRole,
                                                     java.lang.String arcrole)
                                                       throws XBRLException

Specified by:

getRelationshipsFrom in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get relationships from.

linkRole - The link role constraining the set of returned active relationships.

arcrole - The arcrole used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A sorted set of all active relationships that involve the specified arcrole and that have the specified link role and that run from the specified source fragment, ordered by the arc order attribute value. The arcrole and link role is ignored if it is null.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsFrom(java.lang.String, String, String)

getRelationshipsFrom

public java.util.List<Relationship> getRelationshipsFrom(java.lang.String sourceIndex,
                                                java.lang.String arcrole)
                                                  throws XBRLException

Specified by:

getRelationshipsFrom in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get relationships from.

arcrole - The arcrole used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve the specified arcrole and that run from the specified source fragment.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsFrom(java.lang.String, String)

getRelationshipsTo

public java.util.List<Relationship> getRelationshipsTo(java.lang.String targetIndex,
                                              java.util.Set<java.lang.String> arcroles)
                                                throws XBRLException

Specified by:

getRelationshipsTo in interface Analyser

Parameters:

targetIndex - The index of the fragment to get relationships to.

arcroles - The arcroles used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve any of the specified arcroles and that run to the specified target fragment.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsTo(java.lang.String, Set)

getRelationshipsTo

public java.util.List<Relationship> getRelationshipsTo(java.lang.String targetIndex,
                                              java.lang.String linkRole,
                                              java.util.Set<java.lang.String> arcroles)
                                                throws XBRLException

Specified by:

getRelationshipsTo in interface Analyser

Parameters:

targetIndex - The index of the fragment to get relationships to.

linkRole - The link role constraining the set of returned active relationships.

arcroles - The arcroles used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve any of the specified arcroles and that have the specified link role and that run to the specified target fragment.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsTo(java.lang.String, String, Set)

getRelationshipsTo

public java.util.SortedSet<Relationship> getRelationshipsTo(java.lang.String targetIndex,
                                                   java.lang.String linkRole,
                                                   java.lang.String arcrole)
                                                     throws XBRLException

Specified by:

getRelationshipsTo in interface Analyser

Parameters:

targetIndex - The index of the fragment to get relationships to.

linkRole - The link role constraining the set of returned active relationships.

arcrole - The arcrole used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A sorted set of all active relationships that involve the specified arcrole and that have the specified link role and that run to the specified target fragment. The relationships are sorted by the order attributes on the arcs expressing them. The arcrole and link role is ignored if it is null.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsTo(java.lang.String, String, String)

getRelationshipsTo

public java.util.List<Relationship> getRelationshipsTo(java.lang.String targetIndex,
                                              java.lang.String arcrole)
                                                throws XBRLException

Specified by:

getRelationshipsTo in interface Analyser

Parameters:

targetIndex - The index of the fragment to get relationships to.

arcrole - The arcrole used to select the returned list of active relationships that have been persisted in the data store.

Returns:

A list of all active relationships that involve the specified arcrole and that run to the specified target fragment.

Throws:

XBRLException

See Also:

Analyser.getRelationshipsTo(java.lang.String, String)

getRootRelationships

public java.util.List<Relationship> getRootRelationships(java.lang.String linkRole,
                                                java.lang.String arcrole)
                                                  throws XBRLException

Specified by:

getRootRelationships in interface Analyser

Parameters:

linkRole - The link role of the network.

arcrole - The arcrole of the network.

Returns:

the relationships that run from root fragments in the network with the specified link role and arcrole. If the arcrole or link role is null it is ignored.

Throws:

XBRLException

See Also:

Analyser.getRootRelationships(String, String)

getRoots

public <F extends Fragment> java.util.Set<F> getRoots(java.lang.String linkRole,
                                             java.lang.String arcrole)
                                           throws XBRLException

Specified by:

getRoots in interface Analyser

Type Parameters:

F - The fragment type

Parameters:

linkRole - The link role URI

arcrole - The arcrole URI

Returns:

the list of fragments that are roots of networks with the given link role and arcrole.

Throws:

XBRLException

See Also:

Analyser.getRoots(String, String)

getRootIndices

public java.util.Set<java.lang.String> getRootIndices(java.lang.String linkRole,
                                             java.lang.String arcrole)
                                               throws XBRLException

Specified by:

getRootIndices in interface Analyser

Parameters:

linkRole - The link role defining the network

arcrole - The arcrole defining the network

Returns:

the set of indices of the root fragments in the network. If the arcrole or link role is null it is ignored.

Throws:

XBRLException

See Also:

Analyser.getRootIndices(String, String)

getLabelRelationships

public java.util.List<Relationship> getLabelRelationships(java.lang.String sourceIndex)
                                                   throws XBRLException

Specified by:

getLabelRelationships in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the labels for.

Returns:

a list of active relationships to labels from the fragment identified by the specified index.

Throws:

XBRLException

See Also:

Analyser.getLabelRelationships(java.lang.String)

getLabelRelationshipsByLanguage

public java.util.List<Relationship> getLabelRelationshipsByLanguage(java.lang.String sourceIndex,
                                                           java.lang.String language)
                                                             throws XBRLException

Specified by:

getLabelRelationshipsByLanguage in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the labels for.

language - The XML language code identifying the language of the label.

Returns:

a list of active relationships to labels from the fragment identified by the specified index and with the specified language. The list is empty if no relationships match the specified selection criteria.

Throws:

XBRLException

See Also:

Analyser.getLabelRelationshipsByLanguage(java.lang.String, java.lang.String)

getLabelRelationshipsByLanguageAndRole

public java.util.List<Relationship> getLabelRelationshipsByLanguageAndRole(java.lang.String sourceIndex,
                                                                  java.lang.String language,
                                                                  java.lang.String role)
                                                                    throws XBRLException

Specified by:

getLabelRelationshipsByLanguageAndRole in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the labels for.

language - The XML language code identifying the language of the label.

role - A required resource role for the labels.

Returns:

a list of active relationships to labels that match the selection criteria.

Throws:

XBRLException

See Also:

Analyser.getLabelRelationshipsByLanguageAndRole(java.lang.String, java.lang.String, String)

getLabelRelationshipsByLanguages

public java.util.List<Relationship> getLabelRelationshipsByLanguages(java.lang.String sourceIndex,
                                                            java.util.List<java.lang.String> languages)
                                                              throws XBRLException

Specified by:

getLabelRelationshipsByLanguages in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the labels for.

languages - The list of XML language code identifying the language of the label, in order of preference with the first value being the most preferred. A null value in the list implies that the full set of labels that match the other criteria will be selected.

Returns:

a list of active relationships to labels that match the selection criteria. The list is empty if no relationships match the specified selection criteria.

Throws:

XBRLException

See Also:

Analyser.getLabelRelationshipsByLanguages(java.lang.String, java.util.List)

getLabelRelationshipsByRole

public java.util.List<Relationship> getLabelRelationshipsByRole(java.lang.String sourceIndex,
                                                       java.lang.String role)
                                                         throws XBRLException

Specified by:

getLabelRelationshipsByRole in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the labels for.

role - A required resource role for the labels.

Returns:

a list of active relationships to labels that match the selection criteria.

Throws:

XBRLException

See Also:

Analyser.getLabelRelationshipsByRole(java.lang.String, String)

getLabelRelationshipsByRoles

public java.util.List<Relationship> getLabelRelationshipsByRoles(java.lang.String sourceIndex,
                                                        java.util.List<java.lang.String> languages,
                                                        java.util.List<java.lang.String> roles)
                                                          throws XBRLException

Specified by:

getLabelRelationshipsByRoles in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the labels for.

languages - The list of XML language code identifying the language of the label, in order of preference with the first value being the most preferred. A null value in the list implies that the full set of labels that match the other criteria will be selected.

roles - A list of resource roles for the labels in order of preference with the first role in the list being the most preferred XLink role attribute value. A null value in the list implies that the full set of labels that match the other criteria will be selected.

Returns:

a list of active relationships to labels that match the selection criteria. Note that label language preferences get precedence over label role preferences.

Throws:

XBRLException

See Also:

Analyser.getLabelRelationshipsByRoles(java.lang.String, java.util.List, List)

getLabelRelationshipsByRoles

public java.util.List<Relationship> getLabelRelationshipsByRoles(java.lang.String sourceIndex,
                                                        java.util.List<java.lang.String> roles)
                                                          throws XBRLException

Specified by:

getLabelRelationshipsByRoles in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the labels for.

roles - A list of resource roles for the labels in order of preference with the first role in the list being the most preferred XLink role attribute value. A null value in the list implies that the full set of labels that match the other criteria will be selected.

Returns:

a list of active relationships to labels that match the selection criteria.

Throws:

XBRLException

See Also:

Analyser.getLabelRelationshipsByRoles(java.lang.String, List)

getReferenceRelationships

public java.util.List<Relationship> getReferenceRelationships(java.lang.String sourceIndex)
                                                       throws XBRLException

Specified by:

getReferenceRelationships in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the references for.

Returns:

a list of active relationships to references from the fragment identified by the specified index.

Throws:

XBRLException

See Also:

Analyser.getReferenceRelationships(java.lang.String)

getReferenceRelationshipsByLanguage

public java.util.List<Relationship> getReferenceRelationshipsByLanguage(java.lang.String sourceIndex,
                                                               java.lang.String language)
                                                                 throws XBRLException

Specified by:

getReferenceRelationshipsByLanguage in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the references for.

language - The XML language code identifying the language of the reference.

Returns:

a list of active relationships to references from the fragment identified by the specified index and with the specified language. The list is empty if no relationships match the specified selection criteria.

Throws:

XBRLException

See Also:

Analyser.getReferenceRelationshipsByLanguage(java.lang.String, java.lang.String)

getReferenceRelationshipsByLanguageAndRole

public java.util.List<Relationship> getReferenceRelationshipsByLanguageAndRole(java.lang.String sourceIndex,
                                                                      java.lang.String language,
                                                                      java.lang.String role)
                                                                        throws XBRLException

Specified by:

getReferenceRelationshipsByLanguageAndRole in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the references for.

language - The XML language code identifying the language of the reference.

role - A required resource role for the references.

Returns:

a list of active relationships to references that match the selection criteria.

Throws:

XBRLException

See Also:

Analyser.getReferenceRelationshipsByLanguageAndRole(java.lang.String, java.lang.String, String)

getReferenceRelationshipsByLanguages

public java.util.List<Relationship> getReferenceRelationshipsByLanguages(java.lang.String sourceIndex,
                                                                java.util.List<java.lang.String> languages)
                                                                  throws XBRLException

Specified by:

getReferenceRelationshipsByLanguages in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the references for.

languages - The list of XML language code identifying the language of the reference, in order of preference with the first value being the most preferred. A null value in the list implies that the full set of references that match the other criteria will be selected.

Returns:

a list of active relationships to references that match the selection criteria. The list is empty if no relationships match the specified selection criteria.

Throws:

XBRLException

See Also:

Analyser.getReferenceRelationshipsByLanguages(java.lang.String, java.util.List)

getReferenceRelationshipsByRole

public java.util.List<Relationship> getReferenceRelationshipsByRole(java.lang.String sourceIndex,
                                                           java.lang.String role)
                                                             throws XBRLException

Specified by:

getReferenceRelationshipsByRole in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the references for.

role - A required resource role for the references.

Returns:

a list of active relationships to references that match the selection criteria.

Throws:

XBRLException

See Also:

Analyser.getReferenceRelationshipsByRole(java.lang.String, String)

getReferenceRelationshipsByRoles

public java.util.List<Relationship> getReferenceRelationshipsByRoles(java.lang.String sourceIndex,
                                                            java.util.List<java.lang.String> languages,
                                                            java.util.List<java.lang.String> roles)
                                                              throws XBRLException

Specified by:

getReferenceRelationshipsByRoles in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the references for.

languages - The list of XML language code identifying the language of the reference, in order of preference with the first value being the most preferred. A null value in the list implies that the full set of references that match the other criteria will be selected.

roles - A list of resource roles for the references in order of preference with the first role in the list being the most preferred XLink role attribute value. A null value in the list implies that the full set of references that match the other criteria will be selected.

Returns:

a list of active relationships to references that match the selection criteria.

Throws:

XBRLException

See Also:

Analyser.getReferenceRelationshipsByRoles(java.lang.String, java.util.List, List)

getReferenceRelationshipsByRoles

public java.util.List<Relationship> getReferenceRelationshipsByRoles(java.lang.String sourceIndex,
                                                            java.util.List<java.lang.String> roles)
                                                              throws XBRLException

Specified by:

getReferenceRelationshipsByRoles in interface Analyser

Parameters:

sourceIndex - The index of the fragment to get the references for.

roles - A list of resource roles for the references in order of preference with the first role in the list being the most preferred XLink role attribute value. A null value in the list implies that the full set of references that match the other criteria will be selected.

Returns:

a list of active relationships to references that match the selection criteria.

Throws:

XBRLException

See Also:

Analyser.getReferenceRelationshipsByRoles(java.lang.String, List)

getRelationships

public java.util.List<Relationship> getRelationships(java.lang.String sourceIndex,
                                            java.lang.String targetIndex,
                                            java.lang.String linkRole,
                                            java.lang.String arcrole)
                                              throws XBRLException

Specified by:

getRelationships in interface Analyser

Parameters:

sourceIndex - The source index to match.

targetIndex - The target index to match.

linkRole - The link role to match.

arcrole - The arcrole to match.

Returns:

a list of persisted relationships matching the specified criteria. The arcrole and linkrole are ignored if they are equal to null.

Throws:

XBRLException

See Also:

Analyser.getRelationships(String, String, String, String)