Clover Coverage Report
Coverage timestamp: Sun Mar 23 2008 08:24:39 GMT
3   93   1   1
0   12   1   3
3     1  
1    
 
 
  PbaException       Line # 58 3 1 66.7% 0.6666667
 
No Tests
 
1    /*
2    * Copyright (c) 2000-2005, University of Salford
3    * All rights reserved.
4    *
5    * Redistribution and use in source and binary forms, with or without
6    * modification, are permitted provided that the following conditions are met:
7    *
8    * Redistributions of source code must retain the above copyright notice, this
9    * list of conditions and the following disclaimer.
10    *
11    * Redistributions in binary form must reproduce the above copyright notice,
12    * this list of conditions and the following disclaimer in the documentation
13    * and/or other materials provided with the distribution.
14    *
15    * Neither the name of the University of Salford nor the names of its
16    * contributors may be used to endorse or promote products derived from this
17    * software without specific prior written permission.
18    *
19    * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20    * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21    * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22    * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23    * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24    * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25    * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26    * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27    * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28    * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29    * POSSIBILITY OF SUCH DAMAGE.
30    */
31   
32    package issrg.pba;
33   
34    /**
35    * This is an exception to be thrown by PBA API implementations in cases of
36    * need. It contains the real cause of the error, in case the error has been
37    * caused by some other objects used by the implementation.
38    *
39    * <p>Example:
40    * <p><code>try{<br>
41    * ...<br>
42    * }catch(PbaException pba){<br>
43    * throw pba;<br>
44    * }catch(Throwable th){<br>
45    * throw new PbaException("Internal error", th);<br>
46    * }<br>
47    * </code>
48    * Note that the code above will throw only PbaExceptions. All other errors
49    * are caught and embedded. This allows the caller of the code to catch
50    * PbaExceptions only, and be sure nothing else will happen. The simplest
51    * error handler will just display an error, a sophisticated error handler
52    * can still extract the real cause of the error and do something cleverer.
53    *
54    * @author A Otenko
55    * @version 1.0
56    */
57   
 
58    public class PbaException extends issrg.utils.EmbeddedException {
59    //public static final int UNDEFINED_ERROR=-1;
60   
61    //protected int errCode=UNDEFINED_ERROR;
62    /**
63    * The default constructor builds an exception with no explanation
64    * message and no embedded exception.
65    */
 
66  0 toggle public PbaException(){
67  0 super();
68    }
69   
70    /**
71    * This constructor builds an exception with a message but no
72    * embedded exception.
73    *
74    * @param msg is the String message explaining the error; can be null
75    */
 
76  824 toggle public PbaException(String msg){
77  824 super(msg);
78    }
79   
80    /**
81    * This constructor builds an exception with a message and an
82    * embedded exception to be returned by getEmbedded method.
83    *
84    * @param msg is the String explanation of the error; can be null
85    * @param th is the Throwable object to be believed the cause of
86    * the error; can be null, if there is no embedded exception
87    *
88    * @see issrg.utils.EmbeddedException#getEmbedded()
89    */
 
90  199 toggle public PbaException(String msg, Throwable th){
91  199 super(msg, th);
92    }
93    }