adonisjs5的Ioc机制初探

什么是Ioc Ioc(Inversion of Control)是一种设计模式.它指的是使用某对象/资源的代码,不负责该对象的依赖对象的创建和维护,而交给一个专门的容器来负责.这样,怎么创建对象的控制权就转移到了这个专门的容器,即实现了所谓的控制反转.Ioc用来降低对象之间由依赖关系产生的耦合.(按照软件工程理论,依赖算是最弱的一种耦合了.依赖 < 关联 < 聚合 < 组合< 继承)我感觉,Ioc算是一个升级版的工厂模式,它管理了大量的工厂函数和对应的资源名称.可以把创建资源/对象的依赖写在Ioc里面. adonisjs5中的Ioc 我感觉有点奇怪,adonisjs5的官方文档中没有专门提及Ioc. https://docs.adonisjs.com/guides/introduction{.wp-editor-md-post-content-link} 但在adonisjs4.x https://legacy.adonisjs.com/docs/4.1/ioc-container{.wp-editor-md-post-content-link} 的官方文档中却有单独的一节来讲Ioc.以至于,我第一次读完adonis5的文档后,对Ioc竟然没什么印象.而Ioc却是adonis最为重要的概念.anyway~,看看adonis的源代码怎么处理Ioc吧. 注册Ioc 在adonisjs的代码中搜索一下, find node_modules/@adonisjs -iname "*ioc*" 很容易发现adonisjs实现Ioc的代码在node_modules/@adonisjs/fold/build/src/Ioc/这个目录中.目录名就是Ioc,毫不掩饰自己的目的. 逛一逛Ioc这个目录下的js文件,发现最重要的是index.js 和 binBindings.js这两个文件.其中index.js中有一个类就叫Ioc, 而注册到Ioc中的资源被放在Bindings.js文件中Bindings类中. /** * Define a binding */ register(binding, callback, singleton) { this.list.set(binding, { callback, singleton }); return this; } Binding类中的register函数非常显眼.显然注册一个资源到Ioc的代码会走到这里.在这里下断点,调起调试器.发现register函数的三个参数的含义是: binding即资源的的namespace,通过调试器发现注册的第一个资源的namespace是“Adonis/Core/Application”;callback相当于创建这种资源的工厂函数,调用它即生产出一个对应的对象;而singleton则是一个boolean值,指示该种资源是不是一个单件.看看栈的上一个frame,是Ioc类的singleton()函数.看来,“Adonis/Core/Application”这个资源是通过Ioc.singleton()创建的. /** * Same as the [[bind]] method, but registers a singleton only. Singleton's callback * is invoked only for the first time and then the cached value is used */ singleton(binding, callback) { helpers_2.ensureIsFunction(callback, '"ioc.singleton" expect 2nd argument to be a function'); this.bindings.register(binding, callback, true); return this; } Ioc.singleton()函数注释告诉我们.single()函数跟bind()函数一样,只不过是注册一个单件,单件的callback工厂函数仅调用一次.第一次创建会把资源cache起来,而后直接返回cache.这个cache即Bindings类中的list成员.虽然名字是list,但却是一个Map.映射namespace到对象/资源. ...

December 20, 2021 · 2 min · kamus

使用Prettier,Husky和lint-staged,在提交javascript代码前自动格式化代码

目标 为防止提交不合格的代码排版到仓库中,我们希望在提交前格式化代码,使之符合项目的代码格式规范,而且尽可能保证逻辑正确。即目标有两点: 对git staged的代码强行格式化,使符合规范。对于没有被staged的代码或文件,将完全忽略。 跑单元测试。只有通过了单元测试才能提交代码。 安装依赖 $ npm install --save-dev husky lint-staged 先安装husky和lint-staged。注间在安装husky之前需要确保工程目录已经是一个合法的git仓库。因为,安装husky时需要给git仓库安装预提交钩子(precommit hook)。 Lint-staged提供了一个关键的功能,它能找到所有被git staged的文件,而不是工程下面所有的文件,然后通过管道交给Prettier做格式化。 修改npm脚本 对npm script做如下改动: "scripts": { "precommit": "lint-staged" }, "lint-staged": { "*.{js,jsx,json}": ["prettier --write", "git add"] } scripts.precommit由Husky处理,它会依照配置在把代码正式提交到仓库前运行lint-staged(当然我们也可以配置其他命令)。 Lint-staged再找到属于它自己的配置部分,即lint-staged键下面的配置。 在此例中,所有staged状态的,且扩展名是.js, .jsx, 和.json文件都会自动交由Prettier做格式化,然后再提交。 为何一定要用lint-staged You might wonder why we don’t just use Husky to run a few npm scripts. 你可以会疑惑,为什么一定要罗里罗嗦地用lint-staged,用Husky直接调用npm脚本不更简单么。 这是因为我们用lint-staged拿到staged状态的文件,而不是所有的文件。 你的node工程文件中可能已经有如下做代码格式化的脚本 "format": "prettier --write '**/*.{js,jsx}'" 你可能会因此如下配置 "lint-staged": { "*.{js,jsx,json}": ["npm run format", "git add"] } 如果是这样配置的话,就没有必要用lint-staged了。因为,这样的配置会把prettier应用到所有匹配.js,.jsx.json的文件上,而不是仅staged状态的文件。 ...

November 24, 2019 · 1 min · kamus