Package org.datanucleus.metadata.xml
Class AbstractMetaDataHandler
- java.lang.Object
-
- org.xml.sax.helpers.DefaultHandler
-
- org.datanucleus.metadata.xml.AbstractMetaDataHandler
-
- All Implemented Interfaces:
ContentHandler
,DTDHandler
,EntityResolver
,ErrorHandler
- Direct Known Subclasses:
PersistenceFileMetaDataHandler
public class AbstractMetaDataHandler extends DefaultHandler
Abstract handler for MetaData parsing. Should be extended to handle processing of specific types of metadata.
-
-
Field Summary
Fields Modifier and Type Field Description protected StringBuilder
charactersBuffer
parser bufferprotected EntityResolver
entityResolver
Entity Resolver to use (if required)protected String
filename
Filename containing the XML metadataprotected MetaData
metadata
The MetaData for this file (the end result of the parse process).protected MetaDataManager
mmgr
Manager for the MetaData.protected Stack<MetaData>
stack
Stack of meta-data elements.protected boolean
validate
Whether to validate while parsing.
-
Constructor Summary
Constructors Constructor Description AbstractMetaDataHandler(MetaDataManager mmgr, String filename, EntityResolver resolver)
Constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
characters(char[] ch, int start, int length)
Notification handler for the "body" data inside an element.void
error(SAXParseException e)
Parser error method.protected String
getAttr(Attributes attrs, String key)
Accessor for an attribute out of the attributes for an element.protected String
getAttr(Attributes attrs, String key, String defaultValue)
Accessor for an attribute out of the attributes for an element.MetaData
getMetaData()
Accessor for the MetaData for this file.protected MetaData
getStack()
Accessor for the current MetaData component.String
getString()
Accessor for the "body" text metadata.boolean
isPersistenceContext()
protected MetaData
popStack()
Method to remove the current MetaData component from the Stack.protected void
pushStack(MetaData md)
Method to add a MetaData component to the Stack.InputSource
resolveEntity(String publicId, String systemId)
Method to resolve XML entities.void
setValidate(boolean validate)
Method to set whether to validate during the the handling.-
Methods inherited from class org.xml.sax.helpers.DefaultHandler
endDocument, endElement, endPrefixMapping, fatalError, ignorableWhitespace, notationDecl, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning
-
-
-
-
Field Detail
-
mmgr
protected final MetaDataManager mmgr
Manager for the MetaData.
-
filename
protected final String filename
Filename containing the XML metadata
-
metadata
protected MetaData metadata
The MetaData for this file (the end result of the parse process).
-
entityResolver
protected final EntityResolver entityResolver
Entity Resolver to use (if required)
-
charactersBuffer
protected StringBuilder charactersBuffer
parser buffer
-
validate
protected boolean validate
Whether to validate while parsing.
-
-
Constructor Detail
-
AbstractMetaDataHandler
public AbstractMetaDataHandler(MetaDataManager mmgr, String filename, EntityResolver resolver)
Constructor.- Parameters:
mmgr
- Manager for the MetaDatafilename
- The filenameresolver
- Entity Resolver to use (null if not available)
-
-
Method Detail
-
isPersistenceContext
public boolean isPersistenceContext()
-
setValidate
public void setValidate(boolean validate)
Method to set whether to validate during the the handling.- Parameters:
validate
- Whether to validate
-
getMetaData
public MetaData getMetaData()
Accessor for the MetaData for this file.- Returns:
- The MetaData.
-
error
public void error(SAXParseException e) throws SAXException
Parser error method. If any syntactical errors are encountered on validation they will appear here and be logged as warnings. Just points the user to the line/column of their Meta-Data file for now.- Specified by:
error
in interfaceErrorHandler
- Overrides:
error
in classDefaultHandler
- Parameters:
e
- Parse Exception- Throws:
SAXException
- See Also:
ErrorHandler.error(org.xml.sax.SAXParseException)
-
getAttr
protected String getAttr(Attributes attrs, String key, String defaultValue)
Accessor for an attribute out of the attributes for an element. Allows the specification of a default if no value is provided.- Parameters:
attrs
- The attributeskey
- Key for the attribute to returndefaultValue
- A default to impose if no value.- Returns:
- Value for the attribute with the specified key.
-
getAttr
protected String getAttr(Attributes attrs, String key)
Accessor for an attribute out of the attributes for an element.- Parameters:
attrs
- The attributeskey
- Key for the attribute to return- Returns:
- Value for the attribute with the specified key.
-
resolveEntity
public InputSource resolveEntity(String publicId, String systemId) throws SAXException
Method to resolve XML entities. Uses the entity resolver (if provided) to check for local variants.- Specified by:
resolveEntity
in interfaceEntityResolver
- Overrides:
resolveEntity
in classDefaultHandler
- Parameters:
publicId
- The public id.systemId
- The system id.- Returns:
- Input Source for the URI.
- Throws:
SAXException
- See Also:
EntityResolver.resolveEntity(java.lang.String,java.lang.String)
-
characters
public void characters(char[] ch, int start, int length) throws SAXException
Notification handler for the "body" data inside an element.- Specified by:
characters
in interfaceContentHandler
- Overrides:
characters
in classDefaultHandler
- Parameters:
ch
- The charactersstart
- The start position in the character array.length
- The length of the string.- Throws:
SAXException
- in parsing errors
-
getString
public String getString()
Accessor for the "body" text metadata. Resets the body text after access.- Returns:
- the string form of this metadata
-
getStack
protected MetaData getStack()
Accessor for the current MetaData component.- Returns:
- The current MetaData component.
-
popStack
protected MetaData popStack()
Method to remove the current MetaData component from the Stack.- Returns:
- Latest MetaData component.
-
pushStack
protected void pushStack(MetaData md)
Method to add a MetaData component to the Stack.- Parameters:
md
- The component to add.
-
-