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 mr...@apache.org on 2009/11/27 19:46:19 UTC

svn commit: r884950 - in /xml/commons/trunk/java/external/src/javax/xml: datatype/ parsers/ transform/ validation/ xpath/

Author: mrglavas
Date: Fri Nov 27 18:46:18 2009
New Revision: 884950

URL: http://svn.apache.org/viewvc?rev=884950&view=rev
Log:
Adding minimal Javadoc for new newInstance() methods introduced by JAXP 1.4.

Modified:
    xml/commons/trunk/java/external/src/javax/xml/datatype/DatatypeFactory.java
    xml/commons/trunk/java/external/src/javax/xml/parsers/DocumentBuilderFactory.java
    xml/commons/trunk/java/external/src/javax/xml/parsers/SAXParserFactory.java
    xml/commons/trunk/java/external/src/javax/xml/transform/TransformerFactory.java
    xml/commons/trunk/java/external/src/javax/xml/validation/SchemaFactory.java
    xml/commons/trunk/java/external/src/javax/xml/xpath/XPathFactory.java

Modified: xml/commons/trunk/java/external/src/javax/xml/datatype/DatatypeFactory.java
URL: http://svn.apache.org/viewvc/xml/commons/trunk/java/external/src/javax/xml/datatype/DatatypeFactory.java?rev=884950&r1=884949&r2=884950&view=diff
==============================================================================
--- xml/commons/trunk/java/external/src/javax/xml/datatype/DatatypeFactory.java (original)
+++ xml/commons/trunk/java/external/src/javax/xml/datatype/DatatypeFactory.java Fri Nov 27 18:46:18 2009
@@ -103,6 +103,12 @@
         }
     }
     
+    /**
+     * @return New instance of a <code>DocumentBuilderFactory</code>
+     *
+     * @throws DatatypeConfigurationException If the implementation is not
+     *   available or cannot be instantiated.
+     */
     public static DatatypeFactory newInstance(String factoryClassName,
             ClassLoader classLoader) throws DatatypeConfigurationException {
         if (factoryClassName == null) {

Modified: xml/commons/trunk/java/external/src/javax/xml/parsers/DocumentBuilderFactory.java
URL: http://svn.apache.org/viewvc/xml/commons/trunk/java/external/src/javax/xml/parsers/DocumentBuilderFactory.java?rev=884950&r1=884949&r2=884950&view=diff
==============================================================================
--- xml/commons/trunk/java/external/src/javax/xml/parsers/DocumentBuilderFactory.java (original)
+++ xml/commons/trunk/java/external/src/javax/xml/parsers/DocumentBuilderFactory.java Fri Nov 27 18:46:18 2009
@@ -111,6 +111,12 @@
         }
     }
     
+    /**
+     * @return New instance of a <code>DocumentBuilderFactory</code>
+     *
+     * @exception FactoryConfigurationError if the implementation is not
+     * available or cannot be instantiated.
+     */
     public static DocumentBuilderFactory newInstance(String factoryClassName,
             ClassLoader classLoader) {
         if (factoryClassName == null) {

Modified: xml/commons/trunk/java/external/src/javax/xml/parsers/SAXParserFactory.java
URL: http://svn.apache.org/viewvc/xml/commons/trunk/java/external/src/javax/xml/parsers/SAXParserFactory.java?rev=884950&r1=884949&r2=884950&view=diff
==============================================================================
--- xml/commons/trunk/java/external/src/javax/xml/parsers/SAXParserFactory.java (original)
+++ xml/commons/trunk/java/external/src/javax/xml/parsers/SAXParserFactory.java Fri Nov 27 18:46:18 2009
@@ -123,6 +123,12 @@
         }
     }
     
+    /**
+     * @return A new instance of a SAXParserFactory.
+     *
+     * @exception FactoryConfigurationError if the implementation is
+     * not available or cannot be instantiated.
+     */
     public static SAXParserFactory newInstance(String factoryClassName,
             ClassLoader classLoader) {
         if (factoryClassName == null) {

Modified: xml/commons/trunk/java/external/src/javax/xml/transform/TransformerFactory.java
URL: http://svn.apache.org/viewvc/xml/commons/trunk/java/external/src/javax/xml/transform/TransformerFactory.java?rev=884950&r1=884949&r2=884950&view=diff
==============================================================================
--- xml/commons/trunk/java/external/src/javax/xml/transform/TransformerFactory.java (original)
+++ xml/commons/trunk/java/external/src/javax/xml/transform/TransformerFactory.java Fri Nov 27 18:46:18 2009
@@ -122,6 +122,12 @@
         }
     }
     
+    /**
+     * @return new TransformerFactory instance, never null.
+     *
+     * @throws TransformerFactoryConfigurationError Thrown if the implementation
+     *    is not available or cannot be instantiated.
+     */
     public static TransformerFactory newInstance(String factoryClassName,
             ClassLoader classLoader) throws TransformerFactoryConfigurationError {
         if (factoryClassName == null) {

Modified: xml/commons/trunk/java/external/src/javax/xml/validation/SchemaFactory.java
URL: http://svn.apache.org/viewvc/xml/commons/trunk/java/external/src/javax/xml/validation/SchemaFactory.java?rev=884950&r1=884949&r2=884950&view=diff
==============================================================================
--- xml/commons/trunk/java/external/src/javax/xml/validation/SchemaFactory.java (original)
+++ xml/commons/trunk/java/external/src/javax/xml/validation/SchemaFactory.java Fri Nov 27 18:46:18 2009
@@ -196,6 +196,15 @@
         return f;
     }
     
+    /**
+     * @return New instance of a <code>SchemaFactory</code>
+     * 
+     * @throws IllegalArgumentException
+     *      If no implementation of the schema language is available.
+     * 
+     * @throws NullPointerException
+     *      If the <tt>schemLanguage</tt> parameter is null.
+     */
     public static SchemaFactory newInstance(String schemaLanguage,
             String factoryClassName, ClassLoader classLoader) {
         if (schemaLanguage == null) {      

Modified: xml/commons/trunk/java/external/src/javax/xml/xpath/XPathFactory.java
URL: http://svn.apache.org/viewvc/xml/commons/trunk/java/external/src/javax/xml/xpath/XPathFactory.java?rev=884950&r1=884949&r2=884950&view=diff
==============================================================================
--- xml/commons/trunk/java/external/src/javax/xml/xpath/XPathFactory.java (original)
+++ xml/commons/trunk/java/external/src/javax/xml/xpath/XPathFactory.java Fri Nov 27 18:46:18 2009
@@ -127,7 +127,7 @@
     * 
     * @throws XPathFactoryConfigurationException If the specified object model is unavailable.
     * @throws NullPointerException If <code>uri</code> is <code>null</code>. 
-	 * @throws IllegalArgumentException If <code>uri.length() == 0</code>.
+	* @throws IllegalArgumentException If <code>uri.length() == 0</code>.
     */
     public static final XPathFactory newInstance(final String uri)
         throws XPathFactoryConfigurationException {
@@ -156,6 +156,13 @@
         return xpathFactory;
     }
     
+    /**
+     * @return Instance of an <code>XPathFactory</code>.
+     * 
+     * @throws XPathFactoryConfigurationException If the specified object model is unavailable.
+     * @throws NullPointerException If <code>uri</code> is <code>null</code>. 
+     * @throws IllegalArgumentException If <code>uri.length() == 0</code>.
+     */
     public static XPathFactory newInstance(String uri, String factoryClassName,
             ClassLoader classLoader) throws XPathFactoryConfigurationException {
         if (uri == null) {