12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.xml.transform;
  27 
  28 /**
  29  * <p>An object that implements this interface contains the information
  30  * needed to build a transformation result tree.
  31  *
  32  * @author <a href="Jeff.Suttor@Sun.com">Jeff Suttor</a>
  33  * @since 1.4
  34  */
  35 public interface Result {
  36 
  37     /**
  38      * The name of the processing instruction that is sent if the
  39      * result tree disables output escaping.
  40      *
  41      * <p>Normally, result tree serialization escapes{@literal & and <} (and
  42      * possibly other characters) when outputting text nodes.
  43      * This ensures that the output is well-formed XML. However,
  44      * it is sometimes convenient to be able to produce output that is
  45      * almost, but not quite well-formed XML; for example,
  46      * the output may include ill-formed sections that will
  47      * be transformed into well-formed XML by a subsequent non-XML aware
  48      * process. If a processing instruction is sent with this name,
  49      * serialization should be output without any escaping.
  50      *
  51      * <p>Result DOM trees may also have PI_DISABLE_OUTPUT_ESCAPING and
  52      * PI_ENABLE_OUTPUT_ESCAPING inserted into the tree.

  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.xml.transform;
  27 
  28 /**
  29  * <p>An object that implements this interface contains the information
  30  * needed to build a transformation result tree.
  31  *
  32  * @author Jeff Suttor
  33  * @since 1.4
  34  */
  35 public interface Result {
  36 
  37     /**
  38      * The name of the processing instruction that is sent if the
  39      * result tree disables output escaping.
  40      *
  41      * <p>Normally, result tree serialization escapes{@literal & and <} (and
  42      * possibly other characters) when outputting text nodes.
  43      * This ensures that the output is well-formed XML. However,
  44      * it is sometimes convenient to be able to produce output that is
  45      * almost, but not quite well-formed XML; for example,
  46      * the output may include ill-formed sections that will
  47      * be transformed into well-formed XML by a subsequent non-XML aware
  48      * process. If a processing instruction is sent with this name,
  49      * serialization should be output without any escaping.
  50      *
  51      * <p>Result DOM trees may also have PI_DISABLE_OUTPUT_ESCAPING and
  52      * PI_ENABLE_OUTPUT_ESCAPING inserted into the tree.