XSOM 20110809-redhat-3

com.sun.xml.xsom.parser
Class AnnotationParser

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

public abstract class AnnotationParser
extends Object

Used to parse <xs:annotation>.

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

Constructor Summary
AnnotationParser()
           
 
Method Summary
abstract  ContentHandler getContentHandler(AnnotationContext context, String parentElementName, ErrorHandler errorHandler, EntityResolver entityResolver)
          Called every time a new <xs:annotation> element is found.
abstract  Object getResult(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
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AnnotationParser

public AnnotationParser()
Method Detail

getContentHandler

public abstract ContentHandler getContentHandler(AnnotationContext context,
                                                 String parentElementName,
                                                 ErrorHandler errorHandler,
                                                 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 Object getResult(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.

XSOM 20110809-redhat-3

Copyright © 2012 Oracle. All Rights Reserved.