blob: 634b78c8e684ec6a03bb92b2343456ebad76b0cb [file] [log] [blame]
<HTML><HEAD><META CONTENT="text/html; charset=UTF-8" HTTP-EQUIV="Content-Type"/><TITLE>EMMA Coverage Report</TITLE><STYLE TYPE="text/css"> TABLE,TD,TH {border-style:solid; border-color:black;} TD,TH {background:white;margin:0;line-height:100%;padding-left:0.5em;padding-right:0.5em;} TD {border-width:0 1px 0 0;} TH {border-width:1px 1px 1px 0;} TR TD.h {color:red;} TABLE {border-spacing:0; border-collapse:collapse;border-width:0 0 1px 1px;} P,H1,H2,H3,TH {font-family:verdana,arial,sans-serif;font-size:10pt;} TD {font-family:courier,monospace;font-size:10pt;} TABLE.hdft {border-spacing:0;border-collapse:collapse;border-style:none;} TABLE.hdft TH,TABLE.hdft TD {border-style:none;line-height:normal;} TABLE.hdft TH.tl,TABLE.hdft TD.tl {background:#6699CC;color:white;} TABLE.hdft TD.nv {background:#6633DD;color:white;} .nv A:link {color:white;} .nv A:visited {color:white;} .nv A:active {color:yellow;} TABLE.hdft A:link {color:white;} TABLE.hdft A:visited {color:white;} TABLE.hdft A:active {color:yellow;} .in {color:#356085;} TABLE.s TD {padding-left:0.25em;padding-right:0.25em;} TABLE.s TD.l {padding-left:0.25em;padding-right:0.25em;text-align:right;background:#F0F0F0;} TABLE.s TR.z TD {background:#FF9999;} TABLE.s TR.p TD {background:#FFFF88;} TABLE.s TR.c TD {background:#CCFFCC;} A:link {color:#0000EE;text-decoration:none;} A:visited {color:#0000EE;text-decoration:none;} A:hover {color:#0000EE;text-decoration:underline;} TABLE.cn {border-width:0 0 1px 0;} TABLE.s {border-width:1px 0 1px 1px;} TD.h {color:red;border-width:0 1px 0 0;} TD.f {border-width:0 1px 0 1px;} TD.hf {color:red;border-width:0 1px 0 1px;} TH.f {border-width:1px 1px 1px 1px;} TR.cis TD {background:#F0F0F0;} TR.cis TD {border-width:1px 1px 1px 0;} TR.cis TD.h {color:red;border-width:1px 1px 1px 0;} TR.cis TD.f {border-width:1px 1px 1px 1px;} TR.cis TD.hf {color:red;border-width:1px 1px 1px 1px;} TD.b {border-style:none;background:transparent;line-height:50%;} TD.bt {border-width:1px 0 0 0;background:transparent;line-height:50%;} TR.o TD {background:#F0F0F0;}TABLE.it {border-style:none;}TABLE.it TD,TABLE.it TH {border-style:none;}</STYLE></HEAD><BODY><TABLE CLASS="hdft" CELLSPACING="0" WIDTH="100%"><TR><TH CLASS="tl"><A HREF="http://www.eclemma.org/">EMMA</A> Coverage Report (generated Fri Feb 20 18:44:54 GMT 2009)</TH></TR><TR><TD CLASS="nv">[<A HREF="../xslUnitTestCoverage.html">all classes</A>][<A HREF="6f.html">org.eclipse.wst.sse.core.internal.util</A>]</TD></TR></TABLE><H2>COVERAGE SUMMARY FOR SOURCE FILE [<SPAN CLASS="in">Assert.java</SPAN>]</H2><TABLE CELLSPACING="0" WIDTH="100%"><TR><TH>name</TH><TH>class, %</TH><TH>method, %</TH><TH>block, %</TH><TH>line, %</TH></TR><TR><TD>Assert.java</TD><TD CLASS="h">50%  (1/2)</TD><TD CLASS="h">22%  (2/9)</TD><TD CLASS="h">11%  (7/65)</TD><TD CLASS="h">21%  (4/19)</TD></TR></TABLE><H3>COVERAGE BREAKDOWN BY CLASS AND METHOD</H3><TABLE CLASS="cn" CELLSPACING="0" WIDTH="100%"><TR><TH CLASS="f">name</TH><TH>class, %</TH><TH>method, %</TH><TH>block, %</TH><TH>line, %</TH></TR><TR><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD></TR><TR CLASS="cis"><TD CLASS="f">class <A HREF="#0">Assert$AssertionFailedException</A></TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/2)</TD><TD CLASS="h">0%   (0/13)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR><TD CLASS="f"><A HREF="#0">Assert$AssertionFailedException (Assert): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/6)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#2">Assert$AssertionFailedException (Assert, String): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/7)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR><TD CLASS="bt"> </TD><TD CLASS="bt"> </TD><TD CLASS="bt"> </TD><TD CLASS="bt"> </TD><TD CLASS="bt"> </TD></TR><TR CLASS="cis"><TD CLASS="f">class <A HREF="#3">Assert</A></TD><TD>100% (1/1)</TD><TD CLASS="h">29%  (2/7)</TD><TD CLASS="h">13%  (7/52)</TD><TD CLASS="h">27%  (4/15)</TD></TR><TR><TD CLASS="f"><A HREF="#4">Assert (): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/3)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#3">isLegal (boolean): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR><TD CLASS="f"><A HREF="#6">isLegal (boolean, String): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/8)</TD><TD CLASS="h">0%   (0/3)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#7">isTrue (boolean): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR><TD CLASS="f"><A HREF="#8">isTrue (boolean, String): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/15)</TD><TD CLASS="h">0%   (0/3)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#9">isNotNull (Object, String): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">21%  (3/14)</TD><TD CLASS="h">67%  (2/3)</TD></TR><TR><TD CLASS="f"><A HREF="#a">isNotNull (Object): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (4/4)</TD><TD>100% (2/2)</TD></TR></TABLE><P></P><TABLE CLASS="s" CELLSPACING="0" WIDTH="100%"><TR><TD CLASS="l">1</TD><TD>/*******************************************************************************</TD></TR><TR><TD CLASS="l">2</TD><TD> * Copyright (c) 2001, 2005 IBM Corporation and others.</TD></TR><TR><TD CLASS="l">3</TD><TD> * All rights reserved. This program and the accompanying materials</TD></TR><TR><TD CLASS="l">4</TD><TD> * are made available under the terms of the Eclipse Public License v1.0</TD></TR><TR><TD CLASS="l">5</TD><TD> * which accompanies this distribution, and is available at</TD></TR><TR><TD CLASS="l">6</TD><TD> * http://www.eclipse.org/legal/epl-v10.html</TD></TR><TR><TD CLASS="l">7</TD><TD> *</TD></TR><TR><TD CLASS="l">8</TD><TD> * Contributors:</TD></TR><TR><TD CLASS="l">9</TD><TD> *     IBM Corporation - initial API and implementation</TD></TR><TR><TD CLASS="l">10</TD><TD> *     Jens Lukowski/Innoopract - initial renaming/restructuring</TD></TR><TR><TD CLASS="l">11</TD><TD> *     </TD></TR><TR><TD CLASS="l">12</TD><TD> *******************************************************************************/</TD></TR><TR><TD CLASS="l">13</TD><TD>package org.eclipse.wst.sse.core.internal.util;</TD></TR><TR><TD CLASS="l">14</TD><TD> </TD></TR><TR><TD CLASS="l">15</TD><TD> </TD></TR><TR><TD CLASS="l">16</TD><TD>/**</TD></TR><TR><TD CLASS="l">17</TD><TD> * &lt;code&gt;Assert&lt;/code&gt; is useful for for embedding runtime sanity checks in</TD></TR><TR><TD CLASS="l">18</TD><TD> * code. The predicate methods all test a condition and throw some type of</TD></TR><TR><TD CLASS="l">19</TD><TD> * unchecked exception if the condition does not hold.</TD></TR><TR><TD CLASS="l">20</TD><TD> * &lt;p&gt;</TD></TR><TR><TD CLASS="l">21</TD><TD> * Assertion failure exceptions, like most runtime exceptions, are thrown when</TD></TR><TR><TD CLASS="l">22</TD><TD> * something is misbehaving. Assertion failures are invariably unspecified</TD></TR><TR><TD CLASS="l">23</TD><TD> * behavior; consequently, clients should never rely on these being thrown</TD></TR><TR><TD CLASS="l">24</TD><TD> * (and certainly should not being catching them specifically).</TD></TR><TR><TD CLASS="l">25</TD><TD> * &lt;/p&gt;</TD></TR><TR><TD CLASS="l">26</TD><TD> */</TD></TR><TR><TD CLASS="l">27</TD><TD>public final class Assert {</TD></TR><TR><TD CLASS="l">28</TD><TD> </TD></TR><TR><TD CLASS="l">29</TD><TD>        /**</TD></TR><TR><TD CLASS="l">30</TD><TD>         * &lt;code&gt;AssertionFailedException&lt;/code&gt; is a runtime exception thrown</TD></TR><TR><TD CLASS="l">31</TD><TD>         * by some of the methods in &lt;code&gt;Assert&lt;/code&gt;.</TD></TR><TR><TD CLASS="l">32</TD><TD>         * &lt;p&gt;</TD></TR><TR><TD CLASS="l">33</TD><TD>         * This class is not declared public to prevent some misuses; programs</TD></TR><TR><TD CLASS="l">34</TD><TD>         * that catch or otherwise depend on assertion failures are susceptible to</TD></TR><TR><TD CLASS="l">35</TD><TD>         * unexpected breakage when assertions in the code are added or removed.</TD></TR><TR><TD CLASS="l">36</TD><TD>         * &lt;/p&gt;</TD></TR><TR><TD CLASS="l">37</TD><TD>         */</TD></TR><TR><TD CLASS="l">38</TD><TD>        class AssertionFailedException extends RuntimeException {</TD></TR><TR><TD CLASS="l">39</TD><TD>                /**</TD></TR><TR><TD CLASS="l">40</TD><TD>                 * Comment for &lt;code&gt;serialVersionUID&lt;/code&gt;</TD></TR><TR><TD CLASS="l">41</TD><TD>                 */</TD></TR><TR><TD CLASS="l">42</TD><TD>                private static final long serialVersionUID = 1L;</TD></TR><TR><TD CLASS="l">43</TD><TD> </TD></TR><TR><TD CLASS="l"><A NAME="0">44</A></TD><TD>                /**</TD></TR><TR><TD CLASS="l">45</TD><TD>                 * Constructs a new exception.</TD></TR><TR><TD CLASS="l">46</TD><TD>                 */</TD></TR><TR><TD CLASS="l">47</TD><TD>                public AssertionFailedException() {</TD></TR><TR CLASS="z"><TD CLASS="l">48</TD><TD>                        super();</TD></TR><TR CLASS="z"><TD CLASS="l">49</TD><TD>                }</TD></TR><TR><TD CLASS="l">50</TD><TD> </TD></TR><TR><TD CLASS="l"><A NAME="2">51</A></TD><TD>                /**</TD></TR><TR><TD CLASS="l">52</TD><TD>                 * Constructs a new exception with the given message.</TD></TR><TR><TD CLASS="l">53</TD><TD>                 */</TD></TR><TR><TD CLASS="l">54</TD><TD>                public AssertionFailedException(String detail) {</TD></TR><TR CLASS="z"><TD CLASS="l">55</TD><TD>                        super(detail);</TD></TR><TR CLASS="z"><TD CLASS="l">56</TD><TD>                }</TD></TR><TR><TD CLASS="l">57</TD><TD>        }</TD></TR><TR><TD CLASS="l">58</TD><TD> </TD></TR><TR><TD CLASS="l">59</TD><TD>        /**</TD></TR><TR><TD CLASS="l">60</TD><TD>         * Asserts that an argument is legal. If the given boolean is not</TD></TR><TR><TD CLASS="l">61</TD><TD>         * &lt;code&gt;true&lt;/code&gt;, an &lt;code&gt;IllegalArgumentException&lt;/code&gt; is</TD></TR><TR><TD CLASS="l">62</TD><TD>         * thrown.</TD></TR><TR><TD CLASS="l">63</TD><TD>         * </TD></TR><TR><TD CLASS="l">64</TD><TD>         * @param expression</TD></TR><TR><TD CLASS="l">65</TD><TD>         *            the outcode of the check</TD></TR><TR><TD CLASS="l">66</TD><TD>         * @return &lt;code&gt;true&lt;/code&gt; if the check passes (does not return if the</TD></TR><TR><TD CLASS="l">67</TD><TD>         *         check fails)</TD></TR><TR><TD CLASS="l"><A NAME="3">68</A></TD><TD>         * @exception IllegalArgumentException</TD></TR><TR><TD CLASS="l">69</TD><TD>         *                if the legality test failed</TD></TR><TR><TD CLASS="l">70</TD><TD>         */</TD></TR><TR><TD CLASS="l">71</TD><TD>        public static boolean isLegal(boolean expression) {</TD></TR><TR CLASS="z"><TD CLASS="l">72</TD><TD>                return isLegal(expression, &#34;&#34;); //$NON-NLS-1$</TD></TR><TR><TD CLASS="l">73</TD><TD>        }</TD></TR><TR><TD CLASS="l">74</TD><TD> </TD></TR><TR><TD CLASS="l">75</TD><TD>        /**</TD></TR><TR><TD CLASS="l">76</TD><TD>         * Asserts that an argument is legal. If the given boolean is not</TD></TR><TR><TD CLASS="l">77</TD><TD>         * &lt;code&gt;true&lt;/code&gt;, an &lt;code&gt;IllegalArgumentException&lt;/code&gt; is</TD></TR><TR><TD CLASS="l">78</TD><TD>         * thrown. The given message is included in that exception, to aid</TD></TR><TR><TD CLASS="l">79</TD><TD>         * debugging.</TD></TR><TR><TD CLASS="l">80</TD><TD>         * </TD></TR><TR><TD CLASS="l">81</TD><TD>         * @param expression</TD></TR><TR><TD CLASS="l">82</TD><TD>         *            the outcode of the check</TD></TR><TR><TD CLASS="l">83</TD><TD>         * @param message</TD></TR><TR><TD CLASS="l">84</TD><TD>         *            the message to include in the exception</TD></TR><TR><TD CLASS="l">85</TD><TD>         * @return &lt;code&gt;true&lt;/code&gt; if the check passes (does not return if the</TD></TR><TR><TD CLASS="l">86</TD><TD>         *         check fails)</TD></TR><TR><TD CLASS="l"><A NAME="6">87</A></TD><TD>         * @exception IllegalArgumentException</TD></TR><TR><TD CLASS="l">88</TD><TD>         *                if the legality test failed</TD></TR><TR><TD CLASS="l">89</TD><TD>         */</TD></TR><TR><TD CLASS="l">90</TD><TD>        public static boolean isLegal(boolean expression, String message) {</TD></TR><TR CLASS="z"><TD CLASS="l">91</TD><TD>                if (!expression)</TD></TR><TR CLASS="z"><TD CLASS="l">92</TD><TD>                        throw new IllegalArgumentException();</TD></TR><TR CLASS="z"><TD CLASS="l">93</TD><TD>                return expression;</TD></TR><TR><TD CLASS="l">94</TD><TD>        }</TD></TR><TR><TD CLASS="l">95</TD><TD> </TD></TR><TR><TD CLASS="l">96</TD><TD>        /**</TD></TR><TR><TD CLASS="l">97</TD><TD>         * Asserts that the given object is not &lt;code&gt;null&lt;/code&gt;. If this is</TD></TR><TR><TD CLASS="l">98</TD><TD>         * not the case, some kind of unchecked exception is thrown.</TD></TR><TR><TD CLASS="l">99</TD><TD>         * </TD></TR><TR><TD CLASS="l">100</TD><TD>         * @param object</TD></TR><TR><TD CLASS="l">101</TD><TD>         *            the value to test</TD></TR><TR><TD CLASS="l"><A NAME="a">102</A></TD><TD>         * @exception IllegalArgumentException</TD></TR><TR><TD CLASS="l">103</TD><TD>         *                if the object is &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">104</TD><TD>         */</TD></TR><TR><TD CLASS="l">105</TD><TD>        public static void isNotNull(Object object) {</TD></TR><TR CLASS="c"><TD CLASS="l">106</TD><TD>                isNotNull(object, &#34;&#34;); //$NON-NLS-1$</TD></TR><TR CLASS="c"><TD CLASS="l">107</TD><TD>        }</TD></TR><TR><TD CLASS="l">108</TD><TD> </TD></TR><TR><TD CLASS="l">109</TD><TD>        /**</TD></TR><TR><TD CLASS="l">110</TD><TD>         * Asserts that the given object is not &lt;code&gt;null&lt;/code&gt;. If this is</TD></TR><TR><TD CLASS="l">111</TD><TD>         * not the case, some kind of unchecked exception is thrown. The given</TD></TR><TR><TD CLASS="l">112</TD><TD>         * message is included in that exception, to aid debugging.</TD></TR><TR><TD CLASS="l">113</TD><TD>         * </TD></TR><TR><TD CLASS="l">114</TD><TD>         * @param object</TD></TR><TR><TD CLASS="l">115</TD><TD>         *            the value to test</TD></TR><TR><TD CLASS="l">116</TD><TD>         * @param message</TD></TR><TR><TD CLASS="l">117</TD><TD>         *            the message to include in the exception</TD></TR><TR><TD CLASS="l"><A NAME="9">118</A></TD><TD>         * @exception IllegalArgumentException</TD></TR><TR><TD CLASS="l">119</TD><TD>         *                if the object is &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">120</TD><TD>         */</TD></TR><TR><TD CLASS="l">121</TD><TD>        public static void isNotNull(Object object, String message) {</TD></TR><TR CLASS="c"><TD CLASS="l">122</TD><TD>                if (object == null) {</TD></TR><TR><TD CLASS="l">123</TD><TD>                        //Logger.log(Logger.ERROR, &#34;null_argument: &#34; + message); //$NON-NLS-1$</TD></TR><TR CLASS="z"><TD CLASS="l">124</TD><TD>                        throw new Assert().new AssertionFailedException(message);</TD></TR><TR><TD CLASS="l">125</TD><TD>                }</TD></TR><TR CLASS="c"><TD CLASS="l">126</TD><TD>        }</TD></TR><TR><TD CLASS="l">127</TD><TD> </TD></TR><TR><TD CLASS="l">128</TD><TD>        /**</TD></TR><TR><TD CLASS="l">129</TD><TD>         * Asserts that the given boolean is &lt;code&gt;true&lt;/code&gt;. If this is not</TD></TR><TR><TD CLASS="l">130</TD><TD>         * the case, some kind of unchecked exception is thrown.</TD></TR><TR><TD CLASS="l">131</TD><TD>         * </TD></TR><TR><TD CLASS="l">132</TD><TD>         * @param expression</TD></TR><TR><TD CLASS="l">133</TD><TD>         *            the outcode of the check</TD></TR><TR><TD CLASS="l"><A NAME="7">134</A></TD><TD>         * @return &lt;code&gt;true&lt;/code&gt; if the check passes (does not return if the</TD></TR><TR><TD CLASS="l">135</TD><TD>         *         check fails)</TD></TR><TR><TD CLASS="l">136</TD><TD>         */</TD></TR><TR><TD CLASS="l">137</TD><TD>        public static boolean isTrue(boolean expression) {</TD></TR><TR CLASS="z"><TD CLASS="l">138</TD><TD>                return isTrue(expression, &#34;&#34;); //$NON-NLS-1$</TD></TR><TR><TD CLASS="l">139</TD><TD>        }</TD></TR><TR><TD CLASS="l">140</TD><TD> </TD></TR><TR><TD CLASS="l">141</TD><TD>        /**</TD></TR><TR><TD CLASS="l">142</TD><TD>         * Asserts that the given boolean is &lt;code&gt;true&lt;/code&gt;. If this is not</TD></TR><TR><TD CLASS="l">143</TD><TD>         * the case, some kind of unchecked exception is thrown. The given message</TD></TR><TR><TD CLASS="l">144</TD><TD>         * is included in that exception, to aid debugging.</TD></TR><TR><TD CLASS="l">145</TD><TD>         * </TD></TR><TR><TD CLASS="l">146</TD><TD>         * @param expression</TD></TR><TR><TD CLASS="l">147</TD><TD>         *            the outcode of the check</TD></TR><TR><TD CLASS="l">148</TD><TD>         * @param message</TD></TR><TR><TD CLASS="l">149</TD><TD>         *            the message to include in the exception</TD></TR><TR><TD CLASS="l"><A NAME="8">150</A></TD><TD>         * @return &lt;code&gt;true&lt;/code&gt; if the check passes (does not return if the</TD></TR><TR><TD CLASS="l">151</TD><TD>         *         check fails)</TD></TR><TR><TD CLASS="l">152</TD><TD>         */</TD></TR><TR><TD CLASS="l">153</TD><TD>        public static boolean isTrue(boolean expression, String message) {</TD></TR><TR CLASS="z"><TD CLASS="l">154</TD><TD>                if (!expression) {</TD></TR><TR CLASS="z"><TD CLASS="l">155</TD><TD>                        throw new Assert().new AssertionFailedException(message);</TD></TR><TR><TD CLASS="l">156</TD><TD>                }</TD></TR><TR CLASS="z"><TD CLASS="l">157</TD><TD>                return expression;</TD></TR><TR><TD CLASS="l"><A NAME="4">158</A></TD><TD>        }</TD></TR><TR><TD CLASS="l">159</TD><TD> </TD></TR><TR><TD CLASS="l">160</TD><TD>        /* This class is not intended to be instantiated. */</TD></TR><TR><TD CLASS="l">161</TD><TD>        private Assert() {</TD></TR><TR CLASS="z"><TD CLASS="l">162</TD><TD>                super();</TD></TR><TR CLASS="z"><TD CLASS="l">163</TD><TD>        }</TD></TR><TR><TD CLASS="l">164</TD><TD>}</TD></TR></TABLE><P></P><TABLE CLASS="hdft" CELLSPACING="0" WIDTH="100%"><TR><TD CLASS="nv">[<A HREF="../xslUnitTestCoverage.html">all classes</A>][<A HREF="6f.html">org.eclipse.wst.sse.core.internal.util</A>]</TD></TR><TR><TD CLASS="tl"><A HREF="http://www.eclemma.org/support.html">EMMA 2.0.5312 EclEmma Fix 1</A> (C) Vladimir Roubtsov</TD></TR></TABLE></BODY></HTML>