Noomi

一个基于node的企业级框架，基于typescript开发，支持路由、过滤器、IoC、Aop、事务及嵌套、安全框架、缓存、集群。
Noomi全面支持typescript，提供快捷简单的注解编写方式和丰富的配置处理能力。
框架官网：www.noomi.cn。

快速接入

支持noomi-cli一键安装，完成noomi及其依赖包的安装，同时建立项目框架。

源码迁移

源码迁移到gitee(git@gitee.com:weblabsw/noomijs)，原github继续有效。

升级

1.0.0

针对noomi的实际使用情况，noomi从0.x版本升级到1.x版本，主要做了以下修改：

修复热部署在windows系统下的bug；
修复ncache替换计算bug；
删除route errorhandler配置项，替换方法，采用web后置处理；
增加web后置处理，装饰器为@WebHandler，与filter相对应(webfilter在web请求处理前处理)，用法与filter相似，route异常处理可以在该环节处理；
过滤器和后置处理，不再支持字符串，支持完整正则表达式；
如果未设置实例名（@Instance），实例名默认为类名，不再是首字母小写的驼峰命名方式；
不再支持实例、切面、路由、过滤器配置文件方式，统一采用注解（装饰器）方式；
切点(pointcut)不再装饰方法，采用装饰属性，advice中直接使用装饰的属性名作为pointcutId；
修复非单例类的注入aop问题。

核心模块

主要包括以下部分：

路由

路由作为web服务器与浏览器交互的桥梁，把js方法以RESTful方式暴露给客户端（浏览器）。

@Router()
class Clazz1{
    @Route('/path')
    method1(){
        ...
    }
    ...
}

过滤器

过滤器为路由进行过滤，可针对不同的路由，设置不同的过滤方法，对路由及请求参数进行预处理。

class Clazz1{
    @WebFilter(path,priority)
    do(request,resonpse){
        ...
        return true/false;
    }
}

IoC

IoC（依赖注入）在需要依赖某个实例时，由注入器进行注入，不需要进行new操作。
所有实例通过实例工厂统一管理，便于实例重用，降低实例创建和释放的消耗。
@Instance注解表示该类所创建的实例由实例工厂进行管理。
@Inject注解表示把实例工厂中该实例名对应的实例注入到成员变量中。

@Instance('instance1')
class Clazz1{
    @Inject('instance2')
    relInstance:Clazz2;
    method1(){
        this.relInstance.***
        ...
    }
}

Aop

把业务无关代码独立出来，做成切面，然后把切面包裹到业务代码上，通常应用场景为日志、事务等。

@Aspect()
class Clazz1{
    @Pointcut(["test1.*","test2.*"])
    testPointcut(){}
    @Before("testPointcut()")
    method1(){
        ...
    }
    @After("testPointcut()")
    method2(){
        ...
    }
    @Around("testPointcut()")
    method3(){
        ...
    }
    @AfterThrow("testPointcut()")
    method4(){
        ...
    }
    @AfterReturn("testPointcut()")
    method5(args){
        ...
    }

事务

事务主要针对数据库操作，事务操作可以在业务代码中编写，这样用有两个缺点：

事务代码与业务代码无关；
如果一个事务方法调用了多个事务方法，当非第一个方法出现异常时，则会导致事务回滚错误。

实际开发中，我们不建议在业务代码中写事务相关代码，建议使用noomi事务，noomi支持事务及嵌套事务。

@Transactioner()
class Clazz1{
    @Transactional()
    async method1(){
        ...
    }
    ...
}

缓存

noomi提供了NCache类，可以提供内存和redis缓存统一处理，使用方便。

const cache = new NCache({
    name:'***',
    saveType:0/1,
    max_size:2000000,
    redis:'default'
});

集群

NCache支持redis缓存，web缓存和session都作为NCache的实例存在，所以可直接存放在redis上，从而实现多核和多机集群，我们建议采用PM2实现集群部署。

安全

noomi提供内置安全框架，用户只需提供对应的数据表和配置相应参数即可实现资源访问鉴权。

{
    "save_type":1,
    "redis":"default",
    "expressions":["/*"],       
    "dboption":{},
    "auth_fail_url":"***",    
    "login_url":"***"         
}

更多使用细节请参考Noomi官网。

noomijs/noomi

Noomi

快速接入

源码迁移

升级

1.0.0

核心模块

路由

过滤器

IoC

Aop

事务

缓存

集群

安全