This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/xerces-j.git
The following commit(s) were added to refs/heads/main by this push:
new 38654b364 [XERCESJ-1781] Javadoc fix for non-existing
DOMSystemException (#50)
38654b364 is described below
commit 38654b3644403813661160b26cebd163e8c2b5f0
Author: Samael <[email protected]>
AuthorDate: Wed Nov 19 12:21:22 2025 +0000
[XERCESJ-1781] Javadoc fix for non-existing DOMSystemException (#50)
---
src/org/apache/xerces/dom3/as/DOMASBuilder.java | 24 ++++++++++----------
src/org/apache/xerces/dom3/as/DOMASException.java | 2 +-
src/org/apache/xerces/dom3/as/DOMASWriter.java | 12 +++++-----
.../apache/xerces/parsers/DOMASBuilderImpl.java | 26 ++++++++++------------
4 files changed, 31 insertions(+), 33 deletions(-)
diff --git a/src/org/apache/xerces/dom3/as/DOMASBuilder.java
b/src/org/apache/xerces/dom3/as/DOMASBuilder.java
index c5a919938..fcadf446d 100644
--- a/src/org/apache/xerces/dom3/as/DOMASBuilder.java
+++ b/src/org/apache/xerces/dom3/as/DOMASBuilder.java
@@ -43,10 +43,11 @@ public interface DOMASBuilder extends LSParser {
public void setAbstractSchema(ASModel abstractSchema);
/**
- * Parse a Abstract Schema from a location identified by an URI reference.
+ * Parse an Abstract Schema from a location identified by a URI reference.
+ *
* @param uri The location of the Abstract Schema to be read.
* @return The newly created Abstract Schema.
- * @exception DOMASException
+ * @throws DOMASException
* Exceptions raised by <code>parseASURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
@@ -56,11 +57,11 @@ public interface DOMASBuilder extends LSParser {
* <br> WRONG_MIME_TYPE_ERR: Raised when <code>mimeTypeCheck</code> is
* <code>true</code> and the input source has an incorrect MIME Type.
* See the attribute <code>mimeTypeCheck</code>.
- * @exception DOMSystemException
+ * @throws Exception
* Exceptions raised by <code>parseURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
- * handlers will raise a DOMSystemException if any form I/O or other
+ * handlers will raise an <code>Exception</code> if any form I/O or
other
* system error occurs during the parse, but application defined error
* handlers are not required to do so.
*/
@@ -68,12 +69,11 @@ public interface DOMASBuilder extends LSParser {
throws DOMASException, Exception;
/**
- * Parse a Abstract Schema from a location identified by an
- * <code>LSInput</code>.
- * @param is The <code>LSInput</code> from which the source
- * Abstract Schema is to be read.
- * @return The newly created <code>ASModel</code>.
- * @exception DOMASException
+ * Parse an Abstract Schema from a location identified by a
<code>LSInput</code>.
+ *
+ * @param is the <code>LSInput</code> from which the source Abstract
Schema is to be read
+ * @return the newly created <code>ASModel</code>
+ * @throws DOMASException
* Exceptions raised by <code>parseASURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
@@ -83,11 +83,11 @@ public interface DOMASBuilder extends LSParser {
* <br> Raise a WRONG_MIME_TYPE_ERR when <code>mimeTypeCheck</code> is
* <code>true</code> and the inputsource has an incorrect MIME Type.
* See attribute <code>mimeTypeCheck</code>.
- * @exception DOMSystemException
+ * @throws Exception
* Exceptions raised by <code>parseURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
- * handlers will raise a DOMSystemException if any form I/O or other
+ * handlers will raise an <code>Exception</code> if any form I/O or
other
* system error occurs during the parse, but application defined error
* handlers are not required to do so.
*/
diff --git a/src/org/apache/xerces/dom3/as/DOMASException.java
b/src/org/apache/xerces/dom3/as/DOMASException.java
index fab05efe6..7e9efe9fc 100644
--- a/src/org/apache/xerces/dom3/as/DOMASException.java
+++ b/src/org/apache/xerces/dom3/as/DOMASException.java
@@ -14,7 +14,7 @@ package org.apache.xerces.dom3.as;
/**
* @deprecated
- * Abstract Schemas operations may throw a <code>DOMSystemException</code> as
+ * Abstract Schemas operations may throw a <code>DOMASException</code> as
* described in their descriptions.
* <p>See also the <a
href='http://www.w3.org/TR/2001/WD-DOM-Level-3-ASLS-20011025'>Document Object
Model (DOM) Level 3 Abstract Schemas and Load
and Save Specification</a>.
diff --git a/src/org/apache/xerces/dom3/as/DOMASWriter.java
b/src/org/apache/xerces/dom3/as/DOMASWriter.java
index bdd5e8589..db9bcad70 100644
--- a/src/org/apache/xerces/dom3/as/DOMASWriter.java
+++ b/src/org/apache/xerces/dom3/as/DOMASWriter.java
@@ -32,16 +32,16 @@ and Save Specification</a>.
*/
@Deprecated
public interface DOMASWriter extends LSSerializer {
+
/**
- * Write out the specified Abstract Schema to the specified destination.
+ * Write out the specified Abstract Schema to the specified destination.
* Does it write a DTD or an XML Schema (or something else)? Is it
* possible to use this method to convert a DTD to an XML Schema?
* @param destination The destination for the data to be written.
- * @param model The Abstract Schema to serialize.
- * @exception DOMSystemException
- * This exception will be raised in response to any sort of IO or system
- * error that occurs while writing to the destination. It may wrap an
- * underlying system exception.
+ *
+ * @param model the Abstract Schema to serialize
+ * @throws Exception if any sort of IO or system error occurs
+ * while writing to the destination.
*/
public void writeASModel(java.io.OutputStream destination,
ASModel model)
diff --git a/src/org/apache/xerces/parsers/DOMASBuilderImpl.java
b/src/org/apache/xerces/parsers/DOMASBuilderImpl.java
index e1080a076..d2e231cb2 100644
--- a/src/org/apache/xerces/parsers/DOMASBuilderImpl.java
+++ b/src/org/apache/xerces/parsers/DOMASBuilderImpl.java
@@ -163,11 +163,11 @@ public class DOMASBuilderImpl
}
/**
- * Parse a Abstract Schema from a location identified by an URI.
+ * Parse an Abstract Schema from a location identified by a URI.
*
- * @param uri The location of the Abstract Schema to be read.
- * @return The newly created <code>Abstract Schema</code>.
- * @exception DOMASException
+ * @param uri the location of the Abstract Schema to be read
+ * @return the newly created <code>Abstract Schema</code>
+ * @throws DOMASException
* Exceptions raised by <code>parseASURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
@@ -177,11 +177,11 @@ public class DOMASBuilderImpl
* <br> WRONG_MIME_TYPE_ERR: Raised when <code>mimeTypeCheck</code> is
* <code>true</code> and the inputsource has an incorrect MIME Type.
* See attribute <code>mimeTypeCheck</code>.
- * @exception DOMSystemException
+ * @throws Exception
* Exceptions raised by <code>parseURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
- * handlers will raise a DOMSystemException if any form I/O or other
+ * handlers will raise an <code>Exception</code> if any form I/O or other
* system error occurs during the parse, but application defined error
* handlers are not required to do so.
*/
@@ -192,13 +192,11 @@ public class DOMASBuilderImpl
}
/**
- * Parse a Abstract Schema from a location identified by an
- * <code>LSInput</code>.
+ * Parse an Abstract Schema from a location identified by a
<code>LSInput</code>.
*
- * @param is The <code>LSInput</code> from which the source
- * Abstract Schema is to be read.
- * @return The newly created <code>ASModel</code>.
- * @exception DOMASException
+ * @param is the <code>LSInput</code> from which the source Abstract
Schema is to be read
+ * @return the newly created <code>ASModel</code>
+ * @throws DOMASException
* Exceptions raised by <code>parseASURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
@@ -208,11 +206,11 @@ public class DOMASBuilderImpl
* <br> WRONG_MIME_TYPE_ERR: Raised when <code>mimeTypeCheck</code> is
* true and the inputsource has an incorrect MIME Type. See attribute
* <code>mimeTypeCheck</code>.
- * @exception DOMSystemException
+ * @throws Exception
* Exceptions raised by <code>parseURI()</code> originate with the
* installed ErrorHandler, and thus depend on the implementation of
* the <code>DOMErrorHandler</code> interfaces. The default error
- * handlers will raise a DOMSystemException if any form I/O or other
+ * handlers will raise an <code>Exception</code> if any form I/O or other
* system error occurs during the parse, but application defined error
* handlers are not required to do so.
*/
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
