Package org.geotools.xml
Class XMLElementHandler
- Object
-
- XMLElementHandler
-
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
ComplexElementHandler
,DocumentHandler
,IgnoreHandler
,SimpleElementHandler
public abstract class XMLElementHandler extends Object implements Serializable
Intended to act as both a definition and a generic handler.- Author:
- dzwiers, Refractions Research, Inc. http://www.refractions.net, $Author:$ (last modification)
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
XMLElementHandler()
Creates a new XSIElementHandler object.
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description void
characters(String text)
This method throws a SAXNotSupportedException if it is called and not overwritten.abstract void
endElement(URI namespaceURI, String localName, Map<String,Object> hints)
handles SAX end Element events.abstract Element
getElement()
This returns the Element specified.abstract XMLElementHandler
getHandler(URI namespaceURI, String localName, Map<String,Object> hints)
This will find an appropriate XMLElementHandler for the specified child if appropriate.abstract String
getName()
This returns the name of the element being represented by this handler.abstract Object
getValue()
This method will get the value of the element depending on it's type.static void
setLogLevel(Level l)
Sets the logger level for all XMLElementHandlers.abstract void
startElement(URI namespaceURI, String localName, Attributes attr)
handles SAX start Element events.
-
-
-
Field Detail
-
logger
protected static final Logger logger
the logger -- should be used for debugging (assuming there are bugs LOL)
-
-
Method Detail
-
characters
public void characters(String text) throws SAXException
This method throws a SAXNotSupportedException if it is called and not overwritten. When overridding this method, you should be careful to understand that it may be called more than once per element. Therefore it would be advisable to log the text and handle the text's interpretation at a later time (- Throws:
SAXException
-
endElement
public abstract void endElement(URI namespaceURI, String localName, Map<String,Object> hints) throws SAXException, OperationNotSupportedException
handles SAX end Element events. This matches the end of the element declaration in the document ... and responds to the event generated by the SAX parser. This is an opportunity to complete some post-processing.- Throws:
SAXException
OperationNotSupportedException
- See Also:
SchemaContentHandler#endElement
-
startElement
public abstract void startElement(URI namespaceURI, String localName, Attributes attr) throws SAXException
handles SAX start Element events. This matches the start of the element declaration in the document ... and responds to the event generated by the SAX parser. This is an opportunity to complete some pre-processing.- Throws:
SAXException
- See Also:
SchemaContentHandler#startElement
-
getHandler
public abstract XMLElementHandler getHandler(URI namespaceURI, String localName, Map<String,Object> hints) throws SAXException
This will find an appropriate XMLElementHandler for the specified child if appropriate. This method may return or throw an exception, depending on the severity, if an error occurs. This method should be used to complete a SAX parse of a document for which the Schema is known, and parsed.- Returns:
- XMLElementHandler, or null
- Throws:
SAXException
-
getValue
public abstract Object getValue() throws SAXException
This method will get the value of the element depending on it's type.- Returns:
- Object (may be null)
- Throws:
SAXException
- See Also:
Type#getValue
-
getName
public abstract String getName()
This returns the name of the element being represented by this handler. This name matches the name specified in the Schema.- Returns:
- The Name (may not be null)
-
getElement
public abstract Element getElement()
This returns the Element specified.- Returns:
- Element (may not be null)
-
setLogLevel
public static void setLogLevel(Level l)
Sets the logger level for all XMLElementHandlers.
-
-