Skip to content

ZGIT-Network/OPENAPI-Next-Core

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZGIT OpenAPI Next - Core

ZGIT OPENAPI Next 的服务核心开源版 基于 Node.js Express 框架开发的轻量级、高并发、模块化 API 服务核心

支持模块热更新/添加/移除,避免影响业务连续性。

各个 API 以 .js 模块形式加载,并支持模块与路由热更新。

同时欢迎各位大佬为本项目贡献代码或更多插件。

也许你可以在 https://api.zyghit.cn 查看效果?

方案特色:

  1. 轻量级、高并发。
  2. 模块化 API 组件,支持热更新,无需重启服务。
  3. 高自定义化,基础服务代码完全开源。
  4. 高开发自由度,理论上开发的插件能够实现大多数功能。

Develop Node Version: v20.12.2

安装依赖

npm install

运行

node index.js

特殊说明

配置文件

默认情况会自动生成配置文件 config.ini

如无法生成,请手动新建:

# config.ini

[app]
port=3001
server_name=本地主机
debug=false
copyright=ZGIT Network

[mysql]
host=localhost
user=username
password=pass
database=database

静态文件

若有特别需求需要静态文件,请将其置于 public 目录下

优先级: 静态文件>动态API


已经内置的插件

模块/插件目录:/apis

模块自带以下插件以供您研究:

  • 头像重定向(avatar.js):通过提交邮箱的方式将邮箱自动转换为 md5 并重定向到对应的 Gravatar 头像

使用方法: /avatar?email={your email}&s={size}

  • 授时服务(time-aligned.js):获取当前服务器时间

可提交参数:?type={server|iso|unix|其他参数则返回unix}

  • 演示插件(example.js):示例插件,默认直接输出 Hello World
  • Frpc 的 Toml 转 INI 插件(toml-to-ini.js):将 TOML 格式的配置文件转换为 INI 格式,不过 js 文件只是用来声明引入了此插件。

此插件以静态页面 /public/toml-to-ini 实现功能(目前仅支持toml转ini)。

有关数据库操作的插件目前暂未公开,可联系本仓库管理员也许能提供演示插件。 可参考下方设计模块方法来调用数据库。


设计新 Plugin/API 模块

/apis/ 新建 .js 文件即可识别为新的模块,比如 example.js(不知道是否支持中文,不建议使用中文)

ZGIT OpenAPI Next 支持自动化加载新的 API.JS 模块,新建或者修改 api 时需要重启服务。

Important

如何访问新的API?

假设 example123.js 文件中定义了 / 接口,则的访问路径为: http://{host}/example123

以此类推,假设定义了/114514,那么访问路径为:http://{host}/example123/114514

相关基本插件(示例)代码,此处以文件名 example.js 为例:

// example.js

const express = require('express');
const router = express.Router();


////////DATABASE////////////
// 这部分代码用于数据库连接,如果不需要请勿引用并移除此部分代码.
const db = require('../core/database.js');
const NodeCache = require('node-cache');
const cache = new NodeCache({stdTTL: 60}); // 缓存时间为60秒,可根据需要调整

// 创建连接池
db.createPool();

async function fetchData() {
    const database_name = 'example';
    const cachedData = cache.get('database_name');
    if (cachedData) {
        console.log('~ [Database] 命中缓存');
        return cachedData;
    } else {
        console.log('- [Database] 缓存丢失');
        try {
            const results = await db.query('SELECT * FROM database_name');
            //results即为得到的数据库返回值,可在此处进行处理再返回给事件

            //设置对数据表的缓存
            cache.set('database_name', results);
            console.log('+ [Database] 已缓存数据');
            return results;
        } catch (err) {
            console.error(err);
            throw err;
        }
    }
}

// 使用查询函数并添加缓存
fetchData().then(results => {
    if(_config.app.debug){
        console.log('[DEBUG] \n' + results); // logs the results of the query
    }
}).catch(err => {
    console.error(err); // logs any error
});

//拆除连接池(有必要时进行.)
db.closePool();
// 上面全是数据库连接部分

/////////////////////////////
// 主要实现部分

// 这里是模块名称定义的部分,依次是插件名,版本号和作者
const plugin_info ={
    "name": "example",
    "version": "v1.0",
    "avatar": "example"
}

// 模块信息日志输出
console.log("+ 模块: "+plugin_info.name+" - "+plugin_info.version+" (作者: "+plugin_info.avatar+") 已载入数据.")


// 定义接口(GET)
router.get('/', (req, res) => { //这个接口的请求路径就是 http://{host}/example/ 这样的
    //在此处写入相关原理实现
    //...
    
    res.send('Hello World!'); //使用此函数发送回复
    console.log("~ ["+plugin_info.name+"] " + "已处理GET请求.") //日志输出,可以自行更改
});

// 定义接口(POST)
router.post('/post', (req, res) => { //这个接口的请求路径就是 http://{host}/example/ 这样的
    //在此处写入相关原理实现
    //...
    // 在这里处理你的 POST 请求数据
    // console.log(req.body);

    // 假设你已经处理好了请求,并准备回送一个响应
    res.json({ message: '子接口 POST 请求成功!' });
    // res.send('Hello World!'); //使用此函数发送回复
    console.log("~ ["+plugin_info.name+"] " + "已处理POST请求.") //日志输出,可以自行更改
});

/*
 这里可以继续当前接口添加子接口,比如/jas (GET)
 
 router.get('/jas', (req, res) => {
    res.send('Hello World!');
    console.log("~ ["+plugin_info.name+"] " + "已处理请求.")
  });
  
  请求接口的路径就是:
  http://{host}/example/jas
 */


module.exports = router;

规范:即使子模块根目录没有方法,也需要至少返回一个字符串。


合理使用配置文件

全局变量可使用 _config 来读取 config 中的数据。

比如,若模块需要判断 debug 模式,可通过 _config.app.debug 判断 true 或者 false 。

同样的,也可以通过 _config 读取任何 config.ini 中的数据。

若要修改默认 config 的内容,可以在 ./core/gen_config 中修改。


关于插件热更新的特殊说明

插件管理器热更新插件功能目前处于试验阶段,若插件存在非法代码可能造成服务核心崩溃。

静态页面默认支持热更新,不受到 plugManager 管理。


协议

此项目基于 Apache License 2.0 协议发布并开源,有关详细协议内容请参考 LICENSE 文件。

以下是 Apache License 2.0 协议的简述:

你不能:

  • 声称本软件的原创版权为自己所有。
  • 在未遵循 Apache License 2.0 协议的情况下分发修改后的版本。
  • 将本软件的商标使用权赋予他人,除非获得明确许可。

你可以:

  • 出于任何目的自由运行本软件。
  • 获取源代码并根据需要进行研究和修改。
  • 复制和分发本软件的原始版本或你修改后的版本,但必须保留原始许可证声明、版权声明和免责声明。
  • 将你的修改版本或衍生作品以任何许可证发布,允许与其他许可证兼容的灵活使用。
  • 对修改部分不强制开源,因此可以用于闭源项目中。

About

ZGIT OPENAPI Next的 Node.js 服务核心开源版

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published