You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commons-cvs@xml.apache.org by dl...@apache.org on 2002/01/22 21:45:17 UTC
cvs commit: xml-commons/java/external/src/javax/xml/transform TransformerFactory.java
dleslie 02/01/22 12:45:17
Modified: java/external/src/javax/xml/transform
TransformerFactory.java
Log:
Bugzilla 2230. Added clarification that newInstance, newTransformer(),
and newTemplates() can in fact return null if an ErrorHandler is registered
with the factory and what would otherwise be an Exception occurs.
Revision Changes Path
1.4 +12 -4 xml-commons/java/external/src/javax/xml/transform/TransformerFactory.java
Index: TransformerFactory.java
===================================================================
RCS file: /home/cvs/xml-commons/java/external/src/javax/xml/transform/TransformerFactory.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- TransformerFactory.java 12 Oct 2001 23:44:49 -0000 1.3
+++ TransformerFactory.java 22 Jan 2002 20:45:17 -0000 1.4
@@ -127,7 +127,9 @@
* TransformerFactory</code> it can use the factory to configure
* and obtain parser instances.
*
- * @return new TransformerFactory instance, never null.
+ * @return new TransformerFactory instance, never null (unless an {@link ErrorListener}
+ * is registered with the TransformerFactory, in which case an exception error sends an
+ * error message to the ErrorListener and returns null).
*
* @throws TransformerFactoryConfigurationError
* if the implmentation is not available or cannot be instantiated.
@@ -156,7 +158,9 @@
* @param source An object that holds a URI, input stream, etc.
*
* @return A Transformer object that may be used to perform a transformation
- * in a single thread, never null.
+ * in a single thread, never null (unless an {@link ErrorListener} is registered with
+ * the TransformerFactory, in which case an exception error sends an error message to
+ * the ErrorListener and returns null).
*
* @exception TransformerConfigurationException May throw this during the parse
* when it is constructing the Templates object and fails.
@@ -171,7 +175,9 @@
* @param source An object that holds a URI, input stream, etc.
*
* @return A Transformer object that may be used to perform a transformation
- * in a single thread, never null.
+ * in a single thread, never null (unless an {@link ErrorListener} is registered with
+ * the TransformerFactory, in which case an exception error sends an error message to
+ * the ErrorListener and returns null).
*
* @exception TransformerConfigurationException May throw this during
* the parse when it is constructing the
@@ -191,7 +197,9 @@
* @param source An object that holds a URL, input stream, etc.
*
* @return A Templates object capable of being used for transformation purposes,
- * never null.
+ * never null (unless an {@link ErrorListener} is registered with
+ * the TransformerFactory, in which case an exception error sends an error message to
+ * the ErrorListener and returns null).
*
* @exception TransformerConfigurationException May throw this during the parse when it
* is constructing the Templates object and fails.