org.LexGrid.REST.valueSets
Class ValueDomainDefinition

java.lang.Object
  extended by org.mayo.edu.lgModel.LexGridBase
      extended by org.LexGrid.REST.commonTypes.Versionable
          extended by org.LexGrid.REST.valueSets.ValueDomainDefinition
All Implemented Interfaces:
java.io.Serializable

public class ValueDomainDefinition
extends Versionable
implements java.io.Serializable

A definition of a given value domain. A value domain can be a simple description with no associated value domain entries, or it can consist of one or more definitionEntries that resolve to an enumerated list of entityCodes when applied to one or more codingScheme versions.

Version:
$Revision$ $Date$
See Also:
Serialized Form

Constructor Summary
ValueDomainDefinition()
           
 
Method Summary
 void addDefinitionEntry(DefinitionEntry vDefinitionEntry)
           
 void addDefinitionEntry(int index, DefinitionEntry vDefinitionEntry)
           
 void addRepresentsRealmOrContext(Context vRepresentsRealmOrContext)
           
 void addRepresentsRealmOrContext(int index, Context vRepresentsRealmOrContext)
           
 void addSource(int index, Source vSource)
           
 void addSource(Source vSource)
           
 java.util.Enumeration<? extends DefinitionEntry> enumerateDefinitionEntry()
          Method enumerateDefinitionEntry.
 java.util.Enumeration<? extends Context> enumerateRepresentsRealmOrContext()
          Method enumerateRepresentsRealmOrContext.
 java.util.Enumeration<? extends Source> enumerateSource()
          Method enumerateSource.
 CodingSchemeName getDefaultCodingScheme()
          Returns the value of field 'defaultCodingScheme'.
 DefinitionEntry[] getDefinitionEntry()
          Method getDefinitionEntry.Returns the contents of the collection in an Array.
 DefinitionEntry getDefinitionEntry(int index)
          Method getDefinitionEntry.
 java.util.List<DefinitionEntry> getDefinitionEntryAsReference()
          Method getDefinitionEntryAsReference.Returns a reference to '_definitionEntryList'.
 int getDefinitionEntryCount()
          Method getDefinitionEntryCount.
 MappingsLink getMappings()
          Returns the value of field 'mappings'.
 PropertiesLink getProperties()
          Returns the value of field 'properties'.
 Context[] getRepresentsRealmOrContext()
          Method getRepresentsRealmOrContext.Returns the contents of the collection in an Array.
 Context getRepresentsRealmOrContext(int index)
          Method getRepresentsRealmOrContext.
 java.util.List<Context> getRepresentsRealmOrContextAsReference()
          Method getRepresentsRealmOrContextAsReference.Returns a reference to '_representsRealmOrContextList'.
 int getRepresentsRealmOrContextCount()
          Method getRepresentsRealmOrContextCount.
 Source[] getSource()
          Method getSource.Returns the contents of the collection in an Array.
 Source getSource(int index)
          Method getSource.
 java.util.List<Source> getSourceAsReference()
          Method getSourceAsReference.Returns a reference to '_sourceList'.
 int getSourceCount()
          Method getSourceCount.
 ValueDomainDirectoryEntryGroup getValueDomainDirectoryEntryGroup()
          Returns the value of field 'valueDomainDirectoryEntryGroup'.
 boolean isValid()
          Method isValid.
 java.util.Iterator<? extends DefinitionEntry> iterateDefinitionEntry()
          Method iterateDefinitionEntry.
 java.util.Iterator<? extends Context> iterateRepresentsRealmOrContext()
          Method iterateRepresentsRealmOrContext.
 java.util.Iterator<? extends Source> iterateSource()
          Method iterateSource.
 void marshal(org.xml.sax.ContentHandler handler)
           
 void marshal(java.io.Writer out)
           
 void removeAllDefinitionEntry()
           
 void removeAllRepresentsRealmOrContext()
           
 void removeAllSource()
           
 boolean removeDefinitionEntry(DefinitionEntry vDefinitionEntry)
          Method removeDefinitionEntry.
 DefinitionEntry removeDefinitionEntryAt(int index)
          Method removeDefinitionEntryAt.
 boolean removeRepresentsRealmOrContext(Context vRepresentsRealmOrContext)
          Method removeRepresentsRealmOrContext.
 Context removeRepresentsRealmOrContextAt(int index)
          Method removeRepresentsRealmOrContextAt.
 boolean removeSource(Source vSource)
          Method removeSource.
 Source removeSourceAt(int index)
          Method removeSourceAt.
 void setDefaultCodingScheme(CodingSchemeName defaultCodingScheme)
          Sets the value of field 'defaultCodingScheme'.
 void setDefinitionEntry(DefinitionEntry[] vDefinitionEntryArray)
           
 void setDefinitionEntry(int index, DefinitionEntry vDefinitionEntry)
           
 void setDefinitionEntry(java.util.List<DefinitionEntry> vDefinitionEntryList)
          Sets the value of '_definitionEntryList' by copying the given Vector.
 void setDefinitionEntryAsReference(java.util.List<DefinitionEntry> definitionEntryList)
          Deprecated.  
 void setMappings(MappingsLink mappings)
          Sets the value of field 'mappings'.
 void setProperties(PropertiesLink properties)
          Sets the value of field 'properties'.
 void setRepresentsRealmOrContext(Context[] vRepresentsRealmOrContextArray)
           
 void setRepresentsRealmOrContext(int index, Context vRepresentsRealmOrContext)
           
 void setRepresentsRealmOrContext(java.util.List<Context> vRepresentsRealmOrContextList)
          Sets the value of '_representsRealmOrContextList' by copying the given Vector.
 void setRepresentsRealmOrContextAsReference(java.util.List<Context> representsRealmOrContextList)
          Deprecated.  
 void setSource(int index, Source vSource)
           
 void setSource(java.util.List<Source> vSourceList)
          Sets the value of '_sourceList' by copying the given Vector.
 void setSource(Source[] vSourceArray)
           
 void setSourceAsReference(java.util.List<Source> sourceList)
          Deprecated.  
 void setValueDomainDirectoryEntryGroup(ValueDomainDirectoryEntryGroup valueDomainDirectoryEntryGroup)
          Sets the value of field 'valueDomainDirectoryEntryGroup'.
static ValueDomainDefinition unmarshalValueDomainDefinition(java.io.Reader reader)
          Method unmarshalValueDomainDefinition.
 void validate()
           
 
Methods inherited from class org.LexGrid.REST.commonTypes.Versionable
getEffectiveDate, getEntryState, getExpirationDate, getIsActive, getOwner, getStatus, isIsActive, setEffectiveDate, setEntryState, setExpirationDate, setIsActive, setOwner, setStatus, unmarshalVersionable
 
Methods inherited from class org.mayo.edu.lgModel.LexGridBase
getParent, setParent
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ValueDomainDefinition

public ValueDomainDefinition()
Method Detail

addDefinitionEntry

public void addDefinitionEntry(DefinitionEntry vDefinitionEntry)
                        throws java.lang.IndexOutOfBoundsException
Parameters:
vDefinitionEntry -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

addDefinitionEntry

public void addDefinitionEntry(int index,
                               DefinitionEntry vDefinitionEntry)
                        throws java.lang.IndexOutOfBoundsException
Parameters:
index -
vDefinitionEntry -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

addRepresentsRealmOrContext

public void addRepresentsRealmOrContext(Context vRepresentsRealmOrContext)
                                 throws java.lang.IndexOutOfBoundsException
Parameters:
vRepresentsRealmOrContext -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

addRepresentsRealmOrContext

public void addRepresentsRealmOrContext(int index,
                                        Context vRepresentsRealmOrContext)
                                 throws java.lang.IndexOutOfBoundsException
Parameters:
index -
vRepresentsRealmOrContext -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

addSource

public void addSource(Source vSource)
               throws java.lang.IndexOutOfBoundsException
Parameters:
vSource -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

addSource

public void addSource(int index,
                      Source vSource)
               throws java.lang.IndexOutOfBoundsException
Parameters:
index -
vSource -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

enumerateDefinitionEntry

public java.util.Enumeration<? extends DefinitionEntry> enumerateDefinitionEntry()
Method enumerateDefinitionEntry.

Returns:
an Enumeration over all possible elements of this collection

enumerateRepresentsRealmOrContext

public java.util.Enumeration<? extends Context> enumerateRepresentsRealmOrContext()
Method enumerateRepresentsRealmOrContext.

Returns:
an Enumeration over all possible elements of this collection

enumerateSource

public java.util.Enumeration<? extends Source> enumerateSource()
Method enumerateSource.

Returns:
an Enumeration over all possible elements of this collection

getDefaultCodingScheme

public CodingSchemeName getDefaultCodingScheme()
Returns the value of field 'defaultCodingScheme'. The field 'defaultCodingScheme' has the following description: Local name of the primary coding scheme from which the domain is drawn. defaultCodingScheme must match a local id of a supportedCodingScheme in the mappings section.

Returns:
the value of field 'DefaultCodingScheme'.

getDefinitionEntry

public DefinitionEntry getDefinitionEntry(int index)
                                   throws java.lang.IndexOutOfBoundsException
Method getDefinitionEntry.

Parameters:
index -
Returns:
the value of the org.LexGrid.REST.valueSets.DefinitionEntry at the given index
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

getDefinitionEntry

public DefinitionEntry[] getDefinitionEntry()
Method getDefinitionEntry.Returns the contents of the collection in an Array.

Note: Just in case the collection contents are changing in another thread, we pass a 0-length Array of the correct type into the API call. This way we know that the Array returned is of exactly the correct length.

Returns:
this collection as an Array

getDefinitionEntryAsReference

public java.util.List<DefinitionEntry> getDefinitionEntryAsReference()
Method getDefinitionEntryAsReference.Returns a reference to '_definitionEntryList'. No type checking is performed on any modifications to the Vector.

Returns:
a reference to the Vector backing this class

getDefinitionEntryCount

public int getDefinitionEntryCount()
Method getDefinitionEntryCount.

Returns:
the size of this collection

getMappings

public MappingsLink getMappings()
Returns the value of field 'mappings'. The field 'mappings' has the following description: A hyperlink that goes to "./mappings" a page of type lgRESTNaming:mappings

Returns:
the value of field 'Mappings'.

getProperties

public PropertiesLink getProperties()
Returns the value of field 'properties'. The field 'properties' has the following description: A hyperlink that goes to a properties collection

Returns:
the value of field 'Properties'.

getRepresentsRealmOrContext

public Context getRepresentsRealmOrContext(int index)
                                    throws java.lang.IndexOutOfBoundsException
Method getRepresentsRealmOrContext.

Parameters:
index -
Returns:
the value of the org.LexGrid.REST.commonTypes.Context at the given index
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

getRepresentsRealmOrContext

public Context[] getRepresentsRealmOrContext()
Method getRepresentsRealmOrContext.Returns the contents of the collection in an Array.

Note: Just in case the collection contents are changing in another thread, we pass a 0-length Array of the correct type into the API call. This way we know that the Array returned is of exactly the correct length.

Returns:
this collection as an Array

getRepresentsRealmOrContextAsReference

public java.util.List<Context> getRepresentsRealmOrContextAsReference()
Method getRepresentsRealmOrContextAsReference.Returns a reference to '_representsRealmOrContextList'. No type checking is performed on any modifications to the Vector.

Returns:
a reference to the Vector backing this class

getRepresentsRealmOrContextCount

public int getRepresentsRealmOrContextCount()
Method getRepresentsRealmOrContextCount.

Returns:
the size of this collection

getSource

public Source getSource(int index)
                 throws java.lang.IndexOutOfBoundsException
Method getSource.

Parameters:
index -
Returns:
the value of the org.LexGrid.REST.commonTypes.Source at the given index
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

getSource

public Source[] getSource()
Method getSource.Returns the contents of the collection in an Array.

Note: Just in case the collection contents are changing in another thread, we pass a 0-length Array of the correct type into the API call. This way we know that the Array returned is of exactly the correct length.

Returns:
this collection as an Array

getSourceAsReference

public java.util.List<Source> getSourceAsReference()
Method getSourceAsReference.Returns a reference to '_sourceList'. No type checking is performed on any modifications to the Vector.

Returns:
a reference to the Vector backing this class

getSourceCount

public int getSourceCount()
Method getSourceCount.

Returns:
the size of this collection

getValueDomainDirectoryEntryGroup

public ValueDomainDirectoryEntryGroup getValueDomainDirectoryEntryGroup()
Returns the value of field 'valueDomainDirectoryEntryGroup'.

Returns:
the value of field 'ValueDomainDirectoryEntryGroup'.

isValid

public boolean isValid()
Method isValid.

Overrides:
isValid in class Versionable
Returns:
true if this object is valid according to the schema

iterateDefinitionEntry

public java.util.Iterator<? extends DefinitionEntry> iterateDefinitionEntry()
Method iterateDefinitionEntry.

Returns:
an Iterator over all possible elements in this collection

iterateRepresentsRealmOrContext

public java.util.Iterator<? extends Context> iterateRepresentsRealmOrContext()
Method iterateRepresentsRealmOrContext.

Returns:
an Iterator over all possible elements in this collection

iterateSource

public java.util.Iterator<? extends Source> iterateSource()
Method iterateSource.

Returns:
an Iterator over all possible elements in this collection

marshal

public void marshal(java.io.Writer out)
             throws org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException
Overrides:
marshal in class Versionable
Parameters:
out -
Throws:
org.exolab.castor.xml.MarshalException - if object is null or if any SAXException is thrown during marshaling
org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema

marshal

public void marshal(org.xml.sax.ContentHandler handler)
             throws java.io.IOException,
                    org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException
Overrides:
marshal in class Versionable
Parameters:
handler -
Throws:
java.io.IOException - if an IOException occurs during marshaling
org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema
org.exolab.castor.xml.MarshalException - if object is null or if any SAXException is thrown during marshaling

removeAllDefinitionEntry

public void removeAllDefinitionEntry()

removeAllRepresentsRealmOrContext

public void removeAllRepresentsRealmOrContext()

removeAllSource

public void removeAllSource()

removeDefinitionEntry

public boolean removeDefinitionEntry(DefinitionEntry vDefinitionEntry)
Method removeDefinitionEntry.

Parameters:
vDefinitionEntry -
Returns:
true if the object was removed from the collection.

removeDefinitionEntryAt

public DefinitionEntry removeDefinitionEntryAt(int index)
Method removeDefinitionEntryAt.

Parameters:
index -
Returns:
the element removed from the collection

removeRepresentsRealmOrContext

public boolean removeRepresentsRealmOrContext(Context vRepresentsRealmOrContext)
Method removeRepresentsRealmOrContext.

Parameters:
vRepresentsRealmOrContext -
Returns:
true if the object was removed from the collection.

removeRepresentsRealmOrContextAt

public Context removeRepresentsRealmOrContextAt(int index)
Method removeRepresentsRealmOrContextAt.

Parameters:
index -
Returns:
the element removed from the collection

removeSource

public boolean removeSource(Source vSource)
Method removeSource.

Parameters:
vSource -
Returns:
true if the object was removed from the collection.

removeSourceAt

public Source removeSourceAt(int index)
Method removeSourceAt.

Parameters:
index -
Returns:
the element removed from the collection

setDefaultCodingScheme

public void setDefaultCodingScheme(CodingSchemeName defaultCodingScheme)
Sets the value of field 'defaultCodingScheme'. The field 'defaultCodingScheme' has the following description: Local name of the primary coding scheme from which the domain is drawn. defaultCodingScheme must match a local id of a supportedCodingScheme in the mappings section.

Parameters:
defaultCodingScheme - the value of field 'defaultCodingScheme'.

setDefinitionEntry

public void setDefinitionEntry(int index,
                               DefinitionEntry vDefinitionEntry)
                        throws java.lang.IndexOutOfBoundsException
Parameters:
index -
vDefinitionEntry -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

setDefinitionEntry

public void setDefinitionEntry(DefinitionEntry[] vDefinitionEntryArray)
Parameters:
vDefinitionEntryArray -

setDefinitionEntry

public void setDefinitionEntry(java.util.List<DefinitionEntry> vDefinitionEntryList)
Sets the value of '_definitionEntryList' by copying the given Vector. All elements will be checked for type safety.

Parameters:
vDefinitionEntryList - the Vector to copy.

setDefinitionEntryAsReference

public void setDefinitionEntryAsReference(java.util.List<DefinitionEntry> definitionEntryList)
Deprecated. 

Sets the value of '_definitionEntryList' by setting it to the given Vector. No type checking is performed.

Parameters:
definitionEntryList - the Vector to set.

setMappings

public void setMappings(MappingsLink mappings)
Sets the value of field 'mappings'. The field 'mappings' has the following description: A hyperlink that goes to "./mappings" a page of type lgRESTNaming:mappings

Parameters:
mappings - the value of field 'mappings'.

setProperties

public void setProperties(PropertiesLink properties)
Sets the value of field 'properties'. The field 'properties' has the following description: A hyperlink that goes to a properties collection

Parameters:
properties - the value of field 'properties'.

setRepresentsRealmOrContext

public void setRepresentsRealmOrContext(int index,
                                        Context vRepresentsRealmOrContext)
                                 throws java.lang.IndexOutOfBoundsException
Parameters:
index -
vRepresentsRealmOrContext -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

setRepresentsRealmOrContext

public void setRepresentsRealmOrContext(Context[] vRepresentsRealmOrContextArray)
Parameters:
vRepresentsRealmOrContextArray -

setRepresentsRealmOrContext

public void setRepresentsRealmOrContext(java.util.List<Context> vRepresentsRealmOrContextList)
Sets the value of '_representsRealmOrContextList' by copying the given Vector. All elements will be checked for type safety.

Parameters:
vRepresentsRealmOrContextList - the Vector to copy.

setRepresentsRealmOrContextAsReference

public void setRepresentsRealmOrContextAsReference(java.util.List<Context> representsRealmOrContextList)
Deprecated. 

Sets the value of '_representsRealmOrContextList' by setting it to the given Vector. No type checking is performed.

Parameters:
representsRealmOrContextList - the Vector to set.

setSource

public void setSource(int index,
                      Source vSource)
               throws java.lang.IndexOutOfBoundsException
Parameters:
index -
vSource -
Throws:
java.lang.IndexOutOfBoundsException - if the index given is outside the bounds of the collection

setSource

public void setSource(Source[] vSourceArray)
Parameters:
vSourceArray -

setSource

public void setSource(java.util.List<Source> vSourceList)
Sets the value of '_sourceList' by copying the given Vector. All elements will be checked for type safety.

Parameters:
vSourceList - the Vector to copy.

setSourceAsReference

public void setSourceAsReference(java.util.List<Source> sourceList)
Deprecated. 

Sets the value of '_sourceList' by setting it to the given Vector. No type checking is performed.

Parameters:
sourceList - the Vector to set.

setValueDomainDirectoryEntryGroup

public void setValueDomainDirectoryEntryGroup(ValueDomainDirectoryEntryGroup valueDomainDirectoryEntryGroup)
Sets the value of field 'valueDomainDirectoryEntryGroup'.

Parameters:
valueDomainDirectoryEntryGroup - the value of field 'valueDomainDirectoryEntryGroup'.

unmarshalValueDomainDefinition

public static ValueDomainDefinition unmarshalValueDomainDefinition(java.io.Reader reader)
                                                            throws org.exolab.castor.xml.MarshalException,
                                                                   org.exolab.castor.xml.ValidationException
Method unmarshalValueDomainDefinition.

Parameters:
reader -
Returns:
the unmarshaled org.LexGrid.REST.valueSets.ValueDomainDefinition
Throws:
org.exolab.castor.xml.MarshalException - if object is null or if any SAXException is thrown during marshaling
org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema

validate

public void validate()
              throws org.exolab.castor.xml.ValidationException
Overrides:
validate in class Versionable
Throws:
org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema

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.