Source

main-silver / nbjunit / apichanges.xml

  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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
<?xml version="1.0" encoding="UTF-8"?>
<!--
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Other names may be trademarks of their respective owners.


The contents of this file are subject to the terms of either the GNU
General Public License Version 2 only ("GPL") or the Common
Development and Distribution License("CDDL") (collectively, the
"License"). You may not use this file except in compliance with the
License. You can obtain a copy of the License at
http://www.netbeans.org/cddl-gplv2.html
or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
specific language governing permissions and limitations under the
License.  When distributing the software, include this License Header
Notice in each file and include the License file at
nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the GPL Version 2 section of the License file that
accompanied this code. If applicable, add the following below the
License Header, with the fields enclosed by brackets [] replaced by
your own identifying information:
"Portions Copyrighted [year] [name of copyright owner]"

Contributor(s):

The Original Software is NetBeans. The Initial Developer of the Original
Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
Microsystems, Inc. All Rights Reserved.

If you wish your version of this file to be governed by only the CDDL
or only the GPL Version 2, indicate your decision by adding
"[Contributor] elects to include this software in this distribution
under the [CDDL or GPL Version 2] license." If you do not indicate a
single choice of license, a recipient has the option to distribute
your version of this file under either the CDDL, the GPL Version 2 or
to extend the choice of license to its licensees as provided above.
However, if you add GPL Version 2 code and therefore, elected the GPL
Version 2 license, then the option applies only if the new code is
made subject to such option by the copyright holder.
-->
<?xml-stylesheet type="text/xml" href="../nbbuild/javadoctools/apichanges.xsl"?>
<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../nbbuild/javadoctools/apichanges.dtd">


<apichanges>

    <!-- First, a list of API names you may use: -->
<apidefs>
   <apidef name="nbjunit">NetBeans JUnit Extensions</apidef>
   <apidef name="diff">Diff Support</apidef>
</apidefs>

    <!-- ACTUAL CHANGES BEGIN HERE: -->

<changes>
    <change id="branding.token">
        <api name="nbjunit"/>
        <summary>System property branding.token</summary>
        <version major="1" minor="72" subminor="2"/>
        <date day="1" month="12" year="2011"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                System.getProperty("<a href="@TOP@/architecture-summary.html#systemproperty-branding.token">branding.token</a>") 
                recognized and influences branding used during the test.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
        <issue number="197066"/>
    </change>
    <change id="NbModuleSuite.Configuration.hideExtraModules">
        <api name="nbjunit"/>
        <summary>NbModuleSuite.Configuration.hideExtraModules()</summary>
        <version major="1" minor="72"/>
        <date day="11" month="11" year="2011"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Now there is a way to disable not explicitly enabled modules.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
        <issue number="185291"/>
    </change>
    <change id="NbModuleSuite.Configuration.suite">
        <api name="nbjunit"/>
        <summary>NbModuleSuite.Configuration.suite()</summary>
        <version major="1" minor="70"/>
        <date day="19" month="5" year="2011"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                You may now call <code>suite()</code> directly on a <code>Configuration</code> object.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
        <issue number="197720"/>
    </change>
    <change id="NbModuleSuite.Configuration.addStartupArgument">
        <api name="nbjunit"/>
        <summary>NbModuleSuite.Configuration.addStartupArgument</summary>
        <version major="1" minor="69"/>
        <date day="8" month="4" year="2011"/>
        <author login="tomwheeler"/>
        <compatibility addition="yes"/>
        <description>
            <p>NbModuleSuite.Configuration now has a
                <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#addStartupArgument(java.lang.String...)">
                addStartupArgument</a>
                method which allows one to append one or more command line
                arguments which will be used to start the application.
                Arguments which must be passed directly to the JVM should
                still be specified in the <code>test.run.args</code> property.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
        <issue number="197065" />
    </change>
    <change id="NbTestCase.logRoot">
        <api name="nbjunit"/>
        <summary><code>NbTestCase.logRoot</code> to collect messages from just some code</summary>
        <version major="1" minor="68"/>
        <date day="5" month="5" year="2011"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Overridable method to avoid excessive logging of uninteresting components.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbTestCase"/>
        <issue number="197572"/>
    </change>
    <change id="NbModuleSuite.failOn">
        <api name="nbjunit"/>
        <summary>Easy way to fail the test on error or warning</summary>
        <version major="1" minor="58"/>
        <date day="15" month="3" year="2009"/>
        <author login="jtulach"/>
        <compatibility addition="yes" semantic="compatible" binary="compatible" source="compatible" modification="no"/>
        <description>
            <p>
            Do you need to fail the test when some wrong message or
            exception is logged? Easy now with
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#failOnMessage(java.util.logging.Level)">
                Configuration.failOnMessage(Level.WARNING)</a> and
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#failOnException(java.util.logging.Level)">
                Configuration.failOnException(Level.INFO)</a>.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
        <issue number="155444"/>
    </change>
    <change id="NbModuleSuite.honorAutoloadEager">
        <api name="nbjunit"/>
        <summary>Leave autoloads as autoloads and eagers as eager</summary>
        <version major="1" minor="57"/>
        <date day="13" month="2" year="2009"/>
        <author login="jtulach"/>
        <compatibility addition="yes" semantic="compatible" binary="compatible" source="compatible" modification="no"/>
        <description>
            <p>
            One can decide to <b>not</b> enable autoload modules
            by calling
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#honorAutoloadEager(boolean)">
                Configuration.honorAutoEager(true)</a>.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite.enableClasspathModules">
        <api name="nbjunit"/>
        <summary>Ignore modules on classpath</summary>
        <version major="1" minor="56"/>
        <date day="5" month="1" year="2009"/>
        <author login="jtulach"/>
        <compatibility addition="yes" semantic="compatible" binary="compatible" source="compatible" modification="no"/>
        <description>
            <p>
            One can decide to <b>not</b> include modules on classpath in the test
            by calling 
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#enableClasspathModules(boolean)">
                Configuration.enableClasspathModules(false)</a>.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite.enableModulesForCluster">
        <api name="nbjunit"/>
        <summary>Enable modules in a cluster</summary>
        <version major="1" minor="55"/>
        <date day="20" month="12" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes" semantic="incompatible" binary="compatible" source="compatible" modification="yes"/>
        <description>
            <p>
            It is now possible to easily enable modules in one cluster due
            to <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#enableModules(java.lang.String,%20java.lang.String)">
            Configuration.enableModules</a> method.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
        <issue number="153624"/>
    </change>
    <change id="NbModuleSuite.clustersMulti">
        <api name="nbjunit"/>
        <summary>NbModuleSuite's clusters method can be called multiple times</summary>
        <version major="1" minor="55"/>
        <date day="20" month="12" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes" semantic="incompatible" binary="compatible" source="compatible" modification="yes"/>
        <description>
            <p>Semantics of
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#clusters(java.lang.String)">
            Configuration.clusters</a> method has been extended. It can now be
            called multiple times to accumulate the results.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
        <issue number="153624"/>
    </change>
    <change id="Log.assertInstancesWithNames">
        <api name="nbjunit"/>
        <summary>Log.assertInstances can take list of names one is searching for</summary>
        <version major="1" minor="53"/>
        <date day="8" month="8" year="2008"/>
        <author login="mrkam"/>
        <compatibility addition="yes"/>
        <description>
            <p>Enhanced version of
            <a href="@TOP@/org/netbeans/junit/Log.html#assertInstances(java.lang.String,%20java.lang.String...)">
            assertInstances(String msg, String... types)</a> added.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite.Configuration.reuseUserDir">
        <api name="nbjunit"/>
        <summary>NbModuleSuite.Configuration.reuseUserDir(boolean reuse)</summary>
        <version major="1" minor="52"/>
        <date day="18" month="6" year="2008"/>
        <author login="mrkam"/>
        <compatibility addition="yes"/>
        <description>
            <p>NbModuleSuite.Configuration now has
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#reuseUserDir(boolean)">reuseUserDir(boolean)</a>
            method which enables test suite to reuse userdir from previous suite run.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite.Configuration.addTest">
        <api name="nbjunit"/>
        <summary>NbModuleSuite.Configuration.addTest(Class &lt; ? extends Test> test)</summary>
        <version major="1" minor="51"/>
        <date day="11" month="6" year="2008"/>
        <author login="jsedek"/>
        <compatibility addition="yes"/>
        <description>
            <p>NbModuleSuite.Configuration now has 
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#addTest(java.lang.Class)">addTest(java.lang.Class)</a>
            method which allows to add Test implementation classes into configuration
            and execution of the NbModuleSuite.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite.emptyConfiguration">
        <api name="nbjunit"/>
        <summary>NbModuleSuite.emptyConfiguration()</summary>
        <version major="1" minor="51"/>
        <date day="10" month="6" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>NbModuleSuite now has 
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.html#emptyConfiguration()">emptyConfiguration()</a>
            method which returns empty, ready to be configured configuration.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite.MultiTestCases">
        <api name="nbjunit"/>
        <summary>NbModuleSuite can now wrap multiple TestCase</summary>
        <version major="1" minor="50"/>
        <date day="3" month="6" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>NbModuleSuite.Configuration now has 
            <a href="@TOP@/org/netbeans/junit/NbModuleSuite.Configuration.html#addTest(java.lang.Class,%20java.lang.String...)">addTest(clazz, tests)</a>
            method which allows to add multiple test classes into single configuration
            and execution of the NbModuleSuite.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite.allModules">
        <api name="nbjunit"/>
        <summary>New Utilitity methods in NbModuleSuite</summary>
        <version major="1" minor="49"/>
        <date day="3" month="6" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>Shura requested few new methods to simplify creation of
            <code>NbModuleSuite</code>'s. Added, <code>allModules</code> and
            another variant of <code>create</code> to complement the general
            customization with <code>NbModuleSuite.Configuration</code>.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="NbModuleSuite">
        <api name="nbjunit"/>
        <summary>Support class to allow excution of unit tests inside of NetBeans Runtime Container</summary>
        <version major="1" minor="46"/>
        <date day="29" month="2" year="2008"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                It always used to be hard to setup the right environment for test
                execution. In case this NetBeans this is even harder. The module
                system is ready to work without classpath isolation, however 
                not every feature is available and not every
                behavior remains the same
                That is why there is now the new <code>NbModuleSuite</code>
                support class that allows to really start the whole NetBeans 
                Runtime Container, satisfy all the dependencies and only then 
                load the testing class and execute it.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbModuleSuite"/>
    </change>
    <change id="RandomlyFails">
        <api name="nbjunit"/>
        <summary>Added <code>@RandomlyFails</code></summary>
        <version major="1" minor="51"/>
        <date day="19" month="6" year="2008"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                New annotation added to easily mark tests
                which occasionally fail for no particular reason.
            </p>
        </description>
        <class package="org.netbeans.junit" name="RandomlyFails"/>
        <issue number="137069"/>
    </change>
    <change id="CollectData">
        <api name="nbjunit"/>
        <summary>Support for Garbage Collecting of Log Message Arguments</summary>
        <version major="1" minor="44"/>
        <date day="14" month="12" year="2007"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Methods <code>enableInstances</code> and 
                <code>assertInstances</code> added to <code>Log</code> class to
                simplify writing memory leaks tests integrated with
                <a href="http://wiki.netbeans.org/wiki/view/FitnessViaTimersCounters">timers/counters</a> infastructure.
            </p>
        </description>
        <class package="org.netbeans.junit" name="Log"/>
    </change>
    <change id="PreferencesForTests">
        <api name="nbjunit"/>
        <summary>Default implementation of Preferences isn't used for running tests anymore</summary>
        <version major="1" minor="38"/>
        <date day="13" month="10" year="2006"/>
        <author login="rmatous"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Not persistent implementation of <code>java.util.prefs.Preferences</code> 
                is installed in place of the platform-specific default implementation for running tests.
                See document
                <a href="@org-openide-util@/org/openide/util/doc-files/preferences.html">Preferences in NetBeans</a>
                to learn more.
            </p>
        </description>
        <class package="org.netbeans.junit" name="NbTestCase"/>
    </change>
    
    <change id="MockServicesAndLookup">
        <api name="nbjunit"/>
        <summary>Added class <code>MockServices</code></summary>
        <version major="1" minor="33"/>
        <date day="30" month="6" year="2006"/>
        <author login="jtulach"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                The MockServices class now supports closer cooperation
                with <code>Lookup</code>. By default, clients listening to
                <code>Lookup.Result</code> changes will be notified about
                change in its content whenever one calls <code>MockServices.setServices</code>.
            </p>
        </description>
        <class package="org.netbeans.junit" name="MockServices"/>
    </change>
    
    <change id="MockServices">
        <api name="nbjunit"/>
        <summary>Added class <code>MockServices</code></summary>
        <version major="1" minor="30"/>
        <date day="11" month="5" year="2006"/>
        <author login="jglick"/>
        <compatibility addition="yes"/>
        <description>
            <p>
                Added new utility to help unit tests create mock implementations
                of global services for lookup.
            </p>
        </description>
        <class package="org.netbeans.junit" name="MockServices"/>
    </change>
    
    <change id="controlFlow">
      <api name="nbjunit"/>
      <summary>Non-deterministic execution can be made deterministic</summary>
      <version major="1" minor="28"/>
      <date day="1" month="4" year="2006"/>
      <author login="jtulach"/>
      <compatibility addition="yes" binary="compatible" semantic="compatible" />
      <description>
        <p>An excelent tool to emulate race condition, deadlock or any other
        non-deterministic behaviour created in the form of
        <a href="@TOP@/org/netbeans/junit/Log.html#controlFlow(java.util.logging.Logger,%20java.util.logging.Logger,%20java.lang.String,%20int)">
        Log.controlFlow</a> method.
        </p>
      </description>
      <class package="org.netbeans.junit" name="NbTestCase"/>
      <class package="org.netbeans.junit" name="Log"/>
      <issue number="35067" />
    </change>


<change id="logging">
      <api name="nbjunit"/>
      <summary> Added support for logging</summary>
      <version major="1" minor="27"/>
      <date day="1" month="4" year="2006"/>
      <author login="jtulach"/>
      <compatibility addition="yes" binary="compatible" semantic="compatible" />
      <description>
        <p>Added two ways how to enable logging in a test case. One can
        either overwrite <a href="@TOP@/org/netbeans/junit/NbTestCase.html#logLevel()">NbTestCase.logLevel</a>
        method and return the right level to capture in the test and then
        all the messages logged with the level and greater will be sent
        to <a href="@TOP@/org/netbeans/junit/NbTestCase.html#getLog()">NbTestCase.getLog()</a>
        stream which is placed in working directory.
        </p>

        <p>
        Or one can directly call
        <a href="@TOP@/org/netbeans/junit/Log.html#enable(java.lang.String,%20java.util.logging.Level)">Log.enable</a>
        to capture all the logging into a <code>CharSequence</code>
        which can be later queried for its content, usually by calling <code>its.toString()</code>
        method.
        </p>
      </description>
      <class package="org.netbeans.junit" name="NbTestCase"/>
      <class package="org.netbeans.junit" name="Log"/>
      <issue number="35067" />
    </change>
</changes>

    <htmlcontents>
    <head>
      <title>Change History for the NetBeans JUnit Extensions API</title>
      <link rel="stylesheet" href="prose.css" type="text/css"/>
    </head>
    <body>

<p class="overviewlink"><a href="overview-summary.html">Overview</a></p>

<h1>Introduction</h1>

<p>This document lists changes made to the <a href="@TOP@/index.html">NetBeans JUnit Extensions</a> API.</p>

<!-- The actual lists of changes, as summaries and details: -->
      <hr/>
      <standard-changelists module-code-name="org.netbeans.modules.nbjunit"/>

      <hr/><p>@FOOTER@</p>

    </body>
  </htmlcontents>

</apichanges>