模块  java.sql
软件包  java.sql

Interface SQLInput

  • 所有已知实现类:
    SQLInputImpl

    public interface SQLInput
    一个输入流,包含表示SQL结构类型或SQL不同类型实例的值流。 此接口仅用于自定义映射,由驱动程序在后台使用,程序员永远不会直接调用SQLInput方法。 读取器的方法( readLongreadBytes ,等等)为的实现提供了一种方法SQLData接口以读取值SQLInput对象。 并且如SQLData ,对读取器方法的调用必须按其相应属性出现在类型的SQL定义中的顺序进行。 方法wasNull用于确定读取的最后一个值是否是SQL NULL

    当该方法getObject被调用实现该接口的类的对象SQLData ,JDBC驱动程序调用该方法SQLData.getSQLType ,以确定用户定义的类型(UDT)的SQL类型而定制映射。 驱动程序创建一个SQLInput的实例,并使用UDT的属性填充它。 然后,驱动程序将输入流传SQLData.readSQL方法SQLData.readSQL ,方法SQLData.readSQL在其实现中调用SQLInput读取器方法,以从输入流中读取属性。

    从以下版本开始:
    1.2
    • 方法摘要

      所有方法  实例方法 抽象方法  Default Methods 
      变量和类型 方法 描述
      Array readArray()
      从流中读取SQL ARRAY值并将其作为Java编程语言中的 Array对象返回。
      InputStream readAsciiStream()
      读取流中的下一个属性并将其作为ASCII字符流返回。
      BigDecimal readBigDecimal()
      读取流中的下一个属性,并将其作为Java编程语言中的 java.math.BigDecimal对象返回。
      InputStream readBinaryStream()
      读取流中的下一个属性并将其作为未解释的字节流返回。
      Blob readBlob()
      从流中读取SQL BLOB值并将其作为Java编程语言中的 Blob对象返回。
      boolean readBoolean()
      读取流中的下一个属性并将其作为 boolean以Java编程语言返回。
      byte readByte()
      读取流中的下一个属性并将其作为 byte以Java编程语言返回。
      byte[] readBytes()
      读取流中的下一个属性,并将其作为Java编程语言中的字节数组返回。
      Reader readCharacterStream()
      读取流中的下一个属性并将其作为Unicode字符流返回。
      Clob readClob()
      从流中读取SQL CLOB值,并将其作为Java编程语言中的 Clob对象返回。
      Date readDate()
      读取流中的下一个属性并将其作为 java.sql.Date对象返回。
      double readDouble()
      读取流中的下一个属性,并以Java编程语言将其作为 double返回。
      float readFloat()
      读取流中的下一个属性并将其作为Java编程语言中的 float返回。
      int readInt()
      读取流中的下一个属性并将其作为 int以Java编程语言返回。
      long readLong()
      读取流中的下一个属性,并以Java编程语言将其作为 long返回。
      NClob readNClob()
      从流中读取SQL NCLOB值并将其作为Java编程语言中的 NClob对象返回。
      String readNString()
      读取流中的下一个属性并将其作为Java编程语言中的 String返回。
      Object readObject()
      读取流头部的数据并将其作为Java编程语言中的 Object返回。
      default <T> T readObject​(<T> type)
      读取流中的下一个属性并将其作为 Object以Java编程语言返回。
      Ref readRef()
      从流中读取SQL REF值并将其作为Java编程语言中的 Ref对象返回。
      RowId readRowId()
      从流中读取SQL ROWID值并将其作为Java编程语言中的 RowId对象返回。
      short readShort()
      读取流中的下一个属性,并以Java编程语言将其作为 short返回。
      SQLXML readSQLXML()
      从流中读取SQL XML值并将其作为Java编程语言中的 SQLXML对象返回。
      String readString()
      读取流中的下一个属性并将其作为 String以Java编程语言返回。
      Time readTime()
      读取流中的下一个属性并将其作为 java.sql.Time对象返回。
      Timestamp readTimestamp()
      读取流中的下一个属性并将其作为 java.sql.Timestamp对象返回。
      URL readURL()
      从流中读取SQL DATALINK值并将其作为Java编程语言中的 java.net.URL对象返回。
      boolean wasNull()
      检索读取的最后一个值是否为SQL NULL
    • 方法详细信息

      • readString

        String readString()           throws SQLException
        读取流中的下一个属性,并以Java编程语言将其作为 String返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readBoolean

        boolean readBoolean()             throws SQLException
        读取流中的下一个属性并将其作为 boolean以Java编程语言返回。
        结果
        属性; 如果值为SQL NULL ,则返回false
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readByte

        byte readByte()       throws SQLException
        读取流中的下一个属性,并以Java编程语言将其作为 byte返回。
        结果
        属性; 如果值为SQL NULL ,则返回0
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readShort

        short readShort()         throws SQLException
        读取流中的下一个属性,并以Java编程语言将其作为 short返回。
        结果
        属性; 如果值为SQL NULL ,则返回0
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readInt

        int readInt()     throws SQLException
        读取流中的下一个属性并将其作为 int以Java编程语言返回。
        结果
        属性; 如果值为SQL NULL ,则返回0
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readLong

        long readLong()       throws SQLException
        读取流中的下一个属性,并以Java编程语言将其作为 long返回。
        结果
        属性; 如果值为SQL NULL ,则返回0
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readFloat

        float readFloat()         throws SQLException
        读取流中的下一个属性并将其作为 float以Java编程语言返回。
        结果
        属性; 如果值为SQL NULL ,则返回0
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readDouble

        double readDouble()           throws SQLException
        读取流中的下一个属性并将其作为Java编程语言中的 double返回。
        结果
        属性; 如果值为SQL NULL ,则返回0
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readBigDecimal

        BigDecimal readBigDecimal()                   throws SQLException
        读取流中的下一个属性,并将其作为Java编程语言中的 java.math.BigDecimal对象返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readBytes

        byte[] readBytes()          throws SQLException
        读取流中的下一个属性,并将其作为Java编程语言中的字节数组返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readDate

        Date readDate()       throws SQLException
        读取流中的下一个属性并将其作为 java.sql.Date对象返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readTime

        Time readTime()       throws SQLException
        读取流中的下一个属性并将其作为 java.sql.Time对象返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readTimestamp

        Timestamp readTimestamp()                 throws SQLException
        读取流中的下一个属性并将其作为 java.sql.Timestamp对象返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readCharacterStream

        Reader readCharacterStream()                    throws SQLException
        读取流中的下一个属性并将其作为Unicode字符流返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readAsciiStream

        InputStream readAsciiStream()                     throws SQLException
        读取流中的下一个属性并将其作为ASCII字符流返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readBinaryStream

        InputStream readBinaryStream()                      throws SQLException
        读取流中的下一个属性并将其作为未解释的字节流返回。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readObject

        Object readObject()           throws SQLException
        读取流头部的数据并将其作为Java编程语言中的Object返回。 返回的对象的实际类型由默认类型映射以及此流的类型映射中存在的任何自定义项确定。

        在将流传递给应用程序之前,JDBC驱动程序会在流中注册类型映射。

        当流的头部的数据是SQL NULL ,该方法返回null 如果数据是SQL结构或不同类型,则它确定流头部的数据的SQL类型。 如果流的类型映射具有该SQL类型的条目,则驱动程序构造相应类的对象,并在该对象上调用方法SQLData.readSQL ,该方法使用为该方法描述的协议从流中读取其他数据。

        结果
        作为Java编程语言中的Object ,流头部的数据; null如果数据是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readRef

        Ref readRef()     throws SQLException
        从流中读取SQL REF值并将其作为Java编程语言中的 Ref对象返回。
        结果
        一个Ref对象,表示流头部的SQL REF值; null如果读取的值是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readBlob

        Blob readBlob()       throws SQLException
        从流中读取SQL BLOB值并将其作为Java编程语言中的 Blob对象返回。
        结果
        Blob对象,表示流头部的SQL BLOB值的数据; null如果读取的值是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readClob

        Clob readClob()       throws SQLException
        从流中读取SQL CLOB值并将其作为Java编程语言中的 Clob对象返回。
        结果
        Clob对象,表示流头部的SQL CLOB值的数据; null如果读取的值是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readArray

        Array readArray()         throws SQLException
        从流中读取SQL ARRAY值并将其作为Java编程语言中的 Array对象返回。
        结果
        一个Array对象,表示流头部的SQL ARRAY值的数据; null如果读取的值是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • wasNull

        boolean wasNull()         throws SQLException
        检索读取的最后一个值是否为SQL NULL
        结果
        true如果最近读取的SQL值是SQL NULL ; 否则为false
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.2
      • readURL

        URL readURL()     throws SQLException
        从流中读取SQL DATALINK值并将其作为Java编程语言中的 java.net.URL对象返回。
        结果
        一个 java.net.URL对象。
        异常
        SQLException - 如果发生数据库访问错误,或者URL格式错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.4
      • readNClob

        NClob readNClob()         throws SQLException
        从流中读取SQL NCLOB值并将其作为Java编程语言中的 NClob对象返回。
        结果
        一个NClob对象,表示流头部的SQL NCLOB值的数据; null如果读取的值是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • readNString

        String readNString()            throws SQLException
        读取流中的下一个属性,并以Java编程语言将其作为String返回。 访问时,它适用于使用NCHARNVARCHARLONGNVARCHAR列。
        结果
        属性; 如果值为SQL NULL ,则返回null
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • readSQLXML

        SQLXML readSQLXML()           throws SQLException
        从流中读取SQL XML值并将其作为Java编程语言中的 SQLXML对象返回。
        结果
        SQLXML对象,表示流头部的SQL XML值的数据; null如果读取的值是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • readRowId

        RowId readRowId()         throws SQLException
        从流中读取SQL ROWID值并将其作为Java编程语言中的 RowId对象返回。
        结果
        RowId对象,表示流头部的SQL ROWID值的数据; null如果读取的值是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.6
      • readObject

        default <T> T readObject​(<T> type)                  throws SQLException
        读取流中的下一个属性并将其作为Java编程语言中的Object返回。 返回的对象的实际类型由指定的Java数据类型以及此流的类型映射中存在的任何自定义项确定。

        在将流传递给应用程序之前,JDBC驱动程序会在流中注册类型映射。

        当流头部的属性是SQL NULL该方法返回null 如果属性是SQL结构或不同类型,则它确定流头部的属性的SQL类型。 如果流的类型映射具有该SQL类型的条目,则驱动程序构造相应类的对象,并在该对象上调用方法SQLData.readSQL ,该方法使用为该方法描述的协议从流中读取其他数据。

        默认实现将抛出SQLFeatureNotSupportedException

        参数类型
        T - 此Class对象建模的类的类型
        参数
        type - 表示要将属性转换为的Java数据类型的类。
        结果
        流的头部属性为Java编程语言中的Object ; null如果属性是SQL NULL
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始:
        1.8