aboutsummaryrefslogtreecommitdiff
path: root/src/javax/xml/transform/sax/SAXSource.java
diff options
context:
space:
mode:
Diffstat (limited to 'src/javax/xml/transform/sax/SAXSource.java')
-rw-r--r--src/javax/xml/transform/sax/SAXSource.java209
1 files changed, 0 insertions, 209 deletions
diff --git a/src/javax/xml/transform/sax/SAXSource.java b/src/javax/xml/transform/sax/SAXSource.java
deleted file mode 100644
index 5231564..0000000
--- a/src/javax/xml/transform/sax/SAXSource.java
+++ /dev/null
@@ -1,209 +0,0 @@
-/*
- * Copyright (c) 2000, 2006, Oracle and/or its affiliates. All rights reserved.
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
- *
- * This code is free software; you can redistribute it and/or modify it
- * under the terms of the GNU General Public License version 2 only, as
- * published by the Free Software Foundation. Oracle designates this
- * particular file as subject to the "Classpath" exception as provided
- * by Oracle in the LICENSE file that accompanied this code.
- *
- * This code is distributed in the hope that it will be useful, but WITHOUT
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
- * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
- * version 2 for more details (a copy is included in the LICENSE file that
- * accompanied this code).
- *
- * You should have received a copy of the GNU General Public License version
- * 2 along with this work; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
- *
- * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
- * or visit www.oracle.com if you need additional information or have any
- * questions.
- */
-
-package javax.xml.transform.sax;
-
-import javax.xml.transform.Source;
-import javax.xml.transform.stream.StreamSource;
-
-import org.xml.sax.InputSource;
-import org.xml.sax.XMLReader;
-
-/**
- * <p>Acts as an holder for SAX-style Source.</p>
- *
- * <p>Note that XSLT requires namespace support. Attempting to transform an
- * input source that is not
- * generated with a namespace-aware parser may result in errors.
- * Parsers can be made namespace aware by calling the
- * {@link javax.xml.parsers.SAXParserFactory#setNamespaceAware(boolean awareness)} method.</p>
- *
- * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
- */
-public class SAXSource implements Source {
-
- /**
- * If {@link javax.xml.transform.TransformerFactory#getFeature}
- * returns true when passed this value as an argument,
- * the Transformer supports Source input of this type.
- */
- public static final String FEATURE =
- "http://javax.xml.transform.sax.SAXSource/feature";
-
- /**
- * <p>Zero-argument default constructor. If this constructor is used, and
- * no SAX source is set using
- * {@link #setInputSource(InputSource inputSource)} , then the
- * <code>Transformer</code> will
- * create an empty source {@link org.xml.sax.InputSource} using
- * {@link org.xml.sax.InputSource#InputSource() new InputSource()}.</p>
- *
- * @see javax.xml.transform.Transformer#transform(Source xmlSource, Result outputTarget)
- */
- public SAXSource() { }
-
- /**
- * Create a <code>SAXSource</code>, using an {@link org.xml.sax.XMLReader}
- * and a SAX InputSource. The {@link javax.xml.transform.Transformer}
- * or {@link javax.xml.transform.sax.SAXTransformerFactory} will set itself
- * to be the reader's {@link org.xml.sax.ContentHandler}, and then will call
- * reader.parse(inputSource).
- *
- * @param reader An XMLReader to be used for the parse.
- * @param inputSource A SAX input source reference that must be non-null
- * and that will be passed to the reader parse method.
- */
- public SAXSource(XMLReader reader, InputSource inputSource) {
- this.reader = reader;
- this.inputSource = inputSource;
- }
-
- /**
- * Create a <code>SAXSource</code>, using a SAX <code>InputSource</code>.
- * The {@link javax.xml.transform.Transformer} or
- * {@link javax.xml.transform.sax.SAXTransformerFactory} creates a
- * reader via {@link org.xml.sax.helpers.XMLReaderFactory}
- * (if setXMLReader is not used), sets itself as
- * the reader's {@link org.xml.sax.ContentHandler}, and calls
- * reader.parse(inputSource).
- *
- * @param inputSource An input source reference that must be non-null
- * and that will be passed to the parse method of the reader.
- */
- public SAXSource(InputSource inputSource) {
- this.inputSource = inputSource;
- }
-
- /**
- * Set the XMLReader to be used for the Source.
- *
- * @param reader A valid XMLReader or XMLFilter reference.
- */
- public void setXMLReader(XMLReader reader) {
- this.reader = reader;
- }
-
- /**
- * Get the XMLReader to be used for the Source.
- *
- * @return A valid XMLReader or XMLFilter reference, or null.
- */
- public XMLReader getXMLReader() {
- return reader;
- }
-
- /**
- * Set the SAX InputSource to be used for the Source.
- *
- * @param inputSource A valid InputSource reference.
- */
- public void setInputSource(InputSource inputSource) {
- this.inputSource = inputSource;
- }
-
- /**
- * Get the SAX InputSource to be used for the Source.
- *
- * @return A valid InputSource reference, or null.
- */
- public InputSource getInputSource() {
- return inputSource;
- }
-
- /**
- * Set the system identifier for this Source. If an input source
- * has already been set, it will set the system ID or that
- * input source, otherwise it will create a new input source.
- *
- * <p>The system identifier is optional if there is a byte stream
- * or a character stream, but it is still useful to provide one,
- * since the application can use it to resolve relative URIs
- * and can include it in error messages and warnings (the parser
- * will attempt to open a connection to the URI only if
- * no byte stream or character stream is specified).</p>
- *
- * @param systemId The system identifier as a URI string.
- */
- public void setSystemId(String systemId) {
-
- if (null == inputSource) {
- inputSource = new InputSource(systemId);
- } else {
- inputSource.setSystemId(systemId);
- }
- }
-
- /**
- * <p>Get the base ID (URI or system ID) from where URIs
- * will be resolved.</p>
- *
- * @return Base URL for the <code>Source</code>, or <code>null</code>.
- */
- public String getSystemId() {
-
- if (inputSource == null) {
- return null;
- } else {
- return inputSource.getSystemId();
- }
- }
-
- /**
- * The XMLReader to be used for the source tree input. May be null.
- */
- private XMLReader reader;
-
- /**
- * <p>The SAX InputSource to be used for the source tree input.
- * Should not be <code>null</code>.</p>
- */
- private InputSource inputSource;
-
- /**
- * Attempt to obtain a SAX InputSource object from a Source
- * object.
- *
- * @param source Must be a non-null Source reference.
- *
- * @return An InputSource, or null if Source can not be converted.
- */
- public static InputSource sourceToInputSource(Source source) {
-
- if (source instanceof SAXSource) {
- return ((SAXSource) source).getInputSource();
- } else if (source instanceof StreamSource) {
- StreamSource ss = (StreamSource) source;
- InputSource isource = new InputSource(ss.getSystemId());
-
- isource.setByteStream(ss.getInputStream());
- isource.setCharacterStream(ss.getReader());
- isource.setPublicId(ss.getPublicId());
-
- return isource;
- } else {
- return null;
- }
- }
-}