死鬼,你真的知道如何编写单元测试吗?
本文的宗旨在于通过简单干净实践的方式教会读者,如何使用 Mock 进行工程的单元测试,以便于验证系统中的独立模块功能的健壮性。
从整个工程所处不同阶段的测试手段包括;单元测试、集成测试、系统测试、验收测试、性能测试、安全测试、回归测试,以及兼容、可靠、可用性测试。
而单元测试的重点在于,对工程开发中的代码,进行流程中的单元化测试。如一整个下单流程中,需要调用各项外部的接口(风控、账户、营销、试算、支付),才能完成整个下单流程。但在本地开发过程中,不太能将所有的外部接口都调试为开发环境可用状态,所有这个时候要做单元化测试,对于一些不能随时提供服务的接口进行 Mock 处理。
本文涉及的工程:
- xfg-dev-tech-mock:https://gitcode.net/KnowledgePlanet/road-map/xfg-dev-tech-mock
- chatglm-sdk-java:https://gitcode.net/KnowledgePlanet/road-map/chatglm-sdk-java
一、案例背景
因为 Mock 单元测试的重点,主要体现在;功能流程较长、调用外部接口稳定性较差、测试过程中希望可以不启动 SpringBoot 应用就能对单个功能模块进行测试验证。
所以本章节带着这样一个案例背景的情况,小傅哥带着大家把 《HTTP 框架使用和场景实战 - 结合ChatGLM自动回帖!》 做一个小重构。来对 Mock 框架进行验证使用。
- 首先,这里使用 DDD 工程模型结构,搭建出测试工程。—— DDD 是一种软件设计方法,而软件的设计方法涵盖了;范式、模型、框架、方法论。所以通常下 MVC 与 DDD 的对比先从模型、框架在到思想设计和方法论。
- 之后,我们在这样的一个模型结构下,实现出自动回帖的领域功能。而这个模型的实现恰好需要调用外部的接口和 ChatGLM SDK,这与我们要做的 Mock 测试正好符合,因为在大部分开发场景下,远程的 HTTP 调用可能不不会一直可用,所以可以用 Mock 方式进行模拟。
二、功能实现
1. 工程结构
- 在 domain 中实现一个zsxq的自动回帖领域,而它所需的要调用的接口则由基础设施层提供。
- 另外在 app 中还有 ChatGLM SDK 的配置启动,也会被注入到 AiReply 实现类中。
2. Ai模块启动
# ChatGLM SDK Config
chatglm:
sdk:
config:
# 状态;true = 开启、false 关闭
enabled: false
# 官网地址
api-host: https://open.bigmodel.cn/
# 官网申请 https://open.bigmodel.cn/usercenter/apikeys
api-secret-key: d570f7c5d289cdac2abdfdc562e39f3f.trqz1dH8ZK6E***
@Bean
@ConditionalOnProperty(value = "chatglm.sdk.config.enabled", havingValue = "true", matchIfMissing = false)
public OpenAiSession openAiSession(ChatGLMSDKConfigProperties properties) {
// 1. 配置文件
cn.bugstack.chatglm.session.Configuration configuration = new cn.bugstack.chatglm.session.Configuration();
configuration.setApiHost(properties.getApiHost());
configuration.setApiSecretKey(properties.getApiSecretKey());
// 2. 会话工厂
OpenAiSessionFactory factory = new DefaultOpenAiSessionFactory(configuration);
// 3. 开启会话
return factory.openSession();
}
- 所有的这些配置类的服务,都可以放到 app下的 config 模块中。
- ChatGLM 可以直接在官网申请,默认会赠送18元的额度,对于它所提供的模型,还是非常够测试使用的。
3. 基础设置 - 接口调用
3.1 接口 - 防腐对接
源码:cn.bugstack.xfg.dev.tech.infrastructure.gateway.api.IZSXQApi
public interface IZSXQApi {
/**
* 查询知识星球帖子内容
*
* @return 帖子数据
* @throws IOException 异常
*/
ResponseDTO topics() throws IOException;
/**
* 回复帖子
*
* @param topicId 帖子ID
* @param content 回复内容
*/
void comment(long topicId, String content);
}
- 在基础设置层中定义 gateway 网关接口调用,对于外部的接口使用,中间要做一层防腐,不要直接把外部的接口暴露出去使用。
3.2 使用 - 依赖倒置
源码:cn.bugstack.xfg.dev.tech.infrastructure.gateway.adapter.ZSXQAdapter
public class ZSXQAdapter implements IZSXQAdapter {
@Resource
private IZSXQApi zsxqApi;
@Override
public List<TopicsItemVO> queryTopics() {
try {
ResponseDTO responseDTO = zsxqApi.topics();
RespData respData = responseDTO.getRespData();
List<TopicsItem> topics = respData.getTopics();
List<TopicsItemVO> topicsItemVOList = new ArrayList<>();
for (TopicsItem topicsItem : topics) {
TopicsItemVO topicsItemVO = TopicsItemVO.builder()
.topicId(topicsItem.getTopicId())
.talk(topicsItem.getTalk().getText())
.showCommentsItems(topicsItem.getShowComments() != null ? topicsItem.getShowComments().stream()
.map(showCommentsItem -> {
TopicsItemVO.ShowCommentsItem item = new TopicsItemVO.ShowCommentsItem();
item.setUserId(showCommentsItem.getOwner().getUserId());
return item;
})
.collect(Collectors.toList()) : new ArrayList<>())
.build();
topicsItemVOList.add(topicsItemVO);
}
return topicsItemVOList;
} catch (IOException e) {
throw new RuntimeException(e);
}
}
@Override
public boolean comment(long topicId, String content) {
zsxqApi.comment(topicId, content);
return true;
}
}
- 注意,TopicsItemVO 对象来自于 domain 下领域中模型下的 VO 对象。因为是依赖倒置的,所以 infrastructure 引用的是 domain 并对其接口做实现处理。
- 并且,TopicsItemVO 只是需要获取自己需要的对象,还可以做简单的封装处理。这样可以衔接外部接口和内部逻辑中间的桥梁,不做强关联。
4. 任务调度
源码:cn.bugstack.xfg.dev.tech.job.ReplyJob
public class ReplyJob {
@Resource
private IAiReply aiReply;
@Scheduled(cron = "0/10 * * * * ?")
public void exec() throws Exception {
log.info("自动回帖任务开始执行...");
aiReply.doAiReply();
}
}
- 现在在 trigger 触发器层中的 job 下,就可以调用我们已经实现好的 AiReply 自动回帖功能了。
- 此外,注意 Application 中
@EnableScheduling
注解是开启的,否则任务不能执行。
三、系统测试
1. 集成测试
@Slf4j
@RunWith(SpringRunner.class)
@SpringBootTest
public class ApiTest {
@Resource
private IAiReply aiReply;
@Test
public void test_IAiReply() {
aiReply.doAiReply();
}
}
- 通常情况下这种测试是最多的,写多少功能,就直接测试调用。如功能中所用到的;HTTP接口、RPC接口、数据库、Redis等资源,都会需要使用到。有时候也因为这样,所以不好测试。那么单元测试就出现了。
2. 单元测试
@Slf4j
@RunWith(SpringRunner.class)
@SpringBootTest
public class MockTest {
@Resource
private IAiReply aiReply;
@MockBean
private IZSXQAdapter izsxqAdapter;
@Test
public void test_doAiReply() throws InterruptedException, JsonProcessingException {
Mockito.when(izsxqAdapter.queryTopics()).thenReturn(new ArrayList<TopicsItemVO>() {{
TopicsItemVO topicsItemVO = new TopicsItemVO();
topicsItemVO.setTopicId(10001L);
topicsItemVO.setTalk("<e type=\"mention\" uid=\"241858242255511\" title=\"%40%E5%B0%8F%E5%82%85%E5%93%A5\" /> 提问 java 冒泡排序");
add(topicsItemVO);
}});
Mockito.when(izsxqAdapter.comment(Mockito.anyLong(), Mockito.anyString())).thenReturn(true);
aiReply.doAiReply();
// 等待;ChatGLM 异步回复
new CountDownLatch(1).await();
}
}
- 在基于使用 SpringBoot 的启动,以及一部分功能需要走真实调用的情况下,另外一部分功能的接口可能没法调用时。可以使用这样的一种 MockBean 的方式进行处理,并对整条链路上调用到的接口方法进行 Mock 处理。`Mockito.when(调用到的接口).thenReturn(返回的结果);
- 那么现在在测试方法中,做了2个Mock操作,把查询帖子和回复帖子,都给处理掉。也就是有了 Mock 以后,程序调用到这里,就直接走 Mock 里设置的结果信息了。
3. 功能测试
@Slf4j
@RunWith(MockitoJUnitRunner.class)
public class ZSXQAdapterTest {
@Mock
private IZSXQApi mockZsxqApi;
@InjectMocks
private ZSXQAdapter zsxqAdapterUnderTest;
@Test
public void testQueryTopics() throws Exception {
// Setup
final List<TopicsItemVO> expectedResult = Arrays.asList(TopicsItemVO.builder()
.topicId(0L)
.talk("talk")
.showCommentsItems(Arrays.asList(TopicsItemVO.ShowCommentsItem.builder()
.userId(0L)
.build()))
.build());
// Configure IZSXQApi.topics(...).
final ResponseDTO responseDTO = new ResponseDTO();
final RespData respData = new RespData();
final TopicsItem topicsItem = new TopicsItem();
final ShowCommentsItem showCommentsItem = new ShowCommentsItem();
final Owner owner = new Owner();
owner.setUserId(0L);
showCommentsItem.setOwner(owner);
topicsItem.setShowComments(Arrays.asList(showCommentsItem));
final Talk talk = new Talk();
talk.setText("talk");
topicsItem.setTalk(talk);
topicsItem.setTopicId(0L);
respData.setTopics(Arrays.asList(topicsItem));
responseDTO.setRespData(respData);
when(mockZsxqApi.topics()).thenReturn(responseDTO);
// Run the test
final List<TopicsItemVO> result = zsxqAdapterUnderTest.queryTopics();
// Verify the results
assertEquals(expectedResult, result);
log.info("测试结果:{}", JSON.toJSONString(result));
}
}
- 除了前面两种测试,我们在开发功能的时候,还有场景测试;不启动 SpringBoot 但希望对实现的功能进行测试。
- 那么这里所体现的就是这样的测试,主要使用;
@RunWith(MockitoJUnitRunner.class)
、@Mock
、@InjectMocks
相当于模拟了一个启动的过程,只不过都是 Mock 的信息。但你可以根据这些信息来调试你的接口。 - 提示:你可以安装
IDEA Plugin Squaretest
它能自动的帮你生成Mock单元测试。这个插件是收费的,但还好不贵。
上一篇: 函数单元测试的最佳实践和自动化框架
下一篇: 单元测试:构建可靠软件的关键步骤
推荐阅读
-
[你真的知道如何使用 ES 吗?
-
你真的知道如何使用 XMLHttpRequest 吗?
-
你真的知道如何使用 XMLHttpRequest 吗?
-
死鬼,你真的知道如何编写单元测试吗?
-
你真的会编写单元测试吗?
-
最好的 Docker 可视化管理工具 - Portainer 你真的知道如何使用它吗?
-
你真的知道 ping 命令吗?网络专家告诉你如何玩更多 6!
-
你真的知道如何在 VS 代码中使用 Ctrl、Shift 和 Alt 吗?高效易用的快捷方式:多光标、跳转引用等!
-
趣谈留言队列,搞清楚留言队列到底是什么!-说到消息队列,洪觉大概能猜到人们听到消息队列的反应,大致可以分为以下几类人。 第一类人,懵懵懂懂,刚上大学接触编程,还没用过消息队列,甚至还以为消息队列就是代码里面要新建一个List之类的;第二类人,听过消息队列,了解消息队列,但具体是什么还不是太明白,只知道一说到消息队列,脑海里马上出现了三组词,削峰、异步、解耦;第三类人,用过消息队列,对它有一定了解,但不知道为什么要这样设计,消息队列有什么样的前世今生,是如何演化到现在的模式的?**第四类人,已经对消息队列有了足够的了解,可以阅读本帖作为复习和温习。**你属于哪一类?无论你对消息队列了解多少,读完这篇文章后,我相信你都会有所收获。 什么是消息队列?我们为什么要使用消息队列?真的只是因为它看起来很勉强、很常用吗?当然不是,一项技术的出现往往是为了解决某种痛点,我们就从这个痛点出发,看看消息队列到底是为了解决什么问题而诞生的。 相信大家在工作之前,或者工作中接触单片机的次数会多一点,不管什么业务都一股脑塞进一个系统里,这种情况下接触消息队列的场景会比较少。但随着业务的增长,量上去了,单机系统就很难维护了,也扛不住并发量的增长,就需要把原来的单体应用拆分成多个服务。例如,牛奇网采用分布式架构,将原来的单体系统拆分成用户服务、题库服务、求职服务、论坛服务等,每个分布式节点都有一个集群,保证高可用性。 那虽然在这样的微服务架构下,如果某个核心业务并发量过大,系统就扛不住了。比如淘宝、淘票票、拼多多、京东等电商场景中的支付场景,你在某宝下单并支付后,调用支付服务,完成支付后,还需要更新订单的状态,这个时候就需要调用订单服务,那我们平时也下单,除了简单完成这些操作外,还会给你相应的积分;商家也会收到订单消息,并给您发送旺旺消息,确认订单无误;同时,也会给您发送消息,确认订单无误。确认订单无误;同时您还可以查看您的物流状态;还有系统为了给您推荐更适合您的商品,会根据您的订单做类似的推荐等等,我说的这些都是当我们下单后,肉眼可以感知到系统所做的动作。 **一个支付动作如果还需要调用那么多服务,等他们响应成功,最后再告诉用户你支付成功了,用户在系统中的整个体验会非常糟糕。**设想一下,假设请求服务+处理请求+响应总共需要 50ms,我们上面列出的场景:支付服务、订单服务、积分服务、商家服务、物流服务、推荐服务,总共需要 300ms。
-
反传销网8月30日发布:视频区块链里的骗子,币里的韭菜,杜子建骂人了!金融大V周召说区块链!——“一小帮骗子玩一大帮小白,被割韭菜,小白还轮流被割,割的就是你!” 什么区块链,统统是骗子 作者:周召(知乎金融领域大V,毕业于上海财经大学,目前任职上海某股权投资基金合伙人) 有人问我,区块链现在这么火,到底是不是骗局? 我的回答是: 是骗局。而且我并不是说数字货币是骗局,而是说所有搞区块链的都是骗局。 -01- 区块链是一种鸡肋技术 人类社会任何技术的发明应用,本质都是为了提高社会的生产效率。而所谓区块链技术本质不过是几种早已成熟的技术的大杂烩,冗余且十分低效,除了提高了洗钱和诈骗的效率以外,对人类社会的进步毫无贡献。 真正意义上的区块链得包含三个要素:分布式系统(包括记账和存储),无法篡改的数据结构,以及共识算法,三者互为基础和因果,就像三体世界一样。看上去挺让人不明觉厉的,而经过几年的瞎折腾,稍微懂点区块链的碰了几次壁后都已经渐渐明白区块链其实并没有什么卵用,区块链技术已经名存实亡,沦为了营销工具和传销组织的画皮。 因为符合上述定义的、以比特币为代表的原教旨区块链技术,是反效率的,从经济学角度来说,不但不是一种帕累托改进,甚至还可以说是一种帕累托倒退。 原教旨区块链技术的效率十分低下,因为要遍历所有节点,只能做非常轻量级的数据应用,一旦涉及到大量的数据传输与更新,区块链就瞎了。 一方面整条链交易速度会极慢,另一方面数据库容量极速膨胀,考虑到人手一份的存储机制,区块链其实是对存储资源和能源的一种极大的浪费。 这里还没有加上为了取得所谓的共识和挖矿消耗的巨大的能源,如果说区块链技术是屎,那么这波区块链投机浪潮可谓人类历史上最大规模的搅屎运动。 区块链也验证不了任何东西。 所谓的智能合约,即不智能,也非合约。我看有人还说,如果有了智能合约,就可以跟老板签一份放区块链上,如果明年销售业绩提升30%,就加薪10%,由于区块链不能篡改,不能抵赖,所以老板必须得执行,说得有板有眼,不懂行的愣一看,好像还真是那么回事。 但仔细一想,问题就来了。首先,在区块链上如何证明你真的达到了30%业绩提升?即便真的达到老板耍赖如何执行? 也就是说,如果区块链真这么厉害,要法院和仲裁干什么。 人类社会真正的符合成本效益原则的是代理制度。之前有人说要用区块链改造注册会计师行业,我不知道他准备怎么设计,我猜想他思路大概是这样的,首先肯定搞去中心化,让所有会计师到链上来,然后一个新人要成为注册会计师就要所有会计师同意并记录在链上。 那我就请问了,我每天上班累死累活,为什么还要花时间去验证一个跟我无关的的人的专业能力?最优做法当然是组织一个委员会,让专门的人来负责,这不就是现在注册会师协会干的事儿吗?区块链的逻辑相当于什么事情都要拿出来公投,这个绝对是扯淡的。 当然这么说都有点抬举区块链了,区块链技术本身根本没有判断是非能力,如果这么高级的人工智能,靠一个无脑分布式记账就能实现的话,我们早就进入共产主义社会了。 虽然EOS等数字货币采用了超级节点,通过再中心化的方式提高效率,有点行业协会的意思,是对区块链原教旨主义的一种修正,但是依然无法突破区块链技术最本质的局限性。有人说,私有链和联盟链是区块链技术的未来,也是扯淡,因为区块链技术没有未来。如果有,说明他是包装成区块链的伪区块链技术。 区块链所涉及的所有底层技术,不管是分布式数据库技术,加密技术,还是点对点传输技术等,基本都是早已存在没什么秘密可言的技术。 比特币系统最重要的特性是封闭性和自洽性,他验证不了任何系统自身以外产生的信息的真实性。 所谓系统自身产生的信息,就是数据库数据的变动信息,有价值的基本上有且只有交易信息。所以说比特币最初不过是中本聪一种炫技的产物,来证明自己对几种技术的掌握,你看我多牛逼,设计出了一个像三体一样的系统。因此,数字货币很有可能是区块链从始至终唯一的杀手应用。 比特币和区块链概念从诞生到今天已经快10年了,很多人说区块链技术在爆发的前夜,但这个前夜好像是不是有点过长了啊朋友,跟三体里的长夜有一拼啊。都说区块链技术像是90年代初的互联网,可是90年代初的互联网在十年发展后,已经出现了一大批伟大的公司,阿里巴巴在99年都成立了,区块链怎么除了币还是币呢? 正规的数字货币未来发展的形式无外乎几种,要么就是论坛币形式,或者类似股票的权益凭证等。问题是论坛币和股票之前,本来也都电子化了,区块链来了到底改变了什么呢? 所有想把TOKEN和应用场景结合起来的人最后都很痛苦,最后他们会发现区块链技术就是脱裤子放屁,自己辛苦搞半天,干嘛不自己作为中心关心门来收钱?最后这些人都产生了价值的虚无感,最终精神崩溃,只能发币疯狂收割韭菜,一边嘴里还说着我是个好人之类的奇怪的话。 因此,之前币圈链圈还泾渭分明,互相瞧不起,但这两年链圈逐渐坐不住了,想着是不是趁着泡沫没彻底破灭之前赶快收割一波,不然可能什么都捞不着了。 前段时间和一个名校毕业的链圈朋友瞎聊天,他说他们“致力于用区块链技术解决数字版权保护问题”,我就问他一个问题,你们如何保证你链的版权所有权声明是真实的,万一盗版者抢先一步把数据放在链上怎么办。他说他们的解决方案是连入国家数字版权保护中心的数据库进行验证…… 所以说区块链技术就是个鸡肋,研究到最后都会落入效率与真实性的黑洞,很多人一头扎进链圈后才发现,真正意义上的区块链技术,其实什么都干不了。 -02- 不是蠢就是坏的区块链媒体 空气币和区块链的造富神话,让区块链自媒体也开始迎风乱扭。一群群根本不知道区块链为何物的妖魔鬼怪纷纷进驻区块链自媒体战场,开始大放厥词胡编乱造。 任何东西,但凡只要和区块,链,分,分布式,记账,加密,验证,可追溯等等这些个关键词沾到哪怕一点点,这些所谓的区块链媒体人就会像狗闻到了屎了一样疯狂地把区块链概念往上套。 这让我想起曾经一度也是热闹非凡的物联网,我曾经去看过江苏一家号称要改变世界的“物联网”企业,过去一看是生产路由器的,我黑人问号脸,对方解释说没有路由器万物怎么互联,我觉得他说得好有道理,竟无言以对。 好,下面让我们进入奇葩共赏析时间,来看看区城链媒体经常有哪些危言耸听的奇谈怪论 区块链(分布式记账)的典型应用是*?? 正如前面所说,真正意义上的区块链分布式记账,不光包括“记”这个动作,还包括分布式存储和共识机制等。而*诞生远远早于区块链这个词的出现,勉强算是“分布式编辑”吧,就被很多区块链媒体拿来强行充当区块链技术应用的典范。 其实事实恰恰相反,*恰恰是去中心化失败的典范,现在如果没有精英和专业人士的编辑和维护,*早就没法看了。 区块链会促进社会分工?? 罗振宇好像就说过类似的话,虽然罗振宇说过很多没有逻辑的话,但这句话绝对是最没逻辑思维的。很多区块链自媒体也常常用这句话来忽悠老百姓,说分工代表效率提高社会进步,而区块链“无疑”会促进分工,他们的理由仅仅是分工和分布式记账都共用一个“分”字,就强行把他们扯到一起。 实际情况恰恰相反,区块链是逆分工的,区块链精神是号召所有人积极地参与到他不擅长也不想掺合的事情里面去。 区块链不能像上帝一样许诺他的子民死后上天国,只能给他们许诺你们是六度人脉中的第一级,我可以赚后面五级人的钱,你处于金字塔的顶端。