JSIDoc设计的两个失败点

作者回顾了一年前开发的JSIDoc项目,在解析JS文档方面的心得体会。指出SourceEntry作为ECMAParser子类的设计失误,并建议采用组合而非继承。同时认为JSDoc使用单例模式会更简洁。
JSIDoc是我一年前开发的用来解析JS文档的纯客户端脚本程序。

现在随着JSI2的重构,已经好久没有跟进了,今天回头看看。

很多设计实在是失误,记录一下:



SourceEntry作为ECMAParser的子类:非常失败,导致SourceEntry非常复杂,回头一看,头大!
如果使用组合,这种局面就不会发生。
总结:不要滥用继承。特别是JavaScript这种弱类型语言,成员多了,鬼知道他们在干什么。

JSDoc作为类:算是比较失败吧,如果用单例,很多东西可以简化。
总结:不要总去假设一些没有的需求,宁可新需求到达后重构,甚至重写。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值