annotate bindings/as3/ext/asunit/framework/TestSuite.as @ 770:c54bc2ffbf92 tip

update tags

package asunit.framework {
    import asunit.util.ArrayIterator;
    import asunit.util.Iterator;
    
    import flash.display.DisplayObjectContainer;
    import flash.events.Event;
    
    /**
     *  A <code>TestSuite</code> is a <code>Composite</code> of Tests.
     *  
     *  @see Test
     *  @see TestCase
     *  
     *  @includeExample TestSuiteExample.as
     */
    public class TestSuite extends TestCase implements Test {
        private var fTests:Array = new Array();
        private var testsCompleteCount:Number = 0;
        private var iterator:ArrayIterator;
        private var isRunning:Boolean;

         public function TestSuite() {
             super();
             fTests = new Array();
        }

        protected override function setTestMethods(methodNodes:XMLList):void {
            testMethods = new Array();
        }
        
        /**
         * Adds a test instance to the suite.
         */
        public function addTest(test:Test):void {
			if (!test.getIsComplete())
            	fTests.push(test);
        }
        
        /**
         * Counts the number of tests that will be run by this Suite.
         */
        public override function countTestCases():int {
            var count:int;
            for each(var test:TestCase in fTests) {
                count = count + test.countTestCases();
            }
            return count;
        }
        
        /**
         * Runs the tests and collects their result in a TestResult.
         */
        public override function run():void {
            var result:TestListener = getResult();
            var test:Test;
            var itr:Iterator = getIterator();
            while(itr.hasNext()) {
                isRunning = true;
                test = Test(itr.next());
                test.setResult(result);
                test.addEventListener(Event.COMPLETE, testCompleteHandler);
                test.run();
                if(!test.getIsComplete()) {
                    isRunning = false;
                    break;
                }
            }
        }

        private function getIterator():ArrayIterator {
            if(iterator == null) {
                iterator = new ArrayIterator(fTests);
            }
            return iterator;
        }
        
        private function testCompleteHandler(event:Event):void {
            if(!isRunning) {
                run();
            }
            if(++testsCompleteCount >= testCount()) {
                dispatchEvent(new Event(Event.COMPLETE));
            }
        }
        
        /**
         * Returns the number of tests in this suite
         */
        public function testCount():int {
            return fTests.length;
        }
        
        public override function toString():String {
            return getName();
        }
        
        public override function getIsComplete():Boolean {
            for each(var test:TestCase in fTests) {
                if(!test.getIsComplete()) {
                    return false;
                }
            }
            return true;
        }
        
        public override function setContext(context:DisplayObjectContainer):void {
            super.setContext(context);
            for each(var test:Test in fTests) {
                test.setContext(context);
            }
        }
    }
}