01: /*
02: * $Id: ExtendedLocation.java,v 1.1 2004/07/05 23:11:13 cniles Exp $
03: *
04: * Copyright (c) 2004, Christian Niles, unit12.net
05: * All rights reserved.
06: *
07: * Redistribution and use in source and binary forms, with or without
08: * modification, are permitted provided that the following conditions are met:
09: *
10: * * Redistributions of source code must retain the above copyright
11: * notice, this list of conditions and the following disclaimer.
12: *
13: * * Redistributions in binary form must reproduce the above copyright
14: * notice, this list of conditions and the following disclaimer in the
15: * documentation and/or other materials provided with the distribution.
16: *
17: * * Neither the name of Christian Niles, Unit12, nor the names of its
18: * contributors may be used to endorse or promote products derived from
19: * this software without specific prior written permission.
20: *
21: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24: * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
25: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31: * POSSIBILITY OF SUCH DAMAGE.
32: *
33: */
34: package javanet.staxutils;
35:
36: import javax.xml.stream.Location;
37:
38: /**
39: * Extended the {@link Location} interface that exposes nested {@link Location}s.
40: *
41: * @author Christian Niles
42: * @version $Revision: 1.1 $
43: */
44: public interface ExtendedLocation extends Location {
45:
46: /**
47: * Returns a nested {@link Location}. Nested locations can be used to locate
48: * errors in linked files. This is useful when working with external entities,
49: * included files, and so forth.
50: *
51: * @return The nested {@link Location}, or <code>null</code>.
52: */
53: public Location getNestedLocation();
54:
55: }
|