Skip to content

v0.4.11

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Aug 14:38
· 3 commits to main since this release
v0.4.11
8769ed4

Feature / 新功能

  • 新增 ADT REST 通用代理 ANY /api/adt/{path}：把 SAP ICF 上的 ADT REST API（/sap/bc/adt/**，Eclipse ADT 用的同一套）1:1 透传到网关，用于 dump 正文、ABAP 类源码读写等开发对象操作。
    New generic ADT REST proxy ANY /api/adt/{path}: transparently forwards to the SAP ADT REST API (/sap/bc/adt/** — the same API Eclipse ADT uses), for short-dump inspection, ABAP class source read/write and other development-object operations.

    • 读操作（GET）直接透传；典型用法：/api/adt/runtime/dumps（ST22 dump 列表）、/api/adt/runtime/dump/<key>/formatted（dump 全文）、/api/adt/oo/classes/<name>/source/main（类源码）。
      GETs are forwarded as-is; e.g. /api/adt/runtime/dumps (dump list), /api/adt/runtime/dump/<key>/formatted (full ST22 text), /api/adt/oo/classes/<name>/source/main (class source).
    • 写方法（POST/PUT/DELETE/PATCH）自动获取并携带 X-CSRF-Token + 会话 Cookie，遇 403 自动刷新重试一次；凭据由网关统一持有。
      Write methods automatically fetch and attach the X-CSRF-Token + session cookie (one automatic retry on 403); credentials are held by the gateway.
    • ETag / Last-Modified / If-Match / If-None-Match 双向透传，支持乐观锁写流程（如类源码更新）。
      ETag / Last-Modified / If-Match / If-None-Match are passed through both ways, enabling optimistic-locking write flows (e.g. class source updates).
    • 路径按原始 percent-encoded 形式转发（保留 %2F/%20 等编码意图），解码仅用于安全校验（拒绝 .. 段与控制字符）。
      Paths are forwarded with their original percent-encoding; decoding is only used for safety checks (rejecting .. segments and control characters).
    • ADT 自身的 HTTP 状态码与响应体原样透传；网关侧故障才走 JSON 错误契约：400 ADT_PATH_INVALID / 502 ADT_UNREACHABLE / 503 ADT_DISABLED / 504 ADT_TIMEOUT。
      ADT's own status codes and bodies pass through verbatim; only gateway-side failures use the JSON error contract: 400 ADT_PATH_INVALID / 502 ADT_UNREACHABLE / 503 ADT_DISABLED / 504 ADT_TIMEOUT.

Configuration / 配置

  • SAP_ADT_BASE_URL：ADT 基地址，默认 http://<SAP_ASHOST>:50000；显式设为空串可禁用代理（503 ADT_DISABLED）。
    SAP_ADT_BASE_URL: ADT base URL, defaults to http://<SAP_ASHOST>:50000; set to an empty string to disable the proxy (503 ADT_DISABLED).
  • SAP_ADT_USER / SAP_ADT_PASSWD：代理认证，默认沿用 SAP_USER / SAP_PASSWD。
    SAP_ADT_USER / SAP_ADT_PASSWD: proxy credentials, default to SAP_USER / SAP_PASSWD.
  • 需要目标系统启用 ADT ICF 服务（SICF）。
    Requires the ADT ICF service to be active in the target system (SICF).

Docs / 文档

  • AGENTS.md / AGENTS.zh-CN.md、.env.example 同步新增端点与配置说明。
    AGENTS.md / AGENTS.zh-CN.md and .env.example document the new endpoint and configuration.

Full Changelog: v0.4.10...v0.4.11

Assets 7
Loading