打开APP
userphoto
未登录

开通VIP,畅享免费电子书等14项超值服

开通VIP
【Exception】Java 异常处理基本规则,Java异常处理的基本规范

看了团队中原来代码中的异常处理,心碎了一地,稍微对照阿里巴巴的异常处理规范整理了一遍,准备分享一下,Java的异常处理规范&约束。

一、运行异常的扑捉

不要捕获   Java  类库中定义的继承自 RuntimeException 的运行时异常类,如:IndexOutOfBoundsException / NullPointerException ,这类异常由程序员预检查来规避,保证程序健壮性。

正例:

  1. if(null != obj) {
  2. //TODO
  3. }

反例:

  1. try {
  2. obj.method()
  3. } catch(NullPointerException e){
  4. //TODO
  5. }

二、 try-catch 作用域(现有代码出现率较高)

对大段代码进行try-catch ,这是不负责任的表现。catch 时请分清稳定代码和非稳定代码,稳定代码指的是无论如何不会出错的代码。对于非稳定代码的 catch 尽可能进行区分异常类型,再做对应的异常处理。
正例:
分块catch ,或者直接抛出相对应的异常,然后由下层细化处理。

  1. map.put("status", 500);
  2. try{
  3. //代码省略
  4. map.put("message", "success!");
  5. map.put("status", 200);
  6. } catch (UnknownHostException e) {
  7. //域名错误
  8. map.put("message", "请输入正确的网址");
  9. LoggerUtils.fmtError(e, "网址异常[%s]", url);
  10. } catch (SocketTimeoutException e) {
  11. //超时
  12. map.put("message", "请求地址超时");
  13. LoggerUtils.fmtError(e, "请求地址超时[%s]", url);
  14. } catch (Exception e) {
  15. //其他异常
  16. map.put("message", "请求出现未知异常,请重试!\r\n" + e.getMessage());
  17. LoggerUtils.fmtError(e, "请求出现未知异常,请重试![%s]", url);
  18. }
  19. return map;

反例:

  1. try {
  2. //此处省略1024行代码
  3. } catch(Exception e){
  4. //TODO
  5. }

三、异常的捕捉 & 异常的处理(现有代码出现率较高)

捕获异常是为了处理它,不要捕获了却什么都不处理而抛弃之,如果不想处理它,请将该异常抛给它的调用者。最外层的业务使用者,必须处理异常,将其转化为用户可以理解的内容。

正例:

  1. try{
  2. //代码省略
  3. } catch (UnknownHostException e) {
  4. //域名错误
  5. map.put("message", "请输入正确的网址");
  6. LoggerUtils.fmtError(XXXXManager.class, e, "网址异常[%s]", url);
  7. } catch (SocketTimeoutException e) {
  8. //超时
  9. map.put("message", "请求地址超时");
  10. LoggerUtils.fmtError(XXXXManager.class, e, "请求地址超时[%s]", url);
  11. } catch (Exception e) {
  12. //其他异常
  13. map.put("message", "请求出现未知异常,请重试!\r\n" + e.getMessage());
  14. LoggerUtils.fmtError(XXXXManager.class, e, "请求出现未知异常,请重试![%s]", url);
  15. }

只为描述一下异常,继续抛出。

  1. try{
  2. //代码省略
  3. } catch (UnknownHostException e) {
  4. throw new HNException("xxx处理失败。",e);
  5. }

反例:

1.如下,调用者对异常没有任何感知。

  1. try{
  2. //代码省略
  3. } catch (Exception e) {
  4. System.out.println("插入异常");
  5. }

2.如下,调用者对异常无法定位和判断

  1. try{
  2. //代码省略
  3. } catch (UnknownHostException e) {
  4. throw new RuntimeException("500");
  5. }

四、异常 & 事务

  1. try 块放到了事务代码中,catch 异常后,如果需要回滚事务,一定要注意手动回滚事务。
  2. 在有事务的代码中,catch 异常后,做描述异常等处理后,如果需要事务生效,请把异常继续抛出。

五、异常 & finally

1.如果有对IO 流和资源做操作,必须逐一关闭IO 流和资源对象(从里层到外层),有异常也要做处理。

  1. try{
  2. //代码省略
  3. } catch (Exception e) {
  4. throw new HNException("xxx处理失败。",e);
  5. }finally{
  6. try {
  7. if(null != conn){
  8. conn.disconnect();
  9. }
  10. } catch (Exception e1) {
  11. LoggerUtils.fmtInfo("请求完毕关闭流出现异常![%s]", url);
  12. }
  13. try {
  14. if(null != outStream){
  15. outStream.close();
  16. }
  17. } catch (Exception e2) {
  18. LoggerUtils.fmtInfo("请求完毕关闭流出现异常![%s]", url);
  19. }
  20. try {
  21. if(null != out){
  22. out.close();
  23. }
  24. } catch (Exception e3) {
  25. LoggerUtils.fmtInfo("请求完毕关闭流出现异常![%s]", url);
  26. }
  27. }

  JDK  7 以上可以使用try-with-resources 方式。

六、finally &  return

不能在 finally 块中使用 returnfinally 块中的 return 返回后方法结束执行,不会再执行 try 块中的 return 语句。

七、异常需要精确

捕获异常与抛异常,必须是完全匹配,或者捕获异常是抛异常的父类。如果预期对方抛的是绣球,实际接到的是铅球,就会产生意外情况。

八、程序员的基本修养 & NPE(现有代码中出现率较高)

1.方法(接口)的返回值可以为 null ,但不推荐返回空集合,或者空对象等,必须添加注释充分说明什么情况下会返回 null 值。调用方需要进行 null 判断防止 NPE 问题。

2.防止 NPE ,是程序员的基本修养,注意 NPE 产生的场景。

    a.查询数据库返回null ,包括null 对象和null 集合。

    b.集合内元素有null 对象。





原文地址:https://www.sojson.com/blog/251.html

转载时必须以链接形式注明原始出处及本声明。



本站仅提供存储服务,所有内容均由用户发布,如发现有害或侵权内容,请点击举报
打开APP,阅读全文并永久保存 查看更多类似文章
猜你喜欢
类似文章
【热】打开小程序,算一算2024你的财运
关于Java Tomcat 内存溢出排查心得分享
六大代码问题检验你的Java知识
Java异常处理总结
30 个java编程技巧(最佳实践的初学者)一
Java7语法新特性
J2EE项目异常处理 - dongming - JavaEye技术网站
更多类似文章 >>
生活服务
热点新闻
分享 收藏 导长图 关注 下载文章
绑定账号成功
后续可登录账号畅享VIP特权!
如果VIP功能使用有故障,
可点击这里联系客服!

联系客服