nutzboot/doc/overview.md
2017-11-29 21:52:39 +08:00

74 lines
2.0 KiB
Markdown

# NutzBoot简介
## 什么是Nutz Boot?
简称NB! 基于Nutz的微服务方案,为分布式应用提供便捷的基础框架
一键生成NB的项目: [https://get.nutz.io NB构建器]
## NutzBoot的目标
* 将nutz易用性再提升个一个层次
* 默认配置应满足80%以上的需求
* 默认依赖应满足80%以上的场景
## 几个术语
* AppContext 全局上下文
* Starter,一个自管理的服务
### 全局上下文AppContext
由于nutzboot启动的程序不一定是web程序,所以需要非web上下文,用于存储公用对象,例如ioc容器和配置信息
### AppContext具有的基本特征
* 随处可取
* 持有一个Ioc容器
* 持有配置信息
* 管理starter的生命周期
* 可测试,可替换
## 何为starter
"一种服务": 预配置,依赖关系完整,自我管理.
* 预配置: 默认值应足够好,在大部分情况下不需要修改
* 依赖关系完整: pom.xml只需要加上starter的依赖,相关jar应该完整,不需要再额外添加
* 自我管理: starter应该有自己的生命周期
## 差不多是最简单的demo
```java
package io.nutz.demo.simple;
import org.nutz.boot.NbApp;
import org.nutz.ioc.loader.annotation.*;
import org.nutz.mvc.annotation.*;
@IocBean
public class MainLauncher {
@Ok("raw")
@At("/time/now")
public long now() {
return System.currentTimeMillis();
}
public static void main(String[] args) throws Exception {
new NbApp(MainLauncher.class).run();
}
}
```
## NutzBoot与Nutz.Mvc+Nutz.Dao的区别
* Nutz.Mvc+Nutz.Dao是大家常用的组合, 通常跑在web容器内,发布为war
* NutzBoot是独立的程序,不需要额外的容器,它自身就是一个容器, 然后包含其他容器,例如jetty或tomcat, 发布为jar
* NutzBoot的程序不一定是web程序,可以是dubbo服务端,mq消费者等无UI程序
## Nutz.Mvc及其他starter跟我自己配有什么区别?
* 95%以上的代码互通. 例如在Nutz.Mvc的写法,绝大部分可用
* starter固化了最佳实践,我们的目标是满足80%以上的默认需求,剩余的可配置