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...
Rect java.lang.Object |—ohos.agp.utils.Rect public class Rect extends Object implements Sequenceable 表示一个矩形区域。 该类用于在绘制或勾勒出矩形后,在屏幕上指定矩形区域。 Since: 1 嵌套类摘要 修饰符和类型 类 描述 static class Rect.RotationEnum 表示旋转角度。 从接口 ohos.utils.Sequenceable 继承的嵌套类/接口 Sequenceable.ProducerT 字段摘要 修饰符和类型 字段 描述 int bottom 指示矩形底部的 Y 坐标位置。 int left 表示矩形左侧 X 坐标的位置。 int right 表示矩形右侧X坐标的位置。 int top 指示矩形顶部的 Y 坐标位置。 构造函数摘要 构造函数 描述 Rect() 用于创建 Rect 实例的默认构造函数。 Rect(int left, int top, int right, int bottom) 用于创建 Rect 实例的构造函数。 Rect(Rect rect) 用于通过使用具有整数坐标的矩形来创建 Rect 实例的构造函数。 方法总结 修饰符和类型 方法 描述 void clear() 清除此矩形。 boolean contains(int left, int top, int right, int bottom) 检查指定的矩形是否在该矩形内或等于该矩形。 String convertRectToValue() 将当前矩形转换为指定模式“左上右下”的字符串。 static Rect convertValueToRect(String str) 将指定模式的字符串转换为矩形。 boolean equals(Object object) 指示其他对象是否“等于”这个对象。 void fetchParcel(Parcel parcel) 根据包裹中存储的数据设置矩形参数。 void fuse(int xCoor, int yCoor) 组合这个矩形和指定的点。 void fuse(int left, int top, int right, int bottom) 将此 Rect 与保存给定坐标的指定矩形融合。 void fuse(Rect rect) 将此 Rect 与指定的矩形融合。 int[] getCenter() 获取此 Rect 对象的中心点的坐标数组。 int getCenterX() 获取矩形的 X 轴中心。 int getCenterY() 获取矩形的 Y 轴中心。 int getHeight() 获取矩形的高度。 boolean getIntersectRect(int left, int top, int right, int bottom) 检查此 Rect 是否与具有给定坐标的指定矩形相交,如果它们相交,则将此 Rect 设置为该交点。 boolean getIntersectRect(Rect rect) 检查此 Rect 是否与指定的矩形相交,如果相交,则将此 Rect 设置为该相交。 boolean getIntersectRect(Rect rectA, Rect rectB) 检查两个指定的矩形是否相交,并将此矩形设置为该相交(如果有)。 Point getPivot() 获取枢轴的坐标,此 Rect 对象围绕该坐标旋转和缩放。 int getPivotXCoordinate() 获取枢轴的 X 轴坐标,此 Rect 对象围绕该坐标旋转和缩放。 int getPivotYCoordinate() 获取枢轴的 Y 轴坐标,此 Rect 对象围绕该坐标旋转和缩放。 Point getPreciseCenter() 获取此 Rect 对象的中心点坐标。 float getPreciseHorizontalCenter() 获取此 Rect 的精确水平中心的坐标。 float getPreciseVerticalCenter() 获取此 Rect 的精确垂直中心的坐标。...