1. /*
  2. * Copyright 2003 Sun Microsystems, Inc. All rights reserved.
  3. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
  4. */
  5. /*
  6. * @(#)Source.java 1.9 03/01/23
  7. */
  8. package javax.xml.transform;
  9. import java.lang.String;
  10. import java.io.InputStream;
  11. import java.io.Reader;
  12. /**
  13. * An object that implements this interface contains the information
  14. * needed to act as source input (XML source or transformation instructions).
  15. */
  16. public interface Source {
  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. * Get the system identifier that was set with setSystemId.
  30. *
  31. * @return The system identifier that was set with setSystemId, or null
  32. * if setSystemId was not called.
  33. */
  34. public String getSystemId();
  35. }