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 } 37