/*
 * Copyright (c) 2015, 2017, 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.
 */

/**
 * Provides SAX specific transformation classes.
 *
 * <p>
 * The {@link javax.xml.transform.sax.SAXSource} class allows the
 * setting of an {@link org.xml.sax.XMLReader} to be used for pulling
 * parse events, and an {@link org.xml.sax.InputSource} that may be used to
 * specify the SAX source.
 * <p>
 * The {@link javax.xml.transform.sax.SAXResult} class allows the
 * setting of a {@link org.xml.sax.ContentHandler} to be the receiver of
 * SAX2 events from the transformation.
 * <p>
 * The {@link javax.xml.transform.sax.SAXTransformerFactory} extends
 * {@link javax.xml.transform.TransformerFactory} to provide factory
 * methods for creating {@link javax.xml.transform.sax.TemplatesHandler},
 * {@link javax.xml.transform.sax.TransformerHandler}, and
 * {@link org.xml.sax.XMLReader} instances.
 * <p>
 * To obtain a {@link javax.xml.transform.sax.SAXTransformerFactory},
 * the caller must cast the {@link javax.xml.transform.TransformerFactory}
 * instance returned from
 * {@link javax.xml.transform.TransformerFactory#newInstance}.
 *
 * <p>
 * The {@link javax.xml.transform.sax.TransformerHandler} interface
 * allows a transformation to be created from SAX2 parse events, which is a "push"
 * model rather than the "pull" model that normally occurs for a transformation.
 * Normal parse events are received through the
 * {@link org.xml.sax.ContentHandler} interface, lexical events such as
 * startCDATA and endCDATA are received through the
 * {@link org.xml.sax.ext.LexicalHandler} interface, and events that signal
 * the start or end of disabling output escaping are received via
 * {@link org.xml.sax.ContentHandler#processingInstruction}, with the
 * target parameter being
 * {@link javax.xml.transform.Result#PI_DISABLE_OUTPUT_ESCAPING} and
 * {@link javax.xml.transform.Result#PI_ENABLE_OUTPUT_ESCAPING}. If
 * parameters, output properties, or other features need to be set on the
 * Transformer handler, a {@link javax.xml.transform.Transformer} reference
 * will need to be obtained from
 * {@link javax.xml.transform.sax.TransformerHandler#getTransformer}, and
 * the methods invoked from that reference.
 *
 * <p>
 * The {@link javax.xml.transform.sax.TemplatesHandler} interface
 * allows the creation of {@link javax.xml.transform.Templates} objects
 * from SAX2 parse events. Once the {@link org.xml.sax.ContentHandler}
 * events are complete, the Templates object may be obtained from
 * {@link javax.xml.transform.sax.TemplatesHandler#getTemplates}. Note that
 * {@link javax.xml.transform.sax.TemplatesHandler#setSystemId} should
 * normally be called in order to establish a base system ID from which relative
 * URLs may be resolved.
 * <p>
 * The {@link javax.xml.transform.sax.SAXTransformerFactory#newXMLFilter}
 * method allows the creation of a {@link org.xml.sax.XMLFilter}, which
 * encapsulates the SAX2 notion of a "pull" transformation. The resulting
 * {@code XMLFilters} can be chained together so that a series of transformations
 * can happen with one's output becoming another's input.
 *
 * @since 1.5
 */

package javax.xml.transform.sax;