steven_cheng 一个水平有限的Java开发者 http://steven-cheng.javaeye.com UTF-8 Copyright 2003-2008, JavaEye.com http://blogs.law.harvard.edu/tech/rss JavaEye - 做最棒的软件开发交流社区 异常处理 steven_cheng 作者: steven_cheng  链接：http://steven-cheng.javaeye.com/blog/87667  发表时间: 2007年06月07日

声明：本文系JavaEye网站发布的原创博客文章，未经作者书面许可，严禁任何网站转载本文，否则必将追究法律责任！

最近刚好作了一个产品的异常处理规范，把我做的也拿出来晒晒，和大家讨论一下。

1、CheckException or UnCheckedException

个人倾向用UnCheckedException。我见过的最多的处理异常的代码就是记录日志或转换后抛出，好像做其他操作的少之又少。我以前还见过有人不管三七二十一，抓到什么抛什么，结果一个接口抛出了3-5种CheckException。别扭啊，呵呵。

当然，最大的缺陷就是对接口调用者的使用。至少UnCheckedException可以让接口调用者选择catch还是不catch。

因为这是一个遗留系统，都使用了CheckedException，不过好在使用的比较规范，没有太大麻烦。

2、异常信息

因为开发者众多，异常信息五花八门，有中文的有英文的，有简单的，有复杂的。散落在各个类里，修改起来很麻烦。

我的处理办法是，定义异常码，异常信息和异常码一一对应，定义在properties文件里，抛出异常的地方只引用异常码。这样，如果需要修改异常信息，只要修改properties文件重新打包即可。异常码分为原因码和位置码。位置码一般用在业务逻辑类里。比如一般用到的Facad模式，可能一个接口定义了n个方法，每个方法都抛出XXXBusinessException(XXX用于区分业务子包)，抛出的异常码在代码里顺序定义即可。原因码表示某类异常，比如SQLException引起的异常都为8000。

异常码中原因码按包、类、接口定义，比如：前两位表示一级子包，接下来两位留给二级子包，接下来两位表示类，最后3位表示方法。

异常信息如果需要，可以保留现场信息。比如：“用户[abc]已存在”。这样的信息就比“用户已存在”明确。这个功能可以通过java.text.MessageFormat实现。

3、异常的链式抛出

即，在调用底层接口时捕获到异常，需要转成其他的异常抛出时，使用带Throwable的构造器。这样可以保留最原始的出错信息。

异常基类代码：

java 代码
  1. public class BaseException extends Exception {   
  2.        
  3.        
  4.     protected long errorCode;   
  5.        
  6.        
  7.     protected String[] args;   
  8.   
  9.     /**  
  10.      * @param errorCode  
  11.      */  
  12.     public BaseException(long errorCode) {   
  13.         super();   
  14.         this.errorCode = errorCode;   
  15.     }   
  16.        
  17.     /**  
  18.      * @param errorCode  
  19.      * @param cause  
  20.      */  
  21.     public BaseException(long errorCode,Throwable cause) {   
  22.         super(cause);   
  23.         this.errorCode = errorCode;   
  24.     }   
  25.        
  26.     /**  
  27.      * @param errorCode  
  28.      * @param cause  
  29.      * @param args @see {@link java.text.MessageFormat#format(Object)}  
  30.      */  
  31.     public BaseException(long errorCode,Throwable cause,String[] args) {   
  32.         super(cause);   
  33.         this.errorCode = errorCode;   
  34.         this.args = args;   
  35.     }   
  36.        
  37.     /* (non-Javadoc)  
  38.      * @see java.lang.Throwable#getMessage()  
  39.      */  
  40.     public String getMessage() {   
  41.         String message = "";   
  42.         if (this.args == null || this.args.length == 0) {   
  43.             message = MessageSource.getInstance().resolveCodeWithoutArguments(   
  44.                     this.errorCode);   
  45.         } else {   
  46.             message = MessageSource.getInstance().resolveCode(this.errorCode)   
  47.                     .format(this.args);   
  48.         }   
  49.   
  50.         return this.errorCode+":"+message;   
  51.     }   
  52.   
  53.     /**  
  54.      * @return the errorCode  
  55.      */  
  56.     public long getErrorCode() {   
  57.         return errorCode;   
  58.     }   
  59.   
  60.     /**  
  61.      * @return the args  
  62.      */  
  63.     public String[] getArgs() {   
  64.         return args;   
  65.     }   
  66.   
  67. }  

其中：MessageSource这个类就是根据是否有现场信息，分别处理，得到完整异常信息表述字符串。

关于主贴中嵌套打印的部分，从JDK1.4开始，Throwable就是嵌套打印的，所以不必再覆盖那几个方法了。

现在假使，有AException 和BException，都从BaseException继承。在方法里，我们捕获了AException，需要转换成BException抛出，这时候我们就非常希望能直接用AException的信息(errorCode和args)。所以，如果再来这样一个构造器似乎更好：

java 代码
  1. public BaseException(BaseException cause){   
  2.     this.errorCode = cause.getErrorCode();   
  3.     this.args = cause.getArgs();   
  4. }  

但是，因为Exception有一个构造器：public Exception(Throwable cause)，所以这样的构造器就是重载(overload)，而不是覆盖(Override)。重载，入参又是父子类关系，这样的方法很容易混淆，所以就没有提供。

我按照这个异常处理规范，花了两三天时间把代码重构了一遍。似乎用起来挺好使


本文的讨论也很精彩，浏览讨论>>


JavaEye推荐



]]> Thu, 07 Jun 2007 14:53:43 +0800 http://steven-cheng.javaeye.com/blog/87667 http://steven-cheng.javaeye.com/blog/87667 用apache的configuration实现实时配置 steven_cheng 作者: steven_cheng  链接：http://steven-cheng.javaeye.com/blog/70634  发表时间: 2006年03月24日

声明：本文系JavaEye网站发布的原创博客文章，未经作者书面许可，严禁任何网站转载本文，否则必将追究法律责任！

apache下commons有一个configeration包，对于做配置很方便，尤其是实时热配置。可以自动监测到配置文件的更改而reload配置文件。在项目中使用所以进行了一下封装。

java 代码
  1. public class DefaultRealTimeXMLConfiger {   
  2.        
  3.     private static Log logger = LogFactory.getLog(DefaultRealTimeXMLConfiger.class);   
  4.        
  5.     private String fileName;   
  6.        
  7.     private long reloadPeriod;   
  8.        
  9.     private XMLConfiguration config;   
  10.        
  11.     public void init()   
  12.     {   
  13.         String filePath = GlobalConfigerImpl.getConfDir()+"/"+fileName;   
  14.         logger.debug("will config with XML file["+filePath+"]");   
  15.            
  16.         File file = new File(filePath);   
  17.         if (!file.exists() || !file.isFile()) {   
  18.             logger.error(" can't find file[" + filePath + "]");   
  19.             throw new IllegalArgumentException("config error! can't find file[" + filePath + "]");   
  20.         }   
  21.         this.init(file);   
  22.     }   
  23.        
  24.     public void init(File file) {   
  25.         try {   
  26.             config = new XMLConfiguration(file);   
  27.             FileChangedReloadingStrategy fs = new FileChangedReloadingStrategy();   
  28.             fs.setConfiguration(config);   
  29.                
  30.             if(this.reloadPeriod>0)   
  31.             {   
  32.                 fs.setRefreshDelay(this.reloadPeriod);   
  33.             }   
  34.             config.setReloadingStrategy(fs);   
  35.                
  36.         } catch (ConfigurationException e) {   
  37.             logger.error("error! configer error["+file.getPath()+"]");   
  38.             logger.error(e);   
  39.             e.printStackTrace();   
  40.         }   
  41.     }   
  42.   
  43.     public Object getProperty(String name) {   
  44.         Object s = this.config.getProperty(name);   
  45.         return s;   
  46.     }   
  47.   
  48.     public String getString(String name) {   
  49.         Object s = this.config.getProperty(name);   
  50.         String result = null;   
  51.         if (s != null)   
  52.             result = (String) s;   
  53.   
  54.         return result;   
  55.     }   
  56.   
  57.     public String[] getStringArray(String name) {   
  58.         String[] target = this.config.getStringArray(name);   
  59.            
  60.         return target;   
  61.     }   
  62.        
  63.   
  64.     /**  
  65.      * @return Returns the fileName.  
  66.      */  
  67.     public String getFileName() {   
  68.         return fileName;   
  69.     }   
  70.   
  71.     /**  
  72.      * @param fileName The fileName to set.  
  73.      */  
  74.     public void setFileName(String fileName) {   
  75.         this.fileName = fileName;   
  76.     }   
  77.   
  78.     /**  
  79.      * @return Returns the reloadPeriod.  
  80.      */  
  81.     public long getReloadPeriod() {   
  82.         return reloadPeriod;   
  83.     }   
  84.   
  85.     /**  
  86.      * @param reloadPeriod The reloadPeriod to set.  
  87.      */  
  88.     public void setReloadPeriod(long reloadPeriod) {   
  89.         this.reloadPeriod = reloadPeriod;   
  90.     }   
  91. }  

本文的讨论也很精彩，浏览讨论>>


JavaEye推荐



]]> Fri, 24 Mar 2006 06:34:00 +0800 http://steven-cheng.javaeye.com/blog/70634 http://steven-cheng.javaeye.com/blog/70634