|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.LexGrid.LexBIG.cagrid.adapters.CodedNodeGraphAdapter
public class CodedNodeGraphAdapter
Constructor Summary | |
---|---|
CodedNodeGraphAdapter(CodedNodeGraphGridAdapter adapter)
|
Method Summary | |
---|---|
java.lang.Boolean |
areCodesRelated(NameAndValue arg0,
ConceptReference sourceConcept,
ConceptReference targetConcept,
boolean directOnly)
Determine whether there is an directed edge (or transitive closure of an edge) from the source code to the target code in this graph. |
CodedNodeGraphGrid |
getCodedNodeGraphGridInterface()
|
EndpointReferenceType |
getEndpointReference()
|
CodedNodeGraph |
intersect(CodedNodeGraph arg0)
Return the set of nodes and associations that are present in both graphs. |
java.lang.Boolean |
isCodeInGraph(ConceptReference arg0)
Determine whether the supplied code is in the graph. |
java.util.List<java.lang.String> |
listCodeRelationships(ConceptReference sourceConcept,
ConceptReference targetConcept,
boolean directOnly)
Return a list of all of the associations in the graph that have the supplied source and target codes or, if directOnly is false, all associations whose transitive closure has the supplied associations. |
java.util.List<java.lang.String> |
listCodeRelationships(ConceptReference sourceConcept,
ConceptReference targetConcept,
int distance)
Return a list of all of the associations in the graph that have the supplied source and target codes based on distance between them. |
ResolvedConceptReferenceList |
resolveAsList(ConceptReference graphFocus,
boolean resolveForward,
boolean resolveBackward,
int resolveCodedEntryDepth,
int resolveAssociationDepth,
LocalNameList propertyNames,
CodedNodeSet.PropertyType[] propertyTypes,
SortOptionList sortOptions,
int maxToReturn)
Resolve all of the coded nodes in the list, sorting by the supplied property (if any), resolving the supplied properties, resolving coded entries to the supplied depth and resolving associations to the supplied depth. |
ResolvedConceptReferenceList |
resolveAsList(ConceptReference graphFocus,
boolean resolveForward,
boolean resolveBackward,
int resolveCodedEntryDepth,
int resolveAssociationDepth,
LocalNameList propertyNames,
CodedNodeSet.PropertyType[] propertyTypes,
SortOptionList sortOptions,
LocalNameList filterOptions,
int maxToReturn)
Resolve all of the coded nodes in the list, sorting by the supplied property (if any), resolving the supplied properties, resolving coded entries to the supplied depth, resolving associations to the supplied depth, and allowing for additional filters to be applied against the returned items. |
ResolvedConceptReferenceList |
resolveAsList(ConceptReference graphFocus,
boolean resolveForward,
boolean resolveBackward,
int resolveCodedEntryDepth,
int resolveAssociationDepth,
LocalNameList propertyNames,
CodedNodeSet.PropertyType[] propertyTypes,
SortOptionList sortOptions,
LocalNameList filterOptions,
int maxToReturn,
boolean keepLastAssociationLevelUnresolved)
Resolve all of the coded nodes in the list, sorting by the supplied property (if any), resolving the supplied properties, resolving coded entries to the supplied depth, resolving associations to the supplied depth, and allowing for additional filters to be applied against the returned items. |
CodedNodeGraph |
restrictToAnonymous(java.lang.Boolean arg0)
Return a graph that contains only the codes that are either Anonymous, Non-Anonymous, or Not Specified in the supplied list, and all edges that still have a source and target code remaining. |
CodedNodeGraph |
restrictToAssociations(NameAndValueList arg0,
NameAndValueList arg1)
Restrict the graph to the nodes that participate as a source or target of the named association and, if supplied, the named association qualifiers. |
CodedNodeGraph |
restrictToCodes(CodedNodeSet codes)
Return a graph that contains only the codes that are present in the supplied list, and all edges that still have a source and target code remaining. |
CodedNodeGraph |
restrictToCodeSystem(java.lang.String codingScheme)
Restrict the graph to codes (source and target) that originate from the supplied code system. |
CodedNodeGraph |
restrictToDirectionalNames(NameAndValueList arg0,
NameAndValueList arg1)
Restrict the graph to the nodes that participate as a source or target of an association whose directional name matches the one provided and, if supplied, the named association qualifiers. |
CodedNodeGraph |
restrictToEntityTypes(LocalNameList arg0)
Return a graph that contains only the codes that contain an Entity Type in the supplied list, and all edges that still have a source and target code remaining. |
CodedNodeGraph |
restrictToSourceCodes(CodedNodeSet codes)
Restrict the graph to associations that have one of the codes in the supplied list as source codes. |
CodedNodeGraph |
restrictToSourceCodeSystem(java.lang.String codingScheme)
Restrict the graph to edges that have codes from the specified code system as a source. |
CodedNodeGraph |
restrictToTargetCodes(CodedNodeSet arg0)
Restrict the graph to associations that have one of the codes in the supplied list as target codes. |
CodedNodeGraph |
restrictToTargetCodeSystem(java.lang.String codingScheme)
Restrict the graph to edges that have codes from the specified code system as a target. |
CodedNodeSet |
toNodeList(ConceptReference graphFocus,
boolean resolveForward,
boolean resolveBackward,
int resolveAssociationDepth,
int maxToReturn)
Transform the graph into a simple of list of code references, removing all association information. |
CodedNodeGraph |
union(CodedNodeGraph graph)
Return the union of the two graphs. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public CodedNodeGraphAdapter(CodedNodeGraphGridAdapter adapter) throws java.rmi.RemoteException
java.rmi.RemoteException
Method Detail |
---|
public java.lang.Boolean areCodesRelated(NameAndValue arg0, ConceptReference sourceConcept, ConceptReference targetConcept, boolean directOnly) throws LBInvocationException, LBParameterException
CodedNodeGraph
areCodesRelated
in interface CodedNodeGraph
arg0
- Identifies the association to be tested. The name and value
will be compared against the id and URI of supported
associations for participating coding schemes.sourceConcept
- Source code system/code to be tested.targetConcept
- Target code system/code to be tested.directOnly
- True means only asserted association instances are tested.
False means that, if the association is defined as transitive,
the transitive closure of the association instances are
tested.
LBInvocationException
LBParameterException
public CodedNodeGraph intersect(CodedNodeGraph arg0) throws LBInvocationException, LBParameterException
CodedNodeGraph
intersect
in interface CodedNodeGraph
arg0
- Identifies the CodedNodeGraph to be intersected with.
LBInvocationException
LBParameterException
public java.lang.Boolean isCodeInGraph(ConceptReference arg0) throws LBInvocationException, LBParameterException
CodedNodeGraph
isCodeInGraph
in interface CodedNodeGraph
arg0
- Identifies the coding scheme and code to test.
LBInvocationException
LBParameterException
public java.util.List<java.lang.String> listCodeRelationships(ConceptReference sourceConcept, ConceptReference targetConcept, boolean directOnly) throws LBInvocationException, LBParameterException
CodedNodeGraph
listCodeRelationships
in interface CodedNodeGraph
sourceConcept
- Source end of the association. If null, all sources for the
specified target are included.targetConcept
- Target end of the association. If null, all targets for the
specified source are included.directOnly
- True means only direct associations are tested. False means
that the transitive closure of transitive (and undefined)
associations are tested for membership.
Note that while the class of the returned value appears to imply concepts only, each contained reference inherits from the more general CodedNodeReference and is capable of representing any type of node contained by the graph.
LBInvocationException
LBParameterException
public java.util.List<java.lang.String> listCodeRelationships(ConceptReference sourceConcept, ConceptReference targetConcept, int distance) throws LBInvocationException, LBParameterException
CodedNodeGraph
listCodeRelationships
in interface CodedNodeGraph
sourceConcept
- Source end of the association. If null, all sources for the
specified target are included.targetConcept
- Target end of the association. If null, all targets for the
specified source are included.distance
- Distance (# of edges) source and target codes must have in
between. Must be positive & greater than zero.
LBInvocationException
LBParameterException
public ResolvedConceptReferenceList resolveAsList(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveCodedEntryDepth, int resolveAssociationDepth, LocalNameList propertyNames, CodedNodeSet.PropertyType[] propertyTypes, SortOptionList sortOptions, LocalNameList filterOptions, int maxToReturn) throws LBInvocationException, LBParameterException
CodedNodeGraph
resolveAsList
in interface CodedNodeGraph
graphFocus
- Set the top or "focus" node of the graph. If present, only
the nodes that are reachable via this node will be returned.
If null, nodes with no incoming or outgoing associations
are used as starting points for navigation of forward and
reverse relationships, respectively.resolveForward
- True means resolve in the direction of source to target.resolveBackward
- True means resolve in the direction of target to source.resolveCodedEntryDepth
- Depth in the graph to resolve coded entries. - 1 means don't
resolve anything - just return the code references, 0 means
resolve just the root nodes, 1 means resolve 1 deep, etc.resolveAssociationDepth
- Number of hops to resolve associations. 0 means leave all
associations unresolved, 1 means immediate neighbors, etc. -1
means follow the entire closure of the graph.propertyNames
- Local names of properties to resolve. If not empty and not
null, only properties matching the given names are included
for resolved nodes.propertyTypes
- Indicates whether to resolve only specific property categories,
regardless of the assigned name. Any of the enumerated PropertyType
values can be specified. If not empty and not null, only
properties matching the given types are included for resolved
nodes.sortOptions
- List of sort options to apply during resolution. If supplied,
the sort algorithms will be applied in the order provided. Any
algorithms not valid to be applied in context of node set
iteration, as specified in the sort extension description,
will result in a parameter exception. Available algorithms can
be retrieved through the LexBIGService getSortExtensions()
method after being defined to the LexBIGServiceManager
extension registry.filterOptions
- List of Filter extensions to apply during resolution. If
supplied, filters are applied in the order provided. Each name
in the list must correspond to the name of a Filter
description as registered to the associated service. Available
Filter descriptions can be retrieved through the LexBIGService
getFilterExtensions() method after being defined to the
LexBIGServiceManager extension registry.maxToReturn
- Maximum number of entries to return; a value less than 1
indicates to return unlimited entries (to the limit specified
in the runtime configuration file).
Note that while the class of the returned value appears to imply concepts only, each contained reference inherits from the more general CodedNodeReference and is capable of representing any type of node contained by the graph.
LBInvocationException
LBParameterException
public ResolvedConceptReferenceList resolveAsList(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveCodedEntryDepth, int resolveAssociationDepth, LocalNameList propertyNames, CodedNodeSet.PropertyType[] propertyTypes, SortOptionList sortOptions, LocalNameList filterOptions, int maxToReturn, boolean keepLastAssociationLevelUnresolved) throws LBInvocationException, LBParameterException
CodedNodeGraph
resolveAsList
in interface CodedNodeGraph
graphFocus
- Set the top or "focus" node of the graph. If present, only
the nodes that are reachable via this node will be returned.
If null, nodes with no incoming or outgoing associations
are used as starting points for navigation of forward and
reverse relationships, respectively.resolveForward
- True means resolve in the direction of source to target.resolveBackward
- True means resolve in the direction of target to source.resolveCodedEntryDepth
- Depth in the graph to resolve coded entries. - 1 means don't
resolve anything - just return the code references, 0 means
resolve just the root nodes, 1 means resolve 1 deep, etc.resolveAssociationDepth
- Number of hops to resolve associations. 0 means leave all
associations unresolved, 1 means immediate neighbors, etc. -1
means follow the entire closure of the graph.propertyNames
- Local names of properties to resolve. If not empty and not
null, only properties matching the given names are included
for resolved nodes.propertyTypes
- Indicates whether to resolve only specific property categories,
regardless of the assigned name. Any of the enumerated PropertyType
values can be specified. If not empty and not null, only
properties matching the given types are included for resolved
nodes.sortOptions
- List of sort options to apply during resolution. If supplied,
the sort algorithms will be applied in the order provided. Any
algorithms not valid to be applied in context of node set
iteration, as specified in the sort extension description,
will result in a parameter exception. Available algorithms can
be retrieved through the LexBIGService getSortExtensions()
method after being defined to the LexBIGServiceManager
extension registry.filterOptions
- List of Filter extensions to apply during resolution. If
supplied, filters are applied in the order provided. Each name
in the list must correspond to the name of a Filter
description as registered to the associated service. Available
Filter descriptions can be retrieved through the LexBIGService
getFilterExtensions() method after being defined to the
LexBIGServiceManager extension registry.maxToReturn
- Maximum number of entries to return; a value less than 1
indicates to return unlimited entries (to the limit specified
in the runtime configuration file).keepLastAssociationLevelUnresolved
- Keep the last hop while resolving associations to the resolveAssociationDepth
unresolved. This is useful while drawing trees of an ontology and we need a
quick way to tell if the tree can be expanded further.
Note that while the class of the returned value appears to imply concepts only, each contained reference inherits from the more general CodedNodeReference and is capable of representing any type of node contained by the graph.
LBInvocationException
LBParameterException
public ResolvedConceptReferenceList resolveAsList(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveCodedEntryDepth, int resolveAssociationDepth, LocalNameList propertyNames, CodedNodeSet.PropertyType[] propertyTypes, SortOptionList sortOptions, int maxToReturn) throws LBInvocationException, LBParameterException
CodedNodeGraph
resolveAsList
in interface CodedNodeGraph
graphFocus
- Set the top or "focus" node of the graph. If present, only
the nodes that are reachable via this node will be returned.
If null, nodes with no incoming or outgoing associations
are used as starting points for navigation of forward and
reverse relationships, respectively.resolveForward
- True means resolve in the direction of source to target.resolveBackward
- True means resolve in the direction of target to source.resolveCodedEntryDepth
- Depth in the graph to resolve coded entries. - 1 means don't
resolve anything - just return code references, 0 means
resolve just the root nodes, 1 means resolve 1 deep, etc.resolveAssociationDepth
- Number of hops to resolve associations. 0 means leave all
associations unresolved, 1 means immediate neighbors, etc. -1
means follow the entire closure of the graph.propertyNames
- Local names of properties to resolve. If not empty and not
null, only properties matching the given names are included
for resolved nodes.propertyTypes
- Indicates whether to resolve only specific property categories,
regardless of the assigned name. Any of the enumerated PropertyType
values can be specified. If not empty and not null, only
properties matching the given types are included for resolved
nodes.sortOptions
- List of sort options to apply during resolution. If supplied,
the sort algorithms will be applied in the order provided. Any
algorithms not valid to be applied in context of node set
iteration, as specified in the sort extension description,
will result in a parameter exception. Available algorithms can
be retrieved through the LexBIGService getSortExtensions()
method after being defined to the LexBIGServiceManager
extension registry.maxToReturn
- Maximum number of entries to return; a value less than 1
indicates to return unlimited entries (to the limit specified
in the runtime configuration file).
Each entry will include basic information for the node along with an embedded object (e.g. concept) populated with requested properties.
Note that while the class of the returned value appears to imply concepts only, each contained reference inherits from the more general CodedNodeReference and is capable of representing any type of node contained by the graph.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToAssociations(NameAndValueList arg0, NameAndValueList arg1) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToAssociations
in interface CodedNodeGraph
arg0
- List of associations used to restrict the graph. The name and
value for each item in the list will be compared against the
id and URI of supported associations for participating
coding schemes.arg1
- If supplied, restriction only applies to associations that are
qualified by one or more of the supplied qualifiers. The name
and value for each item in the list will be compared against
the id and URI of supported association qualifiers for
participating coding schemes.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToCodes(CodedNodeSet codes) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToCodes
in interface CodedNodeGraph
codes
- Codes to filter on.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToCodeSystem(java.lang.String codingScheme) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToCodeSystem
in interface CodedNodeGraph
codingScheme
- The local name or URI of the coding scheme to filter on.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToDirectionalNames(NameAndValueList arg0, NameAndValueList arg1) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToDirectionalNames
in interface CodedNodeGraph
arg0
- List of directionalNames used to restrict the graph. A
directional name is compared against the forward and reverse
names for defined associations. If a given name matches more
than one forward or reverse label, all corresponding
associations are included in the restriction.arg1
- If supplied, restriction only applies to associations that are
qualified by one or more of the supplied qualifiers. The name
and value for each item in the list will be compared against
the id and URI of supported association qualifiers for
participating coding schemes.
LBInvocationException
- ,LBParameterException
LBParameterException
public CodedNodeGraph restrictToSourceCodes(CodedNodeSet codes) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToSourceCodes
in interface CodedNodeGraph
codes
- Codes to filter on.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToSourceCodeSystem(java.lang.String codingScheme) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToSourceCodeSystem
in interface CodedNodeGraph
codingScheme
- The local name or URI of the coding scheme to filter on.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToTargetCodes(CodedNodeSet arg0) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToTargetCodes
in interface CodedNodeGraph
arg0
- Codes to filter on.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToTargetCodeSystem(java.lang.String codingScheme) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToTargetCodeSystem
in interface CodedNodeGraph
codingScheme
- The local name or URI of the coding scheme to filter on.
LBInvocationException
LBParameterException
public CodedNodeSet toNodeList(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveAssociationDepth, int maxToReturn) throws LBInvocationException, LBParameterException
CodedNodeGraph
toNodeList
in interface CodedNodeGraph
graphFocus
- Set the top or "focus" node of the graph. If present, only
the nodes that are reachable via this node will be returned.
If null, nodes with no incoming or outgoing associations
are used as starting points for navigation of forward and
reverse relationships, respectively.resolveForward
- True means include all "forward" (source->target)
associations.resolveBackward
- True means render all "reverse" (target->source) associationsresolveAssociationDepth
- Number of hops to resolve associations. 0 means leave all
associations unresolved, 1 means immediate neighbors, etc. -1
means follow the entire closure of the graph.maxToReturn
- Maximum number of entries to return; a value less than 1
indicates to return unlimited entries (to the limit specified
in the runtime configuration file).
LBInvocationException
LBParameterException
public CodedNodeGraph union(CodedNodeGraph graph) throws LBInvocationException, LBParameterException
CodedNodeGraph
union
in interface CodedNodeGraph
graph
- Identifies the CodedNodeGraph to merge with.
LBInvocationException
LBParameterException
public CodedNodeGraph restrictToAnonymous(java.lang.Boolean arg0) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToAnonymous
in interface CodedNodeGraph
LBInvocationException
- the LB invocation exception
LBParameterException
- the LB parameter exceptionpublic CodedNodeGraph restrictToEntityTypes(LocalNameList arg0) throws LBInvocationException, LBParameterException
CodedNodeGraph
restrictToEntityTypes
in interface CodedNodeGraph
arg0
- the local name list
LBInvocationException
- the LB invocation exception
LBParameterException
- the LB parameter exceptionpublic CodedNodeGraphGrid getCodedNodeGraphGridInterface()
public EndpointReferenceType getEndpointReference()
|
Copyright: (c) 2004-2006 Mayo Foundation for Medical Education and Research (MFMER). All rights reserved. MAYO, MAYO CLINIC, and the triple-shield Mayo logo are trademarks and service marks of MFMER. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |