Clover Coverage Report
Coverage timestamp: Sun Mar 23 2008 08:24:39 GMT
3   101   1   1
0   12   1   3
3     1  
1    
 
 
  PkiException       Line # 68 3 1 0% 0.0
 
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.rbac;
33   
34    /**
35    * This class represents a PKI exception condition. It is thrown by the PKI
36    * routines when they are used by the PBA API, and are simply propagated to the
37    * caller.
38    *
39    * <p>Example:
40    * <br><code>try{
41    * <br>...
42    * <br>}catch(PbaException pe){
43    * <br>...
44    * <br>}</code>
45    *
46    * <p>in this example the caller does not care if it was an error caused by
47    * the PKI or not. It just performs some simple routine error-handling.
48    *
49    * <p>Example:
50    * <br><code>try{
51    * <br>...
52    * <br>}catch(PkiException pe){
53    * <br>... // PKI-specific error-handling here
54    * <br>}catch(PbaException pe){
55    * <br>...
56    * <br>}</code>
57    *
58    * <p>however, in this example the caller distinguishes between PKI errors
59    * and the other kinds of errors. It now can handle the PKI errors in a
60    * different way.
61    *
62    * @author A Otenko
63    * @author E Ball
64    * @author D W Chadwick
65    * @version 0.2
66    */
67   
 
68    public class PkiException extends issrg.pba.PbaException {
69    /**
70    * The default constructor builds an exception with no explanation
71    * message and no embedded exception.
72    */
 
73  0 toggle public PkiException(){
74  0 super();
75    }
76   
77    /**
78    * This constructor builds an exception with a message but no
79    * embedded exception.
80    *
81    * @param msg is the String message explaining the error; can be null
82    */
 
83  0 toggle public PkiException(String msg){
84  0 super(msg);
85    }
86   
87    /**
88    * This constructor builds an exception with a message and an
89    * embedded exception to be returned by getEmbedded method.
90    *
91    * @param msg is the String explanation of the error; can be null
92    * @param th is the Throwable object to be believed the cause of
93    * the error; can be null, if there is no embedded exception
94    *
95    * @see issrg.utils.EmbeddedException#getEmbedded()
96    */
 
97  0 toggle public PkiException(String msg, Throwable th){
98  0 super(msg, th);
99    }
100    }
101