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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/Source.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Result.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="Source.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/Source.html#getSystemId()">getSystemId</A></B>()</CODE>
<BR>
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> void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/Source.html#setSystemId(java.lang.String)">setSystemId</A></B>(java.lang.String systemId)</CODE>
<BR>
Set the system
identifier for this Source.</TD>
</TR>
</TABLE>
<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 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/Source.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Result.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="Source.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/SourceLocator.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Source.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="SourceLocator.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> int</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/SourceLocator.html#getColumnNumber()">getColumnNumber</A></B>()</CODE>
<BR>
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> int</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/SourceLocator.html#getLineNumber()">getLineNumber</A></B>()</CODE>
<BR>
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> java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/SourceLocator.html#getPublicId()">getPublicId</A></B>()</CODE>
<BR>
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> java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/SourceLocator.html#getSystemId()">getSystemId</A></B>()</CODE>
<BR>
Return the system
identifier for the current document event.</TD>
</TR>
</TABLE>
<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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/SourceLocator.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Source.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="SourceLocator.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/Templates.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/SourceLocator.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="Templates.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> java.util.Properties</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/Templates.html#getOutputProperties()">getOutputProperties</A></B>()</CODE>
<BR>
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> <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>
Create a new
transformation context for this Templates object.</TD>
</TR>
</TABLE>
<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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/Templates.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/SourceLocator.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="Templates.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/Transformer.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/OutputKeys.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="Transformer.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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 void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/Transformer.html#clearParameters()">clearParameters</A></B>()</CODE>
<BR>
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 <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>
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 java.util.Properties</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/Transformer.html#getOutputProperties()">getOutputProperties</A></B>()</CODE>
<BR>
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 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 name)</CODE>
<BR>
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 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 name)</CODE>
<BR>
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 <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>
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 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> listener)</CODE>
<BR>
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 void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/Transformer.html#setOutputProperties(java.util.Properties)">setOutputProperties</A></B>(java.util.Properties oformat)</CODE>
<BR>
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 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 name,
java.lang.String value)</CODE>
<BR>
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 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 name,
java.lang.Object value)</CODE>
<BR>
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 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> resolver)</CODE>
<BR>
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 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> xmlSource,
<A
HREF="../../../javax/xml/transform/Result.html">Result</A> outputTarget)</CODE>
<BR>
Process the
source tree to the output result.</TD>
</TR>
</TABLE>
<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>
<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> xmlSource,
<A
HREF="../../../javax/xml/transform/Result.html">Result</A> 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 name,
java.lang.Object 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 <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/>,
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 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> 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 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 <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/>,
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 name,
java.lang.String 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 <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/>,
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 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> 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/Transformer.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/OutputKeys.html"><B>PREV
CLASS</B></A>
<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>
<A HREF="Transformer.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerConfigurationException.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
PREV CLASS
<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>
<A HREF="TransformerConfigurationException.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | <A
HREF="#constructor_summary">CONSTR</A> | <A
HREF="#methods_inherited_from_class_javax.xml.transform.TransformerException">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A
HREF="#constructor_detail">CONSTR</A> | 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>
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 msg)</CODE>
<BR>
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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> locator)</CODE>
<BR>
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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> locator,
java.lang.Throwable e)</CODE>
<BR>
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 msg,
java.lang.Throwable e)</CODE>
<BR>
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 e)</CODE>
<BR>
Create a new
<code>TransformerConfigurationException</code> with a
given <code>Exception</code> base cause of the error.</TD>
</TR>
</TABLE>
<!-- ========== 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>
<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>
<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>
<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 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 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 msg,
java.lang.Throwable 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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> 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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> locator,
java.lang.Throwable 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerConfigurationException.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
PREV CLASS
<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>
<A HREF="TransformerConfigurationException.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | <A
HREF="#constructor_summary">CONSTR</A> | <A
HREF="#methods_inherited_from_class_javax.xml.transform.TransformerException">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A
HREF="#constructor_detail">CONSTR</A> | 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerException.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A
HREF="../../../javax/xml/transform/TransformerConfigurationException.html"><B>PREV
CLASS</B></A>
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="TransformerException.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | <A
HREF="#constructor_summary">CONSTR</A> | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A
HREF="#constructor_detail">CONSTR</A> | <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 message)</CODE>
<BR>
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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> locator)</CODE>
<BR>
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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> locator,
java.lang.Throwable e)</CODE>
<BR>
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 message,
java.lang.Throwable e)</CODE>
<BR>
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 e)</CODE>
<BR>
Create a new
TransformerException wrapping an existing exception.</TD>
</TR>
</TABLE>
<!-- ========== 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> java.lang.Throwable</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerException.html#getCause()">getCause</A></B>()</CODE>
<BR>
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> java.lang.Throwable</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerException.html#getException()">getException</A></B>()</CODE>
<BR>
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> java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerException.html#getLocationAsString()">getLocationAsString</A></B>()</CODE>
<BR>
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> <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>
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> java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerException.html#getMessageAndLocation()">getMessageAndLocation</A></B>()</CODE>
<BR>
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> 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 cause)</CODE>
<BR>
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> void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace()">printStackTrace</A></B>()</CODE>
<BR>
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> void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace(java.io.PrintStream)">printStackTrace</A></B>(java.io.PrintStream s)</CODE>
<BR>
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> void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerException.html#printStackTrace(java.io.PrintWriter)">printStackTrace</A></B>(java.io.PrintWriter s)</CODE>
<BR>
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> 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> location)</CODE>
<BR>
Method setLocator
sets an instance of a SourceLocator
object that specifies where an error occured.</TD>
</TR>
</TABLE>
<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>
<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>
<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 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 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 message,
java.lang.Throwable 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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> 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 message,
<A
HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A> locator,
java.lang.Throwable 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> 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 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 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 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerException.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A
HREF="../../../javax/xml/transform/TransformerConfigurationException.html"><B>PREV
CLASS</B></A>
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="TransformerException.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | <A
HREF="#constructor_summary">CONSTR</A> | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A
HREF="#constructor_detail">CONSTR</A> | <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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerFactory.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Transformer.html"><B>PREV
CLASS</B></A>
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="TransformerFactory.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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 <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> source,
java.lang.String media,
java.lang.String title,
java.lang.String charset)</CODE>
<BR>
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 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 name)</CODE>
<BR>
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 <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>
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 boolean</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerFactory.html#getFeature(java.lang.String)">getFeature</A></B>(java.lang.String name)</CODE>
<BR>
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 <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>
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 <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>
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 <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> source)</CODE>
<BR>
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 <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>
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 <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> source)</CODE>
<BR>
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 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 name,
java.lang.Object value)</CODE>
<BR>
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 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> listener)</CODE>
<BR>
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 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> resolver)</CODE>
<BR>
Set an object
that is used by default during the transformation
to resolve URIs used in xsl:import, or xsl:include.</TD>
</TR>
</TABLE>
<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>
<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> 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> 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> source,
java.lang.String media,
java.lang.String title,
java.lang.String 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. -
</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> 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 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 name,
java.lang.Object 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 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> 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerFactory.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Transformer.html"><B>PREV
CLASS</B></A>
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="TransformerFactory.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerFactoryConfigurationError.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
PREV CLASS
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="TransformerFactoryConfigurationError.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | <A
HREF="#constructor_summary">CONSTR</A> | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A
HREF="#constructor_detail">CONSTR</A> | <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>
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 e)</CODE>
<BR>
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 e,
java.lang.String msg)</CODE>
<BR>
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 msg)</CODE>
<BR>
Create a new
<code>TransformerFactoryConfigurationError</code> with
the <code>String </code> specified as an error message.</TD>
</TR>
</TABLE>
<!-- ========== 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> java.lang.Exception</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#getException()">getException</A></B>()</CODE>
<BR>
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> java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../javax/xml/transform/TransformerFactoryConfigurationError.html#getMessage()">getMessage</A></B>()</CODE>
<BR>
Return the
message (if any) for this error .</TD>
</TR>
</TABLE>
<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>
<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>
<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 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 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 e,
java.lang.String 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/TransformerFactoryConfigurationError.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
PREV CLASS
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="TransformerFactoryConfigurationError.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | <A
HREF="#constructor_summary">CONSTR</A> | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A
HREF="#constructor_detail">CONSTR</A> | <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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/URIResolver.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Templates.html"><B>PREV
CLASS</B></A>
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="URIResolver.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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> <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 href,
java.lang.String base)</CODE>
<BR>
Called by the
processor when it encounters
an xsl:include, xsl:import, or document() function.</TD>
</TR>
</TABLE>
<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 href,
java.lang.String 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> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-summary.html"><FONT
ID="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT
CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="class-use/URIResolver.html"><FONT
ID="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="package-tree.html"><FONT
ID="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../deprecated-list.html"><FONT
ID="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../index-all.html"><FONT
ID="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A
HREF="../../../help-doc.html"><FONT
ID="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/transform/Templates.html"><B>PREV
CLASS</B></A>
NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
<A HREF="URIResolver.html" TARGET="_top"><B>NO
FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: INNER | FIELD | CONSTR | <A
HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | CONSTR | <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>
