testable-mock/docs/zh-cn/doc/private-accessor.md

20 lines
1.5 KiB
Markdown
Raw Normal View History

2020-11-22 22:12:51 +08:00
访问私有成员字段和方法
---
2020-11-28 17:03:39 +08:00
如今关于私有方法是否应该做单元测试的争论正逐渐消停,开发者的普遍实践已经给出事实答案。通过公有方法间接测私有方法在很多情况下难以进行,开发者们更愿意通过修改方法可见性的办法来让原本私有的方法在测试用例中变得可测。
此外在单元测试中时常会需要对被测对象进行特定的成员字段初始化但有时由于被测类的构造方法限制使得无法便捷的对这些字段进行赋值。那么能否在不破坏被测类型封装的情况下允许单元测试用例内的代码直接访问被测类的私有方法和成员变量呢TestableMock提供了一种简单的解决方案。
2020-11-22 22:12:51 +08:00
只需为测试类添加`@EnablePrivateAccess`注解,即可在测试用例中获得以下增强能力:
- 调用被测类的私有方法
- 读取被测类的私有成员
- 修改被测类的私有成员
- 修改被测类的常量成员使用final修饰的成员
2020-11-28 17:03:39 +08:00
访问和修改私有、常量成员时IDE可能会提示语法有误但编译器将能够正常运行测试。使用编译期代码增强目前仅实现了Java语言的适配
2020-11-22 22:12:51 +08:00
2020-11-28 17:03:39 +08:00
若不希望看到IDE的语法错误提醒或是在非Java语言的JVM工程譬如Kotlin语言也可以借助`PrivateAccessor`工具类来实现私有成员的访问。
2020-11-22 22:12:51 +08:00
效果见`java-demo`和`kotlin-demo`示例项目`DemoPrivateAccessTest`测试类中的用例。