XmlReader (Java Platform SE 8 )
Keywords: javax.sql.rowset.spi.XmlReader interface
Date: 2026-04-17

compact3
javax.sql.rowset.spi

## Interface XmlReader

- All Superinterfaces:
    RowSetReader

      public interface XmlReader
      extends RowSetReader

  A specialized interface that facilitates an extension of the `SyncProvider` abstract class for XML orientated synchronization providers.

  `SyncProvider` implementations that supply XML data reader capabilities such as output XML stream capabilities can implement this interface to provide standard `XmlReader` objects to `WebRowSet` implementations.

  An `XmlReader` object is registered as the XML reader for a `WebRowSet` by being assigned to the rowset's `xmlReader` field. When the `WebRowSet` object's `readXml` method is invoked, it in turn invokes its XML reader's `readXML` method.

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `readXML(WebRowSet caller, Reader reader)` Reads and parses the given `WebRowSet` object from the given input stream in XML format.

    - ### Methods inherited from interface javax.sql.RowSetReader

      `readData`

- - ### Method Detail

    - #### readXML

          void readXML(WebRowSet caller,
                       Reader reader)
                throws SQLException

      Reads and parses the given `WebRowSet` object from the given input stream in XML format. The `xmlReader` field of the given `WebRowSet` object must contain this `XmlReader` object.

      If a parsing error occurs, the exception that is thrown will include information about the location of the error in the original XML document.

      Parameters:
        `caller` - the `WebRowSet` object to be parsed, whose `xmlReader` field must contain a reference to this `XmlReader` object
        `reader` - the `java.io.Reader` object from which `caller` will be read
      Throws:
        `SQLException` - if a database access error occurs or this `XmlReader` object is not the reader for the given rowset

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.