1. // $Id: Source.java,v 1.2 2003/09/07 23:02:09 jsuttor Exp $

  2. /*

  3.  * @(#)Source.java	1.14 04/07/26

  4.  * 

  5.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  6.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  7.  */

  8. 

  9. package javax.xml.transform;

  10. 

  11. /**

  12.  * An object that implements this interface contains the information

  13.  * needed to act as source input (XML source or transformation instructions).

  14.  */

  15. public interface Source {

  16. 

  17.     /**

  18.      * Set the system identifier for this Source.

  19.      *

  20.      * <p>The system identifier is optional if the source does not

  21.      * get its data from a URL, but it may still be useful to provide one.

  22.      * The application can use a system identifier, for example, to resolve

  23.      * relative URIs and to include in error messages and warnings.</p>

  24.      *

  25.      * @param systemId The system identifier as a URL string.

  26.      */

  27.     public void setSystemId(String systemId);

  28. 

  29.     /**

  30.      * Get the system identifier that was set with setSystemId.

  31.      *

  32.      * @return The system identifier that was set with setSystemId, or null

  33.      * if setSystemId was not called.

  34.      */

  35.     public String getSystemId();

  36. }