一个超级简单轻量的 Node.js MVC 框架
jj.js 是一个模仿 ThinkPHP5 设计的轻量级 Node.js MVC 框架。基于 Proxy 实现了类库自动加载、懒加载和 Class 自动实例化及单例化技术，所有类库想用直接调用，系统会自动导入，无需手动 require/import。
| 特性 | 说明 |
|---|---|
| 🏗️ 经典 MVC | 模仿 ThinkPHP5，PHP 开发者友好，快速上手 |
| 🔄 自动加载 | 系统类库、用户类库都支持自动加载、懒加载 |
| 🎯 智能实例化 | Class 自动生成单实例，节省内存开销 |
| 🧩 三级中间件 | 应用级、路由级、控制器级，方便插件及二次开发 |
| 🌐 多应用模式 | 支持单应用和多应用两种运行模式 |
| 📝 完整类型提示 | 基于 JSDoc，自动生成应用端 types 类型文件 |
- GitHub：https://github.com/yafoo/jj.js
- 码云镜像：https://gitee.com/yafu/jj.js
- 官网：https://me.i-i.me/special/jj.html
npm i jj.js运行环境要求：Node.js >= 18
1. 创建控制器 ./app/controller/index.js
const {Controller} = require('jj.js');
class Index extends Controller {
async index() {
this.$show('Hello jj.js, hello world!');
}
}
module.exports = Index;2. 创建应用入口 ./server.js
const {App, Logger} = require('jj.js');
const app = new App();
app.listen(3000, '0.0.0.0', () => {
Logger.info('HTTP server is ready on port 3000');
});3. 启动服务
node server.js4. 访问测试
浏览器打开 http://127.0.0.1:3000，页面输出：Hello jj.js, hello world!
💡 在线体验：Stackblitz Hello World
project/
├── app/ # 应用目录（默认应用，可改名）
│ ├── controller/ # 控制器目录（可改名）
│ │ └── index.js # 首页控制器
│ ├── view/ # 模板目录（可改名）
│ │ └── index/ # index 控制器模板
│ │ └── index.htm # 模板文件
│ ├── middleware/ # 中间件目录（不可改名）
│ ├── model/ # 模型目录（可改名）
│ ├── pagination/ # 分页目录（可改名）
│ ├── logic/ # 逻辑目录（可改名）
│ └── ... # 其他自定义目录
├── common/ # 公共应用目录（可选）
├── config/ # 配置目录（不可改名）
│ ├── app.js # 应用配置
│ ├── db.js # 数据库配置
│ ├── routes.js # 路由配置
│ ├── view.js # 模板配置
│ ├── cache.js # 缓存配置
│ └── ... # 其他配置
├── public/ # 静态资源目录（可改名）
│ └── static/ # CSS/JS/图片等
├── node_modules/ # Node.js 依赖
├── server.js # 应用入口文件（必需，可改名）
├── types.js # JSDOC类型文件（开发模式自动生成）
├── jsconfig.json # 代码提示配置（没有，则编辑器不会提示）
└── package.json # NPM 配置
| 目录 | 必需 | 说明 |
|---|---|---|
config/ |
❌ | 应用配置目录，所有配置参数放在这里，可简化为 config.js |
app/ |
✅ | 默认应用目录，支持多应用时可创建 app2、app3 等 |
common/ |
❌ | 公共应用目录，存放公共 model、logic 等 |
public/ |
❌ | 静态资源目录，在 config/app.js 中通过 static_dir 配置 |
server.js |
✅ | 应用入口文件，名字可任意修改 |
多应用模式：在
./config/app.js中设置app_multi: true即可启用。
const {
App, // 应用类（继承 Koa）
Controller, // 控制器基类
Db, // 数据库类
Model, // 模型基类
Pagination, // 分页类
View, // 视图/模板类
Logger, // 日志类（静态类）
Cookie, // Cookie 操作类
Response, // 响应类
Upload, // 文件上传类
Url, // URL 生成类
Middleware, // 中间件基类
Cache, // 缓存类（静态类）
Context, // 上下文基类
Request // 请求类
} = require('jj.js');Ctx (Proxy 基类 - 核心自动加载机制)
│
└── Context (基础上下文类)
│
├── Middleware (中间件基类)
│ │
│ └── Controller (控制器类)
│ └── 用户自定义控制器
│
├── Model (模型类)
│ └── 用户自定义模型
│
├── Db (数据库类)
│ ├── Mysql (lib/db/mysql.js)
│ ├── Sqlite (lib/db/sqlite.js)
│ └── Mongodb (lib/db/mongodb.js)
│
├── View (视图/模板类)
├── Response (响应类)
├── Request (请求类)
├── Url (URL 生成类)
├── Cookie (Cookie 操作类)
├── Upload (文件上传类)
└── Pagination (分页类)
静态类（不需要继承）：
├── Logger (日志类)
└── Cache (缓存类)
💡 开发建议：继承系统类库后，可在类内使用
$前缀属性实现自动加载功能。链式调用类方法时会自动实例化单例。
类库自动加载、懒加载是整个框架的核心。
控制器 ./app/controller/index.js：
const {Controller} = require('jj.js');
class Index extends Controller {
async index() {
this.$show('Hello jj.js, hello world!');
}
async user() {
// 直接使用 $db，框架自动加载并实例化
const user_info = await this.$db.table('user').find({id: 1});
this.$show(user_info);
}
}
module.exports = Index;访问：http://127.0.0.1:3000/index/user
加载流程：
this.$db
↓
1. 检查当前类实例是否有 $db 属性
↓ (没有)
2. 检查应用目录 ./app/db.js 或 ./app/db/
↓ (没有)
3. 检查应用根目录 ./db.js 或 ./db/
↓ (没有)
4. 检查框架 lib/db.js ✅ 找到！
↓
自动实例化（单例）并返回 Db 实例
智能实例化：调用
this.$db.table('user')时，框架先检测是否有table静态方法，没有则自动 new 实例，然后调用实例方法。
模型 ./app/model/user.js：
const {Model} = require('jj.js');
class User extends Model {
async getUserInfo(condition) {
return await this.db.find(condition);
}
}
module.exports = User;控制器调用：
async user() {
// 自动加载 ./app/model/user.js 并调用 getUserInfo 方法
const user_info = await this.$model.user.getUserInfo({id: 1});
this.$show(user_info);
}注意：模型内使用
this.db（无$前缀）是专属该模型的独立实例，避免多模型调用时混淆。
应用配置可以是 ./config/ 目录，也可以简化为一个 ./config.js 文件。只需设置需要修改的项，未设置的会继承框架默认配置。
module.exports = {
app_debug: false, // 调试模式
app_multi: false, // 是否开启多应用
default_app: 'app', // 默认应用
default_controller: 'index', // 默认控制器
default_action: 'index', // 默认方法
common_app: 'common', // 公共应用
controller_folder: 'controller', // 控制器目录名
static_dir: '', // 静态文件目录（为空关闭静态访问）
koa_body: null // koa-body 配置（null 关闭）
};module.exports = {
default: {
type: 'mysql',
host: '127.0.0.1',
database: 'jj',
user: 'root',
password: '',
port: '',
charset: 'utf8mb4',
prefix: 'jj_'
},
sqlite: {
type: 'sqlite',
database: ':memory:',
prefix: 'jj_'
},
mongodb: {
type: 'mongodb',
host: '127.0.0.1',
database: 'jj',
port: 27017,
prefix: 'jj_'
}
};基于 @koa/router 开发，支持 URL 匹配、路由命名、反向编译等功能。
module.exports = [
// 基本路由
{url: '/', path: 'app/index/index2'},
// 动态参数 + 路由命名
{url: '/article/:id.html', path: 'app/article/article', name: 'article'},
// 中间件类型
{url: '/admin', path: 'app/admin/check', type: 'middleware'},
// 模板直接输出
{url: '/about', path: 'app/about/index', type: 'view'},
// 直接路由到函数
{url: '/hello', path: async (ctx, next) => {
ctx.body = 'hello world!';
}}
];反向编译：配置
name后，可使用this.$url.build(':article', {id: 123})生成/article/123.html
| 类型 | 规范 | 示例 |
|---|---|---|
| 类名 | 大驼峰 | UserController |
| 方法名 | 小驼峰 | getUserInfo() |
| 私有方法 | 下划线前缀 | _validateData() |
| 控制器文件名 | 小写下划线 | user_controller.js |
- Melog - 基于 jj.js 的轻量博客系统
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}