单元测试 - 金融分布式架构 SOFAStack

SOFABoot 工程原型提供两类单元测试：

抽象类的测试基类
继承抽象测试基类的测试子类

本文将以 SOFABoot Web 工程的测试类为例，对测试类的测试逻辑进行说明。

说明

SOFABoot Core 工程的测试类，测试逻辑比较简单，可参考 SOFABoot Web 工程，不再详细说明。

测试类路径：

测试基类（AbstractTestBasesrc）：
projectName/app/web/src/main/test/java/.../base/AbstractTestBase.java
测试子类（SofaRestServiceTest）： projectName/app/web/src/main/test/java/.../usercases/SofaRestServiceTest.java

更多单元测试的资料可以参考 Spring Boot 官方文档。

测试基类

示例代码

以下为默认生成的 AbstractTestBase.java 测试基类的示例代码：

/**
 * 参考文档: http://docs.spring.io/spring-boot/docs/1.4.2.RELEASE/reference/htmlsingle/#boot-features-testing
 */
@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest(classes = SOFABootWebSpringApplication.class, webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT)
public abstract class AbstractTestBase {

    public static final String SOFA_REST_PORT = "8341";

    @Autowired
    public EmbeddedWebApplicationContext server;

    /**
     * 8080
     */
    @LocalServerPort
    public int definedPort;


    @Autowired
    public TestRestTemplate testRestTemplate;

    public String urlHttpPrefix;

    public String sofaRestHttpPrefix;

    @Before
    public void setUp() {
        sofaRestHttpPrefix = "http://localhost:" + SOFA_REST_PORT;
        urlHttpPrefix = "http://localhost:" + definedPort;
        childSetUp();
    }

    /**
     * 测试子类每个方法执行前需要进行的初始化代码放在此
     */
    public abstract void childSetUp();

}

代码解读

@SpringBootTest 的参数：
- SOFABootWebSpringApplication 类：是 SOFABoot 的启动函数。在运行单元测试时，能直接启动 SOFABoot 框架，并完成所有依赖中间件的自动配置和启动。
- webEnvironment：用以配置 Servlet 环境。DEFINED_PORT 表示，该模式会提供一个真实的 Servlet 环境，使用内嵌的容器，但是使用定义好的端口。
注入的 bean：
- EmbeddedWebApplicationContext 实例：用于测试用户上下文。
- TestRestTemplate 实例：用于测试 REST 功能的模板实例。

测试子类

示例代码

以下为默认生成的 SofaRestServiceTest.java 测试类的示例代码：

public class SofaRestServiceTest extends AbstractTestBase {

    @Test
    public void testSofaRestGet() throws Exception {
        assertNotNull(testRestTemplate);
        String restUrl = sofaRestHttpPrefix + "/webapi/users/xiaoming";
//注意：RestSampleFacadeResp 一定要有默认构造函数
        ResponseEntity<RestSampleFacadeResp> response = testRestTemplate.getForEntity(restUrl, RestSampleFacadeResp.class);
        RestSampleFacadeResp restSampleFacadeResp = response.getBody();
        assertTrue(restSampleFacadeResp.isSuccess());
//注意：这里仅供测试使用，使用的是 jackson 不支持泛型的反序列化，所以被反序列化为 map。
//  使用详情请参考文档：http://docs.spring.io/spring-boot/docs/1.4.2.RELEASE/reference/htmlsingle/#boot-features-testing
        Map<String, Integer> demoUserModel = (Map<String, Integer>) restSampleFacadeResp.getData();
        assertTrue(demoUserModel.get("userId") >= 0);
    }
}

代码解读

通过继承关系，子类可以从基类中获取下述信息：
- 基类注入的 TestRestTemplate 实例
- REST 端口号 8341
- 待测试的 SOFAREST 的 URL：用来测试 SOFAREST 的功能，根据返回的数据结果进行校验
测试逻辑
- TestRestTemplate 会发起 restUrl 请求，并返回 response 对象。
- response 对象通过 getBody() 方法，获取 restSampleFacadeResp 对象，通过 assertTrue() 方法对获取的数据进行判断。
- restSampleFacadeResp 对象通过 getData() 方法，获取 SampleRestFacadeRestImpl 中的默认数据，并通过 assertTrue() 方法对获取的数据进行判断。
测试结果验证
- 方式 1：可以通过 IDEA 运行测试类 SofaRestServiceTest，通过测试时，控制台会提示：“Tests passed: 1 of 1 test”。
- 方式 2：运行 SOFABootWebSpringApplication 类，然后在浏览器地址栏输入：http://localhost:8341/webapi/users/xiaoming，则输出结果如下图所示。

常见问题

项目正常启动，REST 无法正常访问，报错信息提示 processValue() 方法异常。

现象

运行 SOFABootWebSpringApplication 类，项目正常启动。
在浏览器地址栏输入：http://localhost:8341/webapi/users/xiaoming 后，没有输出结果。

查看 /logs/rest/common-error.log ，有下述报错信息：

[SOFA-REST-WORK-3-1] ERROR c.a.sofa.rest.server.netty.support.RequestHandler-Unexpected java.lang.NoSuchMethodError: com.alibaba.fastjson.serializer.JavaBeanSerializer.processValue(Lcom/alibaba/fastjson/serializer/JSONSerializer;Lcom/alibaba/fastjson/serializer/BeanContext;Ljava/lang/Object;Ljava/lang/String;Ljava/lang/Object;)Ljava/lang/Object;Ljava/lang/Integer

原因

上述错误主要是由于 Fastjson 版本 1.2.62 不兼容 1.2.60 以前的方法 JavaBeanSerializer.processValue 造成的。

解决方案

可以在主 pom.xml 中引入 fastjson 1.2.60 版本的依赖即可解决，示例如下：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.60</version>
</dependency>