0
|
1 /*
|
|
2 * (c) Copyright IBM Corp 2002, 2005
|
|
3 */
|
|
4
|
|
5 package javax.wadls.xml;
|
|
6
|
|
7 import org.xml.sax.*;
|
|
8
|
|
9 /**
|
|
10 * This interface can act as an additional layer of indirection between
|
|
11 * a WSDLReader and the actual location of WSDL documents. One
|
|
12 * use could be to retrieve WSDL documents from JAR files, while still
|
|
13 * retaining the ability to resolve imported documents using relative
|
|
14 * URIs.
|
|
15 *
|
|
16 * @author Owen Burroughs (owenb@uk.ibm.com)
|
|
17 *
|
|
18 * @see WSDLReader#readWSDL(WSDLLocator)
|
|
19 */
|
|
20 public interface WADLLocator
|
|
21 {
|
|
22 /**
|
|
23 * Returns an InputSource "pointed at" the base document.
|
|
24 *
|
|
25 * @return the InputSource object or null if the base document could
|
|
26 * not be found
|
|
27 */
|
|
28 public InputSource getBaseInputSource();
|
|
29
|
|
30 /**
|
|
31 * Returns an InputSource "pointed at" an imported wsdl document.
|
|
32 *
|
|
33 * @param parentLocation a URI specifying the location of the
|
|
34 * document doing the importing. This can be null if the import location
|
|
35 * is not relative to the parent location.
|
|
36 * @param importLocation a URI specifying the location of the
|
|
37 * document to import. This might be relative to the parent document's
|
|
38 * location.
|
|
39 * @return the InputSource object or null if the import cannot be found.
|
|
40 */
|
|
41 public InputSource getImportInputSource(String parentLocation,
|
|
42 String importLocation);
|
|
43
|
|
44 /**
|
|
45 * Returns a URI representing the location of the base document.
|
|
46 */
|
|
47 public String getBaseURI();
|
|
48
|
|
49 /**
|
|
50 * Returns a URI representing the location of the last import document
|
|
51 * to be resolved. This is used in resolving nested imports where an
|
|
52 * import location is relative to the parent document.
|
|
53 */
|
|
54 public String getLatestImportURI();
|
|
55 }
|
|
56
|