update release note

This commit is contained in:
金戟 2020-11-18 11:03:53 +08:00
parent 401b5f83d7
commit 2ae34e0b41
5 changed files with 18 additions and 8 deletions

View File

@ -1,10 +1,10 @@
常见用问题
常见使用问题
---
**1. 如何Mock被测类中通过`@Autowired`初始化的字段?**
#### 1. 如何Mock被测类中通过`@Autowired`初始化的字段?
直接创建被测类对象,然后利用`TestableMock`访问私有成员的能力直接给这些字段赋值即可。
**2. 通过<u>接口对象或基类对象</u>指向派生类的实例,调用执行了派生类实现的方法。使用`@TestableMock`定义Mock方法时首个参数类型应该用 接口/基类 还是 派生类?**
#### 2. 通过<u>接口对象或基类对象</u>指向派生类的实例,调用执行了派生类实现的方法。使用`@TestableMock`定义Mock方法时首个参数类型应该用 接口/基类 还是 派生类?
应该使用 接口/基类 类型,参见`should_able_to_mock_override_method`测试用例。

4
docs/introduction.md Normal file
View File

@ -0,0 +1,4 @@
TestableMock简介
---
TBD

View File

@ -1,19 +1,19 @@
已知问题
---
**1. 访问私有方法或私有成员代码在IDE提示语法错误**
#### 1. 访问私有方法或私有成员代码在IDE提示语法错误
使用`@EnablePrivateAccessor`注解后访问私有方法或成员变量虽然能正常通过编译但在IDE上依然会提示语法错误。
这个问题与使用`Lombok`工具库后使用生成的`getter`和`setter`会被IDE报语法错误一样需要通过IDE插件来解决。
当前`TestableMock`尚未提供相关插件。也可以改用`PrivateAccessor`工具类来访问私有成员来避免IDE的异常信息。
**2. 通过IDE运行单个测试用例时Mock功能失效**
#### 2. 通过IDE运行单个测试用例时Mock功能失效
这是由于IDE运行单个测试用例时只会运行`maven-surefire-plugin`插件,跳过了`testable-maven-plugin`插件执行导致Mock功能所需的JavaAgent没有随测试启动。
解决方法有两种:
**方法一**:在单元测试配置的"虚拟机参数VM Option"属性值末尾添加JavaAgent启动参数`-javaagent:${HOME}/.m2/repository/com/alibaba/testable/testable-agent/0.2.2/testable-agent-0.2.2.jar`
**方法一**:在单元测试配置的"虚拟机参数VM Option"属性值末尾添加JavaAgent启动参数`-javaagent:${HOME}/.m2/repository/com/alibaba/testable/testable-agent/0.3.0/testable-agent-0.3.0.jar`
> PS请将路径中的版本号替换成实际使用的版本号

View File

@ -1,10 +1,12 @@
# Release Note
## upcoming version
- support share mock method between test classes
- support detail log of mocking process for diagnosis
## v0.3.0
- add `without()` checker to verify mock method never invoked with specified parameters
- support fuzz matcher when verifying mock invocation
- add `@MockWith` annotation to support share mock method between test classes
- add method to print detail log of mocking process for debugging
## v0.2.2
- support mock method parameters check

4
docs/troubleshooting.md Normal file
View File

@ -0,0 +1,4 @@
自助问题排查
---
TBD