《Effective java》读书记录-第24条-消除非受检警告

时间:2022-04-21 17:51:07

用泛型编程时,会遇到许多编译器警告:非受检强制转化警告(unchecked cast warnings)、非受检方法调用警告、非受检普通数组创建警告、以及非受检转换警告(unchecked  conversion warnings)。

许多非受检警告很容易消除。有些警告比较难以消除。记住!要尽可能地消除每一个非受检警告。如果消除了所有警告,就可以确保代码是类型安全的。

如果无法消除警告,同时可以证明引起警告的代码是类型安全的,(只有在这种情况下才可以用一个@ SupperessWarnings("unchecked")注解来禁止这条警告)。SupperessWarnings注解可以用在任何粒度级别中,应该始终在尽可能小的范围内使用SupperessWarnings注解永远不要在整个类上使用SupperessWarnings,这么做可能会掩盖重要的警告。

每当使用SupperessWarnings("unchecked")注解时,都要添加一条注释,说明为什么这么做是安全的。

总而言之,非受检警告很重要,不要忽略它们。每一条警告都表示可能在运行时抛出 ClassCastException异常。要尽最大的努力消除这些警告。如果无法消除非受检警告,同时可以证明引起警告的代码是类型安全的,就可以在尽可能小的范围中,用@SupperessWarnings("unchecked")注解禁止该警告。要用注解吧禁止该警告的原因记录下来。