|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
public interface XMLParser
A UIMA XMLParser parses XML documents and generates UIMA components represented by
the XML.
An application obtains a reference to the XMLParser by calling the
UIMAFramework.getXMLParser() method. The application then uses the
XMLParser by passing an InputStream to one of its
parse methods - for example
parseAnalysisEngineDescription(XMLInputSource) for parsing an
AnalysisEngineDescription from its XML representation.
XML schema validation is off by default; it can be turned on by calling the method
enableSchemaValidation(boolean).
UIMA developers who provide new types of XMLizable components must configure the XML parser by
using the addMapping(String,String) method to specify mappings between XML Element names
and the class names of the objects to be built from elements with those names. All objects to be
built by the XML parser must implement XMLizable and provide an implementation of
XMLizable.buildFromXMLElement(Element, XMLParser).
Note that we are considering replacing this ad-hoc XML data binding interface with the java standard extension JAXB. See http://java.sun.com/xml/jaxb for details on JAXB.
| Nested Class Summary | |
|---|---|
static class |
XMLParser.ParsingOptions
Option settings for the parser. |
| Field Summary | |
|---|---|
static String |
RESOURCE_SPECIFIER_NAMESPACE
XML namespace for ResourceSpecifiers. |
static String |
RESOURCE_SPECIFIER_SCHEMA_NAME
Name of schema for ResourceSpecifiers. |
| Method Summary | |
|---|---|
void |
addMapping(String aElementName,
String aClassName)
Configures this XMLParser by registering a mapping between the name of an XML element and the Class of object to be built from elements with that name. |
XMLizable |
buildObject(Element aElement)
Builds an object from its XML DOM representation. |
XMLizable |
buildObject(Element aElement,
XMLParser.ParsingOptions aOptions)
Builds an object from its XML DOM representation. |
Object |
buildObjectOrPrimitive(Element aElement,
XMLParser.ParsingOptions aOptions)
Builds an object from its XML DOM representation. |
void |
enableSchemaValidation(boolean aEnable)
Enables or disables XML scheam validation. |
SaxDeserializer |
newSaxDeserializer()
Creates a new SaxDeserializer object, which implements the SAX
ContentHandler interface and can be used to deserialize an
XMLizable object from the events sent from a SAX parser. |
SaxDeserializer |
newSaxDeserializer(XMLParser.ParsingOptions aOptions)
Creates a new SaxDeserializer. |
XMLizable |
parse(XMLInputSource aInput)
Parses an XML input stream and produces an object. |
XMLizable |
parse(XMLInputSource aInput,
String aNamespaceForSchema,
URL aSchemaUrl)
Parses an XML input stream and produces an object. |
XMLizable |
parse(XMLInputSource aInput,
String aNamespaceForSchema,
URL aSchemaUrl,
XMLParser.ParsingOptions aOptions)
Parses an XML input stream and produces an object. |
XMLizable |
parse(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses an XML input stream and produces an object. |
AnalysisEngineDescription |
parseAnalysisEngineDescription(XMLInputSource aInput)
Parses an AnalysisEngineDescription from an XML input stream. |
AnalysisEngineDescription |
parseAnalysisEngineDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses an AnalysisEngineDescription from an XML input stream. |
CasConsumerDescription |
parseCasConsumerDescription(XMLInputSource aInput)
Parses a CasConsumerDescription from an XML input stream. |
CasConsumerDescription |
parseCasConsumerDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a CasConsumerDescription from an XML input stream. |
CasInitializerDescription |
parseCasInitializerDescription(XMLInputSource aInput)
Parses a CasInitializerDescription from an XML input stream. |
CasInitializerDescription |
parseCasInitializerDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a CasInitializerDescription from an XML input stream. |
CollectionReaderDescription |
parseCollectionReaderDescription(XMLInputSource aInput)
Parses a CollectionReaderDescription from an XML input stream. |
CollectionReaderDescription |
parseCollectionReaderDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a CollectionReaderDescription from an XML input stream. |
CpeDescription |
parseCpeDescription(XMLInputSource aInput)
Parses a CpeDescription from an XML input stream. |
CustomResourceSpecifier |
parseCustomResourceSpecifier(XMLInputSource aInput)
Parses a CustomResourceSpecifier from an XML input stream. |
CustomResourceSpecifier |
parseCustomResourceSpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a CustomResourceSpecifier from an XML input stream. |
FlowControllerDescription |
parseFlowControllerDescription(XMLInputSource aInput)
Parses a FlowControllerDescription from an XML input stream. |
FlowControllerDescription |
parseFlowControllerDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a FlowControllerDescription from an XML input stream. |
FsIndexCollection |
parseFsIndexCollection(XMLInputSource aInput)
Parses a FsIndexCollection from an XML input stream. |
FsIndexCollection |
parseFsIndexCollection(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a FsIndexCollection from an XML input stream. |
IndexBuildSpecification |
parseIndexBuildSpecification(XMLInputSource aInput)
Parses an IndexBuildSpecification from an XML input stream. |
IndexBuildSpecification |
parseIndexBuildSpecification(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses an IndexBuildSpecification from an XML input stream. |
PearSpecifier |
parsePearSpecifier(XMLInputSource aInput)
Parses a PearSpecifier from an XML input stream. |
PearSpecifier |
parsePearSpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a PearSpecifier from an XML input stream. |
ResourceManagerConfiguration |
parseResourceManagerConfiguration(XMLInputSource aInput)
Parses a ResourceManagerConfiguration from an XML input stream. |
ResourceManagerConfiguration |
parseResourceManagerConfiguration(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a ResourceManagerConfiguration from an XML input stream. |
ResourceMetaData |
parseResourceMetaData(XMLInputSource aInput)
Parses a ResourceMetaData object from an XML input stream. |
ResourceMetaData |
parseResourceMetaData(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a ResourceMetaData object from an XML input stream. |
ResourceSpecifier |
parseResourceSpecifier(XMLInputSource aInput)
Parses a ResourceSpecifier from an XML input stream. |
ResourceSpecifier |
parseResourceSpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a ResourceSpecifier from an XML input stream. |
ResultSpecification |
parseResultSpecification(XMLInputSource aInput)
Parses a ResultSpecification from an XML input stream. |
ResultSpecification |
parseResultSpecification(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a ResultSpecification from an XML input stream. |
TaeDescription |
parseTaeDescription(XMLInputSource aInput)
Deprecated. As of v2.0, parseAnalysisEngineDescription(XMLInputSource) should be used
instead. |
TaeDescription |
parseTaeDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Deprecated. As of v2.0, parseAnalysisEngineDescription(XMLInputSource,ParsingOptions)
should be used instead. |
TypePriorities |
parseTypePriorities(XMLInputSource aInput)
Parses a TypePriorities declaration from an XML input stream. |
TypePriorities |
parseTypePriorities(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a TypePriorities declaration from an XML input stream. |
TypeSystemDescription |
parseTypeSystemDescription(XMLInputSource aInput)
Parses a TypeSystemDescription from an XML input stream. |
TypeSystemDescription |
parseTypeSystemDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a TypeSystemDescription from an XML input stream. |
URISpecifier |
parseURISpecifier(XMLInputSource aInput)
Parses a URISpecifier from an XML input stream. |
URISpecifier |
parseURISpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
Parses a URISpecifier from an XML input stream. |
| Field Detail |
|---|
static final String RESOURCE_SPECIFIER_NAMESPACE
static final String RESOURCE_SPECIFIER_SCHEMA_NAME
| Method Detail |
|---|
void enableSchemaValidation(boolean aEnable)
aEnable - true to enable validation, false to disable validation
XMLizable parse(XMLInputSource aInput,
String aNamespaceForSchema,
URL aSchemaUrl)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaNamespaceForSchema - XML namespace for elements to be validated against XML schema. If null, no schema will
be used (unless one is declared in the document itself). This parameter is ignored if
schema validation has not been enabled via enableSchemaValidation(boolean).aSchemaUrl - URL to XML schema that will be used to validate the XML document. If null, no schema
will be used (unless one is declared in the document itself). This parameter is
ignored if schema validation has not been enabled via
enableSchemaValidation(boolean).
XMLizable object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid object
XMLizable parse(XMLInputSource aInput,
String aNamespaceForSchema,
URL aSchemaUrl,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaNamespaceForSchema - XML namespace for elements to be validated against XML schema. If null, no schema will
be used (unless one is declared in the document itself). This parameter is ignored if
schema validation has not been enabled via enableSchemaValidation(boolean).aSchemaUrl - URL to XML schema that will be used to validate the XML document. If null, no schema
will be used (unless one is declared in the document itself). This parameter is
ignored if schema validation has not been enabled via
enableSchemaValidation(boolean).aOptions - option settings
XMLizable object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid object
XMLizable parse(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
XMLizable object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid object
XMLizable parse(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
XMLizable object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid object
ResourceSpecifier parseResourceSpecifier(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
ResourceSpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid ResourceSpecifier
ResourceSpecifier parseResourceSpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
ResourceSpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid ResourceSpecifier
ResourceMetaData parseResourceMetaData(XMLInputSource aInput)
throws InvalidXMLException
RESOURCE_SPECIFIER_SCHEMA_NAME if it can be found in the classpath.
aInput - the input source from which to read the XML document
ResourceMetaData object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid ResourceSpecifier
ResourceMetaData parseResourceMetaData(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
RESOURCE_SPECIFIER_SCHEMA_NAME if it can be found in the classpath.
aInput - the input source from which to read the XML documentaOptions - option settings
ResourceMetaData object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid ResourceSpecifier
URISpecifier parseURISpecifier(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
URISpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid URISpecifier
URISpecifier parseURISpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
URISpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid URISpecifier
AnalysisEngineDescription parseAnalysisEngineDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
AnalysisEngineDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid AnalysisEngineDescription
AnalysisEngineDescription parseAnalysisEngineDescription(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
AnalysisEngineDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid AnalysisEngineDescription
@Deprecated
TaeDescription parseTaeDescription(XMLInputSource aInput)
throws InvalidXMLException
parseAnalysisEngineDescription(XMLInputSource) should be used
instead.
aInput - the input source from which to read the XML document
TaeDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid TaeDescription
@Deprecated
TaeDescription parseTaeDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
parseAnalysisEngineDescription(XMLInputSource,ParsingOptions)
should be used instead.
aInput - the input source from which to read the XML documentaOptions - option settings
TaeDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid TaeDescription
CasConsumerDescription parseCasConsumerDescription(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
CasConsumerDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CasConsumerDescription
CasConsumerDescription parseCasConsumerDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
CasConsumerDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CasConsumerDescription
CasInitializerDescription parseCasInitializerDescription(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
CasInitializerDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CasInitializerDescription
CasInitializerDescription parseCasInitializerDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
CasInitializerDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CasInitializerDescription
CollectionReaderDescription parseCollectionReaderDescription(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
CollectionReaderDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CollectionReaderDescription
CollectionReaderDescription parseCollectionReaderDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
CollectionReaderDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CollectionReaderDescription
CpeDescription parseCpeDescription(XMLInputSource aInput)
throws InvalidXMLException
NOTE: the option settings XMLParser.ParsingOptions are not currently available for parsing
CpeDescriptions, because they use a different parsing mechanism than the other specifier types.
aInput - the input source from which to read the XML document
cpeDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid IndexingSpecification
ResultSpecification parseResultSpecification(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
ResultSpecification object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid ResultSpecification
ResultSpecification parseResultSpecification(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
ResultSpecification object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid ResultSpecification
TypeSystemDescription parseTypeSystemDescription(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
TypeSystemDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid TypeSystemDescription
TypeSystemDescription parseTypeSystemDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
TypeSystemDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid TypeSystemDescription
TypePriorities parseTypePriorities(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
TypePriorities object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid TypePriorities
TypePriorities parseTypePriorities(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
TypePriorities object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid TypePriorities
FsIndexCollection parseFsIndexCollection(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
FsIndexCollection object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid FsIndexCollection
FsIndexCollection parseFsIndexCollection(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
FsIndexCollection object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid FsIndexCollection
ResourceManagerConfiguration parseResourceManagerConfiguration(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
ResourceManagerConfiguration object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid
ResourceManagerConfiguration
ResourceManagerConfiguration parseResourceManagerConfiguration(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
ResourceManagerConfiguration object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid
ResourceManagerConfiguration
FlowControllerDescription parseFlowControllerDescription(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
FlowControllerDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid FlowControllerDescription
FlowControllerDescription parseFlowControllerDescription(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
FlowControllerDescription object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid FlowControllerDescription
CustomResourceSpecifier parseCustomResourceSpecifier(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
CustomResourceSpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CustomResourceSpecifier
CustomResourceSpecifier parseCustomResourceSpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
CustomResourceSpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid CustomResourceSpecifier
PearSpecifier parsePearSpecifier(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
PearSpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid PearSpecifier
PearSpecifier parsePearSpecifier(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
PearSpecifier object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid PearSpecifier
IndexBuildSpecification parseIndexBuildSpecification(XMLInputSource aInput)
throws InvalidXMLException
aInput - the input source from which to read the XML document
IndexBuildSpecification object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid IndexBuildSpecification
IndexBuildSpecification parseIndexBuildSpecification(XMLInputSource aInput,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
aInput - the input source from which to read the XML documentaOptions - option settings
IndexBuildSpecification object constructed from the XML document
InvalidXMLException - if the input XML is not valid or does not specify a valid IndexBuildSpecification
XMLizable buildObject(Element aElement)
throws InvalidXMLException
XMLizable.buildFromXMLElement(Element, XMLParser) method to construct sub-objects.
aElement - a DOM Element
XMLizable object constructed from the DOM element
InvalidXMLException - if the XML element does not specify a valid object
XMLizable buildObject(Element aElement,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
XMLizable.buildFromXMLElement(Element, XMLParser) method to construct sub-objects.
aElement - a DOM ElementaOptions - option settings
XMLizable object constructed from the DOM element
InvalidXMLException - if the XML element does not specify a valid object
Object buildObjectOrPrimitive(Element aElement,
XMLParser.ParsingOptions aOptions)
throws InvalidXMLException
XMLizable.buildFromXMLElement(Element, XMLParser) method to construct sub-objects.
This method is similar to buildObject(Element, XMLParser.ParsingOptions) but can also
parse primitive-typed objects wrapped as XML elements, such as
<integer>42</integer.
aElement - a DOM ElementaOptions - option settings
XMLizable, String, or one of the primitive type wrapper objects (e.g.
Integer, Float, Boolean).
InvalidXMLException - if the XML element does not specify a valid objectSaxDeserializer newSaxDeserializer()
SaxDeserializer object, which implements the SAX
ContentHandler interface and can be used to deserialize an
XMLizable object from the events sent from a SAX parser. This can be used if the
application already has a SAX parser that generates these events. In most cases, it is easier
to use one of the parse methods on this interface.
The SAX deserializer returned my this method will expand XIncludes but will not do schema validation.
ContentHandler and can be used to
deserialize an XMLizable object from SAX events.
InvalidXMLException - if the XML element does not specify a valid objectSaxDeserializer newSaxDeserializer(XMLParser.ParsingOptions aOptions)
SaxDeserializer.
aOptions - option settings
ContentHandler and can be used to
deserialize an XMLizable object from SAX events.
InvalidXMLException - if the XML element does not specify a valid objectnewSaxDeserializer()
void addMapping(String aElementName,
String aClassName)
throws ClassNotFoundException
aElementName - the name of an XML elementaClassName - the name of a Class of object to be built. This class must implement XMLizable
and have a zero-argument constructor.
ClassNotFoundException - if the class named by aClassName could not be found
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||