com.sun.xml.xsom.parser
Class AnnotationParser

java.lang.Object
  extended by com.sun.xml.xsom.parser.AnnotationParser

public abstract class AnnotationParser
extends java.lang.Object

Used to parse <xs:annotation>.

Author:
Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)

Constructor Summary
AnnotationParser()
           
 
Method Summary
abstract  org.xml.sax.ContentHandler getContentHandler(AnnotationContext context, java.lang.String parentElementName, org.xml.sax.ErrorHandler errorHandler, org.xml.sax.EntityResolver entityResolver)
          Called every time a new <xs:annotation> element is found.
abstract  java.lang.Object getResult(java.lang.Object existing)
          Once the SAX events are fed to the ContentHandler, this method will be called to retrieve the parsed result.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AnnotationParser

public AnnotationParser()
Method Detail

getContentHandler

public abstract org.xml.sax.ContentHandler getContentHandler(AnnotationContext context,
                                                             java.lang.String parentElementName,
                                                             org.xml.sax.ErrorHandler errorHandler,
                                                             org.xml.sax.EntityResolver entityResolver)
Called every time a new <xs:annotation> element is found. The sub-tree rooted at <xs:annotation> will be sent to this ContentHandler as if it is a whole document.

Parameters:
context - indicates the schema component that owns this annotation. Always non-null.
parentElementName - local name of the element that contains <xs:annotation>. (e.g., "element", "attribute", ... )
errorHandler - The error handler that the client application specifies. The returned content handler can send its errors to this object.
entityResolver - The entity resolver that is currently in use. Again, The returned content handler can use this object if it needs to resolve entities.

getResult

public abstract java.lang.Object getResult(java.lang.Object existing)
Once the SAX events are fed to the ContentHandler, this method will be called to retrieve the parsed result.

Parameters:
existing - An annotation object which was returned from another AnnotationParser before. Sometimes, one schema component can have multiple <:xs:annotation> elements and this parameter is used to merge all those annotations together. If there is no existing object, null will be passed.
Returns:
Any object, including null.