001//
002// This file was generated by the JavaTM Architecture for XML Binding(JAXB) Reference Implementation, v1.0.6-01/24/2006 06:15 PM(kohsuke)-fcs 
003// See <a href="http://java.sun.com/xml/jaxb">http://java.sun.com/xml/jaxb</a> 
004// Any modifications to this file will be lost upon recompilation of the source schema. 
005// Generated on: 2012.10.03 at 04:27:47 AM CEST 
006//
007
008package org.jdtaus.mojo.resource.model.impl.runtime;
009
010import javax.xml.bind.UnmarshallerHandler;
011import javax.xml.bind.ValidationEvent;
012
013import org.xml.sax.SAXException;
014
015/**
016 * Unified event handler that processes
017 * both the SAX events and error events.
018 * 
019 * <p>
020 * This interface refines {@link ContentHandler} as follows:
021 * <ol>
022 *  <li>element names and attribute names must be {@link String#intern()}ed.
023 *  <li>namespace prefix and uris must be {@link String#intern()}ed.
024 * </ol>
025 */
026public interface SAXUnmarshallerHandler extends UnmarshallerHandler {
027    
028    /**
029     * Reports an error to the user, and asks if s/he wants
030     * to recover. If the canRecover flag is false, regardless
031     * of the client instruction, an exception will be thrown.
032     * 
033     * Only if the flag is true and the user wants to recover from an error,
034     * the method returns normally.
035     * 
036     * The thrown exception will be catched by the unmarshaller.
037     */
038    void handleEvent( ValidationEvent event, boolean canRecover ) throws SAXException;
039}