第八章 异常(Exceptions)

8.1 SQLException

一个SQLException实例异常抛出 当和数据源交互的过程中出现错误时,该异常包含以下信息:

  • 描绘错误的原文: String 包含了 描绘异常的信息 当调用 SQLException.getMessage 方法时
  • SQL 状态:Srtring 包含了SQL 状态,当调用 SQLException.getSQLState 方法时
  • 错误码:这是一个标志错误的 integer 类型的值,它的值是依赖于特的的实现的,也可能是底层数据源返回的实际错误代码,错误代码可以使用SQLException.getErrorCode方法检索
  • 原因:这是一种人为的抛出导致 SQLException 发生
  • 异常链:如果发生多个错误,则可以通过引用异常链,所有的异常链都可以通过 SQLException.getNextException 去获得,假如没有更多的异常链了 则 getNextException 方法返回 null

8.2 对于java SE支持链式execeptions

SqlException类及其子类已增强为java SE支持链式异常能力,支持此功能的更改如下:

  • 添加四个构造函数以提供原因参数的支持
  • getCause 方法 除了 返回 SQLExceptions 还可能返回 Non-SQLExceptions

有关附加信息,请参阅JDBC API规范

8.3 导航 SQLException

在执行SQL语句时可能会出现一个或多个异常,每个异常都有各自潜在的因果关系。这就意味着当一个JDBC应用捕获一个SQLException,有一种可能性,可能会有额外的SQLException拴在原抛出SQLException。访问附加链接的SQLException,申请将递归调用getnextexception直到返回空值

一个 SQLException 可能会出现因果关系 ,由一个或多个 SQLException 抛出造成的。你可以递归调用sqlexception.getcause 方法,直到返回空值,

下面的代码演示了应用程序如何浏览sqlexception及其原因:

catch(SQLException ex) {
while(ex != null) {
System.out.println("SQLState:" + ex.getSQLState());
System.out.println("Error Code:" + ex.getErrorCode());
System.out.println("Message:" + ex.getMessage());
Throwable t = ex.getCause();
while(t != null) {
System.out.println("Cause:" + t);
t = t.getCause();
}
ex = ex.getNextException();
}
}

8.4 使用 For-Each 循环 对于 SQLException

JDBC 异常可能会使用 JavaSE For-Each 循环 来导航 SQLException 以及 它们之间的关系

catch(SQLException ex) {
for(Throwable e : ex ) {
System.out.println("Error encountered: " + e);
}
}

8.5 SQLWarning

SQLWarning 是 SQLException 的子类,下面的接口方法将产生一个sqlwarning对象如果他们遇到一个数据库访问的警告:

  • Connection
  • DataSet
  • Statement
  • ResultSet

当一个方法产生一个sqlwarning对象,调用者不了解数据访问的警告。该方法必须调用适当getWarnings对象检索SQLWarning对象。然而,对sqlwarning的datatruncation子类可以被扔在某些情况下,见8.3节“datatruncation”页上的8-46详情

如果多个数据访问的警告时,它们会是在第一个,可以通过递归调用sqlwarning.getnextwarning方法检索。如果有链中没有更多的警告,getnextwarning返回null

8.6 数据截断

DataTruncation 是 SQLWarning 的子类,提供信息当数据截断的时候,当数据源写入数据时发生数据截断,一个 DataTruncation 对象会被抛出,即使已经生成警告,已截断的数据值也已写入数据源。从数据源读取数据时发生截断,会报告一个 SQLWarning
一个datatruncation对象包含以下信息:

  • 描绘的字符串 "Data truncation"
  • SQLState "01004" 当 从数据源读取数据时发生截断
  • SQLState "22001" 当数据源写入数据时发生数据截断
  • 一个 boolean 指示值是否截断为参数值或列值。
  • 给出截断的列或参数的索引的int 类型值,如果列的索引值或参数是未知的,该方法datatruncation.getindex返回-1,如果索引是未知的,会返回值datatruncation.getparameter和datatruncation.getread 是未定义 的
  • 一个布尔值,用来指示截断是在读还是写操作上发生的。如果datatruncation.getread截断发生在读,则返回 true,如果datatruncation.getread截断发生在写,则返回 false
  • 方法datatruncation.getdatasize返回int,表示数据应该已经传送的字节数。如果数据转换正在执行,这个数字可能是近似的。如果大小未知,则值可能是1
  • 方法datatruncation.gettransfersize返回实际转换的字节 或 如果字节数为-1 则是未知的

8.7 静止的截断(Silent Truncation)

statement.setmaxfieldsize方法允许的最大大小(以字节为单位)是集。此限制仅适用于二进制、varbinary、LONGVARBINARY、CHAR、LONGVARCHAR、nchar、nvarchar varchar数据类型,和LONGNVARCHAR

如果使用setmaxfieldsize设定了最大限制,试图去读取超过限制的数据时,由于超过规定的极限,任何截断不会报道

8.8 BatchUpdateException

一个batchupdateexception对象提供有关发生在批处理语句被执行的错误信息。这个异常的行为在第14章“批处理更新”中描述

8.9 SQLClientinfoException

SQLClientInfoException 会抛出通过Connection.setClientInfo 方法 发生在 设置一个 或更多个 指定 的客户端 properties 失败时,sqlclientinfoexception包含信息指示客户端properties 属性没有设置。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,236评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,867评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,715评论 0 340
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,899评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,895评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,733评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,085评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,722评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,025评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,696评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,816评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,447评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,057评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,009评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,254评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,204评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,561评论 2 343

推荐阅读更多精彩内容