FlexUnit 4 Demo

这段时间正在使用FlexUnit进行测试驱动开发，这里试着翻译一下FlexUnit 4 wiki[部分]。系列文章打算在我的博客http://andychen0208.blogbus.com里翻译，以锻炼自己的英语水平。（英文不好，本着学习、讨教和共享的精神，希望大家鼓励和指正,原文请移步http://docs.flexunit.org/index.php?title=FlexUnit4FeatureOverview

FlexUnit 4 主要的新功能
     Test元数据
     在FlexUnit4中，使用命名为[Test]的元数据来标志Test Case，不再使用一些特殊的前缀[比如test等]来标志，同样,在特定的Test和Suite中也不需要了，并且所有的类不再需要继承自框架中任何类。以下是两个测试的例子： 

 [Test]
    public function addition():void { 
        Assert.assertEquals(12, simpleMath.add(7, 5)); 
    } 
    [Test] 
    public function subtraction():void { 
        Assert.assertEquals(9, simpleMath.subtract(12, 3)); 
    } 

  由于现在不需要从FlexUnit框架中派生出任何的类，你将会注意到你过去使用的“断言”方法（assertEquals, assertTrue），现在已经作为静态方法封装在Assert类了。在本文章之后，将告诉大家更多的新的“断言”方法。

     Before and After
     有时为了方便测试，你需要启动你的测试环境，比如上边的两个例子中，在测试运行之前，你需要确保simpleMath的引用或它的实例已经存在。在FlexUnit和FlexInt的前一版本中，你需要重构一个签名为setup()或者tearDown()的方法来完成这一个目标，而FlexUnit4引入了 Before 和After这两个元数据来实现同样的功能。只要标志为Before的方法，它将会在运行在所有的测试之前，而标志为After的方法则运行在有的测试之后，这也意味着在测试之前后测试之后可以定义多个方法。

 [Before]
    public function runBeforeEveryTest():void { 
        simpleMath = new SimpleMath(); 
    } 

    [Before]
    public function alsoRunBeforeEveryTest():void { 
        simpleMath1 = new SimpleMath(); 
    } 

    [After] 
    public function runAfterEveryTest():void { 
        simpleMath = null; 
        simpleMath1 = null; 
    } 

 如果你选择使用多个Before和After，你可以用order参数来控制他们运行的先后顺序.比如：

    [Before(order=1)]
    ...  
    [Before(order=2)]
    ...  
      BeforeClass and AfterClass
      标志为Before和After的方法分别运行在各测试方法之前和之后。而BeforeClass和AfterClass允许你定义一些静态方法，这些方法运行在整个测试类之前和之后，并且只运行一次。同样和Before、After一样，你也可以定义多个标志为BeforeClass和AfterClass的方法，并且通过order参数来控制他们的先后顺序。比如：  

  [BeforeClass]
    public static function runBeforeClass():void { 
        // run for one time before all test cases 
    } 

    [AfterClass] 
    public static function runAfterClass():void { 
        // run for one time after all test cases 
    }

  Exception Handling [异常处理]

      Test metadata can also have an expects parameter. The expects parameter allows you to indicate that a given test is expected to throw an exception. If the test throws the named exception it is considered a success, if it does not, it is considered a failure. This prevents us from having to write tests wrapped in a try block with an empty catch. 
      Test元数据中同样存在一个命名为expects的参数，这个expects参数允许你指示一个给定的测试去捕获一个异常。如果这个测试抛出了这个指定的异常，那么我们认为是测试成功的，否则认为是测试失败的。这就可以避免我们不得不去写一个用try catch语句包裹的而catch语句中什么也没干的测试。 

 [Test(expects="flash.errors.IOError")] 
    public function doIOError():void { 
        //a test which causes an IOError }Or 

    [Test(expects="TypeError")] 
    public function divisionWithException():void { 
        simpleMath.divide( 11, 0 );
    }

 Ignore [忽略] 

     Ignore metadata can be added before any test case you want to ignore. You can also add a string which indicates why you are ignoring the test. Unlike commenting out a test, these tests will still appear in the output reminding you to fix and/or complete these methods. 
     Ignore元数据可以添加在你想忽略测试的任何测试用例前，你也可以添加一个用来说明你为什么要忽略该测试的字符串。不同于注释掉的测试，用Ignore元数据标志的测试将依然出现在输出的结果中，以提醒你确定或完成这些测试方法。

 [Ignore("Not Ready to Run")] 
    [Test] 
    public function multiplication():void { 
        Assert.assertEquals(15, simpleMath.multiply(3, 5)); 
    }

 Async [异步] 

    In previous versions of FlexUnit it was difficult to have multiple asynchronous events and to test code that was event driven but not always asynchronous. Fluint provides enhanced asynchronous support including asynchronous setup and teardown, but every test carried the overhead of the asynchronous code to facilitate this feature. FlexUnit 4 allows the developer to specify which tests need asynchronous support using the async parameter. When provided, the async parameter enables the full asynchronous support provided by Fluint for that particular test. When the async parameter is specified you may also specify an optional timeout for the method. 
      在FlexUnit的前一版本中，拥有多个异步事件以及对那些定义为事件驱动但不一定是异步的代码进行测试是比较困难的。Fluint以包含异步构造（setup）和析构（teardown）的方式提供了强化的异步支持，但为了促进这一功能，每一个测试增加异步代码的开销。FlexUnit4允许开发者使用async参数来指定哪些测试需要异步支持。当async参数被提供后，它使得由Fluint为那些特定的测试提供的完全异步支持成为可能。在async参数被指定时，你也可以为这个方法说明一个timeout的可选项。

 [Before(async,timeout="250")] 
    public function setMeUp():void { 
    }

    [After(async,timeout="250")] 
    public function allDone():void { 
    }

    [Test(async,timeout="500")] 
    public function doSomethingAsynchronous():void { 
        //Async.proceedOnEvent( testCase, target, eventName ); 
        //Async.failOnEvent( testCase, target, eventName ); 
        //Async.handleEvent( testCase, target, eventName, eventHandler ); 
        //Async.asyncHandler( testCase, eventHandler ); 
        //Async.asyncResponder( testCase, responder ); 
    }

 In addition to the async parameter, there are several new Async methods, each of which can also take individual timeouts, handlers and passThroughData. 

    除了async参数外，这里还有几个新的Async方法，每个方法也能带自己的timeouts, handlers 和passThroughData.