001    //
002    // This file was generated by the JavaTM Architecture for XML Binding(JAXB) Reference Implementation, v1.0.1-05/30/2003 05:06 AM(java_re)-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: 2004.10.11 at 12:13:34 EDT 
006    //
007    
008    /*
009     * Copyright 2003 Sun Microsystems, Inc. All rights reserved.
010     * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
011     */
012    
013    /*
014     * @(#)$Id: SAXUnmarshallerHandler.java,v 1.5 2003/05/14 18:36:18 lschwenk Exp $
015     */
016    package astronomy.data.spectra.impl.runtime;
017    
018    import javax.xml.bind.UnmarshallerHandler;
019    import javax.xml.bind.ValidationEvent;
020    
021    import org.xml.sax.SAXException;
022    
023    /**
024     * Unified event handler that processes
025     * both the SAX events and error events.
026     */
027    public interface SAXUnmarshallerHandler extends UnmarshallerHandler {
028        
029        /**
030         * Reports an error to the user, and asks if s/he wants
031         * to recover. If the canRecover flag is false, regardless
032         * of the client instruction, an exception will be thrown.
033         * 
034         * Only if the flag is true and the user wants to recover from an error,
035         * the method returns normally.
036         * 
037         * The thrown exception will be catched by the unmarshaller.
038         */
039        void handleEvent( ValidationEvent event, boolean canRecover ) throws SAXException;
040    }