soootaleb/ddapps

DDAPPS

!https://circleci.com/gh/soootaleb/ddapps/tree/main.svg?style=shield

DDAPPS是一个基于Deno的事件驱动框架，适用于构建“活的”应用（与传统请求/响应服务不同），例如分布式数据库、***等。

镜像概述

DDAPPS利用JavaScript的异步特性构建分布式系统，提供强类型支持以提升开发体验，并包含客户端SDK、CLI工具、网络通信、监控等核心组件，帮助开发者快速构建分布式应用。

核心功能

• 客户端SDK：用于自定义集成，与系统交互。
• CLI工具：支持系统交互和项目初始化。
• 网络通信：实现集群节点间的通信。
• 监控功能：观察系统运行状态。
• API处理：处理客户端请求并路由。
• 日志记录：记录系统事件。
• Peer核心组件：系统的核心逻辑单元。

使用场景

• 构建分布式键值存储系统（类似etcd）。
• 开发***应用。
• 实现消息导向的服务器应用（无需用户连接即可运行）。

配置说明

Docker部署示例

启动DDAPPS服务器

bash
docker run -p 8080:8080 soootaleb/ddapps --console-messages --debug

参数说明：

• --console-messages：启用控制台日志。
• --debug：显示所有消息（默认仅显示客户端请求）。

使用CLI交互

bash
# 假设CLI镜像为soootaleb/ddappsctl，使用host网络访问本地服务器
docker run --network host soootaleb/ddappsctl ping

预期响应：

TypeScript
{
  type: "ClientResponse",
  source: "localhost",
  destination: "Client",
  payload: { token: "px2vydgrs7", type: "Pong", payload: 3, timestamp: 1647610732124 }
}

添加自定义功能

创建hostname.ddapps.ts文件：

TypeScript
import { DDAPPS, Api, EMType, Message, EOpType, state as base } from "https://deno.land/x/ddapps@1.4.5/mod.ts";

class HostnameApi extends Api {
  protected override [EMType.ClientRequest](message: Message<EMType.ClientRequest>) {
    super.ClientRequest(message);
    this.response(message.payload.token, EOpType.Any, Deno.hostname());
  }
}

new DDAPPS().use(HostnameApi).run(base);

运行（需Deno环境）：

bash
deno run -A --unstable hostname.ddapps.ts

使用CLI发送请求：

bash
deno run -A --unstable cli/ddapps.ts any