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) {