javax.wsdl.xml.WSDLLocator Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of libre-wsdl4j Show documentation

Open and Free WSDL library: Web Services Description Language. Libre-wsdl4j is a fork of WSDL4J 1.6.3. WSL4j is a Java stub generator for WSDL. Many software projects still depends on WSL4j, so the idea is that libre-wsdl4j should be an actively maintained version of this software on GitHub. "WSDL, that's an anchronym i haven't heard in almost ten years." Still big in the enterprise world" - comments on the Internet.

The newest version!

/*
 * (c) Copyright IBM Corp 2002, 2006 
 */

package javax.wsdl.xml;

import org.xml.sax.*;

/**
 * This interface can act as an additional layer of indirection between
 * a WSDLReader and the actual location of WSDL documents. One
 * use could be to retrieve WSDL documents from JAR files, while still
 * retaining the ability to resolve imported documents using relative
 * URIs.
 *
 * @author Owen Burroughs ([email protected])
 *
 * @see WSDLReader#readWSDL(WSDLLocator)
 */
public interface WSDLLocator
{
  /**
   * Returns an InputSource "pointed at" the base document.
   * 
   * @return the InputSource object or null if the base document could
   * not be found
   */
  InputSource getBaseInputSource();

  /**
   * Returns an InputSource "pointed at" an imported wsdl document.
   *
   * @param parentLocation a URI specifying the location of the
   * document doing the importing. This can be null if the import location
   * is not relative to the parent location.
   * @param importLocation a URI specifying the location of the
   * document to import. This might be relative to the parent document's
   * location.
   * @return the InputSource object or null if the import cannot be found.
   */
  InputSource getImportInputSource(String parentLocation,
                                   String importLocation);

  /**
   * Returns a URI representing the location of the base document.
   */
  String getBaseURI();

  /**
   * Returns a URI representing the location of the last import document
   * to be resolved. This is used in resolving nested imports where an
   * import location is relative to the parent document.
   */
  String getLatestImportURI();
  
  /**
   * Releases all associated system resources such as the InputStreams
   * associated with the Base and Import InputSources. 
   */
  void close();
}