ISQLData 接口

定义

用于将 SQL 用户定义类型(UDT)的自定义映射的接口映射到Java编程语言中的类。

[Android.Runtime.Register("java/sql/SQLData", "", "Java.Sql.ISQLDataInvoker")]
public interface ISQLData : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("java/sql/SQLData", "", "Java.Sql.ISQLDataInvoker")>]
type ISQLData = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
属性
实现

注解

用于将 SQL 用户定义类型(UDT)的自定义映射的接口映射到Java编程语言中的类。 实现 SQLData 接口的类的类对象将在相应 Connection 对象的类型映射中输入,以及它是自定义映射的 UDT 的 SQL 名称。

通常, SQLData 实现将为 SQL 结构化类型的每个属性或 SQL DISTINCT 类型的单个字段定义字段。 使用 ResultSet.getObject 该方法从数据源检索 UDT 时,它将映射为此类的实例。 程序员可以像Java编程语言中的任何其他对象一样对此类实例进行操作,然后通过调用PreparedStatement.setObject该方法来存储对它所做的任何更改,该方法会将它映射回 SQL 类型。

预计自定义映射的类实现将由工具完成。 在典型的实现中,程序员只需提供 SQL UDT 的名称、要映射到的类的名称,以及要映射到 UDT 的每个属性的字段的名称。 该工具将使用此信息来实现 SQLData.readSQLSQLData.writeSQL 方法。 该方法 readSQL 调用适当的 SQLInput 方法从对象 SQLInput 中读取每个属性,方法 writeSQL 调用 SQLOutput 方法通过对象将每个属性写回数据源 SQLOutput

应用程序程序员通常不会直接调用SQLData方法,并且SQLInput由方法(而不是应用程序代码)在内部SQLData调用和SQLOutput方法。

已在 1.2 中添加。

Java文档java.sql.SQLData

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

属性

名称 说明
Handle

获取基础 Android 对象的 JNI 值。

(继承自 IJavaObject)
JniIdentityHashCode

返回包装实例的值 java.lang.System.identityHashCode()

(继承自 IJavaPeerable)
JniManagedPeerState

托管对等方的状态。

(继承自 IJavaPeerable)
JniPeerMembers

成员访问和调用支持。

(继承自 IJavaPeerable)
PeerReference

返回JniObjectReference包装的Java对象实例。

(继承自 IJavaPeerable)
SQLTypeName

获取此对象所表示的用户 定义类型 (UDT) 的 SQL 名称。

方法

名称 说明
Disposed()

在释放实例时调用。

(继承自 IJavaPeerable)
DisposeUnlessReferenced()

如果没有对此实例的未完成引用,则调用 Dispose();否则不执行任何操作。

(继承自 IJavaPeerable)
Finalized()

在实例完成时调用。

(继承自 IJavaPeerable)
ReadSQL(ISQLInput, String)

使用从数据库读取的数据填充此对象。

SetJniIdentityHashCode(Int32)

设置由 JniIdentityHashCode. 返回的值。

(继承自 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

用于将 SQL 用户定义类型(UDT)的自定义映射的接口映射到Java编程语言中的类。

(继承自 IJavaPeerable)
SetPeerReference(JniObjectReference)

设置由 PeerReference. 返回的值。

(继承自 IJavaPeerable)
UnregisterFromRuntime()

取消注册此实例,使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。

(继承自 IJavaPeerable)
WriteSQL(ISQLOutput)

将此对象写入给定的 SQL 数据流,将其转换回数据源中的 SQL 值。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

用于将 SQL 用户定义类型(UDT)的自定义映射的接口映射到Java编程语言中的类。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于