鸿蒙OS开发文档 第2页

RowSet public interface RowSet extends ResultSet 添加对 JavaBeans™ 组件模型的 JDBC API 支持的接口。 可以在可视化 Bean 开发环境中用作 JavaBeans 组件的行集可以在设计时创建和配置，并在运行时执行。 RowSet 接口提供一组 JavaBeans 属性，允许将 RowSet 实例配置为连接到 JDBC 数据源并从数据源读取一些数据。 一组 setter 方法（setInt、setBytes、setString 等）提供了一种将输入参数传递给行集的命令属性的方法。 此命令是行集从关系数据库获取数据时使用的 SQL 查询，通常是这种情况。 RowSet 接口支持 JavaBeans 事件，允许在行集上发生事件时通知应用程序中的其他组件，例如其值的更改。 RowSet 接口的独特之处在于它旨在使用 JDBC API 的其余部分来实现。 换句话说，RowSet 实现是在 JDBC 驱动程序“顶部”执行的软件层。 任何人都可以提供 RowSet 接口的实现，包括希望将 RowSet 实现作为其 JDBC 产品的一部分提供的 JDBC 驱动程序供应商。 RowSet 对象可以与数据源建立连接并在其整个生命周期中维护该连接，在这种情况下，它称为连接行集。行集还可以与数据源建立连接，从中获取数据，然后关闭连接。这样的行集称为断开连接的行集。断开连接的行集可以在断开连接时对其数据进行更改，然后将更改发送回数据的原始源，但它必须重新建立连接才能这样做。 断开连接的行集可能具有与之关联的读取器（RowSetReader 对象）和写入器（RowSetWriter 对象）。读取器可以以许多不同的方式实现，以使用数据填充行集，包括从非关系数据源获取数据。编写器还可以以多种不同方式实现，以将对行集数据所做的更改传播回底层数据源。 行集易于使用。 RowSet 接口扩展了标准的 java.sql.ResultSet 接口。 RowSetMetaData 接口扩展了 java.sql.ResultSetMetaData 接口。因此，熟悉 JDBC API 的开发人员必须学习最少数量的新 API 才能使用行集。此外，与 JDBC ResultSet 对象一起使用的第三方软件工具也可以很容易地与行集一起使用。 Since: 1.4 字段摘要 从接口 java.sql.ResultSet 继承的字段 CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE 方法总结 修饰符和类型 方法 描述 void addRowSetListener(RowSetListener listener) 注册给定的侦听器，以便将在此 RowSet 对象上发生的事件通知它。 void clearParameters() 清除为此 RowSet 对象的命令设置的参数。 void execute() 用数据填充此 RowSet 对象。 String getCommand() 检索此 RowSet 对象的命令属性。 String getDataSourceName() 检索标识此 RowSet 对象的数据源的逻辑名称。 boolean getEscapeProcessing() 检索是否为此 RowSet 对象启用了转义处理。 int getMaxFieldSize() 检索可以为某些列值返回的最大字节数。 int getMaxRows() 检索此 RowSet 对象可以包含的最大行数。 String getPassword() 检索用于创建数据库连接的密码。 int getQueryTimeout() 检索驱动程序等待语句执行的最大秒数。 int getTransactionIsolation() 检索为此 RowSet 对象设置的事务隔离级别。...

PooledConnection public interface PooledConnection 为连接池管理提供挂钩的对象。 PooledConnection 对象表示与数据源的物理连接。 当应用程序完成连接时，连接可以被回收而不是关闭，从而减少需要建立的连接数量。 应用程序程序员不直接使用 PooledConnection 接口； 相反，它由管理连接池的中间层基础设施使用。 当应用程序调用 DataSource.getConnection 方法时，它会返回一个 Connection 对象。 如果正在进行连接池，则该 Connection 对象实际上是 PooledConnection 对象的句柄，它是一个物理连接。 连接池管理器（通常是应用程序服务器）维护一个 PooledConnection 对象池。如果池中有可用的 PooledConnection 对象，则连接池管理器会返回一个 Connection 对象，该对象是该物理连接的句柄。如果没有可用的 PooledConnection 对象，则连接池管理器调用 ConnectionPoolDataSource 方法 getPoolConnection 来创建新的物理连接。实现 ConnectionPoolDataSource 的 JDBC 驱动程序创建一个新的 PooledConnection 对象并返回一个句柄。 当应用程序关闭连接时，它会调用 Connection 方法 close。完成连接池时，会通知连接池管理器，因为它已使用 ConnectionPool 方法 addConnectionEventListener 将自己注册为 ConnectionEventListener 对象。连接池管理器停用 PooledConnection 对象的句柄并将 PooledConnection 对象返回到连接池，以便可以再次使用它。因此，当应用程序关闭其连接时，底层物理连接将被回收而不是被关闭。 在连接池管理器调用 PooledConnection 方法关闭之前，物理连接不会关闭。 通常调用此方法以有序关闭服务器，或者如果致命错误导致连接不可用。 连接池管理器通常也是语句池管理器，维护 PreparedStatement 对象池。 当应用程序关闭准备好的语句时，它会调用 PreparedStatement 方法 close。 当语句池完成时，池管理器会收到通知，因为它已使用 ConnectionPool 方法 addStatementEventListener 将自己注册为 StatementEventListener 对象。 因此，当应用程序关闭其 PreparedStatement 时，底层的准备好的语句被回收而不是被关闭。 Since: 1.4 方法总结 修饰符和类型 方法 描述 void addConnectionEventListener(ConnectionEventListener listener) 注册给定的事件侦听器，以便在此 PooledConnection 对象上发生事件时通知它。 void addStatementEventListener(StatementEventListener listener) 使用此 PooledConnection 对象注册 StatementEventListener。 void close() 关闭此 PooledConnection 对象表示的物理连接。 Connection getConnection() 创建并返回一个 Connection 对象，该对象是此 PooledConnection 对象表示的物理连接的句柄。 void removeConnectionEventListener(ConnectionEventListener listener) 当此 PooledConnection 对象上发生事件时，从将通知的组件列表中删除给定的事件侦听器。 void removeStatementEventListener(StatementEventListener listener) 当驱动程序检测到 PreparedStatement 已关闭或无效时，将通知的组件列表中删除指定的 StatementEventListener。 方法详情 getConnection Connection getConnection() throws SQLException 创建并返回一个 Connection 对象，该对象是此 PooledConnection 对象表示的物理连接的句柄。 当应用程序调用了 DataSource.getConnection 方法并且没有可用的 PooledConnection 对象时，连接池管理器调用此方法。 有关更多信息，请参阅 PooledConnection。 返回: 一个...

DataSource public interface DataSource extends CommonDataSource, Wrapper 用于连接到此 DataSource 对象所代表的物理数据源的工厂。 作为 DriverManager 工具的替代方法，DataSource 对象是获取连接的首选方法。 实现 DataSource 接口的对象通常会向基于 Java™ Naming and Directory (JNDI) API 的命名服务注册。 DataSource 接口由驱动程序供应商实现。 有三种类型的实现： 基本实现——产生一个标准的 Connection 对象 连接池实现——生成一个将自动参与连接池的连接对象。 此实现与中间层连接池管理器一起使用。 分布式事务实现——生成一个可用于分布式事务并且几乎总是参与连接池的 Connection 对象。 此实现与中间层事务管理器一起使用，并且几乎总是与连接池管理器一起使用。 DataSource 对象具有可在必要时修改的属性。 例如，如果将数据源移动到不同的服务器，则可以更改服务器的属性。 好处是因为可以更改数据源的属性，因此无需更改访问该数据源的任何代码。 通过 DataSource 对象访问的驱动程序不会将自身注册到 DriverManager。 相反，通过查找操作检索 DataSource 对象，然后用于创建 Connection 对象。 通过基本实现，通过 DataSource 对象获得的连接与通过 DriverManager 工具获得的连接相同。 DataSource 的实现必须包含一个公共的无参数构造函数。 Since: 1.4 方法总结 修饰符和类型 方法 描述 Connection getConnection() 尝试与此 DataSource 对象所代表的数据源建立连接。 Connection getConnection(String username, String password) 尝试与此 DataSource 对象所代表的数据源建立连接。 从接口 javax.sql.CommonDataSource 继承的方法 getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter 从接口 java.sql.Wrapper 继承的方法 isWrapperFor, unwrap 方法详情 getConnection Connection getConnection() throws SQLException 尝试与此 DataSource 对象所代表的数据源建立连接。 返回: 与数据源的连接 Throws: Throw名称 Throw描述 SQLException 如果发生数据库访问错误 SQLTimeoutException 当驱动程序确定已超过 setLoginTimeout 方法指定的超时值并至少尝试取消当前数据库连接尝试时 getConnection Connection getConnection(String username, String password) throws SQLException 尝试与此 DataSource 对象所代表的数据源建立连接。 参数： 参数名称 参数描述 username 代表其建立连接的数据库用户 password 用户密码 返回: 与数据源的连接 Throws: Throw名称 Throw描述 SQLException 如果发生数据库访问错误 SQLTimeoutException...

ConnectionPoolDataSource public interface ConnectionPoolDataSource extends CommonDataSource PooledConnection 对象的工厂。 实现此接口的对象通常会向基于 Java™ 命名和目录接口 (JNDI) 的命名服务注册。 Since: 1.4 方法总结 修饰符和类型 方法 描述 PooledConnection getPooledConnection() 尝试建立可用作池连接的物理数据库连接。 PooledConnection getPooledConnection(String user, String password) 尝试建立可用作池连接的物理数据库连接。 从接口 javax.sql.CommonDataSource 继承的方法 getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter 方法详情 getPooledConnection PooledConnection getPooledConnection() throws SQLException 尝试建立可用作池连接的物理数据库连接。 返回: 一个 PooledConnection 对象，它是与此 ConnectionPoolDataSource 对象所代表的数据库的物理连接 Throws: Throw名称 Throw描述 SQLException 如果发生数据库访问错误 SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法 Since: 1.4 getPooledConnection PooledConnection getPooledConnection(String user, String password) throws SQLException 尝试建立可用作池连接的物理数据库连接。 参数： 参数名称 参数描述 user 代表其建立连接的数据库用户 password 用户密码 返回: 一个 PooledConnection 对象，它是与此 ConnectionPoolDataSource 对象所代表的数据库的物理连接 Throws: Throw名称 Throw描述 SQLException 如果发生数据库访问错误 SQLFeatureNotSupportedException 如果 JDBC 驱动程序不支持此方法 Since: 1.4

ConnectionEventListener public interface ConnectionEventListener extends EventListener 注册以接收由 PooledConnection 对象生成的事件的通知的对象。 ConnectionEventListener 接口由连接池组件实现。 连接池组件通常由 JDBC 驱动程序供应商或其他系统软件供应商提供。 当应用程序使用侦听器注册的池连接完成时，JDBC 驱动程序会通知 ConnectionEventListener 对象。 在应用程序在其 PooledConnection 对象的表示上调用 close 方法后，将发生通知。 当由于 PooledConnection 不适合将来使用而发生连接错误时，也会通知 ConnectionEventListener ——例如，服务器已崩溃。 在驱动程序使用 PooledConnection 对象向应用程序抛出 SQLException 之前，JDBC 驱动程序会通知侦听器。 Since: 1.4 方法总结 修饰符和类型 方法 描述 void connectionClosed(ConnectionEvent event) 通知此 ConnectionEventListener 应用程序已在其表示的池连接上调用 close 方法。 void connectionErrorOccurred(ConnectionEvent event) 通知此 ConnectionEventListener 发生了致命错误并且无法再使用池连接。 方法详情 connectionClosed void connectionClosed(ConnectionEvent event) 通知此 ConnectionEventListener 应用程序已在其表示的池连接上调用 close 方法。 参数： 参数名称 参数描述 event 描述事件源的事件对象 connectionErrorOccurred void connectionErrorOccurred(ConnectionEvent event) 通知此 ConnectionEventListener 发生了致命错误并且无法再使用池连接。 驱动程序在向应用程序抛出给定 ConnectionEvent 对象中包含的 SQLException 之前发出此通知。 参数： 参数名称 参数描述 event 描述事件源并包含驱动程序即将抛出的 SQLException 的事件对象

CommonDataSource public interface CommonDataSource 定义 DataSource、XADataSource 和 ConnectionPoolDataSource 之间通用方法的接口。 方法总结 修饰符和类型 方法 描述 int getLoginTimeout() 获取此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。 PrintWriter getLogWriter() 检索此 DataSource 对象的日志写入器。 Logger getParentLogger() 返回此数据源使用的所有 Logger 的父 Logger。 void setLoginTimeout(int seconds) 设置此数据源在尝试连接到数据库时将等待的最长时间（以秒为单位）。 void setLogWriter(PrintWriter out) 将此 DataSource 对象的日志写入器设置为给定的 java.io.PrintWriter 对象。 方法详情 getLogWriter PrintWriter getLogWriter() throws SQLException 检索此 DataSource 对象的日志写入器。 日志写入器是一个字符输出流，该数据源的所有日志记录和跟踪消息都将打印到该流中。 这包括由该对象的方法打印的消息，由该对象制造的其他对象的方法打印的消息，等等。 打印到数据源特定日志写入器的消息不会打印到与 java.sql.DriverManager 类关联的日志写入器。 创建 DataSource 对象时，日志写入器最初为 null； 换句话说，默认是禁用日志记录。 返回: 此数据源的日志编写器；如果禁用了日志记录，则为 null Throws: Throw名称 Throw描述 SQLException 如果发生数据库访问错误 Since: 1.4 setLogWriter void setLogWriter(PrintWriter out) throws SQLException 将此 DataSource 对象的日志写入器设置为给定的 java.io.PrintWriter 对象。 日志写入器是一个字符输出流，该数据源的所有日志记录和跟踪消息都将打印到该流中。 这包括由该对象的方法打印的消息，由该对象制造的其他对象的方法打印的消息，等等。 打印到特定于数据源的日志写入器的消息不会打印到与 java.sql.DriverManager 类关联的日志写入器。 创建 DataSource 对象时，日志写入器最初为 null； 换句话说，默认是禁用日志记录。 参数： 参数名称 参数描述 out 新的日志写入器； 要禁用日志记录，请设置为 null Throws: Throw名称 Throw描述 SQLException 如果发生数据库访问错误 Since: 1.4 setLoginTimeout void setLoginTimeout(int seconds) throws SQLException 设置此数据源在尝试连接到数据库时将等待的最长时间（以秒为单位）。 零值指定超时是默认的系统超时（如果有的话）； 否则，它指定没有超时。 创建 DataSource 对象时，登录超时最初为零。 参数： 参数名称 参数描述 seconds 数据源登录时间限制 Throws: Throw名称 Throw描述 SQLException 如果发生数据库访问错误。 Since: 1.4 getLoginTimeout int getLoginTimeout() throws SQLException 获取此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。...

TextTool java.lang.Object |—ohos.agp.utils.TextTool public class TextTool extends Object 用于操作字符串或字符的实用程序类。 Since: 3 方法总结 修饰符和类型 方法 描述 static int findChar(CharSequence source, char destChar, int startIndex, int endIndex) 从源字符串的指定范围中查找目标字符的索引。 static String getSubstring(CharSequence source, int startIndex, int endIndex) 根据源字符串的指定范围获取一个新的字符串。 static boolean isEqual(CharSequence sourceA, CharSequence sourceB) 检查字符串 A 的内容是否等于字符串 B 的内容。 static boolean isLayoutRightToLeft(Locale locale) 检查指定区域设置的文本布局是否从右到左。 static boolean isNullOrEmpty(CharSequence source) 检查源字符串是否为空。 static CharSequence replaceCharSequence(CharSequence source, char[] originalCharacterSet, char[] replacementCharacterSet) 将输入文本中的一个或多个目标字符替换为一个或多个指定字符。 static char[] subCharArray(CharSequence source, int startIndex, int endIndex) 根据源字符串的指定范围获取一个新的字符数组。 static void subCharArray(CharSequence source, int startIndex, int endIndex, char[] destChars, int destIndex) 根据源字符串的指定范围获取一个新的字符数组，并将该数组放在目标字符数组的特定位置。 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 方法详情 isNullOrEmpty public static boolean isNullOrEmpty(CharSequence source) 检查源字符串是否为空。 参数： 参数名称 参数描述 source 指示要检查的源字符串。 返回: 如果字符串为空，则返回 true； 否则返回 false。 Since: 3 isEqual public static boolean isEqual(CharSequence sourceA, CharSequence sourceB) 检查字符串 A 的内容是否等于字符串 B 的内容。 参数： 参数名称 参数描述 sourceA 指示要比较的源字符串 A。 sourceB 指示要比较的源字符串 B。 返回: 如果两个字符串的内容相等，则返回 true； 否则返回 false。 Since: 3 isLayoutRightToLeft public static boolean isLayoutRightToLeft(Locale locale) 检查指定区域设置的文本布局是否从右到左。 参数： 参数名称 参数描述 locale 指示要检查的语言环境。 该参数可以为空。 返回: 如果布局是从右到左，则返回 true； 如果布局是从左到右或语言环境为空，则返回 false。 Since: 3 findChar public static int findChar(CharSequence source, char destChar, int startIndex, int...

TextAlignment java.lang.Object |—ohos.agp.utils.TextAlignment public class TextAlignment extends Object 设置文本组件使用的对齐模式以与其父组件对齐。 此类设置文本组件如何在按钮和布局等容器中对齐。 对齐方式包括左对齐、右对齐、水平居中对齐、垂直居中对齐、居中对齐、顶部对齐、底部对齐、开始对齐和结束对齐。 Since: 1 字段摘要 修饰符和类型 字段 描述 static int BOTTOM 表示底部对齐。 static int CENTER 表示中心对齐。 static int END 表示文本与容器的末端对齐。 static int HORIZONTAL_CENTER 表示水平居中对齐。 static int LEFT 表示左对齐。 static int RIGHT 表示右对齐。 static int START 表示文本与容器的开头对齐。 static int TOP 表示顶部对齐。 static int VERTICAL_CENTER 表示垂直居中对齐。 构造函数摘要 构造函数 描述 TextAlignment() 方法总结 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 字段详细信息 BOTTOM public static final int BOTTOM 表示底部对齐。 此常量表示文本与容器的底部边缘对齐。 CENTER public static final int CENTER 表示中心对齐。 此常量表示文本与容器的中心对齐。 END public static final int END 表示文本与容器的末端对齐。 Since: 3 HORIZONTAL_CENTER public static final int HORIZONTAL_CENTER 表示水平居中对齐。 此常量表示文本在容器中水平居中。 LEFT public static final int LEFT 表示左对齐。 此常量指示文本与容器的左边缘对齐。 RIGHT public static final int RIGHT 表示右对齐。 此常量表示文本与容器的右边缘对齐。 START public static final int START 表示文本与容器的开头对齐。 Since: 3 TOP public static final int TOP 表示顶部对齐。 此常量指示文本与容器的顶部边缘对齐。...

SystemSettingsHelper java.lang.Object |—ohos.agp.utils.SystemSettingsHelper public class SystemSettingsHelper extends Object 用于获取一些系统设置的辅助类。 Since: 5 方法总结 修饰符和类型 方法 描述 void bindTouchWithGesture(boolean bind) 建立触摸转发和消费过程与手势检测的绑定关系。 static SystemSettingsHelper getInstance() 创建单个 SystemSettingsHelper 实例。 boolean isTouchBoundWithGesture() 获取手势检测是否绑定到触摸转发和消费过程。 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 方法详情 getInstance public static SystemSettingsHelper getInstance() 创建单个 SystemSettingsHelper 实例。 返回: 返回一个 SystemSettingsHelper 实例。 Since: 7 bindTouchWithGesture public void bindTouchWithGesture(boolean bind) 建立触摸转发和消费过程与手势检测的绑定关系。 参数： 参数名称 参数描述 bind 指示是否绑定关系。 Since: 7 isTouchBoundWithGesture public boolean isTouchBoundWithGesture() 获取手势检测是否绑定到触摸转发和消费过程。 返回: 如果关系建立，则返回 true； 否则返回 false。 默认值是true。 Since: 7

RectFloat java.lang.Object |—ohos.agp.utils.RectFloat public class RectFloat extends Object 指示使用浮点坐标的矩形。 此类描述矩形的位置、宽度和高度。 Since: 3 嵌套类摘要 修饰符和类型 类 描述 static class RectFloat.RotationEnum 表示旋转角度。 字段摘要 修饰符和类型 字段 描述 float bottom 表示矩形右下角的Y坐标。 float left 表示矩形左上角的X坐标。 float right 表示矩形右下角的X坐标。 float top 表示矩形左上角的Y坐标。 构造函数摘要 构造函数 描述 RectFloat() 用于创建 RectFloat 实例的默认构造函数。 RectFloat(float left, float top, float right, float bottom) 用于创建 RectFloat 实例的构造函数。 RectFloat(Rect rect) 用于通过使用具有整数坐标的矩形来创建 RectFloat 实例的构造函数。 RectFloat(RectFloat rectFloat) 用于通过使用具有浮点坐标的矩形创建 RectFloat 实例的构造函数。 方法总结 修饰符和类型 方法 描述 void clear() 清除此 RectFloat。 String convertRectToSignedValue() 将此矩形转换为指定模式“left,top”中的有符号浮点字符串。 boolean equals(Object o) 指示其他对象是否“等于”这个对象。 void fuse(float xCoor, float yCoor) 组合这个矩形和指定的点。 void fuse(float left, float top, float right, float bottom) 将此 RectFloat 与保存给定坐标的指定矩形融合。 void fuse(RectFloat rectFloat) 将此 RectFloat 与指定的矩形融合。 Point getCenter() 获取此 RectFloat 的中心点。 float getHeight() 获取此 RectFloat 的高度。 float getHorizontalCenter() 获取此 RectFloat 的水平中心坐标。 boolean getIntersectRect(RectFloat rectFloat) 检查此 RectFloat 是否与指定的矩形相交，如果它们相交，则将此 RectFloat 设置为该相交。 Point getPivot() 获得一个枢轴点。 float getPivotXCoordinate() 获取枢轴的 x 坐标，此 RectFloat 围绕该坐标旋转和缩放。 float getPivotYCoordinate() 获取枢轴的 y 坐标，此 RectFloat 围绕该坐标旋转和缩放。 DimensFloat getRectSize() 获取此 RectFloat 的大小。 float getVerticalCenter() 获取此 RectFloat 的垂直中心的坐标。 float getWidth() 获取此 RectFloat 的宽度。 int hashCode() 返回对象的哈希码值。 boolean isEmpty() 检查此 RectFloat 是否为空。 boolean isInclude(float x, float y) 检查指定点是否在此 RectFloat 内。 boolean isInclude(float left, float top, float right, float bottom) 检查指定的矩形是否在此 RectFloat 内。 boolean isInclude(Point point) 检查指定点是否在此 RectFloat 内。 boolean isInclude(RectFloat rectFloat) 检查指定的矩形是否在此 RectFloat 内。 boolean isIntersect(float left, float top, float right, float bottom) 根据 left、top、right 和 bottom 检查指定的矩形是否与此 RectFloat 相交。 boolean...