学习教程到openapi时发现示例程序登录不能成功,对比之前发现是src/services下的文件内容发生了变化,而这正式openapi的核心所在。不同之处在于新生成的api.ts多了params参数,实际登录调用时该参数并没有传入。那么问题就在openapi了,但是理解openapi的生成并不是一件容易的事。首先,如何调试是一个问题,解决方法见博客。第二个问题是,openapi是如何生成这些文件的,流程理解见博客。剩下的问题在于做好了这些准备后,如何解决params参数的问题。
最简单的办法就是删了api.ts中的params部分,但是这个后期使用带来很大的不便,一不小心重新生成就又会再次引入了,那么我们分析下不必要的params为什么会引入呢?通过阅读源码,openapi使用了nunjucks作为模板引擎,在生成ts文件时,params为空但还是生成了,这个问题引擎无法解决,只有在输入参数时对params进行控制。我的解决办法就是修改如下函数:
serviceGenerator.js->getParamsTP():
- templateParams['path'] = templateParams['path'] || [];
+ // templateParams['path'] = templateParams['path'] || []; //sideeffect: add unexpected property 'path' to templateParams
let match = null;
while (match = regex.exec(path)) {
+ if(!templateParams['path']) {
+ templateParams['path'] = [];
+ }
if (!templateParams['path'].some(p => p.name === match[1])) {
templateParams['path'].push(Object.assign(Object.assign({}, DEFAULT_PATH_PARAM), { name: match[1] }));
}
}
修改过后,就能够在执行umi openapi后,让项目继续正常运行。