1
2
3
4
5
6
7
8 package de.nierbeck.timeTrack.model.impl.runtime;
9
10 import javax.xml.bind.UnmarshallerHandler;
11 import javax.xml.bind.ValidationEvent;
12
13 import org.xml.sax.SAXException;
14
15 /***
16 * Unified event handler that processes both the SAX events and error events.
17 *
18 * <p>
19 * This interface refines {@link ContentHandler} as follows:
20 * <ol>
21 * <li>element names and attribute names must be {@link String#intern()}ed.
22 * <li>namespace prefix and uris must be {@link String#intern()}ed.
23 * </ol>
24 */
25 public interface SAXUnmarshallerHandler extends UnmarshallerHandler {
26
27 /***
28 * Reports an error to the user, and asks if s/he wants to recover. If the
29 * canRecover flag is false, regardless of the client instruction, an
30 * exception will be thrown.
31 *
32 * Only if the flag is true and the user wants to recover from an error, the
33 * method returns normally.
34 *
35 * The thrown exception will be catched by the unmarshaller.
36 */
37 void handleEvent(ValidationEvent event, boolean canRecover)
38 throws SAXException;
39 }