org.LexGrid.LexBIG.cagrid
Class Utils

java.lang.Object
  extended by org.LexGrid.LexBIG.cagrid.Utils

public class Utils
extends java.lang.Object

Utilities class for the LexBIG caGrid Services.

Author:
Kevin Peterson

Constructor Summary
Utils()
           
 
Method Summary
static java.lang.String[] associationIdentificationToStringArray(AssociationIdentification[] assocs)
          Constructs a String array containing the values of the AssociationIdentification array.
static GraphResolutionPolicy buildGraphResolutionPolicy(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveCodedEntryDepth, int resolveAssociationDepth, LocalNameList propertyNames, CodedNodeSet.PropertyType[] propertyTypes, SortOptionList sortOptions, LocalNameList filterOptions, int maxToReturn, boolean keepLastAssociationLevelUnresolved)
           
static GraphResolutionPolicy buildGraphResolutionPolicy(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveCodedEntryDepth, int resolveAssociationDepth, LocalNameList propertyNames, CodedNodeSet.PropertyType[] propertyTypes, SortOptionList sortOptions, LocalNameList filterOptions, int maxToReturn, boolean keepLastAssociationLevelUnresolved)
           
static HierarchyResolutionPolicy buildHierarchyResolutionPolicy(java.lang.String hierarchyID, java.lang.String conceptCode, boolean resolveConcepts, NameAndValueList associationQualifiers)
           
static NodeListPolicy buildNodeListPolicy(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveAssociationDepth, int maxToReturn)
           
static NodeListPolicy buildNodeListPolicy(ConceptReference graphFocus, boolean resolveForward, boolean resolveBackward, int resolveAssociationDepth, int maxToReturn)
           
static RelationshipDistanceBasedPolicy buildRelationshipDistanceBasedPolicy(ConceptReference sourceConcept, ConceptReference targetConcept, int distance)
           
static RelationshipTypeBasedPolicy buildRelationshipTypeBasedPolicy(ConceptReference sourceConcept, ConceptReference targetConcept, boolean directOnly)
           
static SetResolutionPolicy buildSetResolutionPolicy(SortOptionList sortOptions, LocalNameList filterOptions, LocalNameList propertyNames, CodedNodeSet.PropertyType[] propertyTypes, boolean resolveConcepts, int maxToReturn)
           
static ConceptReference checkIfConceptReferencsIsResolved(ConceptReference ref)
          Because caGrid services cannot pass a ResolvedConceptReference, this method builds a ConceptReference out of a ResolvedConceptReference
static ConceptReference checkIfConceptReferencsIsResolved(ConceptReference ref)
           
static java.lang.String[] conceptIdentificationArrayToString(ConceptIdentification[] codeArray)
           
static CodedNodeSet.ActiveOption convertActiveOption(ActiveOption option)
           
static org.LexGrid.LexBIG.iso21090.DataModel.enums.ActiveOption convertActiveOption(CodedNodeSet.ActiveOption option)
           
static CodedNodeSet.ActiveOption convertActiveOption(org.LexGrid.LexBIG.iso21090.DataModel.enums.ActiveOption option)
           
static org.LexGrid.LexBIG.iso21090.DataModel.enums.HierarchyPathResolveOption convertHierarchyPathResolveOption(LexBIGServiceConvenienceMethods.HierarchyPathResolveOption option)
           
static LexBIGServiceConvenienceMethods.HierarchyPathResolveOption convertHierarchyPathResolveOption(org.LexGrid.LexBIG.iso21090.DataModel.enums.HierarchyPathResolveOption option)
           
static org.LexGrid.LexBIG.iso21090.DataModel.enums.PropertyType[] convertPropertyType(CodedNodeSet.PropertyType[] inputArray)
          Constructs an array of PropertyType objects based on values in a String array.
static CodedNodeSet.PropertyType[] convertPropertyType(org.LexGrid.LexBIG.iso21090.DataModel.enums.PropertyType[] inputArray)
          Constructs an array of PropertyType objects based on values in a String array.
static org.LexGrid.LexBIG.iso21090.DataModel.enums.SearchDesignationOption convertSearchDesignationOption(CodedNodeSet.SearchDesignationOption option)
           
static CodedNodeSet.SearchDesignationOption convertSearchDesignationOption(org.LexGrid.LexBIG.iso21090.DataModel.enums.SearchDesignationOption option)
           
static java.lang.String[] directionalAssociationIdentificationToStringArray(DirectionalAssociationIdentification[] assocs)
          Constructs a String array containing the values of the DirectionalAssociationIdentification array.
static java.lang.String[] enumArrayToStringArray(java.lang.Enum[] enumerator)
          Constructs a String array containing the values of the Enumerator array.
static java.lang.String[] hierarchyIdentificationToStringArray(HierarchyIdentification[] ids)
          Constructs a String array containing the values of the HierarchyIdentification array.
static void processException(java.lang.Exception e)
          LexEVS Grid Service is a layer over Distributed LexBIG, which itself is a layer over LexBIG.
static java.lang.String[] propertyIdentificationToStringArray(PropertyIdentification[] ids)
           
static java.lang.String[] statusArrayToString(Status[] statusArray)
           
static ActiveOption[] stringArrayToActiveOption(java.lang.String[] stringArray)
          Constructs an array of ActiveOption objects based on values in a String array.
static AssociationIdentification[] stringArrayToAssociationIdentification(java.lang.String[] stringArray)
           
static ConceptIdentification[] stringArrayToConceptIdentification(java.lang.String[] codes)
          Constructs a String array containing the values of the ConceptIdentification array.
static DirectionalAssociationIdentification[] stringArrayToDirectionalAssociationIdentification(java.lang.String[] stringArray, boolean isForward)
           
static HierarchyIdentification[] stringArrayToHierarchyIdentification(java.lang.String[] ids)
           
static PropertyIdentification[] stringArrayToPropertyIdentification(java.lang.String[] stringArray)
          Constructs an array of PropertyIdentification objects based on values in a String array.
static Status[] stringArrayToStatus(java.lang.String[] stringArray)
          Constructs an array of Status objects based on values in a String array.
static java.net.URI URIConverter(org.apache.axis.types.URI uri)
          Transfroms a org.apache.axis.types.URI to an java.net.URI
static org.apache.axis.types.URI URIConverter(java.net.URI uri)
          Transfroms a java.net.URI to an org.apache.axis.types.URI
static AssociationIdentification wrapAssociationIdentification(java.lang.String name)
           
static CodeExistence wrapCodeExistence(boolean isPresent)
           
static CodeRelationship wrapCodeRelationship(boolean areRelated)
           
static CodeState wrapCodeState(boolean isActive)
           
static CodingSchemeCopyRight wrapCodingSchemCopyRight(java.lang.String text)
           
static CodingSchemeIdentification wrapCodingSchemeIdentifier(java.lang.String codingScheme)
           
static ConceptIdentification wrapConceptIdentification(java.lang.String code)
           
static Direction wrapDirection(boolean isForward)
           
static DirectionalAssociationIdentification wrapDirectionalAssociationIdentification(java.lang.String id, boolean isForward)
           
static ExtensionIdentification wrapExtensionIdentification(java.lang.String name)
           
static HierarchyIdentification wrapHierarchyIdentificationIdentification(java.lang.String identifier)
           
static LanguageIdentification wrapLanguageIdentification(java.lang.String name)
           
static MatchCriteria wrapMatchCritia(java.lang.String text)
           
static RelationContainerIdentification wrapRelationContainerIdentification(java.lang.String name)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Utils

public Utils()
Method Detail

enumArrayToStringArray

public static java.lang.String[] enumArrayToStringArray(java.lang.Enum[] enumerator)
Constructs a String array containing the values of the Enumerator array.

Parameters:
enumerator - Enumerator to be converted to a String array.
Returns:
The String array with values corresponding to the values of the passed in enumerator

stringArrayToConceptIdentification

public static ConceptIdentification[] stringArrayToConceptIdentification(java.lang.String[] codes)
Constructs a String array containing the values of the ConceptIdentification array.

Parameters:
enumerator - Enumerator to be converted to a String array.
Returns:
The String array with values corresponding to the values of the passed in enumerator

stringArrayToHierarchyIdentification

public static HierarchyIdentification[] stringArrayToHierarchyIdentification(java.lang.String[] ids)

hierarchyIdentificationToStringArray

public static java.lang.String[] hierarchyIdentificationToStringArray(HierarchyIdentification[] ids)
Constructs a String array containing the values of the HierarchyIdentification array.

Parameters:
ids - HierarchyIdentification array to be converted to a String array.
Returns:
The String array with values corresponding to the values of the passed in array.

propertyIdentificationToStringArray

public static java.lang.String[] propertyIdentificationToStringArray(PropertyIdentification[] ids)

directionalAssociationIdentificationToStringArray

public static java.lang.String[] directionalAssociationIdentificationToStringArray(DirectionalAssociationIdentification[] assocs)
Constructs a String array containing the values of the DirectionalAssociationIdentification array.

Parameters:
ids - DirectionalAssociationIdentification array to be converted to a String array.
Returns:
The String array with values corresponding to the values of the passed in array.

associationIdentificationToStringArray

public static java.lang.String[] associationIdentificationToStringArray(AssociationIdentification[] assocs)
Constructs a String array containing the values of the AssociationIdentification array.

Parameters:
ids - DirectionalAssociationIdentification array to be converted to a String array.
Returns:
The String array with values corresponding to the values of the passed in array.

convertPropertyType

public static CodedNodeSet.PropertyType[] convertPropertyType(org.LexGrid.LexBIG.iso21090.DataModel.enums.PropertyType[] inputArray)
Constructs an array of PropertyType objects based on values in a String array.

Parameters:
stringArray - The array containing the values of the PropertyType enum.
Returns:
The constructed PropertyType enum array.

convertPropertyType

public static org.LexGrid.LexBIG.iso21090.DataModel.enums.PropertyType[] convertPropertyType(CodedNodeSet.PropertyType[] inputArray)
Constructs an array of PropertyType objects based on values in a String array.

Parameters:
stringArray - The array containing the values of the PropertyType enum.
Returns:
The constructed PropertyType enum array.

stringArrayToActiveOption

public static ActiveOption[] stringArrayToActiveOption(java.lang.String[] stringArray)
Constructs an array of ActiveOption objects based on values in a String array.

Parameters:
stringArray - The array containing the values of the ActiveOption enum.
Returns:
The constructed ActiveOption enum array.

stringArrayToStatus

public static Status[] stringArrayToStatus(java.lang.String[] stringArray)
Constructs an array of Status objects based on values in a String array.

Parameters:
stringArray - The array containing the values of the Status.
Returns:
The constructed Status array.

statusArrayToString

public static java.lang.String[] statusArrayToString(Status[] statusArray)

stringArrayToPropertyIdentification

public static PropertyIdentification[] stringArrayToPropertyIdentification(java.lang.String[] stringArray)
Constructs an array of PropertyIdentification objects based on values in a String array.

Parameters:
stringArray - The array containing the values of the Status.
Returns:
The constructed PropertyIdentification array.

stringArrayToDirectionalAssociationIdentification

public static DirectionalAssociationIdentification[] stringArrayToDirectionalAssociationIdentification(java.lang.String[] stringArray,
                                                                                                       boolean isForward)

stringArrayToAssociationIdentification

public static AssociationIdentification[] stringArrayToAssociationIdentification(java.lang.String[] stringArray)

checkIfConceptReferencsIsResolved

public static ConceptReference checkIfConceptReferencsIsResolved(ConceptReference ref)
Because caGrid services cannot pass a ResolvedConceptReference, this method builds a ConceptReference out of a ResolvedConceptReference

Parameters:
ref - The ConceptReference to check
Returns:
If the passed in ConceptReference is actually a ResolvedConceptReference object, it will return a ConceptReference based on it. If the object passed in is a ConceptReference, simply return it.

checkIfConceptReferencsIsResolved

public static ConceptReference checkIfConceptReferencsIsResolved(ConceptReference ref)

URIConverter

public static org.apache.axis.types.URI URIConverter(java.net.URI uri)
                                              throws MalformedURIException
Transfroms a java.net.URI to an org.apache.axis.types.URI

Parameters:
uri - The URI to be transformed
Returns:
The new URI.
Throws:
MalformedURIException

URIConverter

public static java.net.URI URIConverter(org.apache.axis.types.URI uri)
                                 throws MalformedURIException
Transfroms a org.apache.axis.types.URI to an java.net.URI

Parameters:
uri - The URI to be transformed
Returns:
The new URI.
Throws:
MalformedURIException

buildHierarchyResolutionPolicy

public static HierarchyResolutionPolicy buildHierarchyResolutionPolicy(java.lang.String hierarchyID,
                                                                       java.lang.String conceptCode,
                                                                       boolean resolveConcepts,
                                                                       NameAndValueList associationQualifiers)

buildRelationshipTypeBasedPolicy

public static RelationshipTypeBasedPolicy buildRelationshipTypeBasedPolicy(ConceptReference sourceConcept,
                                                                           ConceptReference targetConcept,
                                                                           boolean directOnly)

buildRelationshipDistanceBasedPolicy

public static RelationshipDistanceBasedPolicy buildRelationshipDistanceBasedPolicy(ConceptReference sourceConcept,
                                                                                   ConceptReference targetConcept,
                                                                                   int distance)

buildGraphResolutionPolicy

public static GraphResolutionPolicy buildGraphResolutionPolicy(ConceptReference graphFocus,
                                                               boolean resolveForward,
                                                               boolean resolveBackward,
                                                               int resolveCodedEntryDepth,
                                                               int resolveAssociationDepth,
                                                               LocalNameList propertyNames,
                                                               CodedNodeSet.PropertyType[] propertyTypes,
                                                               SortOptionList sortOptions,
                                                               LocalNameList filterOptions,
                                                               int maxToReturn,
                                                               boolean keepLastAssociationLevelUnresolved)

buildGraphResolutionPolicy

public static GraphResolutionPolicy buildGraphResolutionPolicy(ConceptReference graphFocus,
                                                               boolean resolveForward,
                                                               boolean resolveBackward,
                                                               int resolveCodedEntryDepth,
                                                               int resolveAssociationDepth,
                                                               LocalNameList propertyNames,
                                                               CodedNodeSet.PropertyType[] propertyTypes,
                                                               SortOptionList sortOptions,
                                                               LocalNameList filterOptions,
                                                               int maxToReturn,
                                                               boolean keepLastAssociationLevelUnresolved)

buildSetResolutionPolicy

public static SetResolutionPolicy buildSetResolutionPolicy(SortOptionList sortOptions,
                                                           LocalNameList filterOptions,
                                                           LocalNameList propertyNames,
                                                           CodedNodeSet.PropertyType[] propertyTypes,
                                                           boolean resolveConcepts,
                                                           int maxToReturn)

buildNodeListPolicy

public static NodeListPolicy buildNodeListPolicy(ConceptReference graphFocus,
                                                 boolean resolveForward,
                                                 boolean resolveBackward,
                                                 int resolveAssociationDepth,
                                                 int maxToReturn)

buildNodeListPolicy

public static NodeListPolicy buildNodeListPolicy(ConceptReference graphFocus,
                                                 boolean resolveForward,
                                                 boolean resolveBackward,
                                                 int resolveAssociationDepth,
                                                 int maxToReturn)

wrapCodingSchemeIdentifier

public static CodingSchemeIdentification wrapCodingSchemeIdentifier(java.lang.String codingScheme)

wrapMatchCritia

public static MatchCriteria wrapMatchCritia(java.lang.String text)

wrapCodeExistence

public static CodeExistence wrapCodeExistence(boolean isPresent)

wrapExtensionIdentification

public static ExtensionIdentification wrapExtensionIdentification(java.lang.String name)

wrapHierarchyIdentificationIdentification

public static HierarchyIdentification wrapHierarchyIdentificationIdentification(java.lang.String identifier)

wrapLanguageIdentification

public static LanguageIdentification wrapLanguageIdentification(java.lang.String name)

wrapCodeRelationship

public static CodeRelationship wrapCodeRelationship(boolean areRelated)

wrapCodeState

public static CodeState wrapCodeState(boolean isActive)

wrapDirection

public static Direction wrapDirection(boolean isForward)

wrapDirectionalAssociationIdentification

public static DirectionalAssociationIdentification wrapDirectionalAssociationIdentification(java.lang.String id,
                                                                                            boolean isForward)

wrapConceptIdentification

public static ConceptIdentification wrapConceptIdentification(java.lang.String code)

wrapRelationContainerIdentification

public static RelationContainerIdentification wrapRelationContainerIdentification(java.lang.String name)

wrapCodingSchemCopyRight

public static CodingSchemeCopyRight wrapCodingSchemCopyRight(java.lang.String text)

wrapAssociationIdentification

public static AssociationIdentification wrapAssociationIdentification(java.lang.String name)

convertSearchDesignationOption

public static org.LexGrid.LexBIG.iso21090.DataModel.enums.SearchDesignationOption convertSearchDesignationOption(CodedNodeSet.SearchDesignationOption option)

convertSearchDesignationOption

public static CodedNodeSet.SearchDesignationOption convertSearchDesignationOption(org.LexGrid.LexBIG.iso21090.DataModel.enums.SearchDesignationOption option)

convertActiveOption

public static org.LexGrid.LexBIG.iso21090.DataModel.enums.ActiveOption convertActiveOption(CodedNodeSet.ActiveOption option)

convertActiveOption

public static CodedNodeSet.ActiveOption convertActiveOption(ActiveOption option)

convertActiveOption

public static CodedNodeSet.ActiveOption convertActiveOption(org.LexGrid.LexBIG.iso21090.DataModel.enums.ActiveOption option)

convertHierarchyPathResolveOption

public static org.LexGrid.LexBIG.iso21090.DataModel.enums.HierarchyPathResolveOption convertHierarchyPathResolveOption(LexBIGServiceConvenienceMethods.HierarchyPathResolveOption option)

convertHierarchyPathResolveOption

public static LexBIGServiceConvenienceMethods.HierarchyPathResolveOption convertHierarchyPathResolveOption(org.LexGrid.LexBIG.iso21090.DataModel.enums.HierarchyPathResolveOption option)

conceptIdentificationArrayToString

public static java.lang.String[] conceptIdentificationArrayToString(ConceptIdentification[] codeArray)

processException

public static void processException(java.lang.Exception e)
                             throws LBParameterException,
                                    LBException,
                                    LBInvocationException,
                                    LBResourceUnavailableException,
                                    InvalidServiceContextAccess,
                                    java.rmi.RemoteException
LexEVS Grid Service is a layer over Distributed LexBIG, which itself is a layer over LexBIG. Often, Exceptions are rethrown or wrappered by the various layers, making them hard to understand by the time they reach the Grid Service layer. This method attempts to unwrap some of these Exceptions to find the real cause of the problem. After it receives an Exception, it cycles through the causes and attempts to locate the actual buried cause. It then creates a Grid Exception to correspond to that, and rethrows this new Exception.

Parameters:
e - The Exception to process
Throws:
LBParameterException
LBException
LBInvocationException
LBResourceUnavailableException
InvalidServiceContextAccess
java.rmi.RemoteException

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.