xml-general-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dles...@apache.org
Subject cvs commit: xml-site/targets/xalan-j/apidocs/javax/xml/transform Source.html SourceLocator.html Templates.html Transformer.html TransformerConfigurationException.html TransformerException.html TransformerFactory.html TransformerFactoryConfigurationError.html URIResolver.html trax.html
Date Wed, 17 Jan 2001 13:51:47 GMT
dleslie     01/01/17 05:51:46

  Added:       targets/xalan-j/apidocs/javax/xml/transform Source.html
                        SourceLocator.html Templates.html Transformer.html
                        TransformerConfigurationException.html
                        TransformerException.html TransformerFactory.html
                        TransformerFactoryConfigurationError.html
                        URIResolver.html trax.html
  Log:
  Oops! Evidently forgot to add these files to CVS.
  
  Revision  Changes    Path
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/Source.html
  
  Index: Source.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Interface  Source
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Source.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Result.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/SourceLocator.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="Source.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Interface  Source</H2>
  <DL>
  <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../javax/xml/transform/dom/DOMSource.html">DOMSource</A>, <A HREF="../../../javax/xml/transform/sax/SAXSource.html">SAXSource</A>, <A HREF="../../../javax/xml/transform/stream/StreamSource.html">StreamSource</A></DD>
  </DL>
  <HR>
  <DL>
  <DT>public interface <B>Source</B></DL>
  
  <P>
  An object that implements this interface contains the information
   needed to act as source input (XML source or transformation instructions).
  <P>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Source.html#getSystemId()">getSystemId</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the system identifier that was set with setSystemId.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Source.html#setSystemId(java.lang.String)">setSystemId</A></B>(java.lang.String&nbsp;systemId)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the system identifier for this Source.</TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="setSystemId(java.lang.String)"><!-- --></A><H3>
  setSystemId</H3>
  <PRE>
  public void <B>setSystemId</B>(java.lang.String&nbsp;systemId)</PRE>
  <DL>
  <DD>Set the system identifier for this Source.
  
   <p>The system identifier is optional if the source does not
   get its data from a URL, but it may still be useful to provide one.
   The application can use a system identifier, for example, to resolve
   relative URIs and to include in error messages and warnings.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>systemId</CODE> - The system identifier as a URL string.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getSystemId()"><!-- --></A><H3>
  getSystemId</H3>
  <PRE>
  public java.lang.String <B>getSystemId</B>()</PRE>
  <DL>
  <DD>Get the system identifier that was set with setSystemId.<DD><DL>
  <DT><B>Returns:</B><DD>The system identifier that was set with setSystemId, or null
   if setSystemId was not called.</DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Source.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Result.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/SourceLocator.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="Source.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/SourceLocator.html
  
  Index: SourceLocator.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Interface  SourceLocator
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/SourceLocator.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Source.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/Templates.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="SourceLocator.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Interface  SourceLocator</H2>
  <DL>
  <DT><B>All Known Subinterfaces:</B> <DD><A HREF="../../../javax/xml/transform/dom/DOMLocator.html">DOMLocator</A></DD>
  </DL>
  <DL>
  <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../org/apache/xalan/templates/ElemTemplateElement.html">ElemTemplateElement</A>, <A HREF="../../../org/apache/xml/utils/SAXSourceLocator.html">SAXSourceLocator</A></DD>
  </DL>
  <HR>
  <DL>
  <DT>public interface <B>SourceLocator</B></DL>
  
  <P>
  This interface is primarily for the purposes of reporting where
   an error occurred in the XML source or transformation instructions.
  <P>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;int</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/SourceLocator.html#getColumnNumber()">getColumnNumber</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the character position where the current document event ends.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;int</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/SourceLocator.html#getLineNumber()">getLineNumber</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the line number where the current document event ends.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/SourceLocator.html#getPublicId()">getPublicId</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the public identifier for the current document event.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/SourceLocator.html#getSystemId()">getSystemId</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the system identifier for the current document event.</TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="getPublicId()"><!-- --></A><H3>
  getPublicId</H3>
  <PRE>
  public java.lang.String <B>getPublicId</B>()</PRE>
  <DL>
  <DD>Return the public identifier for the current document event.
  
   <p>The return value is the public identifier of the document
   entity or of the external parsed entity in which the markup that
   triggered the event appears.</p><DD><DL>
  <DT><B>Returns:</B><DD>A string containing the public identifier, or
           null if none is available.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/SourceLocator.html#getSystemId()"><CODE>getSystemId()</CODE></A></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getSystemId()"><!-- --></A><H3>
  getSystemId</H3>
  <PRE>
  public java.lang.String <B>getSystemId</B>()</PRE>
  <DL>
  <DD>Return the system identifier for the current document event.
  
   <p>The return value is the system identifier of the document
   entity or of the external parsed entity in which the markup that
   triggered the event appears.</p>
  
   <p>If the system identifier is a URL, the parser must resolve it
   fully before passing it to the application.</p><DD><DL>
  <DT><B>Returns:</B><DD>A string containing the system identifier, or null
           if none is available.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/SourceLocator.html#getPublicId()"><CODE>getPublicId()</CODE></A></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getLineNumber()"><!-- --></A><H3>
  getLineNumber</H3>
  <PRE>
  public int <B>getLineNumber</B>()</PRE>
  <DL>
  <DD>Return the line number where the current document event ends.
  
   <p><strong>Warning:</strong> The return value from the method
   is intended only as an approximation for the sake of error
   reporting; it is not intended to provide sufficient information
   to edit the character content of the original XML document.</p>
  
   <p>The return value is an approximation of the line number
   in the document entity or external parsed entity where the
   markup that triggered the event appears.</p><DD><DL>
  <DT><B>Returns:</B><DD>The line number, or -1 if none is available.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/SourceLocator.html#getColumnNumber()"><CODE>getColumnNumber()</CODE></A></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getColumnNumber()"><!-- --></A><H3>
  getColumnNumber</H3>
  <PRE>
  public int <B>getColumnNumber</B>()</PRE>
  <DL>
  <DD>Return the character position where the current document event ends.
  
   <p><strong>Warning:</strong> The return value from the method
   is intended only as an approximation for the sake of error
   reporting; it is not intended to provide sufficient information
   to edit the character content of the original XML document.</p>
  
   <p>The return value is an approximation of the column number
   in the document entity or external parsed entity where the
   markup that triggered the event appears.</p><DD><DL>
  <DT><B>Returns:</B><DD>The column number, or -1 if none is available.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/SourceLocator.html#getLineNumber()"><CODE>getLineNumber()</CODE></A></DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/SourceLocator.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Source.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/Templates.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="SourceLocator.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/Templates.html
  
  Index: Templates.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Interface  Templates
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Templates.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/SourceLocator.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/URIResolver.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="Templates.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Interface  Templates</H2>
  <DL>
  <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../org/apache/xalan/templates/StylesheetRoot.html">StylesheetRoot</A></DD>
  </DL>
  <HR>
  <DL>
  <DT>public interface <B>Templates</B></DL>
  
  <P>
  An object that implements this interface is the runtime representation of processed
   transformation instructions.
  
   <p>Templates must be threadsafe for a given instance
   over multiple threads running concurrently, and may
   be used multiple times in a given session.</p>
  <P>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.util.Properties</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Templates.html#getOutputProperties()">getOutputProperties</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the static properties for xsl:output.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;<A HREF="../../../javax/xml/transform/Transformer.html">Transformer</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Templates.html#newTransformer()">newTransformer</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new transformation context for this Templates object.</TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="newTransformer()"><!-- --></A><H3>
  newTransformer</H3>
  <PRE>
  public <A HREF="../../../javax/xml/transform/Transformer.html">Transformer</A> <B>newTransformer</B>()
                             throws <A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A></PRE>
  <DL>
  <DD>Create a new transformation context for this Templates object.<DD><DL>
  <DT><B>Returns:</B><DD>A valid non-null instance of a Transformer.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A> - if a Transformer can not be created.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getOutputProperties()"><!-- --></A><H3>
  getOutputProperties</H3>
  <PRE>
  public java.util.Properties <B>getOutputProperties</B>()</PRE>
  <DL>
  <DD>Get the static properties for xsl:output.  The object returned will
   be a clone of the internal values. Accordingly, it can be mutated
   without mutating the Templates object, and then handed in to
   <A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperties(java.util.Properties)"><CODE>Transformer.setOutputProperties(java.util.Properties)</CODE></A>.
  
   <p>The properties returned should contain properties set by the stylesheet,
   and these properties are "defaulted" by default properties specified by
   <a href="http://www.w3.org/TR/xslt#output">section 16 of the
   XSL Transformations (XSLT) W3C Recommendation</a>.  The properties that
   were specifically set by the stylesheet should be in the base
   Properties list, while the XSLT default properties that were not
   specifically set should be in the "default" Properties list.  Thus,
   getOutputProperties().getProperty(String key) will obtain any
   property in that was set by the stylesheet, <em>or</em> the default
   properties, while
   getOutputProperties().get(String key) will only retrieve properties
   that were explicitly set in the stylesheet.</p>
  
   <p>For XSLT,
   <a href="http://www.w3.org/TR/xslt#attribute-value-templates">Attribute
   Value Templates</a> attribute values will
   be returned unexpanded (since there is no context at this point).  The
   namespace prefixes inside Attribute Value Templates will be unexpanded,
   so that they remain valid XPath values.  (For XSLT 1.0, this is not
   a problem since Attribute Value Templates are not allowed for xsl:output
   attributes.  However, the will be allowed in versions after 1.1.)</p><DD><DL>
  <DT><B>Returns:</B><DD>A Properties object, never null.</DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Templates.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/SourceLocator.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/URIResolver.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="Templates.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/Transformer.html
  
  Index: Transformer.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Class  Transformer
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Transformer.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/OutputKeys.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/TransformerFactory.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="Transformer.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Class  Transformer</H2>
  <PRE>
  java.lang.Object
    |
    +--<B>javax.xml.transform.Transformer</B>
  </PRE>
  <DL>
  <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../org/apache/xalan/transformer/TransformerIdentityImpl.html">TransformerIdentityImpl</A>, <A HREF="../../../org/apache/xalan/transformer/TransformerImpl.html">TransformerImpl</A></DD>
  </DL>
  <HR>
  <DL>
  <DT>public abstract class <B>Transformer</B><DT>extends java.lang.Object</DL>
  
  <P>
  An instace of this abstract class can transform a
   source tree into a result tree.
  
   <p>An instance of this class can be obtained with the <code>
   TransformerFactory.newTransformer</code> method. This instance may
   then be used to process XML from a variety of sources and write
   the transformation output to a variety of sinks.</p>
  
   <p>An object of this class may not be used in multiple threads
   running concurrently.  Different Transformers may be used
   concurrently by different threads.</p>
  
   <p>A Transformer may be used multiple times.  Parameters and
   output properties are preserved across transformations.</p>
  <P>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#clearParameters()">clearParameters</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Clear all parameters set with setParameter.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#getErrorListener()">getErrorListener</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the error event handler in effect for the transformation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;java.util.Properties</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#getOutputProperties()">getOutputProperties</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get a copy of the output properties for the transformation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;java.lang.String</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#getOutputProperty(java.lang.String)">getOutputProperty</A></B>(java.lang.String&nbsp;name)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get an output property that is in effect for the
   transformation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;java.lang.Object</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#getParameter(java.lang.String)">getParameter</A></B>(java.lang.String&nbsp;name)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get a parameter that was explicitly set with setParameter
   or setParameters.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#getURIResolver()">getURIResolver</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get an object that will be used to resolve URIs used in
   document(), etc.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#setErrorListener(javax.xml.transform.ErrorListener)">setErrorListener</A></B>(<A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A>&nbsp;listener)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the error event listener in effect for the transformation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperties(java.util.Properties)">setOutputProperties</A></B>(java.util.Properties&nbsp;oformat)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the output properties for the transformation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperty(java.lang.String, java.lang.String)">setOutputProperty</A></B>(java.lang.String&nbsp;name,
                    java.lang.String&nbsp;value)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set an output property that will be in effect for the
   transformation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#setParameter(java.lang.String, java.lang.Object)">setParameter</A></B>(java.lang.String&nbsp;name,
               java.lang.Object&nbsp;value)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Add a parameter for the transformation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#setURIResolver(javax.xml.transform.URIResolver)">setURIResolver</A></B>(<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A>&nbsp;resolver)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set an object that will be used to resolve URIs used in
   document().</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/Transformer.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)">transform</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;xmlSource,
            <A HREF="../../../javax/xml/transform/Result.html">Result</A>&nbsp;outputTarget)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Process the source tree to the output result.</TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Object</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>equals, 
  getClass, 
  hashCode, 
  notify, 
  notifyAll, 
  toString, 
  wait, 
  wait, 
  wait</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="transform(javax.xml.transform.Source, javax.xml.transform.Result)"><!-- --></A><H3>
  transform</H3>
  <PRE>
  public abstract void <B>transform</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;xmlSource,
                                 <A HREF="../../../javax/xml/transform/Result.html">Result</A>&nbsp;outputTarget)
                          throws <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></PRE>
  <DL>
  <DD>Process the source tree to the output result.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>xmlSource</CODE> - The input for the source tree.<DD><CODE>outputTarget</CODE> - The output target.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A> - If an unrecoverable error occurs
   during the course of the transformation.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setParameter(java.lang.String, java.lang.Object)"><!-- --></A><H3>
  setParameter</H3>
  <PRE>
  public abstract void <B>setParameter</B>(java.lang.String&nbsp;name,
                                    java.lang.Object&nbsp;value)</PRE>
  <DL>
  <DD>Add a parameter for the transformation.
  
   <p>Pass a qualified name as a two-part string, the namespace URI
   enclosed in curly braces ({}), followed by the local name. If the
   name has a null URL, the String only contain the local name. An
   application can safely check for a non-null URI by testing to see if the first
   character of the name is a '{' character.</p>
   <p>For example, if a URI and local name were obtained from an element
   defined with &lt;xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/&gt;,
   then the qualified name would be "{http://xyz.foo.com/yada/baz.html}foo". Note that
   no prefix is used.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the parameter, which may begin with a namespace URI
   in curly braces ({}).<DD><CODE>value</CODE> - The value object.  This can be any valid Java object. It is
   up to the processor to provide the proper object coersion or to simply
   pass the object on for use in an extension.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getParameter(java.lang.String)"><!-- --></A><H3>
  getParameter</H3>
  <PRE>
  public abstract java.lang.Object <B>getParameter</B>(java.lang.String&nbsp;name)</PRE>
  <DL>
  <DD>Get a parameter that was explicitly set with setParameter
   or setParameters.
  
   <p>This method does not return a default parameter value, which
   cannot be determined until the node context is evaluated during
   the transformation process.<DD><DL>
  <DT><B>Returns:</B><DD>A parameter that has been set with setParameter, or null if 
   a parameter with the given name was not found.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="clearParameters()"><!-- --></A><H3>
  clearParameters</H3>
  <PRE>
  public abstract void <B>clearParameters</B>()</PRE>
  <DL>
  <DD>Clear all parameters set with setParameter.</DL>
  <HR>
  
  <A NAME="setURIResolver(javax.xml.transform.URIResolver)"><!-- --></A><H3>
  setURIResolver</H3>
  <PRE>
  public abstract void <B>setURIResolver</B>(<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A>&nbsp;resolver)</PRE>
  <DL>
  <DD>Set an object that will be used to resolve URIs used in
   document().
  
   <p>If the resolver argument is null, the URIResolver value will
   be cleared, and the default behavior will be used.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>resolver</CODE> - An object that implements the URIResolver interface,
   or null.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getURIResolver()"><!-- --></A><H3>
  getURIResolver</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A> <B>getURIResolver</B>()</PRE>
  <DL>
  <DD>Get an object that will be used to resolve URIs used in
   document(), etc.<DD><DL>
  <DT><B>Returns:</B><DD>An object that implements the URIResolver interface,
   or null.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setOutputProperties(java.util.Properties)"><!-- --></A><H3>
  setOutputProperties</H3>
  <PRE>
  public abstract void <B>setOutputProperties</B>(java.util.Properties&nbsp;oformat)
                                    throws java.lang.IllegalArgumentException</PRE>
  <DL>
  <DD>Set the output properties for the transformation.  These
   properties will override properties set in the Templates
   with xsl:output.
  
   <p>If argument to this function is null, any properties
   previously set are removed, and the value will revert to the value
   defined in the templates object.</p>
  
   <p>Pass a qualified property key name as a two-part string, the namespace URI
   enclosed in curly braces ({}), followed by the local name. If the
   name has a null URL, the String only contain the local name. An
   application can safely check for a non-null URI by testing to see if the first
   character of the name is a '{' character.</p>
   <p>For example, if a URI and local name were obtained from an element
   defined with &lt;xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/&gt;,
   then the qualified name would be "{http://xyz.foo.com/yada/baz.html}foo". Note that
   no prefix is used.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>oformat</CODE> - A set of output properties that will be
   used to override any of the same properties in affect
   for the transformation.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - if any of the argument keys are not
   recognized and are not namespace qualified.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/OutputKeys.html"><CODE>OutputKeys</CODE></A>, 
  <CODE>Properties</CODE></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getOutputProperties()"><!-- --></A><H3>
  getOutputProperties</H3>
  <PRE>
  public abstract java.util.Properties <B>getOutputProperties</B>()</PRE>
  <DL>
  <DD>Get a copy of the output properties for the transformation.
  
   <p>The properties returned should contain properties set by the user,
   and properties set by the stylesheet, and these properties
   are "defaulted" by default properties specified by <a href="http://www.w3.org/TR/xslt#output">section 16 of the
   XSL Transformations (XSLT) W3C Recommendation</a>.  The properties that
   were specifically set by the user or the stylesheet should be in the base
   Properties list, while the XSLT default properties that were not
   specifically set should be the default Properties list.  Thus,
   getOutputProperties().getProperty(String key) will obtain any
   property in that was set by <A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperty(java.lang.String, java.lang.String)"><CODE>setOutputProperty(java.lang.String, java.lang.String)</CODE></A>,
   <A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperties(java.util.Properties)"><CODE>setOutputProperties(java.util.Properties)</CODE></A>, in the stylesheet, <em>or</em> the default
   properties, while
   getOutputProperties().get(String key) will only retrieve properties
   that were explicitly set by <A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperty(java.lang.String, java.lang.String)"><CODE>setOutputProperty(java.lang.String, java.lang.String)</CODE></A>,
   <A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperties(java.util.Properties)"><CODE>setOutputProperties(java.util.Properties)</CODE></A>, or in the stylesheet.</p>
  
   <p>Note that mutation of the Properties object returned will not
   effect the properties that the transformation contains.</p>
  
   <p>If any of the argument keys are not recognized and are not
   namespace qualified, the property will be ignored.  In other words the
   behaviour is not orthogonal with setOutputProperties.</p><DD><DL>
  <DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/OutputKeys.html"><CODE>OutputKeys</CODE></A>, 
  <CODE>Properties</CODE></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setOutputProperty(java.lang.String, java.lang.String)"><!-- --></A><H3>
  setOutputProperty</H3>
  <PRE>
  public abstract void <B>setOutputProperty</B>(java.lang.String&nbsp;name,
                                         java.lang.String&nbsp;value)
                                  throws java.lang.IllegalArgumentException</PRE>
  <DL>
  <DD>Set an output property that will be in effect for the
   transformation.
  
   <p>Pass a qualified property name as a two-part string, the namespace URI
   enclosed in curly braces ({}), followed by the local name. If the
   name has a null URL, the String only contain the local name. An
   application can safely check for a non-null URI by testing to see if the first
   character of the name is a '{' character.</p>
   <p>For example, if a URI and local name were obtained from an element
   defined with &lt;xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/&gt;,
   then the qualified name would be "{http://xyz.foo.com/yada/baz.html}foo". Note that
   no prefix is used.</p>
  
   <p>The Properties object that was passed to <A HREF="../../../javax/xml/transform/Transformer.html#setOutputProperties(java.util.Properties)"><CODE>setOutputProperties(java.util.Properties)</CODE></A> won't
   be effected by calling this method.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>name</CODE> - A non-null String that specifies an output
   property name, which may be namespace qualified.<DD><CODE>value</CODE> - The non-null string value of the output property.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - If the property is not supported, and is
   not qualified with a namespace.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/OutputKeys.html"><CODE>OutputKeys</CODE></A></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getOutputProperty(java.lang.String)"><!-- --></A><H3>
  getOutputProperty</H3>
  <PRE>
  public abstract java.lang.String <B>getOutputProperty</B>(java.lang.String&nbsp;name)
                                              throws java.lang.IllegalArgumentException</PRE>
  <DL>
  <DD>Get an output property that is in effect for the
   transformation.  The property specified may be a property
   that was set with setOutputProperty, or it may be a
   property specified in the stylesheet.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>name</CODE> - A non-null String that specifies an output
   property name, which may be namespace qualified.<DT><B>Returns:</B><DD>The string value of the output property, or null
   if no property was found.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - If the property is not supported.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/OutputKeys.html"><CODE>OutputKeys</CODE></A></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setErrorListener(javax.xml.transform.ErrorListener)"><!-- --></A><H3>
  setErrorListener</H3>
  <PRE>
  public abstract void <B>setErrorListener</B>(<A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A>&nbsp;listener)
                                 throws java.lang.IllegalArgumentException</PRE>
  <DL>
  <DD>Set the error event listener in effect for the transformation.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>listener</CODE> - The new error listener.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - if listener is null.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getErrorListener()"><!-- --></A><H3>
  getErrorListener</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A> <B>getErrorListener</B>()</PRE>
  <DL>
  <DD>Get the error event handler in effect for the transformation.<DD><DL>
  <DT><B>Returns:</B><DD>The current error handler, which should never be null.</DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Transformer.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/OutputKeys.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/TransformerFactory.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="Transformer.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/TransformerConfigurationException.html
  
  Index: TransformerConfigurationException.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Class  TransformerConfigurationException
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerConfigurationException.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;PREV CLASS&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/TransformerException.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerConfigurationException.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#methods_inherited_from_class_javax.xml.transform.TransformerException">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;METHOD</FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Class  TransformerConfigurationException</H2>
  <PRE>
  java.lang.Object
    |
    +--java.lang.Throwable
          |
          +--java.lang.Exception
                |
                +--<A HREF="../../../javax/xml/transform/TransformerException.html">javax.xml.transform.TransformerException</A>
                      |
                      +--<B>javax.xml.transform.TransformerConfigurationException</B>
  </PRE>
  <HR>
  <DL>
  <DT>public class <B>TransformerConfigurationException</B><DT>extends <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></DL>
  
  <P>
  Indicates a serious configuration error.
  <P>
  <DL>
  <DT><B>See Also: </B><DD><A HREF="../../../serialized-form.html#javax.xml.transform.TransformerConfigurationException">Serialized Form</A></DL>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  <A NAME="constructor_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Constructor Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html#TransformerConfigurationException()">TransformerConfigurationException</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerConfigurationException</code> with no
   detail mesage.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html#TransformerConfigurationException(java.lang.String)">TransformerConfigurationException</A></B>(java.lang.String&nbsp;msg)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerConfigurationException</code> with
   the <code>String </code> specified as an error message.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html#TransformerConfigurationException(java.lang.String, javax.xml.transform.SourceLocator)">TransformerConfigurationException</A></B>(java.lang.String&nbsp;message,
                                    <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new TransformerConfigurationException from a message and a Locator.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html#TransformerConfigurationException(java.lang.String, javax.xml.transform.SourceLocator, java.lang.Throwable)">TransformerConfigurationException</A></B>(java.lang.String&nbsp;message,
                                    <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
                                    java.lang.Throwable&nbsp;e)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Wrap an existing exception in a TransformerConfigurationException.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html#TransformerConfigurationException(java.lang.String, java.lang.Throwable)">TransformerConfigurationException</A></B>(java.lang.String&nbsp;msg,
                                    java.lang.Throwable&nbsp;e)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerConfigurationException</code> with the
   given <code>Exception</code> base cause and detail message.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html#TransformerConfigurationException(java.lang.Throwable)">TransformerConfigurationException</A></B>(java.lang.Throwable&nbsp;e)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerConfigurationException</code> with a
   given <code>Exception</code> base cause of the error.</TD>
  </TR>
  </TABLE>
  &nbsp;
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="methods_inherited_from_class_javax.xml.transform.TransformerException"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class javax.xml.transform.<A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><A HREF="../../../javax/xml/transform/TransformerException.html#getCause()">getCause</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#getException()">getException</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#getLocationAsString()">getLocationAsString</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#getLocator()">getLocator</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#getMessageAndLocation()">getMessageAndLocation</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#initCause(java.lang.Throwable)">initCause</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace()">printStackTrace</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace(java.io.PrintStream)">printStackTrace</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace(java.io.PrintWriter)">printStackTrace</A>, 
  <A HREF="../../../javax/xml/transform/TransformerException.html#setLocator(javax.xml.transform.SourceLocator)">setLocator</A></CODE></TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Throwable</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>fillInStackTrace, 
  getLocalizedMessage, 
  getMessage, 
  toString</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Object</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>equals, 
  getClass, 
  hashCode, 
  notify, 
  notifyAll, 
  wait, 
  wait, 
  wait</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  <A NAME="constructor_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Constructor Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="TransformerConfigurationException()"><!-- --></A><H3>
  TransformerConfigurationException</H3>
  <PRE>
  public <B>TransformerConfigurationException</B>()</PRE>
  <DL>
  <DD>Create a new <code>TransformerConfigurationException</code> with no
   detail mesage.</DL>
  <HR>
  
  <A NAME="TransformerConfigurationException(java.lang.String)"><!-- --></A><H3>
  TransformerConfigurationException</H3>
  <PRE>
  public <B>TransformerConfigurationException</B>(java.lang.String&nbsp;msg)</PRE>
  <DL>
  <DD>Create a new <code>TransformerConfigurationException</code> with
   the <code>String </code> specified as an error message.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>msg</CODE> - The error message for the exception.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerConfigurationException(java.lang.Throwable)"><!-- --></A><H3>
  TransformerConfigurationException</H3>
  <PRE>
  public <B>TransformerConfigurationException</B>(java.lang.Throwable&nbsp;e)</PRE>
  <DL>
  <DD>Create a new <code>TransformerConfigurationException</code> with a
   given <code>Exception</code> base cause of the error.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>e</CODE> - The exception to be encapsulated in a
   TransformerConfigurationException.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerConfigurationException(java.lang.String, java.lang.Throwable)"><!-- --></A><H3>
  TransformerConfigurationException</H3>
  <PRE>
  public <B>TransformerConfigurationException</B>(java.lang.String&nbsp;msg,
                                           java.lang.Throwable&nbsp;e)</PRE>
  <DL>
  <DD>Create a new <code>TransformerConfigurationException</code> with the
   given <code>Exception</code> base cause and detail message.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>e</CODE> - The exception to be encapsulated in a
   TransformerConfigurationException<DD><CODE>msg</CODE> - The detail message.<DD><CODE>e</CODE> - The exception to be wrapped in a TransformerConfigurationException</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerConfigurationException(java.lang.String, javax.xml.transform.SourceLocator)"><!-- --></A><H3>
  TransformerConfigurationException</H3>
  <PRE>
  public <B>TransformerConfigurationException</B>(java.lang.String&nbsp;message,
                                           <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)</PRE>
  <DL>
  <DD>Create a new TransformerConfigurationException from a message and a Locator.
  
   <p>This constructor is especially useful when an application is
   creating its own exception from within a DocumentHandler
   callback.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>message</CODE> - The error or warning message.<DD><CODE>locator</CODE> - The locator object for the error or warning.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerConfigurationException(java.lang.String, javax.xml.transform.SourceLocator, java.lang.Throwable)"><!-- --></A><H3>
  TransformerConfigurationException</H3>
  <PRE>
  public <B>TransformerConfigurationException</B>(java.lang.String&nbsp;message,
                                           <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
                                           java.lang.Throwable&nbsp;e)</PRE>
  <DL>
  <DD>Wrap an existing exception in a TransformerConfigurationException.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>message</CODE> - The error or warning message, or null to
                  use the message from the embedded exception.<DD><CODE>locator</CODE> - The locator object for the error or warning.<DD><CODE>e</CODE> - Any exception.</DL>
  </DD>
  </DL>
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerConfigurationException.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;PREV CLASS&nbsp;
  &nbsp;<A HREF="../../../javax/xml/transform/TransformerException.html"><B>NEXT CLASS</B></A></FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerConfigurationException.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#methods_inherited_from_class_javax.xml.transform.TransformerException">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;METHOD</FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/TransformerException.html
  
  Index: TransformerException.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Class  TransformerException
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerException.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/TransformerConfigurationException.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerException.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Class  TransformerException</H2>
  <PRE>
  java.lang.Object
    |
    +--java.lang.Throwable
          |
          +--java.lang.Exception
                |
                +--<B>javax.xml.transform.TransformerException</B>
  </PRE>
  <DL>
  <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A>, <A HREF="../../../org/apache/xpath/XPathException.html">XPathException</A></DD>
  </DL>
  <HR>
  <DL>
  <DT>public class <B>TransformerException</B><DT>extends java.lang.Exception</DL>
  
  <P>
  This class specifies an exceptional condition that occured
   during the transformation process.
  <P>
  <DL>
  <DT><B>See Also: </B><DD><A HREF="../../../serialized-form.html#javax.xml.transform.TransformerException">Serialized Form</A></DL>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  <A NAME="constructor_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Constructor Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.String)">TransformerException</A></B>(java.lang.String&nbsp;message)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new TransformerException.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.String, javax.xml.transform.SourceLocator)">TransformerException</A></B>(java.lang.String&nbsp;message,
                       <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new TransformerException from a message and a Locator.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.String, javax.xml.transform.SourceLocator, java.lang.Throwable)">TransformerException</A></B>(java.lang.String&nbsp;message,
                       <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
                       java.lang.Throwable&nbsp;e)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Wrap an existing exception in a TransformerException.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.String, java.lang.Throwable)">TransformerException</A></B>(java.lang.String&nbsp;message,
                       java.lang.Throwable&nbsp;e)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Wrap an existing exception in a TransformerException.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.Throwable)">TransformerException</A></B>(java.lang.Throwable&nbsp;e)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new TransformerException wrapping an existing exception.</TD>
  </TR>
  </TABLE>
  &nbsp;
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.Throwable</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#getCause()">getCause</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the cause of this throwable or <code>null</code> if the
   cause is nonexistent or unknown.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.Throwable</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#getException()">getException</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method retrieves an exception that this exception wraps.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#getLocationAsString()">getLocationAsString</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the location information as a string.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#getLocator()">getLocator</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Method getLocator retrieves an instance of a SourceLocator
   object that specifies where an error occured.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#getMessageAndLocation()">getMessageAndLocation</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the error message with location information
   appended.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.Throwable</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#initCause(java.lang.Throwable)">initCause</A></B>(java.lang.Throwable&nbsp;cause)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Initializes the <i>cause</i> of this throwable to the specified value.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace()">printStackTrace</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the the trace of methods from where the error
   originated.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace(java.io.PrintStream)">printStackTrace</A></B>(java.io.PrintStream&nbsp;s)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the the trace of methods from where the error
   originated.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace(java.io.PrintWriter)">printStackTrace</A></B>(java.io.PrintWriter&nbsp;s)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print the the trace of methods from where the error
   originated.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerException.html#setLocator(javax.xml.transform.SourceLocator)">setLocator</A></B>(<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;location)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Method setLocator sets an instance of a SourceLocator
   object that specifies where an error occured.</TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Throwable</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>fillInStackTrace, 
  getLocalizedMessage, 
  getMessage, 
  toString</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Object</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>equals, 
  getClass, 
  hashCode, 
  notify, 
  notifyAll, 
  wait, 
  wait, 
  wait</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  <A NAME="constructor_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Constructor Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="TransformerException(java.lang.String)"><!-- --></A><H3>
  TransformerException</H3>
  <PRE>
  public <B>TransformerException</B>(java.lang.String&nbsp;message)</PRE>
  <DL>
  <DD>Create a new TransformerException.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>message</CODE> - The error or warning message.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerException(java.lang.Throwable)"><!-- --></A><H3>
  TransformerException</H3>
  <PRE>
  public <B>TransformerException</B>(java.lang.Throwable&nbsp;e)</PRE>
  <DL>
  <DD>Create a new TransformerException wrapping an existing exception.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>e</CODE> - The exception to be wrapped.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerException(java.lang.String, java.lang.Throwable)"><!-- --></A><H3>
  TransformerException</H3>
  <PRE>
  public <B>TransformerException</B>(java.lang.String&nbsp;message,
                              java.lang.Throwable&nbsp;e)</PRE>
  <DL>
  <DD>Wrap an existing exception in a TransformerException.
  
   <p>This is used for throwing processor exceptions before
   the processing has started.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>message</CODE> - The error or warning message, or null to
                  use the message from the embedded exception.<DD><CODE>e</CODE> - Any exception</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerException(java.lang.String, javax.xml.transform.SourceLocator)"><!-- --></A><H3>
  TransformerException</H3>
  <PRE>
  public <B>TransformerException</B>(java.lang.String&nbsp;message,
                              <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)</PRE>
  <DL>
  <DD>Create a new TransformerException from a message and a Locator.
  
   <p>This constructor is especially useful when an application is
   creating its own exception from within a DocumentHandler
   callback.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>message</CODE> - The error or warning message.<DD><CODE>locator</CODE> - The locator object for the error or warning.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerException(java.lang.String, javax.xml.transform.SourceLocator, java.lang.Throwable)"><!-- --></A><H3>
  TransformerException</H3>
  <PRE>
  public <B>TransformerException</B>(java.lang.String&nbsp;message,
                              <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
                              java.lang.Throwable&nbsp;e)</PRE>
  <DL>
  <DD>Wrap an existing exception in a TransformerException.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>message</CODE> - The error or warning message, or null to
                  use the message from the embedded exception.<DD><CODE>locator</CODE> - The locator object for the error or warning.<DD><CODE>e</CODE> - Any exception</DL>
  </DD>
  </DL>
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="getLocator()"><!-- --></A><H3>
  getLocator</H3>
  <PRE>
  public <A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> <B>getLocator</B>()</PRE>
  <DL>
  <DD>Method getLocator retrieves an instance of a SourceLocator
   object that specifies where an error occured.<DD><DL>
  <DT><B>Returns:</B><DD>A SourceLocator object, or null if none was specified.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setLocator(javax.xml.transform.SourceLocator)"><!-- --></A><H3>
  setLocator</H3>
  <PRE>
  public void <B>setLocator</B>(<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;location)</PRE>
  <DL>
  <DD>Method setLocator sets an instance of a SourceLocator
   object that specifies where an error occured.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>location</CODE> - A SourceLocator object, or null to clear the location.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getException()"><!-- --></A><H3>
  getException</H3>
  <PRE>
  public java.lang.Throwable <B>getException</B>()</PRE>
  <DL>
  <DD>This method retrieves an exception that this exception wraps.<DD><DL>
  <DT><B>Returns:</B><DD>An Throwable object, or null.<DT><B>See Also: </B><DD><A HREF="../../../javax/xml/transform/TransformerException.html#getCause()"><CODE>getCause()</CODE></A></DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getCause()"><!-- --></A><H3>
  getCause</H3>
  <PRE>
  public java.lang.Throwable <B>getCause</B>()</PRE>
  <DL>
  <DD>Returns the cause of this throwable or <code>null</code> if the
   cause is nonexistent or unknown.  (The cause is the throwable that
   caused this throwable to get thrown.)</DL>
  <HR>
  
  <A NAME="initCause(java.lang.Throwable)"><!-- --></A><H3>
  initCause</H3>
  <PRE>
  public java.lang.Throwable <B>initCause</B>(java.lang.Throwable&nbsp;cause)</PRE>
  <DL>
  <DD>Initializes the <i>cause</i> of this throwable to the specified value.
   (The cause is the throwable that caused this throwable to get thrown.)
  
   <p>This method can be called at most once.  It is generally called from
   within the constructor, or immediately after creating the
   throwable.  If this throwable was created
   with <A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.Throwable)"><CODE>TransformerException(Throwable)</CODE></A> or
   <A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.String, java.lang.Throwable)"><CODE>TransformerException(String,Throwable)</CODE></A>, this method cannot be called
   even once.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>cause</CODE> - the cause (which is saved for later retrieval by the
           <A HREF="../../../javax/xml/transform/TransformerException.html#getCause()"><CODE>getCause()</CODE></A> method).  (A <tt>null</tt> value is
           permitted, and indicates that the cause is nonexistent or
           unknown.)<DT><B>Returns:</B><DD>a reference to this <code>Throwable</code> instance.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - if <code>cause</code> is this
           throwable.  (A throwable cannot
           be its own cause.)<DD>java.lang.IllegalStateException - if this throwable was
           created with <A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.Throwable)"><CODE>TransformerException(Throwable)</CODE></A> or
           <A HREF="../../../javax/xml/transform/TransformerException.html#TransformerException(java.lang.String, java.lang.Throwable)"><CODE>TransformerException(String,Throwable)</CODE></A>, or this method has already
           been called on this throwable.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getMessageAndLocation()"><!-- --></A><H3>
  getMessageAndLocation</H3>
  <PRE>
  public java.lang.String <B>getMessageAndLocation</B>()</PRE>
  <DL>
  <DD>Get the error message with location information
   appended.</DL>
  <HR>
  
  <A NAME="getLocationAsString()"><!-- --></A><H3>
  getLocationAsString</H3>
  <PRE>
  public java.lang.String <B>getLocationAsString</B>()</PRE>
  <DL>
  <DD>Get the location information as a string.<DD><DL>
  <DT><B>Returns:</B><DD>A string with location info, or null
   if there is no location information.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="printStackTrace()"><!-- --></A><H3>
  printStackTrace</H3>
  <PRE>
  public void <B>printStackTrace</B>()</PRE>
  <DL>
  <DD>Print the the trace of methods from where the error
   originated.  This will trace all nested exception
   objects, as well as this object.<DD><DL>
  <DT><B>Overrides:</B><DD>printStackTrace in class java.lang.Throwable</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="printStackTrace(java.io.PrintStream)"><!-- --></A><H3>
  printStackTrace</H3>
  <PRE>
  public void <B>printStackTrace</B>(java.io.PrintStream&nbsp;s)</PRE>
  <DL>
  <DD>Print the the trace of methods from where the error
   originated.  This will trace all nested exception
   objects, as well as this object.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>s</CODE> - The stream where the dump will be sent to.<DT><B>Overrides:</B><DD>printStackTrace in class java.lang.Throwable</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="printStackTrace(java.io.PrintWriter)"><!-- --></A><H3>
  printStackTrace</H3>
  <PRE>
  public void <B>printStackTrace</B>(java.io.PrintWriter&nbsp;s)</PRE>
  <DL>
  <DD>Print the the trace of methods from where the error
   originated.  This will trace all nested exception
   objects, as well as this object.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>s</CODE> - The writer where the dump will be sent to.<DT><B>Overrides:</B><DD>printStackTrace in class java.lang.Throwable</DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerException.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/TransformerConfigurationException.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerException.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/TransformerFactory.html
  
  Index: TransformerFactory.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Class  TransformerFactory
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerFactory.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Transformer.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerFactory.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Class  TransformerFactory</H2>
  <PRE>
  java.lang.Object
    |
    +--<B>javax.xml.transform.TransformerFactory</B>
  </PRE>
  <DL>
  <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../javax/xml/transform/sax/SAXTransformerFactory.html">SAXTransformerFactory</A></DD>
  </DL>
  <HR>
  <DL>
  <DT>public abstract class <B>TransformerFactory</B><DT>extends java.lang.Object</DL>
  
  <P>
  A TransformerFactory instance can be used to create Transformer and Template
   objects.
  
   <p>The system property that determines which Factory implementation
   to create is named "javax.xml.transform.TransformerFactory". This
   property names a concrete subclass of the TransformerFactory abstract
    class. If the property is not defined, a platform default is be used.</p>
  <P>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/Source.html">Source</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#getAssociatedStylesheet(javax.xml.transform.Source, java.lang.String, java.lang.String, java.lang.String)">getAssociatedStylesheet</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source,
                          java.lang.String&nbsp;media,
                          java.lang.String&nbsp;title,
                          java.lang.String&nbsp;charset)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the stylesheet specification(s) associated
   via the xml-stylesheet processing instruction (see
   http://www.w3.org/TR/xml-stylesheet/) with the document
   document specified in the source parameter, and that match
   the given criteria.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;java.lang.Object</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#getAttribute(java.lang.String)">getAttribute</A></B>(java.lang.String&nbsp;name)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows the user to retrieve specific attributes on the underlying
   implementation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#getErrorListener()">getErrorListener</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the error event handler for the TransformerFactory.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;boolean</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#getFeature(java.lang.String)">getFeature</A></B>(java.lang.String&nbsp;name)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Look up the value of a feature.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#getURIResolver()">getURIResolver</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the object that is used by default during the transformation
   to resolve URIs used in document(), xsl:import, or xsl:include.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>static&nbsp;<A HREF="../../../javax/xml/transform/TransformerFactory.html">TransformerFactory</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#newInstance()">newInstance</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Obtain a new instance of a <code>TransformerFactory</code>.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/Templates.html">Templates</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#newTemplates(javax.xml.transform.Source)">newTemplates</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Process the Source into a Templates object, which is a
   a compiled representation of the source.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/Transformer.html">Transformer</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#newTransformer()">newTransformer</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new Transformer object that performs a copy
   of the source to the result.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;<A HREF="../../../javax/xml/transform/Transformer.html">Transformer</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#newTransformer(javax.xml.transform.Source)">newTransformer</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Process the Source into a Transformer object.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#setAttribute(java.lang.String, java.lang.Object)">setAttribute</A></B>(java.lang.String&nbsp;name,
               java.lang.Object&nbsp;value)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allows the user to set specific attributes on the underlying
   implementation.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#setErrorListener(javax.xml.transform.ErrorListener)">setErrorListener</A></B>(<A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A>&nbsp;listener)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the error event listener for the TransformerFactory, which
   is used for the processing of transformation instructions,
   and not for the transformation itself.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>abstract &nbsp;void</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactory.html#setURIResolver(javax.xml.transform.URIResolver)">setURIResolver</A></B>(<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A>&nbsp;resolver)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set an object that is used by default during the transformation
   to resolve URIs used in xsl:import, or xsl:include.</TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Object</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>equals, 
  getClass, 
  hashCode, 
  notify, 
  notifyAll, 
  toString, 
  wait, 
  wait, 
  wait</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="newInstance()"><!-- --></A><H3>
  newInstance</H3>
  <PRE>
  public static <A HREF="../../../javax/xml/transform/TransformerFactory.html">TransformerFactory</A> <B>newInstance</B>()
                                        throws <A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html">TransformerFactoryConfigurationError</A></PRE>
  <DL>
  <DD>Obtain a new instance of a <code>TransformerFactory</code>.
   This static method creates a new factory instance 
   This method uses the following ordered lookup procedure to determine
   the <code>TransformerFactory</code> implementation class to
   load:
   <ul>
   <li>
   Use the <code>javax.xml.parsers.DocumentBuilderFactory</code> system
   property.
   </li>
   <li>
   Use the JAVA_HOME(the parent directory where jdk is
   installed)/lib/jaxp.properties for a property file that contains the
   name of the implementation class keyed on the same value as the
   system property defined above.
   </li>
   <li>
   Use the Services API (as detailed in teh JAR specification), if
   available, to determine the classname. The Services API will look
   for a classname in the file
   <code>META-INF/services/javax.xml.parsers.TransformerFactory</code>
   in jars available to the runtime.
   </li>
   <li>
   Platform default <code>TransformerFactory</code> instance.
   </li>
   </ul>
  
   Once an application has obtained a reference to a <code>
   TransformerFactory</code> it can use the factory to configure
   and obtain parser instances.<DD><DL>
  <DT><B>Returns:</B><DD>new TransformerFactory instance, never null.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html">TransformerFactoryConfigurationError</A> - if the implmentation is not available or cannot be instantiated.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="newTransformer(javax.xml.transform.Source)"><!-- --></A><H3>
  newTransformer</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/Transformer.html">Transformer</A> <B>newTransformer</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)
                                      throws <A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A></PRE>
  <DL>
  <DD>Process the Source into a Transformer object.  Care must
   be given not to use this object in multiple threads running concurrently.
   Different TransformerFactories can be used concurrently by different
   threads.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>source</CODE> - An object that holds a URI, input stream, etc.<DT><B>Returns:</B><DD>A Transformer object that may be used to perform a transformation
   in a single thread, never null.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A> - May throw this during the parse
              when it is constructing the Templates object and fails.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="newTransformer()"><!-- --></A><H3>
  newTransformer</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/Transformer.html">Transformer</A> <B>newTransformer</B>()
                                      throws <A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A></PRE>
  <DL>
  <DD>Create a new Transformer object that performs a copy
   of the source to the result.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>source</CODE> - An object that holds a URI, input stream, etc.<DT><B>Returns:</B><DD>A Transformer object that may be used to perform a transformation
   in a single thread, never null.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A> - May throw this during
              the parse when it is constructing the
              Templates object and fails.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="newTemplates(javax.xml.transform.Source)"><!-- --></A><H3>
  newTemplates</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/Templates.html">Templates</A> <B>newTemplates</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)
                                  throws <A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A></PRE>
  <DL>
  <DD>Process the Source into a Templates object, which is a
   a compiled representation of the source. This Templates object
   may then be used concurrently across multiple threads.  Creating
   a Templates object allows the TransformerFactory to do detailed
   performance optimization of transformation instructions, without
   penalizing runtime transformation.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>source</CODE> - An object that holds a URL, input stream, etc.<DT><B>Returns:</B><DD>A Templates object capable of being used for transformation purposes,
   never null.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A> - May throw this during the parse when it
              is constructing the Templates object and fails.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getAssociatedStylesheet(javax.xml.transform.Source, java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
  getAssociatedStylesheet</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/Source.html">Source</A> <B>getAssociatedStylesheet</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source,
                                                 java.lang.String&nbsp;media,
                                                 java.lang.String&nbsp;title,
                                                 java.lang.String&nbsp;charset)
                                          throws <A HREF="../../../javax/xml/transform/TransformerConfigurationException.html">TransformerConfigurationException</A></PRE>
  <DL>
  <DD>Get the stylesheet specification(s) associated
   via the xml-stylesheet processing instruction (see
   http://www.w3.org/TR/xml-stylesheet/) with the document
   document specified in the source parameter, and that match
   the given criteria.  Note that it is possible to return several
   stylesheets, in which case they are applied as if they were
   a list of imports or cascades in a single stylesheet.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>source</CODE> - The XML source document.<DD><CODE>media</CODE> - The media attribute to be matched.  May be null, in which
                case the prefered templates will be used (i.e. alternate = no).<DD><CODE>title</CODE> - The value of the title attribute to match.  May be null.<DD><CODE>charset</CODE> - The value of the charset attribute to match.  May be null.<DT><B>Returns:</B><DD>A Source object suitable for passing to the TransformerFactory.<DT><B>Throws:</B><DD>TransformerConfigurationException. - &nbsp;</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setURIResolver(javax.xml.transform.URIResolver)"><!-- --></A><H3>
  setURIResolver</H3>
  <PRE>
  public abstract void <B>setURIResolver</B>(<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A>&nbsp;resolver)</PRE>
  <DL>
  <DD>Set an object that is used by default during the transformation
   to resolve URIs used in xsl:import, or xsl:include.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>resolver</CODE> - An object that implements the URIResolver interface,
   or null.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getURIResolver()"><!-- --></A><H3>
  getURIResolver</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A> <B>getURIResolver</B>()</PRE>
  <DL>
  <DD>Get the object that is used by default during the transformation
   to resolve URIs used in document(), xsl:import, or xsl:include.<DD><DL>
  <DT><B>Returns:</B><DD>The URIResolver that was set with setURIResolver.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getFeature(java.lang.String)"><!-- --></A><H3>
  getFeature</H3>
  <PRE>
  public abstract boolean <B>getFeature</B>(java.lang.String&nbsp;name)</PRE>
  <DL>
  <DD>Look up the value of a feature.
  
   <p>The feature name is any absolute URI.</p><DD><DL>
  <DT><B>Parameters:</B><DD><CODE>name</CODE> - The feature name, which is an absolute URI.<DT><B>Returns:</B><DD>The current state of the feature (true or false).</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setAttribute(java.lang.String, java.lang.Object)"><!-- --></A><H3>
  setAttribute</H3>
  <PRE>
  public abstract void <B>setAttribute</B>(java.lang.String&nbsp;name,
                                    java.lang.Object&nbsp;value)
                             throws java.lang.IllegalArgumentException</PRE>
  <DL>
  <DD>Allows the user to set specific attributes on the underlying
   implementation.  An attribute in this context is defined to
   be an option that the implementation provides.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the attribute.<DD><CODE>value</CODE> - The value of the attribute.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - thrown if the underlying
   implementation doesn't recognize the attribute.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getAttribute(java.lang.String)"><!-- --></A><H3>
  getAttribute</H3>
  <PRE>
  public abstract java.lang.Object <B>getAttribute</B>(java.lang.String&nbsp;name)
                                         throws java.lang.IllegalArgumentException</PRE>
  <DL>
  <DD>Allows the user to retrieve specific attributes on the underlying
   implementation.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the attribute.<DT><B>Returns:</B><DD>value The value of the attribute.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - thrown if the underlying
   implementation doesn't recognize the attribute.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="setErrorListener(javax.xml.transform.ErrorListener)"><!-- --></A><H3>
  setErrorListener</H3>
  <PRE>
  public abstract void <B>setErrorListener</B>(<A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A>&nbsp;listener)
                                 throws java.lang.IllegalArgumentException</PRE>
  <DL>
  <DD>Set the error event listener for the TransformerFactory, which
   is used for the processing of transformation instructions,
   and not for the transformation itself.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>listener</CODE> - The new error listener.<DT><B>Throws:</B><DD>java.lang.IllegalArgumentException - if listener is null.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getErrorListener()"><!-- --></A><H3>
  getErrorListener</H3>
  <PRE>
  public abstract <A HREF="../../../javax/xml/transform/ErrorListener.html">ErrorListener</A> <B>getErrorListener</B>()</PRE>
  <DL>
  <DD>Get the error event handler for the TransformerFactory.<DD><DL>
  <DT><B>Returns:</B><DD>The current error handler, which should never be null.</DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerFactory.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Transformer.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerFactory.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/TransformerFactoryConfigurationError.html
  
  Index: TransformerFactoryConfigurationError.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Class  TransformerFactoryConfigurationError
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerFactoryConfigurationError.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;PREV CLASS&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerFactoryConfigurationError.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Class  TransformerFactoryConfigurationError</H2>
  <PRE>
  java.lang.Object
    |
    +--java.lang.Throwable
          |
          +--java.lang.Error
                |
                +--<B>javax.xml.transform.TransformerFactoryConfigurationError</B>
  </PRE>
  <HR>
  <DL>
  <DT>public class <B>TransformerFactoryConfigurationError</B><DT>extends java.lang.Error</DL>
  
  <P>
  Thrown when a problem with configuration with the Transformer Factories
   exists. This error will typically be thrown when the class of a
   transformation factory specified in the system properties cannot be found
   or instantiated.
  <P>
  <DL>
  <DT><B>See Also: </B><DD><A HREF="../../../serialized-form.html#javax.xml.transform.TransformerFactoryConfigurationError">Serialized Form</A></DL>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  <A NAME="constructor_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Constructor Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#TransformerFactoryConfigurationError()">TransformerFactoryConfigurationError</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerFactoryConfigurationError</code> with no
   detail mesage.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#TransformerFactoryConfigurationError(java.lang.Exception)">TransformerFactoryConfigurationError</A></B>(java.lang.Exception&nbsp;e)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerFactoryConfigurationError</code> with a
   given <code>Exception</code> base cause of the error.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#TransformerFactoryConfigurationError(java.lang.Exception, java.lang.String)">TransformerFactoryConfigurationError</A></B>(java.lang.Exception&nbsp;e,
                                       java.lang.String&nbsp;msg)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerFactoryConfigurationError</code> with the
   given <code>Exception</code> base cause and detail message.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#TransformerFactoryConfigurationError(java.lang.String)">TransformerFactoryConfigurationError</A></B>(java.lang.String&nbsp;msg)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a new <code>TransformerFactoryConfigurationError</code> with
   the <code>String </code> specified as an error message.</TD>
  </TR>
  </TABLE>
  &nbsp;
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.Exception</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#getException()">getException</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the actual exception (if any) that caused this exception to
   be raised.</TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#getMessage()">getMessage</A></B>()</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the message (if any) for this error .</TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Throwable</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>fillInStackTrace, 
  getLocalizedMessage, 
  printStackTrace, 
  printStackTrace, 
  printStackTrace, 
  toString</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
  <TD><B>Methods inherited from class java.lang.Object</B></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD><CODE>equals, 
  getClass, 
  hashCode, 
  notify, 
  notifyAll, 
  wait, 
  wait, 
  wait</CODE></TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  <A NAME="constructor_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Constructor Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="TransformerFactoryConfigurationError()"><!-- --></A><H3>
  TransformerFactoryConfigurationError</H3>
  <PRE>
  public <B>TransformerFactoryConfigurationError</B>()</PRE>
  <DL>
  <DD>Create a new <code>TransformerFactoryConfigurationError</code> with no
   detail mesage.</DL>
  <HR>
  
  <A NAME="TransformerFactoryConfigurationError(java.lang.String)"><!-- --></A><H3>
  TransformerFactoryConfigurationError</H3>
  <PRE>
  public <B>TransformerFactoryConfigurationError</B>(java.lang.String&nbsp;msg)</PRE>
  <DL>
  <DD>Create a new <code>TransformerFactoryConfigurationError</code> with
   the <code>String </code> specified as an error message.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>msg</CODE> - The error message for the exception.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerFactoryConfigurationError(java.lang.Exception)"><!-- --></A><H3>
  TransformerFactoryConfigurationError</H3>
  <PRE>
  public <B>TransformerFactoryConfigurationError</B>(java.lang.Exception&nbsp;e)</PRE>
  <DL>
  <DD>Create a new <code>TransformerFactoryConfigurationError</code> with a
   given <code>Exception</code> base cause of the error.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>e</CODE> - The exception to be encapsulated in a
   TransformerFactoryConfigurationError.</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="TransformerFactoryConfigurationError(java.lang.Exception, java.lang.String)"><!-- --></A><H3>
  TransformerFactoryConfigurationError</H3>
  <PRE>
  public <B>TransformerFactoryConfigurationError</B>(java.lang.Exception&nbsp;e,
                                              java.lang.String&nbsp;msg)</PRE>
  <DL>
  <DD>Create a new <code>TransformerFactoryConfigurationError</code> with the
   given <code>Exception</code> base cause and detail message.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>e</CODE> - The exception to be encapsulated in a
   TransformerFactoryConfigurationError<DD><CODE>msg</CODE> - The detail message.<DD><CODE>e</CODE> - The exception to be wrapped in a TransformerFactoryConfigurationError</DL>
  </DD>
  </DL>
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="getMessage()"><!-- --></A><H3>
  getMessage</H3>
  <PRE>
  public java.lang.String <B>getMessage</B>()</PRE>
  <DL>
  <DD>Return the message (if any) for this error . If there is no
   message for the exception and there is an encapsulated
   exception then the message of that exception will be returned.<DD><DL>
  <DT><B>Returns:</B><DD>The error message.<DT><B>Overrides:</B><DD>getMessage in class java.lang.Throwable</DL>
  </DD>
  </DL>
  <HR>
  
  <A NAME="getException()"><!-- --></A><H3>
  getException</H3>
  <PRE>
  public java.lang.Exception <B>getException</B>()</PRE>
  <DL>
  <DD>Return the actual exception (if any) that caused this exception to
   be raised.<DD><DL>
  <DT><B>Returns:</B><DD>The encapsulated exception, or null if there is none.</DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/TransformerFactoryConfigurationError.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;PREV CLASS&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="TransformerFactoryConfigurationError.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/URIResolver.html
  
  Index: URIResolver.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
  <!--NewPage-->
  <HTML>
  <HEAD>
  <!-- Generated by javadoc on Fri Jan 12 11:14:48 PST 2001 -->
  <TITLE>
  Xalan-Java 2: Interface  URIResolver
  </TITLE>
  <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
  </HEAD>
  <BODY BGCOLOR="white">
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_top"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_top_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/URIResolver.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Templates.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="URIResolver.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  <!-- ======== START OF CLASS DATA ======== -->
  <H2>
  <FONT SIZE="-1">
  javax.xml.transform</FONT>
  <BR>
  Interface  URIResolver</H2>
  <HR>
  <DL>
  <DT>public interface <B>URIResolver</B></DL>
  
  <P>
  <p>An object that implements this interface that can be called by the processor
   to turn a URI used in document(), xsl:import, or xsl:include into a Source object.
  <P>
  <HR>
  
  <P>
  <!-- ======== INNER CLASS SUMMARY ======== -->
  
  
  <!-- =========== FIELD SUMMARY =========== -->
  
  
  <!-- ======== CONSTRUCTOR SUMMARY ======== -->
  
  
  <!-- ========== METHOD SUMMARY =========== -->
  
  <A NAME="method_summary"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=2><FONT SIZE="+2">
  <B>Method Summary</B></FONT></TD>
  </TR>
  <TR BGCOLOR="white" CLASS="TableRowColor">
  <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
  <CODE>&nbsp;<A HREF="../../../javax/xml/transform/Source.html">Source</A></CODE></FONT></TD>
  <TD><CODE><B><A HREF="../../../javax/xml/transform/URIResolver.html#resolve(java.lang.String, java.lang.String)">resolve</A></B>(java.lang.String&nbsp;href,
          java.lang.String&nbsp;base)</CODE>
  
  <BR>
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Called by the processor when it encounters
   an xsl:include, xsl:import, or document() function.</TD>
  </TR>
  </TABLE>
  &nbsp;
  <P>
  
  <!-- ============ FIELD DETAIL =========== -->
  
  
  <!-- ========= CONSTRUCTOR DETAIL ======== -->
  
  
  <!-- ============ METHOD DETAIL ========== -->
  
  <A NAME="method_detail"><!-- --></A>
  <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
  <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  <TD COLSPAN=1><FONT SIZE="+2">
  <B>Method Detail</B></FONT></TD>
  </TR>
  </TABLE>
  
  <A NAME="resolve(java.lang.String, java.lang.String)"><!-- --></A><H3>
  resolve</H3>
  <PRE>
  public <A HREF="../../../javax/xml/transform/Source.html">Source</A> <B>resolve</B>(java.lang.String&nbsp;href,
                        java.lang.String&nbsp;base)
                 throws <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></PRE>
  <DL>
  <DD>Called by the processor when it encounters
   an xsl:include, xsl:import, or document() function.<DD><DL>
  <DT><B>Parameters:</B><DD><CODE>href</CODE> - An href attribute, which may be relative or absolute.<DD><CODE>base</CODE> - The base URI in effect when the href attribute
   was encountered.<DT><B>Returns:</B><DD>A Source object, or null if the href cannot be resolved,
   and the processor should try to resolve the URI itself.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A> - if an error occurs when trying to
   resolve the URI.</DL>
  </DD>
  </DL>
  <!-- ========= END OF CLASS DATA ========= -->
  <HR>
  
  <!-- ========== START OF NAVBAR ========== -->
  <A NAME="navbar_bottom"><!-- --></A>
  <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
  <TR>
  <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  <A NAME="navbar_bottom_firstrow"><!-- --></A>
  <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
    <TR ALIGN="center" VALIGN="top">
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/URIResolver.html"><FONT ID="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    </TR>
  </TABLE>
  </TD>
  <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  </EM>
  </TD>
  </TR>
  
  <TR>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  &nbsp;<A HREF="../../../javax/xml/transform/Templates.html"><B>PREV CLASS</B></A>&nbsp;
  &nbsp;NEXT CLASS</FONT></TD>
  <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
  &nbsp;<A HREF="URIResolver.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
  </TR>
  <TR>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  </TR>
  </TABLE>
  <!-- =========== END OF NAVBAR =========== -->
  
  <HR>
  Copyright  2000 Apache XML Project. All Rights Reserved.
  </BODY>
  </HTML>
  
  
  
  1.1                  xml-site/targets/xalan-j/apidocs/javax/xml/transform/trax.html
  
  Index: trax.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  <html>
  <head>
  <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <title></title>
  </head>
  <body> 
    
  <h2>Transformation API For XML (TrAX)</h2>
     
    
  <p>
  <b>Edit Date: </b>November 12, 2000</p> 
     
     
     
    
  <h3>Introduction</h3> 
    
  <p>This overview describes the set of APIs contained in
  	 <A href="package-summary.html">javax.xml.transform</A>, <A href="package-summary.html">javax.xml.transform.stream</A>, <A href="package-summary.html">javax.xml.transform.dom</A>, and <A href="package-summary.html">javax.xml.transform.sax</A>. For the sake of brevity, these interfaces are referred to
  	 as TrAX (Transformation API for XML). </p> 
    
  <p>There is a broad need for Java applications to be able to transform XML
  	 and related tree-shaped data structures. In fact, XML is not normally very
  	 useful to an application without going through some sort of transformation,
  	 unless the semantic structure is used directly as data. Almost all XML-related
  	 applications need to perform transformations. Transformations may be described
  	 by Java code, Perl code, <A href="http://www.w3.org/TR/xslt">XSLT</A>
  	 Stylesheets, other types of script, or by proprietary formats. The inputs, one
  	 or multiple, to a transformation, may be a URL, XML stream, a DOM tree, SAX
  	 Events, or a proprietary format or data structure. The output types are the
  	 pretty much the same types as the inputs, but different inputs may need to be
  	 combined with different outputs.</p> 
    
  <p>The great challenge of a transformation API is how to deal with all the
  	 possible combinations of inputs and outputs, without becoming specialized for
  	 any of the given types.</p> 
    
  <p>The Java community will greatly benefit from a common API that will
  	 allow them to understand and apply a single model, write to consistent
  	 interfaces, and apply the transformations polymorphically. TrAX attempts to
  	 define a model that is clean and generic, yet fills general application
  	 requirements across a wide variety of uses. </p> 
     
  	 
  <h3>General Terminology</h3> 
  	 
  <p>This section will explain some general terminology used in this
  		document. Technical terminology will be explained in the Model section. In many
  		cases, the general terminology overlaps with the technical terminology.</p> 
  	 
  <ul>
  <li>
  <p>
  <b>Tree</b>
  <br>This term, as used within this document, describes an
  			 abstract structure that consists of nodes or events that may be produced by
  			 XML. A Tree physically may be a DOM tree, a series of well balanced parse
  			 events (such as those coming from a SAX2 ContentHander), a series of requests
  			 (the result of which can describe a tree), or a stream of marked-up
  			 characters.</p>
  </li>
  <li>
  <p>
  <b>Source Tree(s)</b>
  <br>One or more trees that are the inputs to the
  			 transformation.</p>
  </li>
  <li>
  <p>
  <b>Result Tree(s)</b>
  <br>One or more trees that are the output of the
  			 transformation.</p>
  </li>
  <li>
  <p>
  <b>Transformation</b>
  <br>The processor of consuming a stream or tree to produce
  			 another stream or tree.</p>
  </li>
  <li>
  <p>
  <b>Identity (or Copy) Transformation</b>
  <br>The process of transformation from a source to a result,
  			 making as few structural changes as possible and no informational changes. The
  			 term is somewhat loosely used, as the process is really a copy. from one
  			 "format" (such as a DOM tree, stream, or set of SAX events) to
  			 another.</p>
  </li>
  <li>
  <p>
  <b>Serialization</b>
  <br>The process of taking a tree and turning it into a stream. In
  			 some sense, a serialization is a specialized transformation.</p>
  </li>
  <li>
  <p>
  <b>Parsing</b>
  <br>The process of taking a stream and turning it into a tree. In
  			 some sense, parsing is a specialized transformation.</p>
  </li>
  <li>
  <p>
  <b>Transformer</b>
  <br>A Transformer is the object that executes the transformation.
  			 </p>
  </li>
  <li>
  <p>
  <b>Transformation instructions</b>
  <br>Describes the transformation. A form of code, script, or
  			 simply a declaration or series of declarations.</p>
  </li>
  <li>
  <p>
  <b>Stylesheet</b>
  <br>The same as "transformation instructions," except it is
  			 likely to be used in conjunction with <A href="http://www.w3.org/TR/xslt">XSLT</A>.</p>
  </li>
  <li>
  <p>
  <b>Templates</b>
  <br>Another form of "transformation instructions." In the TrAX
  			 interface, this term is used to describe processed or compiled transformation
  			 instructions. The Source flows through a Templates object to be formed into the
  			 Result.</p>
  </li>
  <li>
  <p>
  <b>Processor</b>
  <br>A general term for the thing that may both process the
  			 transformation instructions, and perform the transformation.</p>
  </li>
  <li>
  <p>
  <b>DOM</b>
  <br>Document Object Model, specifically referring to the
  			 <A href="#http://www.w3.org/TR/DOM-Level-2%20">Document Object Model
  			 (DOM) Level 2 Specification</A>.</p>
  </li>
  <li>
  <p>
  <b>SAX</b>
  <br>Simple API for XML, specifically referring to the
  			 <A href="#http://www.megginson.com/SAX/SAX2">SAX 2.0
  			 release</A>.</p>
  </li>
  </ul> 
    
     
    
  <h3>Requirements</h3> 
    
  <p>The following requirements have been determined from broad experience
  	 with XML projects from the various members participating on the JCP.</p> 
    
  <ol>
  <li>TrAX must provide a clean, simple
  		interface for simple uses.</li>
  <li>TrAX must be powerful enough to be
  		applied to a wide range of uses, such as, e-commerce, content management,
  		server content delivery, and client applications.</li>
  <li>A processor that implements a TrAX
  		interface must be optimizeable. Performance is a critical issue for most
  		transformation use cases.</li>
  <li>As a specialization of the above
  		requirement, a TrAX processor must be able to support a compiled model, so that
  		a single set of transformation instructions can be compiled, optimized, and
  		applied to a large set of input sources.</li>
  <li>TrAX must not be dependent an any
  		given type of transformation instructions. For instance, it must remain
  		independent of <A href="http://www.w3.org/TR/xslt">XSLT</A>.</li>
  <li>TrAX must be able to allow processors
  		to transform DOM trees.</li>
  <li>TrAX must be able to allow processors to
  		produce DOM trees.</li>
  <li>TrAX must allow processors to transform
  		SAX events.</li>
  <li>TrAX must allow processors to produce SAX
  		events.</li>
  <li>TrAX must allow processors to
  		transform streams of XML.</li>
  <li>TrAX must allow processors to produce
  		XML, HTML, and other types of streams.</li>
  <li>TrAX must allow processors to
  		implement the various combinations of inputs and outputs within a single
  		processor.</li>
  <li>TrAX must allow processors
  		to implement only a limited set of inputs. For instance, it should be possible
  		to write a processor that implements the TrAX interfaces and that only
  		processes DOM trees, not streams or SAX events.</li>
  <li>TrAX should allow a
  		processor to implement transformations of proprietary data structures. For
  		instance, it should be possible to implement a processor that provides TrAX
  		interfaces that performs transformation of JDOM trees.</li>
  <li>TrAX must allow the setting
  		of serialization properties, without constraint as to what the details of those
  		properties are.</li>
  <li>TrAX must allow the setting
  		of parameters to the transformation instructions.</li>
  <li>TrAX must support the
  		setting of parameters and properties as XML Namespaced items (i.e., qualified
  		names).</li>
  <li>TrAX must support URL
  		resolution from within the transformation, and have it return the needed data
  		structure.</li>
  <li>TrAX must have a mechanism for
  		reporting errors and warnings to the calling application.</li>
  </ol>  
     
    
  <h3>Model</h3> 
    
  <p>The section defines the abstract model for TrAX, apart from the details
  	 of the interfaces.</p> 
    
  <p>A TRaX <A href="#pattern-TransformerFactory">TransformerFactory</A> is an object
  	 that processes transformation instructions, and produces
  	 <A href="#pattern-Templates">Templates</A> (in the technical
  	 terminology). A <A href="#pattern-Templates">Templates</A>
  	 object provides a <A href="#pattern-Transformer">Transformer</A>, which transforms one or
  	 more <A href="#pattern-Source">Source</A>s into one or more
  	 <A href="#pattern-Result">Result</A>s.</p> 
    
  <p>To use the TRaX interface, you create a
  	 <A href="#pattern-TransformerFactory">TransformerFactory</A>,
  	 which may directly provide a <A href="#pattern-Transformers">Transformers</A>, or which can provide
  	 <A href="#pattern-Templates">Templates</A> from a variety of
  	 <A href="#pattern-Source">Source</A>s. The
  	 <A href="#pattern-Templates">Templates</A> object is a processed
  	 or compiled representation of the transformation instructions, and provides a
  	 <A href="#pattern-Transformer">Transformer</A>. The
  	 <A href="#pattern-Transformer">Transformer</A> processes a
  	 <A href="#pattern-Transformer">Source</A> according to the
  	 instructions found in the <A href="#pattern-Templates">Templates</A>, and produces a
  	 <A href="#pattern-Result">Result</A>.</p> 
    
  <p>The process of transformation from a tree, either in the form of an
  	 object model, or in the form of parse events, into a stream, is known as
  	 <U>serialization</U>. We believe this is the most suitable term for
  	 this process, despite the overlap with Java object serialization.</p> 
    
  <H3>TRaX Patterns</H3>
  <ul>
  <p>
  <b><a name="pattern-Processor">Processor</a></b>
  <br>
  <br>
  <i>Intent: </i>Generic concept for the
    set of objects that implement the TrAX interfaces.<br>
  <i>Responsibilities: </i>Create compiled transformation instructions, transform
    sources, and manage transformation parameters and
    properties.<br>
  <i>Thread safety: </i>Only the Templates object can be
    used concurrently in multiple threads. The rest of the processor does not do
    synchronized blocking, and so may not be used to perform multiple concurrent
    operations.</p>
  <p>
  <b><a name="pattern-TransformerFactory">TransformerFactory</a></b>
  <br>
  <br>
  <i>Intent: </i>Serve as a vendor-neutral Processor interface for
    <A href="http://www.w3.org/TR/xslt">XSLT</A> and similar
    processors.<br>
  <i>Responsibilities: </i>Serve as a factory for a concrete
    implementation of an TransformerFactory, serve as a direct factory for
    Transformer objects, serve as a factory for Templates objects, and manage
    processor specific features.<br>
  <i>Thread safety: </i>A
    TransformerFactory may not perform mulitple concurrent
    operations.</p>
  <p>
  <b><a name="pattern-Templates">Templates</a></b>
  <br>
  <br>
  <i>Intent: </i>The
    runtime representation of the transformation instructions.<br>
  <i>Responsibilities: </i>A data bag for transformation instructions; act as a factory
    for Transformers.<br>
  <i>Thread safety: </i>Threadsafe for concurrent
    usage over multiple threads once construction is complete.</p>
  <p>
  <b><a name="pattern-Transformer">Transformer</a></b>
  <br>
  <br>
  <i>Intent: </i>Act as a per-thread
    execution context for transformations, act as an interface for performing the
    transformation.<br>
  <i>Responsibilities: </i>Perform the
    transformation.<br>
  <i>Thread safety: </i>Only one instance per thread
    is safe.<br>
  <i>Notes: </i>The Transformer is bound to the Templates
    object that created it.</p>
  <p>
  <b><a name="pattern-Source">Source</a></b>
  <br>
  <br>
  <i>Intent: </i>Serve as a
    single vendor-neutral object for multiple types of input.<br>
  <i>Responsibilities: </i>Act as simple data holder for System IDs, DOM nodes, streams,
    etc.<br>
  <i>Thread safety: </i>Threadsafe concurrently over multiple
    threads for read-only operations; must be synchronized for edit
    operations.</p>
  <p>
  <b><a name="pattern-Result">Result</a></b>
  <br>
  <br>
  <i>Potential alternate name: </i>ResultTarget<br>
  <i>Intent: </i>Serve
    as a single object for multiple types of output, so there can be simple process
    method signatures.<br>
  <i>Responsibilities: </i>Act as simple data holder for
    output stream, DOM node, ContentHandler, etc.<br>
  <i>Thread safety: </i>Threadsafe concurrently over multiple threads for read-only,
    must be synchronized for edit.</p>
  </ul> 
    
  
  </body>
  </html>
  
  
  

Mime
View raw message