You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jmeter-dev@jakarta.apache.org by se...@apache.org on 2007/09/04 19:27:21 UTC

svn commit: r572745 - /jakarta/jmeter/branches/rel-2-2/src/core/org/apache/jmeter/util/XPathUtil.java

Author: sebb
Date: Tue Sep  4 10:27:20 2007
New Revision: 572745

URL: http://svn.apache.org/viewvc?rev=572745&view=rev
Log:
Remove unused throw clause; tidy documentation

Modified:
    jakarta/jmeter/branches/rel-2-2/src/core/org/apache/jmeter/util/XPathUtil.java

Modified: jakarta/jmeter/branches/rel-2-2/src/core/org/apache/jmeter/util/XPathUtil.java
URL: http://svn.apache.org/viewvc/jakarta/jmeter/branches/rel-2-2/src/core/org/apache/jmeter/util/XPathUtil.java?rev=572745&r1=572744&r2=572745&view=diff
==============================================================================
--- jakarta/jmeter/branches/rel-2-2/src/core/org/apache/jmeter/util/XPathUtil.java (original)
+++ jakarta/jmeter/branches/rel-2-2/src/core/org/apache/jmeter/util/XPathUtil.java Tue Sep  4 10:27:20 2007
@@ -50,7 +50,12 @@
 	private static DocumentBuilderFactory documentBuilderFactory;
 
 	/**
-	 * Might
+	 * Returns a suitable document builder factory.
+	 * Caches the factory in case the next caller wants the same options.
+	 * 
+	 * @param validate should the parser validate documents?
+	 * @param whitespace should the parser eliminate whitespace in element content?
+	 * @param namespace should the parser be namespace aware?
 	 * 
 	 * @return javax.xml.parsers.DocumentBuilderFactory
 	 */
@@ -71,15 +76,14 @@
 	/**
 	 * Create a DocumentBuilder using the makeDocumentFactory func.
 	 * 
-	 * @param validate
-	 * @param whitespace
-	 * @param namespace
+	 * @param validate should the parser validate documents?
+	 * @param whitespace should the parser eliminate whitespace in element content?
+	 * @param namespace should the parser be namespace aware?
 	 * @return document builder
 	 * @throws ParserConfigurationException
-	 * @throws SAXException
 	 */
 	public static DocumentBuilder makeDocumentBuilder(boolean validate, boolean whitespace, boolean namespace)
-			throws ParserConfigurationException, SAXException {
+			throws ParserConfigurationException {
 		DocumentBuilder builder = makeDocumentBuilderFactory(validate, whitespace, namespace).newDocumentBuilder();
 		builder.setErrorHandler(new MyErrorHandler(validate, false));
 		return builder;
@@ -97,7 +101,8 @@
 	 * @param namespace
 	 *            Is Namespace aware.
 	 * @param tolerant
-	 *            Is tolerant
+	 *            Is tolerant - i.e. use the Tidy parser
+	 *
 	 * @return document
 	 * @throws ParserConfigurationException
 	 * @throws IOException



---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org