asyncy/http

Asyncy HTTP Gateway

概述

Asyncy HTTP Gateway是一个API网关服务器，主要用于通过HTTP协议执行Stories。它提供了HTTP接口来接收和处理请求，并根据定义的逻辑执行相应的Stories。

核心功能和特性

• 支持通过HTTP方法（如GET）监听和处理请求
• 可获取请求的body、headers等信息
• 能够设置响应数据、状态码并完成响应
• 提供端点注册和取消注册功能，灵活管理HTTP接口

使用场景和适用范围

适用于需要通过HTTP接口触发和执行Stories的场景，例如构建API服务、微服务架构中的请求路由与处理、自定义HTTP端点逻辑实现等。

使用方法和配置说明

开发环境设置

1. 创建并激活虚拟环境

bash
virtualenv -p python3.6 venv
source venv/bin/activate

2. 安装依赖

bash
pip install -r requirements.txt

本地运行

bash
python -m app.main --logging=debug --debug

注册端点

通过以下命令注册一个端点：

bash
curl --data '{"endpoint": "http://localhost:9000/story/foo", "data":{"path":"/ping", "method": "post"}}' \ 
     -H "Content-Type: application/json" \ 
     localhost:8889/register

注册后可访问该端点：

bash
curl -X POST -d 'foobar' http://localhost:8888/world

取消注册端点

通过以下命令取消注册端点：

bash
curl --data '{"endpoint": "http://localhost:9000/story/foo", "data":{"path":"/ping", "method": "post"}}' \ 
     -H "Content-Type: application/json" \ 
     localhost:8889/unregister

示例

以下是一个简单的Stories执行示例，当HTTP服务器监听GET方法的根路径请求时，输出请求信息并返回"Hello World"：

coffee
when http server listen method: 'get' path: '/' as req
    log info msg: req.body
    log info msg: req.headers
    log info msg: req.headers['Host']
    req write data: 'Hello World'
    req status code: 200
    req finish

访问该端点的效果：

bash
curl [***]
>>> Hello World