/usr/share/doc/junit4/api/src-html/org/junit/experimental/categories/CategoryValidator.html is in junit4-doc 4.12-6.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 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 123 124 125 126 127 128 129 130 131 132 133 134 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<title>Source code</title>
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
</head>
<body>
<div class="sourceContainer">
<pre><span class="sourceLineNo">001</span>package org.junit.experimental.categories;<a name="line.1"></a>
<span class="sourceLineNo">002</span><a name="line.2"></a>
<span class="sourceLineNo">003</span>import static java.util.Arrays.asList;<a name="line.3"></a>
<span class="sourceLineNo">004</span>import static java.util.Collections.unmodifiableList;<a name="line.4"></a>
<span class="sourceLineNo">005</span>import static java.util.Collections.unmodifiableSet;<a name="line.5"></a>
<span class="sourceLineNo">006</span><a name="line.6"></a>
<span class="sourceLineNo">007</span>import java.lang.annotation.Annotation;<a name="line.7"></a>
<span class="sourceLineNo">008</span>import java.util.ArrayList;<a name="line.8"></a>
<span class="sourceLineNo">009</span>import java.util.HashSet;<a name="line.9"></a>
<span class="sourceLineNo">010</span>import java.util.List;<a name="line.10"></a>
<span class="sourceLineNo">011</span>import java.util.Set;<a name="line.11"></a>
<span class="sourceLineNo">012</span><a name="line.12"></a>
<span class="sourceLineNo">013</span>import org.junit.After;<a name="line.13"></a>
<span class="sourceLineNo">014</span>import org.junit.AfterClass;<a name="line.14"></a>
<span class="sourceLineNo">015</span>import org.junit.Before;<a name="line.15"></a>
<span class="sourceLineNo">016</span>import org.junit.BeforeClass;<a name="line.16"></a>
<span class="sourceLineNo">017</span>import org.junit.runners.model.FrameworkMethod;<a name="line.17"></a>
<span class="sourceLineNo">018</span>import org.junit.validator.AnnotationValidator;<a name="line.18"></a>
<span class="sourceLineNo">019</span><a name="line.19"></a>
<span class="sourceLineNo">020</span>/**<a name="line.20"></a>
<span class="sourceLineNo">021</span> * Validates that there are no errors in the use of the {@code Category}<a name="line.21"></a>
<span class="sourceLineNo">022</span> * annotation. If there is, a {@code Throwable} object will be added to the list<a name="line.22"></a>
<span class="sourceLineNo">023</span> * of errors.<a name="line.23"></a>
<span class="sourceLineNo">024</span> *<a name="line.24"></a>
<span class="sourceLineNo">025</span> * @since 4.12<a name="line.25"></a>
<span class="sourceLineNo">026</span> */<a name="line.26"></a>
<span class="sourceLineNo">027</span>public final class CategoryValidator extends AnnotationValidator {<a name="line.27"></a>
<span class="sourceLineNo">028</span><a name="line.28"></a>
<span class="sourceLineNo">029</span> @SuppressWarnings("unchecked")<a name="line.29"></a>
<span class="sourceLineNo">030</span> private static final Set<Class<? extends Annotation>> INCOMPATIBLE_ANNOTATIONS = unmodifiableSet(new HashSet<Class<? extends Annotation>>(<a name="line.30"></a>
<span class="sourceLineNo">031</span> asList(BeforeClass.class, AfterClass.class, Before.class, After.class)));<a name="line.31"></a>
<span class="sourceLineNo">032</span><a name="line.32"></a>
<span class="sourceLineNo">033</span> /**<a name="line.33"></a>
<span class="sourceLineNo">034</span> * Adds to {@code errors} a throwable for each problem detected. Looks for<a name="line.34"></a>
<span class="sourceLineNo">035</span> * {@code BeforeClass}, {@code AfterClass}, {@code Before} and {@code After}<a name="line.35"></a>
<span class="sourceLineNo">036</span> * annotations.<a name="line.36"></a>
<span class="sourceLineNo">037</span> *<a name="line.37"></a>
<span class="sourceLineNo">038</span> * @param method the method that is being validated<a name="line.38"></a>
<span class="sourceLineNo">039</span> * @return A list of exceptions detected<a name="line.39"></a>
<span class="sourceLineNo">040</span> *<a name="line.40"></a>
<span class="sourceLineNo">041</span> * @since 4.12<a name="line.41"></a>
<span class="sourceLineNo">042</span> */<a name="line.42"></a>
<span class="sourceLineNo">043</span> @Override<a name="line.43"></a>
<span class="sourceLineNo">044</span> public List<Exception> validateAnnotatedMethod(FrameworkMethod method) {<a name="line.44"></a>
<span class="sourceLineNo">045</span> List<Exception> errors = new ArrayList<Exception>();<a name="line.45"></a>
<span class="sourceLineNo">046</span> Annotation[] annotations = method.getAnnotations();<a name="line.46"></a>
<span class="sourceLineNo">047</span> for (Annotation annotation : annotations) {<a name="line.47"></a>
<span class="sourceLineNo">048</span> for (Class<?> clazz : INCOMPATIBLE_ANNOTATIONS) {<a name="line.48"></a>
<span class="sourceLineNo">049</span> if (annotation.annotationType().isAssignableFrom(clazz)) {<a name="line.49"></a>
<span class="sourceLineNo">050</span> addErrorMessage(errors, clazz);<a name="line.50"></a>
<span class="sourceLineNo">051</span> }<a name="line.51"></a>
<span class="sourceLineNo">052</span> }<a name="line.52"></a>
<span class="sourceLineNo">053</span> }<a name="line.53"></a>
<span class="sourceLineNo">054</span> return unmodifiableList(errors);<a name="line.54"></a>
<span class="sourceLineNo">055</span> }<a name="line.55"></a>
<span class="sourceLineNo">056</span><a name="line.56"></a>
<span class="sourceLineNo">057</span> private void addErrorMessage(List<Exception> errors, Class<?> clazz) {<a name="line.57"></a>
<span class="sourceLineNo">058</span> String message = String.format("@%s can not be combined with @Category",<a name="line.58"></a>
<span class="sourceLineNo">059</span> clazz.getSimpleName());<a name="line.59"></a>
<span class="sourceLineNo">060</span> errors.add(new Exception(message));<a name="line.60"></a>
<span class="sourceLineNo">061</span> }<a name="line.61"></a>
<span class="sourceLineNo">062</span>}<a name="line.62"></a>
</pre>
</div>
</body>
</html>
|