1<HTML> 2<BODY BGCOLOR="white"> 3<PRE> 4<FONT color="green">001</FONT> // Copyright (c) 2011, Mike Samuel<a name="line.1"></a> 5<FONT color="green">002</FONT> // All rights reserved.<a name="line.2"></a> 6<FONT color="green">003</FONT> //<a name="line.3"></a> 7<FONT color="green">004</FONT> // Redistribution and use in source and binary forms, with or without<a name="line.4"></a> 8<FONT color="green">005</FONT> // modification, are permitted provided that the following conditions<a name="line.5"></a> 9<FONT color="green">006</FONT> // are met:<a name="line.6"></a> 10<FONT color="green">007</FONT> //<a name="line.7"></a> 11<FONT color="green">008</FONT> // Redistributions of source code must retain the above copyright<a name="line.8"></a> 12<FONT color="green">009</FONT> // notice, this list of conditions and the following disclaimer.<a name="line.9"></a> 13<FONT color="green">010</FONT> // Redistributions in binary form must reproduce the above copyright<a name="line.10"></a> 14<FONT color="green">011</FONT> // notice, this list of conditions and the following disclaimer in the<a name="line.11"></a> 15<FONT color="green">012</FONT> // documentation and/or other materials provided with the distribution.<a name="line.12"></a> 16<FONT color="green">013</FONT> // Neither the name of the OWASP nor the names of its contributors may<a name="line.13"></a> 17<FONT color="green">014</FONT> // be used to endorse or promote products derived from this software<a name="line.14"></a> 18<FONT color="green">015</FONT> // without specific prior written permission.<a name="line.15"></a> 19<FONT color="green">016</FONT> // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS<a name="line.16"></a> 20<FONT color="green">017</FONT> // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT<a name="line.17"></a> 21<FONT color="green">018</FONT> // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS<a name="line.18"></a> 22<FONT color="green">019</FONT> // FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE<a name="line.19"></a> 23<FONT color="green">020</FONT> // COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,<a name="line.20"></a> 24<FONT color="green">021</FONT> // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,<a name="line.21"></a> 25<FONT color="green">022</FONT> // BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;<a name="line.22"></a> 26<FONT color="green">023</FONT> // LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER<a name="line.23"></a> 27<FONT color="green">024</FONT> // CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT<a name="line.24"></a> 28<FONT color="green">025</FONT> // LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN<a name="line.25"></a> 29<FONT color="green">026</FONT> // ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE<a name="line.26"></a> 30<FONT color="green">027</FONT> // POSSIBILITY OF SUCH DAMAGE.<a name="line.27"></a> 31<FONT color="green">028</FONT> <a name="line.28"></a> 32<FONT color="green">029</FONT> package org.owasp.html;<a name="line.29"></a> 33<FONT color="green">030</FONT> <a name="line.30"></a> 34<FONT color="green">031</FONT> import com.google.common.base.Throwables;<a name="line.31"></a> 35<FONT color="green">032</FONT> <a name="line.32"></a> 36<FONT color="green">033</FONT> /**<a name="line.33"></a> 37<FONT color="green">034</FONT> * Receives notification of problems.<a name="line.34"></a> 38<FONT color="green">035</FONT> *<a name="line.35"></a> 39<FONT color="green">036</FONT> * @author Mike Samuel <mikesamuel@gmail.com><a name="line.36"></a> 40<FONT color="green">037</FONT> */<a name="line.37"></a> 41<FONT color="green">038</FONT> public interface Handler<T> {<a name="line.38"></a> 42<FONT color="green">039</FONT> <a name="line.39"></a> 43<FONT color="green">040</FONT> void handle(T x);<a name="line.40"></a> 44<FONT color="green">041</FONT> <a name="line.41"></a> 45<FONT color="green">042</FONT> /** A handler that does nothing given any input. */<a name="line.42"></a> 46<FONT color="green">043</FONT> public static final Handler<Object> DO_NOTHING = new Handler<Object>() {<a name="line.43"></a> 47<FONT color="green">044</FONT> public void handle(Object x) {<a name="line.44"></a> 48<FONT color="green">045</FONT> // Really, do nothing.<a name="line.45"></a> 49<FONT color="green">046</FONT> }<a name="line.46"></a> 50<FONT color="green">047</FONT> };<a name="line.47"></a> 51<FONT color="green">048</FONT> <a name="line.48"></a> 52<FONT color="green">049</FONT> /**<a name="line.49"></a> 53<FONT color="green">050</FONT> * A handler that re-raises an error, wrapping it in a runtime exception if<a name="line.50"></a> 54<FONT color="green">051</FONT> * necessary.<a name="line.51"></a> 55<FONT color="green">052</FONT> */<a name="line.52"></a> 56<FONT color="green">053</FONT> public static final Handler<Throwable> PROPAGATE = new Handler<Throwable>() {<a name="line.53"></a> 57<FONT color="green">054</FONT> public void handle(Throwable th) {<a name="line.54"></a> 58<FONT color="green">055</FONT> Throwables.propagate(th);<a name="line.55"></a> 59<FONT color="green">056</FONT> }<a name="line.56"></a> 60<FONT color="green">057</FONT> };<a name="line.57"></a> 61<FONT color="green">058</FONT> }<a name="line.58"></a> 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122</PRE> 123</BODY> 124</HTML> 125