View Javadoc

1   /*
2    * $Source: /usr/cvsroot/melati/throwing-jdbc/src/main/java/org/melati/poem/dbms/test/sql/Thrower.java,v $
3    * $Revision: 1.11 $
4    *
5    * Copyright (C) 2007 Tim Pizey
6    *
7    * Part of Melati (http://melati.org), a framework for the rapid
8    * development of clean, maintainable web applications.
9    *
10   * Melati is free software; Permission is granted to copy, distribute
11   * and/or modify this software under the terms either:
12   *
13   * a) the GNU General Public License as published by the Free Software
14   *    Foundation; either version 2 of the License, or (at your option)
15   *    any later version,
16   *
17   *    or
18   *
19   * b) any version of the Melati Software License, as published
20   *    at http://melati.org
21   *
22   * You should have received a copy of the GNU General Public License and
23   * the Melati Software License along with this program;
24   * if not, write to the Free Software Foundation, Inc.,
25   * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA to obtain the
26   * GNU General Public License and visit http://melati.org to obtain the
27   * Melati Software License.
28   *
29   * Feel free to contact the Developers of Melati (http://melati.org),
30   * if you would like to work out a different arrangement than the options
31   * outlined here.  It is our intention to allow Melati to be used by as
32   * wide an audience as possible.
33   *
34   * This program is distributed in the hope that it will be useful,
35   * but WITHOUT ANY WARRANTY; without even the implied warranty of
36   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
37   * GNU General Public License for more details.
38   *
39   * Contact details for copyright holder:
40   *
41   *     Tim Pizey <timp At paneris.org>
42   *     http://paneris.org/~timp
43   */
44  package org.melati.poem.dbms.test.sql;
45  
46  import java.util.Hashtable;
47  
48  
49  /**
50   * A class which can throw on demand.
51   * 
52   * @author timp
53   * @since 10 Feb 2007
54   *
55   */
56  public abstract class Thrower {
57    
58    static Hashtable<String,Integer> throwers = new Hashtable<String, Integer>();
59  
60    protected Thrower() {}
61    
62    /**
63     * Tell named method to start throwing exceptions.
64     * @param i Interface class object
65     * @param methodName name in class.methodName format
66     */
67    public static void startThrowing(Class<?> i, String methodName) {
68      String fullName = i.getName() + "." + methodName;
69      throwers.put(fullName, new Integer(1));
70    }
71    /**
72     * Tell named method to start throwing exceptions.
73     * @param i Interface class object
74     * @param methodName name in class.methodName format
75     */
76    public static void startThrowingAfter(Class<?> i, String methodName, int goes) {
77      String fullName = i.getName() + "." + methodName;
78      throwers.put(fullName, new Integer(1 + goes));
79    }
80    /**
81     * Tell named method to stop throwing exceptions.
82     * @param i Interface class object
83     * @param methodName name in class.methodName format
84     */
85    public static void stopThrowing(Class<?> i, String methodName) {
86      String fullName = i.getName() + "." + methodName;
87      throwers.put(fullName, new Integer(0));
88    }
89    /**
90     * Check whether method should throw, called once for every method invocation.
91     * @param i Interface class object
92     * @param methodName name in class.methodName format
93     * @return whether method named should throw exception
94     */
95    public static boolean shouldThrow(Class<?> i, String methodName) {
96      String fullName = i.getName() + "." + methodName;
97      if (throwers.get(fullName) == null) 
98        throwers.put(fullName, new Integer(0));
99      int toGo = ((Integer)throwers.get(fullName)).intValue(); 
100     if (toGo == 0)  
101       return false;
102     else { 
103       toGo = toGo - 1;
104       throwers.put(fullName, new Integer(toGo));
105       return toGo == 0 ? true : false;
106     }
107   }
108 
109 }