easymock-2.4

The following examples use the interface Collaborator : 以下例子使用Collaborator 接口：
package org.easymock.samples; public interface Collaborator { void documentAdded(String title); void documentChanged(String title); void documentRemoved(String title); byte voteForRemoval(String title); byte[] voteForRemovals(String[] title); } Implementors of this interface are collaborators (in this case listeners) of a class named ClassUnderTest : 这个接口的实现者就是ClassUnderTest 类的协作者（此例中为listeners）： public class ClassUnderTest { // ... public void addListener(Collaborator listener) { // ... } public void addDocument(String title, byte[] document) { // ... } public boolean removeDocument(String title) { // ... } public boolean removeDocuments(String[] titles) { // ... } } The code for both the class and the interface may be found in the package org.easy mock.samples in samples.zip . 类和接口的代码都可以在samples.zip 的org.easy mock.samples 包中找到。
Writing and maintaining Mock Objects often is a tedious task that may introduce errors. EasyMock 2 generates Mock Objects dynamically - no need to write them, and no generated code! 编写和维护模拟对象常常是一件很无聊却又容易出错的工作。EasyMock 2能动态生成模拟对象—— 不需要 编写模拟对象的代码，因此也不会产生生成代码！
The source code of EasyMock is stored in the zip file src.zip . EasyMock的源代码储存在src.zip 文件中。
Usage - 使用
Most parts of a software system do not work in isolation, but collaborate with other parts to get their job done. In a lot of cases, we do not care about using collaborators in unit testing, as we trust these collaborators. If we do care about it, Mock Objects help us to test the unit under test in isolation. Mock Objects replace collaborators of the unit under test. 软件系统中的绝大多数部件不能独立工作，而需要与其他部件协作，才能完成任务。很多情况下，我们在 进行单元测试的时候，并不担心这些协作者能不能正常工作，因为我们相信它们。但如果我们实在不放心 ， 模拟对象可以帮我们独立测试要测试的单元。模拟对象代替了测试单元的协作者。
-English bilingual Documentation EasyMock 2.4 Chinese ChineseEasyMock 2.4 中英文文档
译者：cool8jay
最后更新时间：2008年8月6日 如发现任何翻译错误，请来信告知，以便修正。 E-mail: cool8jay@ Website:
� �
EasyMock 2 Drawbacks - EasyMock 2 的不足
�
EasyMock 2 does only work with Java 2 Version 5.0 and above. EasyMock 2 只支持Java 2 5.0及以上的版本。
EasyMock by default supports the generation of Mock Objects for interfaces only. For those who would like to generate Mock Objects for classes, there is an extension available at the EasyMock home page. EasyMock 默认只支持为接口生成模拟对象。如果需要为类生成模拟对象，在EasyMock主页上有一个扩 展类可以实现这个功能。
The first Mock Object - 第一个模拟对象
We will now build a test case and toy around with it to understand the functionality of the EasyMock
package. samples.zip contains a modified version of this test. Our first test should check whether the removal of a non-existing document does not lead to a notification of the collaborator. Here is the test without the definition of the Mock Object: 现在，我们建立一个测试用例，围绕它来理解EasyMock 的功能。Samples.zip 中有这个测试用例的修改 版本。我们的第一项测试，验证删除一个不存在的文档时，不会通知协作者。以下是没有定义模拟对象的 测试： package org.easymock.samples; import junit.framework.TestCase; public class ExampleTest extends TestCase { private ClassUnderTest classUnderTest; private Collaborator mock; protected void setUp() { classUnderTest = new ClassUnderTest(); classUnderTest.addListener(mock); } public void testRemoveNonExistingDocument() { // This call should not lead to any notification of the Mock Object: // 这个调用应该不会向模拟对象发送任何通知 classUnderTest.removeDocument("Does not exist"); } } For many tests using EasyMock 2, we only need a static import of methods of org.easymock.EasyMock. This is the only non-internal, non-deprecated class of EasyMock 2. 对于使用EasyMock 2的大部分测试，我们只需要静态引入org.easymock.easymock的所有方法。这是 EasyMock 2中唯一的非内部，非不推荐的类。 import static org.easymock.EasyMock.*; import junit.framework.TestCase; public class ExampleTest extends TestCase { private ClassUnderTest classUnderTest; private Collaborator mock; } To get a Mock Object, we need to 要得到一个模拟对象，我们需要 1. 2. create a Mock Object for the interface we would like to simulate, 创建一个我们要模拟的接口的模拟对象， record the expected behavior, and 纪录预期的行为，
EasyMock 2.4 Readme - EasyMock 2.4自述文件
Documentation for release 2.4 (July 2 2008) 正式发布版2.4的文档（2008 年7月2日） © 2001-2008 OFFIS , Tammo Freese. EasyMock 2 is a library that provides an easy way to use Mock Objects for given interfaces. EasyMock 2 is available under the terms of the MIT license. EasyMock 2是一个通过简单的方法为给定接口生成模拟对象的类库。EasyMock 2基于MIT 许可条款发布。
Mock Objects simulate parts of the behavior of domain code, and are able to check whether they are used as defined. Domain classes can be tested in isolation by simulating their collaborators with Mock Objects. 模拟对象能够模拟领域对象的部分行为，并且能够检验领域对象是否按照定义的那样被使用。通过使用模 拟对象模拟领域类的协作者，可以为领域类营造一个隔离的测试环境。