Effective Java(3rd)-Item27 消除未经检查的警告

  当你使用泛型编程时,你将看到许多编译警告:未检查的强制转换警告,未检查的方法调用,未检查的参数化vararg类型警告,以及未检查的转换警告。 使用泛型获得的经验越多,得到的警告就越少,但是不要期望新编写的代码能够干净地编译。
  许多未检查的异常很容易消除。比如,假设你意外地编写这段声明:

Set exaltation = new HashSet();

编译器将会温柔地提醒你哪里错了:


image.png

  然后你可以根据提示更正,从而警告消失。请注意,你实际上不必指定类型参数,只需要表明它与Java7中引入的菱形操作符(<>)一起存在。编译器将会正确推断实际的类型参数(在这种情况下,类型是Lark):

Set exaltation = new HashSet<>();
  

如果你不能消除一个警告,但是你可以证明引发警告的代码是类型安全的,那么(只有在那个时候)使用@Suppress Warnings("uncheckded")注释来抑制警告。如果你没有在第一时间证明代码是类型安全的就抑制警告了,你就给了自己一个错误的安全感。代码可以编译而不发出任何警告,但是它仍然可以在运行时抛出ClassCastException。但是,如果你忽略了你知道是安全的未经检查的警告(而不是抑制它们),那么你将不会注意到什么时候出现了新的警告,它代表了一个真正的问题。新的警告将在你没有沉默的所有虚假警报中消失
  SuppressWarnings注解可以在任何声明上使用,从一个局部的本地变量声明到一整个类。始终在最小范围中使用SuppressWarnings注解。通常,这将是一个变量声明或一个非常小的方法或构造方法。永远别再一整个类中使用SuppressWarnings。这么做会掩盖关键的警告。

  如果你发现自己在多行长的方法或构造方法上使用了SuppressWarnings注解,你可以将其转移到局部变量声明中。你可能需要声明一个新的局部变量,但是这是值得的。例如,考虑这个toArray方法,它来自ArrayList。


image.png

  如果你编译ArrayList,该方法将会生成这个警告:


image.png

  在return语句上添加SuppressWarnings注解是非法的,因为它不是一个声明 [JLS, 9.7]你可能会尝试将注释放在整个方法上,但是不要这么做。相反,声明一个局部变量以保存返回值并注释其声明,如下所示:


image.png

  生成的方法可以干净地编译,并最小化未检查的警告被抑制的范围。
  每次你使用@SuppressWarnings(“unchecked”)注解,需要添加注释说明为什么这么做是安全的。浙江帮助别人理解代码,更重要的是,它将降低有人修改代码的可能性,而导致计算变得不安全。如果你觉得很难写出这样的注释,那就继续思考。你可能最终会发现未经检查的操作毕竟是不安全的。

  总之,未经检查的警告是重要的。不要忽视它们。每个未检查警告代表了一个在运行时潜在的ClassCastException危险。尽你最大的努力来消除这些警告。如果你不能消除未经检查的警告,并可以证明引发该警告的代码是类型安全,请在尽可能窄的范围内使用@SuppressWarnings("unChecking")注解来抑制警告。并在注释中记录你决定抑制警告的理由。
本文写于2019.6.7,历时1天

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

推荐阅读更多精彩内容