01: //
02: // Copyright (C) 2005 United States Government as represented by the
03: // Administrator of the National Aeronautics and Space Administration
04: // (NASA). All Rights Reserved.
05: //
06: // This software is distributed under the NASA Open Source Agreement
07: // (NOSA), version 1.3. The NOSA has been approved by the Open Source
08: // Initiative. See the file NOSA-1.3-JPF at the top of the distribution
09: // directory tree for the complete NOSA document.
10: //
11: // THE SUBJECT SOFTWARE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY OF ANY
12: // KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT
13: // LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL CONFORM TO
14: // SPECIFICATIONS, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR
15: // A PARTICULAR PURPOSE, OR FREEDOM FROM INFRINGEMENT, ANY WARRANTY THAT
16: // THE SUBJECT SOFTWARE WILL BE ERROR FREE, OR ANY WARRANTY THAT
17: // DOCUMENTATION, IF PROVIDED, WILL CONFORM TO THE SUBJECT SOFTWARE.
18: //
19: package gov.nasa.jpf;
20:
21: import org.xml.sax.*;
22:
23: /**
24: * interface for JPF specific SAX parser to read in XML error traces
25: * Note that the concrete XMLTraceHandler implementation is stored in the trace itself
26: * and gets instantiated via reflection
27: */
28: public interface XMLTraceHandler {
29: /**
30: * return a Path object once the parsing is done
31: */
32: Path getPath();
33:
34: // this is what we need from the DefaultHandler API
35: // not strictly needed - we could also directly extend DefaultHandler
36: // but would still have to implement the additional 'getPath' interface
37: void characters(char[] text, int start, int length);
38:
39: void endElement(String namespaceURI, String localName,
40: String qualifiedName) throws SAXException;
41:
42: void startElement(String namespaceURI, String localName,
43: String qualifiedName, Attributes atts) throws SAXException;
44: }
|