<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Jack-Liang · 文章</title><description>ABAP 开发者 · 记录代码与生活的点滴</description><link>https://jack-liang.com/</link><item><title>ABAP 试用容器下架之后：一场 Hardware Key 之谜的排查记录</title><link>https://jack-liang.com/blog/abap-trial-2025-hardware-key-mystery/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-trial-2025-hardware-key-mystery/</guid><description>ABAP Cloud Developer Trial 2025 已全面下架，本地容器重建后 Hardware Key 变了、旧许可失效、申请渠道也没了。这篇记录把容器救回来的全过程——包括三个查不到资料的发现：固定 MAC 是无效的、内核会自己签许可、以及双容器并发会踩的网络坑。</description><pubDate>Fri, 20 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;之前写过一篇&lt;a href=&quot;/blog/abap-cloud-developer-trial/&quot;&gt;能跑在笔记本中的 SAP 系统&lt;/a&gt;，介绍过 SAP 的 ABAP 试用容器：一台笔记本就能跑一套完整的 ABAP Cloud 开发环境（ABAP Stack + HANA），对自学 ABAP Cloud 的人来说是不可替代的玩具。&lt;/p&gt;
&lt;p&gt;坏消息是：&lt;strong&gt;2026 年 11 月 17 日起，这个试用镜像从 Docker Hub 和 SAP Cloud Appliance Library 全面下架&lt;/strong&gt;，配套的 minisap 临时许可申请入口也同步关闭了。好消息是：本地镜像还在的机器上，容器依然可以救活，而且过程里有一些查遍全网都找不到的发现，值得记录。&lt;/p&gt;
&lt;h2&gt;现象：重建容器后，许可失效了&lt;/h2&gt;
&lt;p&gt;我的容器 a4h-2025 是今年 8 月底装的，用的是 minisap 申请的临时许可（SAP 的试用许可只有三个月寿命，到期要去 minisap 重新申请）。11 月中旬我重建了一个新容器，按照社区惯例固定了 MAC 地址——因为大家都知道 &lt;strong&gt;SAP 的 Hardware Key（许可绑定的硬件指纹）是从网络卡信息派生的&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;然后诡异的事情发生了：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;容器&lt;/th&gt;
&lt;th&gt;MAC 地址&lt;/th&gt;
&lt;th&gt;Hardware Key&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;旧容器（11月初，许可申请时）&lt;/td&gt;
&lt;td&gt;be:a8:ce:35:64:20&lt;/td&gt;
&lt;td&gt;Z0906102924&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;旧容器（重启后）&lt;/td&gt;
&lt;td&gt;be:a8:ce:35:64:20&lt;/td&gt;
&lt;td&gt;F0303562953&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;新容器&lt;/td&gt;
&lt;td&gt;be:a8:ce:35:64:20&lt;/td&gt;
&lt;td&gt;I0175959389&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;同一个 MAC 地址，三个不同的 Hardware Key。&lt;/strong&gt; 旧许可在新 key 上直接失效，而 minisap 的 A4H 申请入口也随下架一起关闭了——官方渠道全断，系统变成孤儿。&lt;/p&gt;
&lt;h2&gt;排查：MAC 固定为什么没用&lt;/h2&gt;
&lt;p&gt;第一反应是怀疑自己哪里做错了，但反复核对：MAC 一致、hostname 一致、IP 一致，key 就是变。翻许可库（SAPLIKEY 表）找线索的时候发现了一个很有说服力的证据：&lt;strong&gt;表里躺着几十个不同 Hardware Key 的许可检查记录，全是镜像构建时期留下的&lt;/strong&gt;——也就是说 SAP 自己的构建管线里，同一个镜像在几十个环境里产生的 key 也各不相同。&lt;/p&gt;
&lt;p&gt;结论：&lt;strong&gt;Hardware Key 的派生不止依赖 MAC&lt;/strong&gt;，它绑定的是容器实例和运行环境的组合（宿主内核、运行时状态都有嫌疑）。固定 MAC 能消除一个变量，但消不掉所有变量。社区流传的『固定 MAC 就能保住许可』在老版本镜像或 Linux 原生 Docker 上可能成立，在 Docker Desktop + Apple Silicon 这套组合上不成立。&lt;/p&gt;
&lt;h2&gt;插曲：双容器并发会踩的网络坑&lt;/h2&gt;
&lt;p&gt;排查期间还踩了一个和许可无关但更隐蔽的坑：新容器启动时，旧容器还在运行。两个容器的 MAC 和发布端口完全相同，结果是&lt;strong&gt;后启动的容器网络端点挂载失败&lt;/strong&gt;——容器能起来，但没有网络。&lt;/p&gt;
&lt;p&gt;这个状态非常隐蔽：容器健康、进程都在，但 ABAP 的消息服务器启动时直接报错退出，日志里的关键是这一行：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;*** ERROR =&amp;gt; NiHL6OSLookupNameToAddr: NiPGetHostByName(vhcala4hci) failed
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;主机名解析失败的原因是 &lt;strong&gt;/etc/hosts 里缺少了主机名条目&lt;/strong&gt;（正常情况下 Docker 会在启动时写入 &lt;code&gt;172.17.0.x vhcala4hci&lt;/code&gt; 这一行），而 hosts 缺行的原因又是网络端点没挂上。三层因果叠在一起，第一次遇到很难定位。&lt;/p&gt;
&lt;p&gt;修复方法：确保另一个容器停止后，重新挂载网络并重启——&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;docker network connect bridge a4h-2025
docker restart a4h-2025
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;重挂载会持久化到容器配置里，之后重启就不会再丢。&lt;/p&gt;
&lt;h2&gt;意外发现：内核会自己签许可&lt;/h2&gt;
&lt;p&gt;把网络修好之后，真正的惊喜来了。a4h-2025 的 Hardware Key 因为网络端点重建又变了一次（变成了 R0258830004），按理说系统应该继续处于无许可状态——但 ABAP 栈完整启动了，许可状态全部 &lt;strong&gt;valid&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Hardware Key          : R0258830004
Software Product      : NetWeaver_HDB
Type of License Key   : temporary
Begin of Validity     : 20261119
End   of Validity     : 20261217
Validity              : valid
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;查许可库才发现：&lt;strong&gt;ABAP 内核在工作进程启动的许可检查路径上，会自动为当前的 Hardware Key 签发一套临时许可&lt;/strong&gt;（NetWeaver_HDB 28 天 + Maintenance_HDB 60 天）。也就是说 Hardware Key 漂移之后，系统重启一次，内核很大概率会&lt;strong&gt;自愈&lt;/strong&gt;——自己给自己签一套新的临时许可。&lt;/p&gt;
&lt;p&gt;这个行为我翻遍了 SAP 社区和 FAQ 都没找到记载，但它解释了一个现象：很多容器用户会发现『重建容器之后莫名其妙又能用了』。&lt;/p&gt;
&lt;h2&gt;逆向：把签名方案挖出来&lt;/h2&gt;
&lt;p&gt;自愈机制能让系统活下来，但我想知道&lt;strong&gt;签名本身是怎么算的&lt;/strong&gt;——如果能独立复现，就不再依赖任何 SAP 组件。目标二进制是 &lt;code&gt;saplikey&lt;/code&gt;：13MB 的 ELF x86-64，SAP 内核的二进制向来带完整符号表和调试信息，这意味着 objdump 的符号表就是一张现成的地图。&lt;/p&gt;
&lt;h3&gt;第一步：从符号表里读出调用链&lt;/h3&gt;
&lt;p&gt;SAP 内核代码的命名纪律救了大忙。符号表里许可相关的函数按前缀分成三组，职责一目了然：&lt;code&gt;likeyind_*&lt;/code&gt; 是许可内部实现，&lt;code&gt;likeyadm_*&lt;/code&gt; 是管理命令，&lt;code&gt;wlikey_*&lt;/code&gt; 是工作进程侧的许可检查。把 &lt;code&gt;-temp&lt;/code&gt; 命令的处理函数往下追，很快得到一条三级调用链——&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;likeyind_make_temporary_likey      装配临时许可结构（字段、日期、系统号）
  └─ get_to_be_signed_format_sensitiv   把字段拼成『待签串』（定宽 + 空格填充）
      └─ likeyind_calculate_fingerprint   对待签串算指纹（即签名）
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;三个函数各司其职，尺寸分别是 692、2184 和 794 字节——第三个尺寸小得可疑，值得优先解剖。&lt;/p&gt;
&lt;h3&gt;第二步：解剖指纹函数&lt;/h3&gt;
&lt;p&gt;794 字节的反汇编，调用序列一目了然：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;haMD5Init(ctx)
convert_UC_to_UTF8(arg1, buf, &amp;amp;len, 0x1f40)   ← 待签串：UC(UTF-16) 转 UTF-8
haMD5Update(ctx, buf, len)
convert_UC_to_UTF8(const_ptr, buf, &amp;amp;len, 0x1f40)  ← 注意：输入不是参数
haMD5Update(ctx, buf, len)                    ← 第二段输入来自 .rodata
haMD5Final(ctx, digest)                       ← 16 字节摘要
likeyb64_encode(digest, 0x10, out, 0x18)      ← 16 字节进，24 字符出
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;两次 &lt;code&gt;haMD5Update&lt;/code&gt; 是整个函数的核心：第一段是调用方传入的待签串，第二段的输入&lt;strong&gt;不是任何参数，而是硬编码在只读段里的一个常量&lt;/strong&gt;。MD5 摘要 16 字节、base64 编码 24 字符——与许可行里观测到的签名长度完全吻合。没有 HMAC、没有密钥调度、没有非对称：&lt;strong&gt;秘密全部浓缩在那个常量里&lt;/strong&gt;，而它就躺在二进制的只读段中。&lt;/p&gt;
&lt;p&gt;顺带一提，调用方在拿到 base64 之后会给它加 &lt;code&gt;0024&lt;/code&gt; 这样的长度前缀，再拼进许可行——SAPLIKEY 的行格式是自描述的：每段数据前面都有 4 位十进制长度标记，这也是后面做格式穷举时最可靠的锚点。&lt;/p&gt;
&lt;h3&gt;第三步：待签串格式——测试向量驱动&lt;/h3&gt;
&lt;p&gt;待签串装配函数有 2184 字节，字段以『指针 + 长度』对数组组织，SIMD 指令做定宽空格填充，中间还有按产品名分叉的分支——逐条硬读汇编的性价比很低。但这里有个巧劲：&lt;strong&gt;许可库里躺着内核自己签出的完整许可行，字段和签名都是现成的测试向量&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;做法：把许可行里的字段值拆出来，按『字段顺序 × 分隔符 × 编码 × 填充方式』组合穷举候选待签串，每条候选算一次 MD5，与许可行里的签名逐字节比对。穷举命中时 MD5 逐字节一致——格式即告锁定；再用另一条不同产品、不同日期的许可行交叉验证，同样命中。两条独立向量都过，格式就不再有歧义。&lt;/p&gt;
&lt;p&gt;最终结论：&lt;strong&gt;签名 = MD5(字段规范拼接 ‖ 固定常量)，无 HMAC、无密钥&lt;/strong&gt;。签名常量与拼接的精确规格不在文中展开——原因见下。&lt;/p&gt;
&lt;h3&gt;顺带挖出来的：-temp 的守卫&lt;/h3&gt;
&lt;p&gt;逆向过程中顺带弄清了 &lt;code&gt;saplikey -temp&lt;/code&gt; 为什么在试用系统上永远失败：自签入口前面有一个守卫函数，逻辑是解析『上次永久许可成功校验』的日期，加上 28 天后与当天比较——试用系统从来没有永久许可，这个日期永远不存在，守卫永远不放行。这也解释了为什么社区里试用容器的许可问题只能靠『重启碰自愈』或者外部方案解决：守卫把官方的自签通道焊死了，而自愈路径恰好没有这个守卫。&lt;/p&gt;
&lt;h2&gt;解决方案的分层&lt;/h2&gt;
&lt;p&gt;自愈不是每次都可靠（比如镜像刚装好、内核还没跑过许可检查的第一次启动），所以我做了三层方案。这里只说思路，具体实现不在文中展开：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;内核原生自签（首选，零维护）&lt;/strong&gt;：利用上面发现的自愈机制——每次 key 变化后正常重启一次容器，让内核自己签。实测 a4h-2025 就是靠这个恢复的。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;独立签名生成器（方案 B，纯 Python）&lt;/strong&gt;：逆向了临时许可的签名方案之后，写了一个不依赖任何 SAP 组件的生成器——任意有效期、任意字段组合，产出可以直接入库的标准许可行。已用内核自己生成的许可做逐字节验证，内核完全接受。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;内核原生路径补丁（方案 A，保险）&lt;/strong&gt;：给 saplikey 的自签入口绕过一个前置守卫，让内核用自己的签名器为当前机器签发许可。作为 B 失效时的保险（比如未来换用不同内核构建的镜像）。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;三层方案互相独立，日常根本用不上——容器里的 10 年期许可装好之后，这件事就结束了。&lt;/p&gt;
&lt;h2&gt;关于边界的说明&lt;/h2&gt;
&lt;p&gt;两句话：自己逆向研究、成果私有保存，在多数法域属于可辩护的学习行为；公开传播可运行的绕过工具则是另一回事——所以签名常量与生成器不在公开范围内。另外，这个产品的官方许可本来就是三个月一签的临时许可，从不存在『永久许可』；用它自己的临时许可机制保住一个官方已停止分发、关闭许可渠道的免费学习系统，是最贴合原意的保存方式。&lt;/p&gt;
&lt;h2&gt;经验总结&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;固定 MAC 不是许可的护身符&lt;/strong&gt;：Hardware Key 绑定的是容器实例与环境的组合，key 漂移是常态。别再和 MAC 较劲，方案设计要假设 key 随时变。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;许可丢了先重启容器再说&lt;/strong&gt;：内核的自愈路径可能直接救活，一行命令的事。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;多容器同镜像部署时，MAC/端口冲突会让后启动者丢网络&lt;/strong&gt;：症状是『容器活着但主机名解析失败』，修复用 &lt;code&gt;docker network connect&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;镜像记得备份&lt;/strong&gt;：下架之后，&lt;code&gt;sapse/abap-cloud-developer-trial:2025&lt;/code&gt; 这个镜像就是绝版。&lt;code&gt;docker save&lt;/code&gt; 一份到冷存储，比任何许可方案都重要。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;发稿前的最后状态&lt;/h2&gt;
&lt;p&gt;文章写到收尾，容器又重启了一轮——不出所料，&lt;strong&gt;Hardware Key 又漂了一次&lt;/strong&gt;（这次是 R1526609231），文章里那个 R0258830004 已成历史。新的临时许可随之就位，窗口给到了一年：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/LicenseOK.png&quot; alt=&quot;SLICENSE 中的两行 Temp 许可，有效期至 2036-11-16&quot;&gt;&lt;/p&gt;
&lt;p&gt;两行许可双双 Valid，有效期到 2036 年 11 月 16 日。这大概是这篇排查记录最好的结尾：&lt;strong&gt;key 会一直漂，这正是文章的核心论点——方案设计必须假设 key 随时变，而系统也确实能在漂移中自我修复。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;如果你也在维护这套试用容器、遇到了许可问题，希望这篇的排查路径能帮你少走弯路——官方渠道虽然关了，但这个学习系统还远没到寿命终点。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>用 sapcli 把 SAP 接进 CI：Docker 靶场、代理排障与 JUnit 闭环</title><link>https://jack-liang.com/blog/sapcli-abap-ci-pipeline/</link><guid isPermaLink="true">https://jack-liang.com/blog/sapcli-abap-ci-pipeline/</guid><description>SE80 和 SAPGUI 不是 ABAP 的唯一入口。用 sapcli 把对象的创建、激活、测试全变成命令行动作——包括一个伪装成 TLS 错误的 macOS 系统代理坑。</description><pubDate>Tue, 17 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;一台 Mac、一个 Docker 里的 ABAP Cloud Developer Trial、一个命令行工具。
本文把「搭环境 → 连上系统 → 跑 ABAP → 跑测试 → 吐 JUnit」这条工具链走通。至于在这套环境里写 AMDP、建 CDS、直连 HANA，见&lt;a href=&quot;/blog/sapcli-amdp-cds-hana-pipeline/&quot;&gt;下篇&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;0. 为什么折腾这个&lt;/h2&gt;
&lt;p&gt;SAP 世界的开发体验长期被两件事拖累：GUI（SE80/SAPGUI）和&amp;quot;只能在 SAP 里看 SAP&amp;quot;。但如果你的 ABAP 对象可以通过 HTTP/ADT 读写、ABAP Unit 能吐 JUnit——那 SAP 就只是一个可以进 CI 流水线、可以进 AI Agent 工具箱的普通组件。&lt;/p&gt;
&lt;p&gt;今天试用了 &lt;a href=&quot;https://github.com/jfilak/sapcli&quot;&gt;sapcli&lt;/a&gt; ，它就是那个&amp;quot;让 SAP 变普通&amp;quot;的命令行工具：Python 写的，走 ADT (ABAP Development Tools) over HTTP，官方定位就是&amp;quot;build your CI tools&amp;quot;。&lt;/p&gt;
&lt;h2&gt;1. 环境：10 分钟搭好靶场&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;ABAP 系统&lt;/strong&gt;：Docker 跑 &lt;code&gt;sapse/abap-cloud-developer-trial:2025&lt;/code&gt;（SID=A4H，HANA 内核，内置 SFLIGHT/SCARR/SPFLI/SBOOK 经典航班数据和 64 万条 T100 消息文本）。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;sapcli&lt;/strong&gt;：不在 PyPI，直接从 GitHub 装：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;python3 -m venv sapcli-venv
sapcli-venv/bin/pip install git+https://github.com/jfilak/sapcli
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;连接配置&lt;/strong&gt;（kubeconfig 风格，&lt;code&gt;~/.sapcli/config.yml&lt;/code&gt;）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-yaml&quot;&gt;current-context: a4h

connections:
  a4h:
    ashost: 127.0.0.1 # 故意的，见下文第一个坑
    client: &amp;#39;001&amp;#39;
    port: 50001 # trial 的 ADT HTTPS 端口
    ssl: true
    ssl_verify: false # 自签名证书
    ssl_use_system_certs: false # 排障时加的，见坑 1.5

users:
  developer:
    user: DEVELOPER
    password: &amp;lt;trial 密码，在容器 env ABAP_TRIAL_DETACH_PWD 里&amp;gt;

contexts:
  a4h:
    connection: a4h
    user: developer
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;chmod 600 ~/.sapcli/config.yml
sapcli abap systeminfo
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code&gt;SID: A4H
userName: DEVELOPER
client: 001
DBName: HDB/02
KernelRelease: 916
...
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;坑 1：macOS 系统代理会&amp;quot;劫持&amp;quot; sapcli&lt;/h3&gt;
&lt;p&gt;我最先配的 &lt;code&gt;ashost: vhcala4hci&lt;/code&gt;（/etc/hosts 里指向 127.0.0.1 的 trial 主机名），结果报 &lt;code&gt;SSL: UNEXPECTED_EOF_WHILE_READING&lt;/code&gt;。排查过程很有戏剧性：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;curl&lt;/code&gt; 能通 → 排除服务端问题&lt;/li&gt;
&lt;li&gt;裸 Python &lt;code&gt;ssl&lt;/code&gt; 握手能通 → 排除 TLS 版本/密码套件问题&lt;/li&gt;
&lt;li&gt;&lt;code&gt;requests&lt;/code&gt; 对 &lt;code&gt;127.0.0.1&lt;/code&gt; 通、对 &lt;code&gt;vhcala4hci&lt;/code&gt; 不通 → 唯一差异是主机名&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;最后发现：&lt;strong&gt;macOS 系统代理&lt;/strong&gt;（Clash 之类的工具，&lt;code&gt;127.0.0.1:7897&lt;/code&gt;）会被 Python 的 &lt;code&gt;urllib.request.getproxies()&lt;/code&gt; 自动读到，&lt;code&gt;requests&lt;/code&gt; 诚实遵守。&lt;code&gt;localhost&lt;/code&gt;/&lt;code&gt;127.0.0.1&lt;/code&gt; 在内置白名单里自动绕过，其他主机名全部走代理——而代理把到 SAP 的 TLS 连接重置了。&lt;strong&gt;不是 SSL 的问题，是代理的问题。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;解法二选一：&lt;code&gt;ashost&lt;/code&gt; 直接写 &lt;code&gt;127.0.0.1&lt;/code&gt;，或运行时 &lt;code&gt;no_proxy=vhcala4hci&lt;/code&gt;。&lt;/p&gt;
&lt;h3&gt;坑 1.5：&lt;code&gt;--ssl-no-system-certs&lt;/code&gt; 的真实含义&lt;/h3&gt;
&lt;p&gt;排查时我以为是 truststore（macOS 系统信任库）的问题，加了 &lt;code&gt;ssl_use_system_certs: false&lt;/code&gt;。后来证明治不了本，但这个开关值得记录：sapcli 默认用系统信任库验证证书，关掉后回退到 certifi 内置 CA。对自签名 trial 环境来说，&lt;code&gt;ssl_verify: false&lt;/code&gt; 才是关键。&lt;/p&gt;
&lt;h2&gt;2. sapcli 日常：把 ABAP 当成普通仓库操作&lt;/h2&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;# 跑 ABAP 片段（内部包成临时 class 的 classrun）
cat &amp;gt; /tmp/hello.abap &amp;lt;&amp;lt;&amp;#39;EOF&amp;#39;
out-&amp;gt;write( |Hello from sapcli, answer = { 40 + 2 }| ).
EOF
sapcli abap run /tmp/hello.abap --package &amp;#39;$TMP&amp;#39;
# Hello from sapcli, answer = 42

# 对象全生命周期
sapcli class create ZCL_FOO &amp;quot;desc&amp;quot; &amp;#39;$TMP&amp;#39;
sapcli class write ZCL_FOO ./zcl_foo.abap -a        # -a = 写完即激活
sapcli class read ZCL_FOO                            # 回读
sapcli class delete ZCL_FOO

# ABAP Unit → JUnit（喂给 CI 的姿势）
sapcli aunit run class ZCL_FOO --output junit4 &amp;gt; junit.xml
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;三个和直觉不同的细节：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;abap run&lt;/code&gt; 里输出必须用 &lt;code&gt;out-&amp;gt;write()&lt;/code&gt;&lt;/strong&gt;——代码被包进 &lt;code&gt;if_oo_adt_classrun~main&lt;/code&gt;，经典 &lt;code&gt;WRITE&lt;/code&gt; 语句不会被 console 捕获。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;class write --type definitions/implementations&lt;/code&gt; 是局部 include&lt;/strong&gt;（SE24 的 Local Types 页签），不是全局类定义；全局类源码用默认 &lt;code&gt;--type main&lt;/code&gt; 整文件写，测试类单独走 &lt;code&gt;--type testclasses&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;激活是独立命令&lt;/strong&gt;：&lt;code&gt;sapcli activation objects activate --object CLAS=ZCL_FOO&lt;/code&gt;，支持一次捆绑多个对象——遇到交叉引用的对象（比如 AMDP 类和它的 CDS 表函数），分开激活会互相卡住，捆绑激活一次通过。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;3. 用 ABAP Unit 吐 JUnit：CI 的最后一块拼图&lt;/h2&gt;
&lt;p&gt;随手写个类和它的测试（&lt;code&gt;--type main&lt;/code&gt; 与 &lt;code&gt;--type testclasses&lt;/code&gt; 两个文件）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; zcl_sapcli_test.abap — main
CLASS zcl_sapcli_test DEFINITION PUBLIC FINAL CREATE PUBLIC.
  PUBLIC SECTION.
    METHODS add IMPORTING iv_a TYPE i iv_b TYPE i
                RETURNING VALUE(rv_r) TYPE i.
ENDCLASS.

CLASS zcl_sapcli_test IMPLEMENTATION.
  METHOD add.
    rv_r = iv_a + iv_b.
  ENDMETHOD.
ENDCLASS.
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; zcl_sapcli_test.tst.abap — testclasses
CLASS ltcl_test DEFINITION FINAL FOR TESTING DURATION SHORT RISK LEVEL HARMLESS.
  PRIVATE SECTION.
    METHODS test_add FOR TESTING.
ENDCLASS.

CLASS ltcl_test IMPLEMENTATION.
  METHOD test_add.
    cl_abap_unit_assert=&amp;gt;assert_equals( exp = 5 act = NEW zcl_sapcli_test( )-&amp;gt;add( iv_a = 2 iv_b = 3 ) ).
  ENDMETHOD.
ENDCLASS.
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;sapcli class create ZCL_SAPCLI_TEST &amp;quot;demo&amp;quot; &amp;#39;$TMP&amp;#39;
sapcli class write ZCL_SAPCLI_TEST /tmp/zcl_sapcli_test.abap
sapcli class write --type testclasses ZCL_SAPCLI_TEST /tmp/zcl_sapcli_test.tst.abap
sapcli activation objects activate --object CLAS=ZCL_SAPCLI_TEST
sapcli aunit run class ZCL_SAPCLI_TEST --output junit4 &amp;gt; junit.xml
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code class=&quot;language-xml&quot;&gt;&amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&amp;lt;testsuites title=&amp;quot;Run&amp;quot; system=&amp;quot;A4H&amp;quot;
 client=&amp;quot;001&amp;quot; executedBy=&amp;quot;DEVELOPER&amp;quot; failures=&amp;quot;0&amp;quot; errors=&amp;quot;0&amp;quot; tests=&amp;quot;1&amp;quot;&amp;gt;
  &amp;lt;testsuite name=&amp;quot;&amp;quot; tests=&amp;quot;1&amp;quot; failures=&amp;quot;0&amp;quot;&amp;gt;
    &amp;lt;testcase classname=&amp;quot;$tmp.clas:zcl_sapcli_test---ltcl_test&amp;quot; name=&amp;quot;test_add&amp;quot;/&amp;gt;
  &amp;lt;/testsuite&amp;gt;
&amp;lt;/testsuites&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;标准 JUnit XML——Jenkins、GitLab CI、GitHub Actions 全都认识。故意写个断言失败（&lt;code&gt;exp = 99 act = 2&lt;/code&gt;），失败信息、堆栈、所在 Include 行号一样不少，该有的信号都有。&lt;/p&gt;
&lt;h2&gt;4. CI 闭环&lt;/h2&gt;
&lt;p&gt;至此齐活：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;git push
  └─ CI Job
       ├─ sapcli class write ...            # 部署源码
       ├─ sapcli activation objects activate # 激活
       ├─ sapcli aunit run --output junit4   # 回归测试
       └─ sapcli abap run smoke.abap         # 冒烟脚本
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;所有操作都是 HTTP，不需要 SAPGUI，不需要 VPN 里的 GUI 跳板。写代码的人在本地用任何编辑器，CI 在流水线里把源码推进 SAP——这就是&amp;quot;把 SAP 变成普通组件&amp;quot;的含义。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;这还不是终点&lt;/strong&gt;：环境里那颗 HANA 心脏才是 trial 最值钱的部分。下一篇把计算真正下推到数据库——在 SFLIGHT 上从零建 AMDP 表函数、CDS 消费层，最后用一句纯 SQL 直连读它：&lt;/p&gt;
&lt;p&gt;👉 &lt;a href=&quot;/blog/sapcli-amdp-cds-hana-pipeline/&quot;&gt;AMDP 表函数从零到 HANA 直连：SFLIGHT 全链路实录&lt;/a&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;环境备忘：ABAP Cloud Developer Trial 2025（Docker，端口 50001=ADT），client 001，演示对象全在 &lt;code&gt;$TMP&lt;/code&gt; 可随时删除。文中所有输出均为系统实测。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>AMDP 表函数从零到 HANA 直连：SFLIGHT 全链路实录</title><link>https://jack-liang.com/blog/sapcli-amdp-cds-hana-pipeline/</link><guid isPermaLink="true">https://jack-liang.com/blog/sapcli-amdp-cds-hana-pipeline/</guid><description>client-dependent 三件套、AMDP 四连坑、捆绑激活解「鸡生蛋」、#covw 授权暗坑、CDS 落库三种形态——在 SFLIGHT 上把 ABAP → AMDP → CDS → 纯 SQL 直连一次走通，所有输出均为实测。</description><pubDate>Tue, 17 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;前置说明：本文的运行环境是 Docker 里的 ABAP Cloud Developer Trial 2025（SID=A4H，client 001），所有对象用命令行工具 sapcli 创建和激活，连接配置、代理排障这些准备工作写在&lt;a href=&quot;/blog/sapcli-abap-ci-pipeline/&quot;&gt;上一篇&lt;/a&gt;里，不再重复。文中所有输出均为系统实测。&lt;/p&gt;
&lt;p&gt;数据：经典 SFLIGHT 航班模型——SFLIGHT 107 行（client 000/001 各有数据）、SCARR 21 家航司、SPFLI 36 条航线。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;0. 目标&lt;/h2&gt;
&lt;p&gt;按「航司 + 航线」统计航班数、均价、最低价，一路做完四层：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;AMDP 类（SQLScript 表函数）
  └─ CDS 表函数（client-dependent，ABAP 消费入口）
       └─ CDS view entity（Open SQL 消费入口）
            └─ HANA 直连 SQL（数据库侧原生读取）
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;ABAP 世界里和 AMDP 相关的文章不少，但大多停在「怎么写 AMDP 类」；这次把消费层（CDS）、数据库层（直连授权）也一次走通——坑恰恰都埋在后半段。&lt;/p&gt;
&lt;h2&gt;1. AMDP 类：四个必须写对的细节&lt;/h2&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CLASS zcl_sapcli_flight DEFINITION PUBLIC FINAL CREATE PUBLIC.
  PUBLIC SECTION.
    INTERFACES if_amdp_marker_hdb.

    CLASS-METHODS get_flight_stats FOR TABLE FUNCTION ztfflightstats.

  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.

CLASS zcl_sapcli_flight IMPLEMENTATION.

  METHOD get_flight_stats
      BY DATABASE FUNCTION
      FOR HDB
      LANGUAGE SQLSCRIPT
      OPTIONS READ-ONLY
      USING sflight.

    RETURN SELECT mandt AS clnt,
                  carrid AS carrid,
                  connid AS connid,
                  COUNT(*) AS flights,
                  ROUND( AVG( price ), 2 ) AS avg_price,
                  MIN( price ) AS min_price
             FROM sflight
            WHERE mandt = :clnt
            GROUP BY mandt, carrid, connid
            ORDER BY carrid, connid;

  ENDMETHOD.

ENDCLASS.
&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;CLASS-METHODS ... FOR TABLE FUNCTION&lt;/code&gt; 声明&lt;strong&gt;不带参数列表&lt;/strong&gt;——签名完全由 CDS 表函数的定义派生&lt;/li&gt;
&lt;li&gt;&lt;code&gt;USING sflight&lt;/code&gt; 必须声明，AMDP 里引用的 DDIC 对象都要在 USING 里列出来，否则报 &lt;code&gt;&amp;quot;SFLIGHT&amp;quot; is unknown&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;SQLScript 体内要&lt;strong&gt;显式 &lt;code&gt;RETURN SELECT&lt;/code&gt;&lt;/strong&gt;——很多老示例只写一个裸 &lt;code&gt;SELECT&lt;/code&gt;，在较新的 HANA 内核上会报 &lt;code&gt;RETURN statement should be defined for table function&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;体内用 &lt;code&gt;:clnt&lt;/code&gt; 引用传入参数&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;2. CDS 表函数：client-dependent 三件套&lt;/h2&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;@EndUserText.label: &amp;#39;Flight route statistics (AMDP table function)&amp;#39;
@ClientHandling.type: #CLIENT_DEPENDENT
@ClientHandling.algorithm: #SESSION_VARIABLE
@AccessControl.authorizationCheck: #NOT_ALLOWED
define table function ZTFFLIGHTSTATS
  with parameters
    @Environment.systemField : #CLIENT
    clnt : abap.clnt
  returns
  {
    key clnt   : abap.clnt;
    key carrid : abap.char( 3 );
    key connid : abap.numc( 4 );
    flights    : abap.int4;
    avg_price  : abap.dec( 15, 2 );
    min_price  : abap.dec( 15, 2 );
  }
  implemented by method zcl_sapcli_flight=&amp;gt;get_flight_stats
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;client 处理的三件套：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code&gt;clnt&lt;/code&gt; 参数标 &lt;code&gt;@Environment.systemField: #CLIENT&lt;/code&gt; → ABAP 消费方&lt;strong&gt;不用传&lt;/strong&gt;，session client 自动注入&lt;/li&gt;
&lt;li&gt;&lt;code&gt;returns&lt;/code&gt; &lt;strong&gt;第一个字段必须是 &lt;code&gt;abap.clnt&lt;/code&gt; 类型&lt;/strong&gt;——否则激活报 &lt;code&gt;is marked as client-specific; type field ... is CHAR (not CLNT)&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;SQLScript 里按 &lt;code&gt;mandt = :clnt&lt;/code&gt; 过滤，&lt;code&gt;GROUP BY&lt;/code&gt; 带上 &lt;code&gt;mandt&lt;/code&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;顺带一提：表结构要自己确认&lt;/h3&gt;
&lt;p&gt;我最初拿 T100 做实验，&lt;code&gt;WHERE mandt = :clnt&lt;/code&gt; 直接报 &lt;code&gt;invalid column name: MANDT&lt;/code&gt;——新版 ABAP Platform 里 T100 已经是跨 client 表了。老经验会过期，动手前先用一行 ABAP 确认结构：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA(lo_struct) = CAST cl_abap_structdescr( cl_abap_typedescr=&amp;gt;describe_by_name( &amp;#39;T100&amp;#39; ) ).
LOOP AT lo_struct-&amp;gt;get_ddic_field_list( p_including_substructres = abap_true )
     ASSIGNING FIELD-SYMBOL(&amp;lt;fs&amp;gt;).
  out-&amp;gt;write( &amp;lt;fs&amp;gt;-fieldname ).
ENDLOOP.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;类与 TF 的「鸡生蛋」问题&lt;/h3&gt;
&lt;p&gt;类声明 &lt;code&gt;FOR TABLE FUNCTION&lt;/code&gt;，TF 又声明 &lt;code&gt;implemented by method&lt;/code&gt;——谁都激活不了对方。解法是把所有对象都写成 inactive，然后捆绑激活一次通过（ADT 在一个事务里解析交叉引用）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;sapcli activation objects activate \
  --object CLAS=ZCL_SAPCLI_FLIGHT \
  --object DDLS=ZTFFLIGHTSTATS \
  --object DDLS=ZCFLIGHTSTATSV
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;AMDP 踩坑速查&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;#&lt;/th&gt;
&lt;th&gt;报错&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;th&gt;解法&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;&lt;code&gt;invalid column name: MANDT&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;新版 ABAP Platform 里 T100 已是&lt;strong&gt;跨 client 表&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;换 SFLIGHT；动手前确认表结构&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;quot;T100&amp;quot; is unknown. ... USING clause&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;AMDP 引用 DDIC 对象必须 USING 声明&lt;/td&gt;
&lt;td&gt;方法头加 &lt;code&gt;USING sflight&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;&lt;code&gt;RETURN statement should be defined&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;新内核要求 SQLScript 表函数显式返回&lt;/td&gt;
&lt;td&gt;体内写 &lt;code&gt;RETURN SELECT ...&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;激活报 client 字段类型不对&lt;/td&gt;
&lt;td&gt;client-dependent TF 的 returns 第一列必须 CLNT&lt;/td&gt;
&lt;td&gt;returns 开头放 &lt;code&gt;clnt : abap.clnt&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h2&gt;3. 消费侧：view entity 一行搞定 session client&lt;/h2&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;@AccessControl.authorizationCheck: #NOT_ALLOWED
define view entity ZCFLIGHTSTATSV
  as select from ztfflightstats( clnt : $session.client )
{
  key carrid,
  key connid,
  flights,
  avg_price,
  min_price
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;三个语法细节：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;view entity 里引用自身参数是 &lt;code&gt;$parameters.p_xxx&lt;/code&gt;，这里用 &lt;code&gt;$session.client&lt;/code&gt; 直接把 session client 喂给 TF&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;client-dependent 源的 view entity 不能把 client 字段放进字段列表&lt;/strong&gt;——client handling 继承后系统自动合成，写出来会报 &lt;code&gt;Client field is not allowed in the entity view&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;CDS 里 FROM 表函数&lt;strong&gt;不需要 &lt;code&gt;table_function&lt;/code&gt; 关键字&lt;/strong&gt;，直接写名字&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;然后 Open SQL 侧就非常干净了——不传参、不写 MANDT：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;SELECT v~carrid, c~carrname, v~connid, v~flights, v~avg_price, v~min_price
  FROM zcflightstatsv AS v
  INNER JOIN scarr AS c ON c~carrid = v~carrid
  ORDER BY v~flights DESCENDING
  INTO TABLE @DATA(lt_top).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;实测输出（client 001，共 14 条航线）：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Lufthansa            conn=0400  n=8  avg=666.00
United Airlines      conn=0941  n=8  avg=879.82
Singapore Airlines   conn=0002  n=6  avg=2320.04
Qantas Airways       conn=0005  n=6  avg=788.64
Japan Airlines       conn=0408  n=6  avg=1061.36
...
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;4. 用 ABAP Unit 给 AMDP 上保险&lt;/h2&gt;
&lt;p&gt;纯 SQL 对拍是最朴素的回归测试：基准用 Open SQL 直查底表（client handling 全自动），被测对象走完整链路，逐航线断言：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CLASS ltcl_flight_stats DEFINITION FINAL FOR TESTING DURATION SHORT RISK LEVEL HARMLESS.
  PRIVATE SECTION.
    METHODS route_stats_matches_open_sql FOR TESTING.
ENDCLASS.

CLASS ltcl_flight_stats IMPLEMENTATION.
  METHOD route_stats_matches_open_sql.
    SELECT carrid, connid, COUNT(*) AS cnt, AVG( price ) AS avg_p
      FROM sflight GROUP BY carrid, connid
      INTO TABLE @DATA(lt_expect).                      &amp;quot; 基准
    SELECT * FROM zcflightstatsv INTO TABLE @DATA(lt_actual).  &amp;quot; 被测
    cl_abap_unit_assert=&amp;gt;assert_equals(
        exp = lines( lt_expect ) act = lines( lt_actual ) ).
    LOOP AT lt_expect ASSIGNING FIELD-SYMBOL(&amp;lt;e&amp;gt;).
      READ TABLE lt_actual INTO DATA(ls_a)
           WITH KEY carrid = &amp;lt;e&amp;gt;-carrid connid = &amp;lt;e&amp;gt;-connid.
      cl_abap_unit_assert=&amp;gt;assert_subrc( ).
      cl_abap_unit_assert=&amp;gt;assert_equals( exp = &amp;lt;e&amp;gt;-cnt act = ls_a-flights ).
      cl_abap_unit_assert=&amp;gt;assert_true(
          act = xsdbool( abs( &amp;lt;e&amp;gt;-avg_p - ls_a-avg_price )
                         &amp;lt; CONV decfloat16( &amp;#39;0.011&amp;#39; ) ) ).
    ENDLOOP.
  ENDMETHOD.
ENDCLASS.
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;sapcli aunit run class ZCL_SAPCLI_FLIGHT --output junit4 &amp;gt; junit.xml
# ✔ ROUTE_STATS_MATCHES_OPEN_SQL [OK]
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;两个 Open SQL 细节（都是实测翻出来的）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;严格模式里子句顺序是 &lt;code&gt;SELECT → FROM → WHERE → GROUP BY → ORDER BY → INTO → UP TO&lt;/code&gt;——&lt;strong&gt;&lt;code&gt;UP TO n ROWS&lt;/code&gt; 要放在 &lt;code&gt;INTO&lt;/code&gt; 之后&lt;/strong&gt;，和很多老教程相反&lt;/li&gt;
&lt;li&gt;&lt;code&gt;abs(...) &amp;lt; &amp;#39;0.011&amp;#39;&lt;/code&gt; 会报&amp;quot;算术表达式不能与非数值操作数比较&amp;quot;，要用 &lt;code&gt;CONV decfloat16( &amp;#39;0.011&amp;#39; )&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;5. 直连 HANA：把表函数当普通函数读&lt;/h2&gt;
&lt;h3&gt;5.1 连接&lt;/h3&gt;
&lt;p&gt;trial 的 HANA SQL 端口是 &lt;strong&gt;30215&lt;/strong&gt;（实例 02；容器里 socat 转发到容器网内）。可用用户：&lt;code&gt;SYSTEM&lt;/code&gt; 和 schema 属主 &lt;code&gt;SAPA4H&lt;/code&gt;（密码同 trial 密码）。DBeaver 里选 SAP HANA 驱动，属性里 &lt;code&gt;encrypt=true&lt;/code&gt; + &lt;code&gt;sslValidateCertificate=false&lt;/code&gt; 即可。&lt;/p&gt;
&lt;p&gt;顺手写了个 20 行的 Python 小跑批（SAP 官方 hdbcli 驱动），多语句按 &lt;code&gt;;&lt;/code&gt; 分隔逐条执行，本文所有直连 SQL 都是它跑的：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-python&quot;&gt;#!/usr/bin/env python
# q.py — 用法: hana-venv/bin/python q.py 查询.sql（或从 stdin 管道）

from hdbcli import dbapi

conn = dbapi.connect(address=&amp;#39;127.0.0.1&amp;#39;, port=30215, user=&amp;#39;SYSTEM&amp;#39;,
                     password=&amp;#39;&amp;lt;trial 密码&amp;gt;&amp;#39;, encrypt=True, sslValidateCertificate=False)
cur = conn.cursor()

sql = open(sys.argv[1]).read() if len(sys.argv) &amp;gt; 1 else sys.stdin.read()
for stmt in [s.strip() for s in sql.split(&amp;#39;;&amp;#39;) if s.strip()]:
    cur.execute(stmt)
    if cur.description:
        for r in cur.fetchall():
            print(r)
    else:
        print(f&amp;#39;OK ({cur.rowcount} rows affected)&amp;#39;)
conn.close()
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;5.2 那句 SQL&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;SELECT s.&amp;quot;CARRID&amp;quot;, c.&amp;quot;CARRNAME&amp;quot;, s.&amp;quot;CONNID&amp;quot;, s.&amp;quot;FLIGHTS&amp;quot;, s.&amp;quot;AVG_PRICE&amp;quot;, s.&amp;quot;MIN_PRICE&amp;quot;
  FROM &amp;quot;SAPA4H&amp;quot;.&amp;quot;ZCL_SAPCLI_FLIGHT=&amp;gt;GET_FLIGHT_STATS&amp;quot;( clnt =&amp;gt; &amp;#39;001&amp;#39; ) AS s
  JOIN &amp;quot;SAPA4H&amp;quot;.&amp;quot;SCARR&amp;quot; AS c
    ON c.&amp;quot;MANDT&amp;quot; = s.&amp;quot;CLNT&amp;quot; AND c.&amp;quot;CARRID&amp;quot; = s.&amp;quot;CARRID&amp;quot;
  ORDER BY s.&amp;quot;FLIGHTS&amp;quot; DESC, s.&amp;quot;AVG_PRICE&amp;quot; DESC
  LIMIT 8;
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code&gt;CARRID | CARRNAME          | CONNID | FLIGHTS | AVG_PRICE | MIN_PRICE
UA     | United Airlines   | 0941   | 8       | 879.82    | 879.82
LH     | Lufthansa         | 0400   | 8       | 666       | 666
LH     | Lufthansa         | 0401   | 8       | 666       | 666
...
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;和 ABAP 侧输出完全一致。注意 HANA 侧的命名规则：&lt;strong&gt;函数名 = &lt;code&gt;类名=&amp;gt;方法名&lt;/code&gt;&lt;/strong&gt;，参数用 &lt;code&gt;=&amp;gt;&lt;/code&gt;，结果集大小写敏感要加引号。&lt;/p&gt;
&lt;h3&gt;5.3 踩坑实录（授权三连）&lt;/h3&gt;
&lt;p&gt;直连读 AMDP 对象，&lt;code&gt;insufficient privilege&lt;/code&gt; 会连续给你三次惊喜：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;函数本身&lt;/strong&gt;：&lt;code&gt;GRANT EXECUTE ON &amp;quot;SAPA4H&amp;quot;.&amp;quot;ZCL_SAPCLI_FLIGHT=&amp;gt;GET_FLIGHT_STATS&amp;quot; TO SYSTEM&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;底表&lt;/strong&gt;：函数是 &lt;code&gt;sql security invoker&lt;/code&gt;，调用方还要有底层表的读权限 → &lt;code&gt;GRANT SELECT ON &amp;quot;SAPA4H&amp;quot;.&amp;quot;SFLIGHT&amp;quot; TO SYSTEM&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;真正的坑&lt;/strong&gt;：AMDP 激活时会把 &lt;code&gt;USING sflight&lt;/code&gt; 编译成对覆盖率包装视图 &lt;code&gt;&amp;quot;ZCL_SAPCLI_FLIGHT=&amp;gt;SFLIGHT#covw&amp;quot;&lt;/code&gt; 的读取（#covw = coverage view）。查函数定义才能发现：&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;-- &amp;quot;SAPA4H&amp;quot;.&amp;quot;ZCL_SAPCLI_FLIGHT=&amp;gt;GET_FLIGHT_STATS&amp;quot; 的真实函数体
RETURN SELECT ... FROM &amp;quot;ZCL_SAPCLI_FLIGHT=&amp;gt;SFLIGHT#covw&amp;quot; WHERE ...
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;所以还差一刀：&lt;code&gt;GRANT SELECT ON &amp;quot;SAPA4H&amp;quot;.&amp;quot;ZCL_SAPCLI_FLIGHT=&amp;gt;SFLIGHT#covw&amp;quot; TO SYSTEM&lt;/code&gt;。&lt;strong&gt;每建一个 AMDP 对象，都要把对应的 &lt;code&gt;类名=&amp;gt;表名#covw&lt;/code&gt; 授出去。&lt;/strong&gt;&lt;/p&gt;
&lt;h2&gt;6. 意外收获：CDS 视图在 HANA catalog 里的三种形态&lt;/h2&gt;
&lt;p&gt;为了搞清「直连能不能读 CDS 视图」，我做了组对比实验，结论比预想有趣：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;CDS 实体&lt;/th&gt;
&lt;th&gt;HANA catalog 形态&lt;/th&gt;
&lt;th&gt;直连姿势&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;CDS 表函数&lt;/td&gt;
&lt;td&gt;HANA function&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;quot;类=&amp;gt;方法&amp;quot;( clnt =&amp;gt; &amp;#39;001&amp;#39; )&lt;/code&gt; 命名传参&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;旧式 &lt;code&gt;define view&lt;/code&gt;（DDIC-based，已 deprecated）&lt;/td&gt;
&lt;td&gt;普通视图（名字 = &lt;code&gt;@AbapCatalog.sqlViewName&lt;/code&gt;）&lt;/td&gt;
&lt;td&gt;&lt;code&gt;SELECT * FROM &amp;quot;SAPA4H&amp;quot;.&amp;quot;ZCOLDV&amp;quot;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;新式 &lt;code&gt;define view entity&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;也物化成真实视图&lt;/strong&gt;（on-stack 平台特有；官方文档说 Cloud 上不落库）&lt;/td&gt;
&lt;td&gt;见下&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;其中 view entity 还分两种情况：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;显式参数（&lt;code&gt;with parameters p_xxx&lt;/code&gt;）→ HANA &lt;strong&gt;参数化视图&lt;/strong&gt;，只能位置传参：&lt;code&gt;SELECT * FROM &amp;quot;SAPA4H&amp;quot;.&amp;quot;ZCV&amp;quot;(&amp;#39;E&amp;#39;)&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;用 &lt;code&gt;$session.client&lt;/code&gt;（本文写法）→ &lt;strong&gt;非参数化视图&lt;/strong&gt;，定义里内嵌 &lt;code&gt;SESSION_CONTEXT(&amp;#39;CDS_CLIENT&amp;#39;)&lt;/code&gt;：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;SELECT ... FROM &amp;quot;ZTFFLIGHTSTATS&amp;quot;(CLNT =&amp;gt; SESSION_CONTEXT(&amp;#39;CDS_CLIENT&amp;#39;)) ...
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这就引出一个直连专属的坑：&lt;strong&gt;普通数据库会话里 &lt;code&gt;CDS_CLIENT&lt;/code&gt; session variable 是空的&lt;/strong&gt;，于是：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;SELECT COUNT(*) FROM &amp;quot;SAPA4H&amp;quot;.&amp;quot;ZCFLIGHTSTATSV&amp;quot;;   -- SYSTEM 直连: 0 行！
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;session context 不随数据库连接走——所以直连场景想读 client 相关数据，老老实实用表函数显式传 &lt;code&gt;clnt =&amp;gt; &amp;#39;001&amp;#39;&lt;/code&gt;，这才是稳的。&lt;/p&gt;
&lt;h2&gt;7. 两套 SQL 速查对照&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;ABAP Open SQL（服务端）&lt;/th&gt;
&lt;th&gt;HANA 直连（客户端）&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;实体传参&lt;/td&gt;
&lt;td&gt;&lt;code&gt;( p = &amp;#39;E&amp;#39; )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;函数 &lt;code&gt;( p =&amp;gt; &amp;#39;E&amp;#39; )&lt;/code&gt;；参数化视图 &lt;code&gt;(&amp;#39;E&amp;#39;)&lt;/code&gt; 位置传参&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;client&lt;/td&gt;
&lt;td&gt;自动注入，代码里不写&lt;/td&gt;
&lt;td&gt;自己传 &lt;code&gt;clnt =&amp;gt; &amp;#39;001&amp;#39;&lt;/code&gt;（或自己加 MANDT 过滤）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;限行&lt;/td&gt;
&lt;td&gt;&lt;code&gt;... INTO @DATA(x) UP TO 10 ROWS&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;LIMIT 10&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;变量绑定&lt;/td&gt;
&lt;td&gt;&lt;code&gt;@lv_var&lt;/code&gt; 转义&lt;/td&gt;
&lt;td&gt;客户端侧参数化 / SQLScript 里 &lt;code&gt;:name&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;访问控制 DCL&lt;/td&gt;
&lt;td&gt;✅ 生效&lt;/td&gt;
&lt;td&gt;❌ 不生效&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;session client&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;td&gt;❌ &lt;code&gt;CDS_CLIENT&lt;/code&gt; 为空 → 物化视图查 client 数据得 0 行&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;权限&lt;/td&gt;
&lt;td&gt;ABAP 权限对象&lt;/td&gt;
&lt;td&gt;HANA GRANT（含 &lt;code&gt;#covw&lt;/code&gt; 视图）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h2&gt;8. 相关阅读&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sapcli-abap-ci-pipeline/&quot;&gt;用 sapcli 把 SAP 接进 CI：Docker 靶场、代理排障与 JUnit 闭环&lt;/a&gt;——本文所有对象的创建、写入、激活、测试命令都来自它，包括那个伪装成 TLS 错误的 macOS 系统代理坑。&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sap-org-hierarchy-amdp-vs-abap/&quot;&gt;九级组织树压进一条 SQL：AMDP 做对了什么，又输在哪&lt;/a&gt;——本文讲「AMDP 怎么用」，那篇用实测数据讲「AMDP 该不该用」：1,469 行时纯 ABAP 快 2.9 倍，1 万行才打平，选型先看耗时分布在哪一层。&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;环境备忘：ABAP Cloud Developer Trial 2025（Docker，端口 50001=ADT、30215=HANA SQL），client 001，全部对象在 &lt;code&gt;$TMP&lt;/code&gt; 可随时删除。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>SAP ALV 技术全览：七种实现方式、可运行 Demo 与选型建议</title><link>https://jack-liang.com/blog/sap-alv-tech-guide/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-alv-tech-guide/</guid><description>ALV 开发到底有几种写法？REUSE 函数、OO ALV、SALV 三代技术一次讲清：七种方式逐一对比用法，附一个七种全包的 Demo 程序（已开源，abapGit 一键拉取），以及实测踩过的几个坑——CL_SALV_HIERARCHICAL_TABLE 的版本门槛、块式 ALV 的动态 ASSIGN 陷阱，最后给出选型建议。</description><pubDate>Sun, 15 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;写 SAP 报表绕不开 ALV。但&amp;quot;ALV&amp;quot;其实不是一个东西——从最早的 &lt;code&gt;REUSE_ALV_*&lt;/code&gt; 函数，到 &lt;code&gt;CL_GUI_ALV_GRID&lt;/code&gt; 控件，再到 SALV 模型，三代技术并存至今，面试和日常开发里经常被问&amp;quot;它们有什么区别、该用哪个&amp;quot;。&lt;/p&gt;
&lt;p&gt;最近我把这个问题系统性整理了一遍，并把&lt;strong&gt;七种 ALV 方式写进了同一个 Demo 程序&lt;/strong&gt;，选择屏幕上单选切换，数据用各系统都有的 SFLIGHT（层级方式抬头用 SPFLI），开源在 ZABAP_TOOLS 仓库，abapGit 可直接拉进系统：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Demo 程序：&lt;a href=&quot;https://github.com/Jack-Liang/ZABAP_TOOLS/blob/main/src/alv/zr_alv_demo_sflight.prog.abap&quot;&gt;zr_alv_demo_sflight.prog.abap&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;仓库：&lt;a href=&quot;https://github.com/Jack-Liang/ZABAP_TOOLS&quot;&gt;ZABAP_TOOLS&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这篇文章是按方式逐个数清楚，文末给选型建议。&lt;/p&gt;
&lt;p&gt;ALV（ABAP List Viewer，最早叫 SAP List Viewer）的三代演进：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;函数时代&lt;/strong&gt;：&lt;code&gt;REUSE_ALV_*&lt;/code&gt; 系列 Function Module（SLIS 类型组）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;OO 控件时代&lt;/strong&gt;：&lt;code&gt;CL_GUI_ALV_GRID&lt;/code&gt;（基于 Control Framework 的网格控件）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SALV 时代&lt;/strong&gt;：&lt;code&gt;CL_SALV_TABLE&lt;/code&gt;（面向对象的封装模型，无需 Field Catalog）&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;提示：如果系统里 SFLIGHT / SPFLI 没数据，先跑一次标准程序 &lt;code&gt;BC_DATA_GENERATOR&lt;/code&gt; 生成演示数据。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;一、ALV 方式总览&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;#&lt;/th&gt;
&lt;th&gt;方式&lt;/th&gt;
&lt;th&gt;技术载体&lt;/th&gt;
&lt;th&gt;是否全屏&lt;/th&gt;
&lt;th&gt;需要 Field Catalog&lt;/th&gt;
&lt;th&gt;需要屏幕/容器&lt;/th&gt;
&lt;th&gt;交互编辑&lt;/th&gt;
&lt;th&gt;典型场景&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;&lt;code&gt;REUSE_ALV_LIST_DISPLAY&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Function Module&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;可选（可自动合并）&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否（只读）&lt;/td&gt;
&lt;td&gt;老式清单型报表&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;&lt;code&gt;REUSE_ALV_GRID_DISPLAY&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Function Module&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;可选&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否（只读）&lt;/td&gt;
&lt;td&gt;老式网格报表，最常用&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;&lt;code&gt;REUSE_ALV_HIERSEQ_LIST_DISPLAY&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Function Module&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;必须手工拼接&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;抬头/行项目层级清单&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;&lt;code&gt;REUSE_ALV_BLOCK_LIST_DISPLAY&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Function Module&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;一页多段清单&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;5&lt;/td&gt;
&lt;td&gt;&lt;code&gt;CL_GUI_ALV_GRID&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;类（OO ALV）&lt;/td&gt;
&lt;td&gt;取决于容器&lt;/td&gt;
&lt;td&gt;可选（LVC）&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;是&lt;/strong&gt;（容器控件）&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;支持&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;可编辑报表、嵌入自定义屏幕&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;6&lt;/td&gt;
&lt;td&gt;&lt;code&gt;CL_SALV_TABLE&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;类（SALV 模型）&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;不需要&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否（只读）&lt;/td&gt;
&lt;td&gt;现代只读报表，&lt;strong&gt;首推&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;7&lt;/td&gt;
&lt;td&gt;&lt;code&gt;CL_SALV_HIERARCHICAL_TABLE&lt;/code&gt; / &lt;code&gt;CL_SALV_TREE&lt;/code&gt;（NW 7.02+）&lt;/td&gt;
&lt;td&gt;类（SALV 模型）&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;不需要&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;SALV 版的层级/树形输出&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;补充说明：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;REUSE_ALV_GRID_DISPLAY_LVC&lt;/code&gt; 是方式 2 的 LVC 变体（LVC 类型池，支持拖拽等），用法与方式 2 基本一致，本文不单独演示。&lt;/li&gt;
&lt;li&gt;在 &lt;strong&gt;ABAP Cloud / BTP ABAP Environment&lt;/strong&gt; 上，以上所有方式都不可用（没有 SAP GUI），报表走 Fiori Elements / SmartTable + CDS，这是另一个话题。&lt;/li&gt;
&lt;li&gt;Web Dynpro 里的 &lt;code&gt;SALV_WD_TABLE&lt;/code&gt; 组件是 SALV 思想的 Web 版，已随 Web Dynpro 一起淡出主流，仅作了解。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;二、各方式的用法详解&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;以下每个方式末尾的代码片段，均节选自完整 Demo 程序（见第三章），可直接在系统中运行。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;1. REUSE_ALV_LIST_DISPLAY —— 最早的列表式 ALV&lt;/h3&gt;
&lt;p&gt;最老的 ALV 入口，输出样式接近传统的 &lt;code&gt;WRITE&lt;/code&gt; 列表，但自带排序、小计、过滤、导出 Excel 等工具栏。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键要点&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;字段目录（Field Catalog）类型为 &lt;code&gt;SLIS_T_FIELDCAT_ALV&lt;/code&gt;，可以：&lt;ul&gt;
&lt;li&gt;手工逐字段填充；或&lt;/li&gt;
&lt;li&gt;用 &lt;code&gt;REUSE_ALV_FIELDCATALOG_MERGE&lt;/code&gt; 从 DDIC 结构（如 SFLIGHT）自动生成；或&lt;/li&gt;
&lt;li&gt;直接传 &lt;code&gt;I_STRUCTURE_NAME = &amp;#39;SFLIGHT&amp;#39;&lt;/code&gt; 让它自己找结构。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;布局结构 &lt;code&gt;SLIS_LAYOUT_ALV&lt;/code&gt;：常用 &lt;code&gt;ZEBRA&lt;/code&gt;（条纹）、&lt;code&gt;COLWIDTH_OPTIMIZE&lt;/code&gt;（列宽自适应）、&lt;code&gt;EDIT&lt;/code&gt;（可编辑，基本没人用）。&lt;/li&gt;
&lt;li&gt;事件通过 &lt;code&gt;IT_EVENTS&lt;/code&gt;（&lt;code&gt;SLIS_T_EVENT&lt;/code&gt;）注册，如 &lt;code&gt;TOP_OF_PAGE&lt;/code&gt;、&lt;code&gt;USER_COMMAND&lt;/code&gt;、&lt;code&gt;PF_STATUS_SET&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;变式保存由 &lt;code&gt;I_SAVE = &amp;#39;A&amp;#39;&lt;/code&gt;（标准+用户变式）/ &lt;code&gt;&amp;#39;X&amp;#39;&lt;/code&gt;（仅标准）/ &lt;code&gt;&amp;#39;U&amp;#39;&lt;/code&gt;（仅用户）控制。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;核心代码片段&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;FORM display_list_alv.
  DATA: lt_fcat   TYPE slis_t_fieldcat_alv,
        ls_layout TYPE slis_layout_alv.

  &amp;quot; 从 DDIC 结构 SFLIGHT 自动生成字段目录
  CALL FUNCTION &amp;#39;REUSE_ALV_FIELDCATALOG_MERGE&amp;#39;
    EXPORTING
      i_structure_name = &amp;#39;SFLIGHT&amp;#39;
    CHANGING
      ct_fieldcat      = lt_fcat
    EXCEPTIONS
      OTHERS           = 1.

  ls_layout-zebra             = abap_true.   &amp;quot; 条纹
  ls_layout-colwidth_optimize = abap_true.   &amp;quot; 列宽自适应

  CALL FUNCTION &amp;#39;REUSE_ALV_LIST_DISPLAY&amp;#39;
    EXPORTING
      i_structure_name = &amp;#39;SFLIGHT&amp;#39;
      is_layout        = ls_layout
      it_fieldcat      = lt_fcat
      i_save           = &amp;#39;A&amp;#39;        &amp;quot; 允许保存布局变式（标准+用户）
    TABLES
      t_outtab         = gt_sflight
    EXCEPTIONS
      OTHERS           = 1.
ENDFORM.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;优缺点&lt;/strong&gt;：依赖少、单 FM 调用即可出报表；但界面老旧、不支持真正的事件驱动，新开发一般不选它。&lt;/p&gt;
&lt;h3&gt;2. REUSE_ALV_GRID_DISPLAY —— 函数版的网格 ALV&lt;/h3&gt;
&lt;p&gt;接口与方式 1 几乎一样，只是输出换成了 Grid 控件（底层就是 &lt;code&gt;CL_GUI_ALV_GRID&lt;/code&gt; 的封装），外观现代一些，支持冻结列、前端拖拽排序等。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键要点&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;参数结构与 LIST 版相同（SLIS 类型组），从 LIST 迁移到 GRID 往往只需改 FM 名字。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;IT_SORT&lt;/code&gt;（&lt;code&gt;SLIS_T_SORTINFO_ALV&lt;/code&gt;）预设排序/小计；&lt;code&gt;IT_FILTER&lt;/code&gt; 预设过滤。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;I_CALLBACK_PF_STATUS_SET&lt;/code&gt; / &lt;code&gt;I_CALLBACK_USER_COMMAND&lt;/code&gt; 用回调 FORM 名字接管工具栏和按钮事件。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;核心代码片段&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;FORM display_grid_alv.
  DATA: lt_fcat   TYPE slis_t_fieldcat_alv,
        ls_layout TYPE slis_layout_alv,
        lt_sort   TYPE slis_t_sortinfo_alv.

  CALL FUNCTION &amp;#39;REUSE_ALV_FIELDCATALOG_MERGE&amp;#39;
    EXPORTING
      i_structure_name = &amp;#39;SFLIGHT&amp;#39;
    CHANGING
      ct_fieldcat      = lt_fcat
    EXCEPTIONS
      OTHERS           = 1.

  ls_layout-zebra             = abap_true.
  ls_layout-colwidth_optimize = abap_true.

  &amp;quot; 预设排序：航线 + 航班号
  lt_sort = VALUE slis_t_sortinfo_alv(
    ( spos = 1 fieldname = &amp;#39;CARRID&amp;#39; up = abap_true )
    ( spos = 2 fieldname = &amp;#39;CONNID&amp;#39; up = abap_true ) ).

  CALL FUNCTION &amp;#39;REUSE_ALV_GRID_DISPLAY&amp;#39;
    EXPORTING
      i_structure_name = &amp;#39;SFLIGHT&amp;#39;
      is_layout        = ls_layout
      it_fieldcat      = lt_fcat
      it_sort          = lt_sort
      i_default        = abap_true
      i_save           = &amp;#39;A&amp;#39;
    TABLES
      t_outtab         = gt_sflight
    EXCEPTIONS
      OTHERS           = 1.
ENDFORM.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;优缺点&lt;/strong&gt;：调用极简、全屏直出；与 LIST 版一样，事件模型是&amp;quot;回调 FORM 名&amp;quot;这种弱类型方式，复杂交互力不从心。适合快速出的只读报表。&lt;/p&gt;
&lt;h3&gt;3. REUSE_ALV_HIERSEQ_LIST_DISPLAY —— 抬头/行项目层级清单&lt;/h3&gt;
&lt;p&gt;一个调用同时展示两张内表（如抬头 VBAK + 行项目 VBAP），通过 &lt;code&gt;IS_KEY_INFO&lt;/code&gt;（&lt;code&gt;SLIS_KEYINFO_ALV&lt;/code&gt;）把两张表用关键字段关联，展开节点看明细。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键要点&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;两张内表的字段目录要&lt;strong&gt;手工拼进同一个 &lt;code&gt;SLIS_T_FIELDCAT_ALV&lt;/code&gt;&lt;/strong&gt;，用 &lt;code&gt;TABNAME&lt;/code&gt; 区分属于哪张表。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;I_TABNAME_HEADER&lt;/code&gt; / &lt;code&gt;I_TABNAME_ITEM&lt;/code&gt; 必须填真实存在的全局内表名&lt;/strong&gt;：FM 展示时会按这个名字动态 &lt;code&gt;ASSIGN (name)&lt;/code&gt; 找数据表，填 FORM 局部变量的名字会在运行时炸 &lt;code&gt;CALL_FUNCTION_PARM_MISSING&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;展开层级由 &lt;code&gt;IS_LAYOUT-EXPAND_ALL&lt;/code&gt;、事件 &lt;code&gt;ITEM_DATA_EXPAND&lt;/code&gt; 控制。&lt;/li&gt;
&lt;li&gt;层级清单天然需要两张表。Demo 程序（选项 &lt;code&gt;r_hier&lt;/code&gt;）抬头用航班计划表 SPFLI、行项目用 SFLIGHT，按 航线+航班号（CARRID+CONNID）关联——两张表都由 &lt;code&gt;BC_DATA_GENERATOR&lt;/code&gt; 生成；真实场景（如 VBAK/VBAP）换成业务表即可。同类需求更推荐 SALV 的 &lt;code&gt;CL_SALV_HIERARCHICAL_TABLE&lt;/code&gt;（见方式 7）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot;&gt;这个&amp;quot;必须全局表名&amp;quot;的坑我在 Demo 调试时实打实踩过一次：静态检查完全正常，一运行就 CALL_FUNCTION_PARM_MISSING，因为这是个动态调用异常，激活阶段根本发现不了。&lt;/Notation&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;调用骨架&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CALL FUNCTION &amp;#39;REUSE_ALV_HIERSEQ_LIST_DISPLAY&amp;#39;
  EXPORTING
    i_callback_program = sy-repid
    is_layout          = ls_layout
    it_fieldcat        = lt_fcat        &amp;quot; 两表字段目录拼在一起，TABNAME 区分
    is_keyinfo         = ls_keyinfo     &amp;quot; 抬头表与行项目表的关联键
    i_tabname_header   = &amp;#39;GT_HEADER&amp;#39;
    i_tabname_item     = &amp;#39;GT_ITEM&amp;#39;
  TABLES
    t_outtab_header    = gt_header
    t_outtab_item      = gt_item
  EXCEPTIONS
    OTHERS             = 1.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;4. REUSE_ALV_BLOCK_LIST_DISPLAY —— 块式多段清单&lt;/h3&gt;
&lt;p&gt;通过 &lt;code&gt;REUSE_ALV_BLOCK_LIST_INIT&lt;/code&gt; / &lt;code&gt;_APPEND&lt;/code&gt; / &lt;code&gt;_DISPLAY&lt;/code&gt; 一组 FM，把多段不同结构的清单拼在同一屏，段与段之间用横条分隔。属于小众用法，只读、不能编辑，仅在&amp;quot;一页看多张表&amp;quot;的老式报表中偶见。Demo 程序（选项 &lt;code&gt;r_block&lt;/code&gt;）把 SFLIGHT 前 50 行 / 后 50 行拆成两块演示。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键要点&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;APPEND&lt;/code&gt; 的 &lt;code&gt;I_TABNAME&lt;/code&gt; 与字段目录的 &lt;code&gt;TABNAME&lt;/code&gt; 必须一致，且必须是&lt;strong&gt;真实存在的全局内表名&lt;/strong&gt;——&lt;code&gt;DISPLAY&lt;/code&gt; 时 FM 按名字动态 &lt;code&gt;ASSIGN&lt;/code&gt; 找表，局部变量名会导致运行时 &lt;code&gt;CALL_FUNCTION_PARM_MISSING&lt;/code&gt; dump（与方式 3 同一颗雷）。&lt;/li&gt;
&lt;li&gt;各块结构可以不同（每块自己的字段目录），Demo 里两块同为 SFLIGHT 仅作演示。&lt;/li&gt;
&lt;li&gt;建议对照 SAP 标准演示程序 &lt;code&gt;BALVBT01&lt;/code&gt; 的调用序列：先 &lt;code&gt;REUSE_ALV_EVENTS_GET&lt;/code&gt; 取标准事件表传给每次 &lt;code&gt;APPEND&lt;/code&gt; 的 &lt;code&gt;IT_EVENTS&lt;/code&gt;，再 &lt;code&gt;INIT → APPEND × N → DISPLAY&lt;/code&gt;。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;调用骨架&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CALL FUNCTION &amp;#39;REUSE_ALV_BLOCK_LIST_INIT&amp;#39;
  EXPORTING
    i_callback_program = sy-repid.

CALL FUNCTION &amp;#39;REUSE_ALV_BLOCK_LIST_APPEND&amp;#39;
  EXPORTING
    is_layout   = ls_layout
    it_fieldcat = lt_fcat
    i_tabname   = &amp;#39;GT_DATA&amp;#39;
    it_events   = lt_events      &amp;quot; 来自 REUSE_ALV_EVENTS_GET
  TABLES
    t_outtab    = gt_data.

CALL FUNCTION &amp;#39;REUSE_ALV_BLOCK_LIST_DISPLAY&amp;#39;
  EXCEPTIONS
    program_error = 1
    OTHERS        = 2.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;5. CL_GUI_ALV_GRID —— OO ALV，可编辑的唯一主流方案&lt;/h3&gt;
&lt;p&gt;真正的 SAP GUI 控件，必须依附于一个&lt;strong&gt;容器&lt;/strong&gt;（Custom Container / Docking Container / Splitter），因此必须搭配一个屏幕（Dynpro）使用。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键要点&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;常用容器：&lt;ul&gt;
&lt;li&gt;&lt;code&gt;CL_GUI_CUSTOM_CONTAINER&lt;/code&gt;：在屏幕画板上画一块区域（控件名传给 &lt;code&gt;CONTAINER_NAME&lt;/code&gt;），布局可控；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CL_GUI_DOCKING_CONTAINER&lt;/code&gt;：代码里动态创建，靠 &lt;code&gt;EXTENSION&lt;/code&gt; 撑满屏幕，&lt;strong&gt;不需要画控件&lt;/strong&gt;，Demo 里用它，最省事。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;字段目录类型换成 LVC 类型池的 &lt;code&gt;LVC_T_FCAT&lt;/code&gt;：只传 &lt;code&gt;I_STRUCTURE_NAME&lt;/code&gt; 时会自动生成（Demo 的做法）；需要自定义时可由 &lt;code&gt;LVC_FIELDCATALOG_MERGE_GET&lt;/code&gt; 生成（注意：部分系统没有此 FM，替代方案是 &lt;code&gt;REUSE_ALV_FIELDCATALOG_MERGE&lt;/code&gt; 生成 SLIS 目录后用 &lt;code&gt;LVC_TRANSFER_FROM_SLIS&lt;/code&gt; 转换）。&lt;/li&gt;
&lt;li&gt;布局 &lt;code&gt;LVC_S_LAYO&lt;/code&gt;：&lt;code&gt;ZEBRA&lt;/code&gt;、&lt;code&gt;CWIDTH_OPT&lt;/code&gt;、&lt;code&gt;SEL_MODE&lt;/code&gt;（行选择模式 A/B/C/D/空格）、&lt;code&gt;EDIT&lt;/code&gt; 等。&lt;/li&gt;
&lt;li&gt;核心方法：&lt;ul&gt;
&lt;li&gt;&lt;code&gt;SET_TABLE_FOR_FIRST_DISPLAY&lt;/code&gt;（首次展示，传结构名+布局+字段目录+内表；注意 &lt;code&gt;IT_FIELDCATALOG&lt;/code&gt; 是 &lt;strong&gt;CHANGING&lt;/strong&gt; 参数）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;REFRESH_TABLE_DISPLAY&lt;/code&gt;（数据变化后刷新）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CHECK_CHANGED_DATA&lt;/code&gt;（编辑报表把前端改动拉回内表）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET_SELECTED_ROWS&lt;/code&gt;（取选中行）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;事件驱动：注册 &lt;code&gt;HANDLE_DATA_CHANGED&lt;/code&gt;、&lt;code&gt;HANDLE_TOOLBAR&lt;/code&gt;、&lt;code&gt;HANDLE_USER_COMMAND&lt;/code&gt;、&lt;code&gt;HANDLE_DOUBLE_CLICK&lt;/code&gt; 等事件处理器，这是它和 FM 方式最本质的区别——&lt;strong&gt;真正的面向对象事件模型&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;是唯一被广泛使用且 SAP 官方支持&lt;strong&gt;单元格级编辑&lt;/strong&gt;的方案（EDIT 字段目录 + &lt;code&gt;MC_STYLE_ENABLED&lt;/code&gt; 等）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;核心代码片段（创建容器 + 首次展示）&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;FORM display_oo_alv.
  DATA ls_layout TYPE lvc_s_layo.

  IF go_docking IS INITIAL.
    &amp;quot; Docking 容器：extension 足够大即铺满整屏
    CREATE OBJECT go_docking
      EXPORTING
        repid     = sy-repid
        dynnr     = &amp;#39;0100&amp;#39;
        side      = cl_gui_docking_container=&amp;gt;dock_at_left
        extension = 3000.

    CREATE OBJECT go_grid
      EXPORTING
        i_parent = go_docking.
  ENDIF.

  ls_layout-zebra      = abap_true.
  ls_layout-cwidth_opt = abap_true.
  ls_layout-sel_mode   = &amp;#39;A&amp;#39;.        &amp;quot; 允许多行选择

  &amp;quot; 不传字段目录：I_STRUCTURE_NAME 会让网格自动从 DDIC 结构生成
  &amp;quot; （如需自定义目录，可用 LVC_FIELDCATALOG_MERGE_GET——部分系统没有此 FM，
  &amp;quot;  替代方案：REUSE_ALV_FIELDCATALOG_MERGE + LVC_TRANSFER_FROM_SLIS 转换）
  go_grid-&amp;gt;set_table_for_first_display(
    EXPORTING
      i_structure_name = &amp;#39;SFLIGHT&amp;#39;
      is_layout        = ls_layout
    CHANGING
      it_outtab        = gt_sflight
    EXCEPTIONS
      OTHERS           = 1 ).
ENDFORM.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;配套的屏幕 PBO / PAI 片段&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;MODULE status_0100 OUTPUT.
  SET PF-STATUS &amp;#39;STATUS_0100&amp;#39;.    &amp;quot; 需自建，至少含 BACK/EXIT/CANC
  SET TITLEBAR  &amp;#39;TITLE_0100&amp;#39;.
  IF go_docking IS INITIAL.
    PERFORM display_oo_alv.
  ENDIF.
ENDMODULE.

MODULE user_command_0100 INPUT.
  &amp;quot; 功能码取决于 SE41 里 STATUS_0100 的定义方式：
  &amp;quot; 直接给按钮分配标准功能键（F3/F15/F12）时，功能码是 &amp;amp;F03/&amp;amp;F15/&amp;amp;F12；
  &amp;quot; 自定义按钮命名常用 BACK/EXIT/CANC。两种都兼容。
  CASE sy-ucomm.
    WHEN &amp;#39;&amp;amp;F03&amp;#39; OR &amp;#39;&amp;amp;F15&amp;#39; OR &amp;#39;&amp;amp;F12&amp;#39;
      OR &amp;#39;BACK&amp;#39; OR &amp;#39;EXIT&amp;#39; OR &amp;#39;CANC&amp;#39;.
      LEAVE TO SCREEN 0.
  ENDCASE.
ENDMODULE.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;优缺点&lt;/strong&gt;：能力天花板最高（编辑、嵌入、事件、拖拽），但开发量最大——要建屏幕、建容器、写 PBO/PAI。&lt;/p&gt;
&lt;h3&gt;6. CL_SALV_TABLE —— SALV 模型，现代只读报表首选&lt;/h3&gt;
&lt;p&gt;SALV（New ALV Object Model）是 SAP 在 7.0 之后给出的统一封装：&lt;strong&gt;一个工厂方法出全屏 ALV，不需要 Field Catalog，不需要屏幕&lt;/strong&gt;，所有设置通过子对象（列、排序、合计、功能条、显示设置）链式完成。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键要点&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;入口：&lt;code&gt;CL_SALV_TABLE=&amp;gt;FACTORY( IMPORTING r_salv_table = ... CHANGING t_table = itab )&lt;/code&gt;，内表行结构直接决定列。&lt;/li&gt;
&lt;li&gt;常用子对象：&lt;ul&gt;
&lt;li&gt;&lt;code&gt;GET_COLUMNS( )-&amp;gt;SET_OPTIMIZE( )&lt;/code&gt; 列宽优化；单列着色需先把 &lt;code&gt;GET_COLUMN( )&lt;/code&gt; 的返回转型为 &lt;code&gt;CL_SALV_COLUMN_TABLE&lt;/code&gt; 再调 &lt;code&gt;SET_COLOR( )&lt;/code&gt;；&lt;code&gt;SET_VISIBLE( )&lt;/code&gt; 隐藏列&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET_SORTS( )-&amp;gt;ADD_SORT( )&lt;/code&gt; 预设排序&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET_AGGREGATIONS( )-&amp;gt;ADD_AGGREGATION( )&lt;/code&gt; 合计&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET_FUNCTIONS( )-&amp;gt;SET_ALL( )&lt;/code&gt; 打开全部标准工具栏&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET_DISPLAY_SETTINGS( )-&amp;gt;SET_STRIPED_PATTERN( )&lt;/code&gt; / &lt;code&gt;SET_LIST_HEADER( )&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET_LAYOUT( )-&amp;gt;SET_KEY( )&lt;/code&gt; + &lt;code&gt;SET_SAVE_RESTRICTION( )&lt;/code&gt; 支持布局变式保存&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GET_SELECTIONS( )-&amp;gt;SET_SELECTION_MODE( )&lt;/code&gt; 行选择；&lt;code&gt;GET_EVENT( )&lt;/code&gt; 注册 &lt;code&gt;DOUBLE_CLICK&lt;/code&gt;、&lt;code&gt;LINK_CLICK&lt;/code&gt;、&lt;code&gt;USER_COMMAND&lt;/code&gt; 等事件&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;兄弟类：&lt;code&gt;CL_SALV_TREE&lt;/code&gt;（树）、&lt;code&gt;CL_SALV_HIERARCHICAL_TABLE&lt;/code&gt;（层级，对应方式 3 的现代化身）。&lt;strong&gt;注意：这两个类自 NW 7.02（EhP2）起才提供&lt;/strong&gt;，更低版本系统上不存在、静态引用无法激活，此时请退回方式 3（&lt;code&gt;REUSE_ALV_HIERSEQ_LIST_DISPLAY&lt;/code&gt;）。&lt;code&gt;CL_SALV_HIERARCHICAL_TABLE&lt;/code&gt; 核心就是工厂 + 关联键：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;cl_salv_hierarchical_table=&amp;gt;factory(
  IMPORTING
    r_hierarchical_table = DATA(lo_hier)
  EXPORTING
    t_header_level_table = lt_spfli     &amp;quot; 抬头表：航班计划 SPFLI
    t_items_level_table  = gt_sflight ).&amp;quot; 行项目表：航班班次 SFLIGHT

lo_hier-&amp;gt;add_hierarchy_relationship(
  EXPORTING
    r_header      = lo_hier-&amp;gt;get_header_level( )
    r_items       = lo_hier-&amp;gt;get_items_level( )
    header_column = &amp;#39;CARRID&amp;#39;
    items_column  = &amp;#39;CARRID&amp;#39; ).        &amp;quot; 多键对可多次调用追加（CONNID 同理）

lo_hier-&amp;gt;display( ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;核心代码片段&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;FORM display_salv.
  TRY.
      &amp;quot; 工厂方法直接出全屏 ALV，无需字段目录、无需屏幕
      cl_salv_table=&amp;gt;factory(
        IMPORTING
          r_salv_table = DATA(lo_salv)
        CHANGING
          t_table      = gt_sflight ).

      lo_salv-&amp;gt;get_columns( )-&amp;gt;set_optimize( abap_true ).                  &amp;quot; 列宽优化
      lo_salv-&amp;gt;get_display_settings( )-&amp;gt;set_striped_pattern( abap_true ).  &amp;quot; 条纹
      lo_salv-&amp;gt;get_display_settings( )-&amp;gt;set_list_header( &amp;#39;SALV：航班清单&amp;#39; ).
      lo_salv-&amp;gt;get_functions( )-&amp;gt;set_all( abap_true ).                     &amp;quot; 全部工具栏

      lo_salv-&amp;gt;get_sorts( )-&amp;gt;add_sort( &amp;#39;CARRID&amp;#39; ).                         &amp;quot; 预设排序
      lo_salv-&amp;gt;get_aggregations( )-&amp;gt;add_aggregation( &amp;#39;PRICE&amp;#39; ).            &amp;quot; 价格合计

      &amp;quot; 单价列高亮（红色系）
      &amp;quot; SET_COLOR 是子类 CL_SALV_COLUMN_TABLE 的方法，GET_COLUMN 返回基类引用，需转型
      CAST cl_salv_column_table(
        lo_salv-&amp;gt;get_columns( )-&amp;gt;get_column( &amp;#39;PRICE&amp;#39; )
      )-&amp;gt;set_color( VALUE lvc_s_colo( col = 6 ) ).

      lo_salv-&amp;gt;display( ).
    CATCH cx_salv_msg cx_salv_not_found
          cx_salv_existing cx_salv_data_error INTO DATA(lx_salv).
      MESSAGE lx_salv-&amp;gt;get_text( ) TYPE &amp;#39;I&amp;#39;.
  ENDTRY.
ENDFORM.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;优缺点&lt;/strong&gt;：代码最短、最&amp;quot;现代 ABAP&amp;quot;风格，无屏幕依赖；&lt;strong&gt;官方只读&lt;/strong&gt;（没有单元格编辑能力，民间有改底层 CL_GUI_ALV_GRID 的 hack，不建议上生产）。只要不编辑，它就是首选。&lt;/p&gt;
&lt;h2&gt;三、完整 Demo 程序&lt;/h2&gt;
&lt;p&gt;完整可运行的 Demo 程序开源在 ZABAP_TOOLS 仓库（abapGit 格式，可直接 pull 进系统）：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/Jack-Liang/ZABAP_TOOLS/blob/main/src/alv/zr_alv_demo_sflight.prog.abap&quot;&gt;zr_alv_demo_sflight.prog.abap&lt;/a&gt;&lt;/strong&gt; —— 一个程序体验全部 7 种 ALV，选择屏幕用单选按钮切换，数据取 SFLIGHT 前 100 行；层级类方式的抬头用同样标配的航班计划表 SPFLI、行项目用 SFLIGHT。&lt;/p&gt;
&lt;p&gt;程序的骨架（全局数据 + 选择屏幕 + 主流程分发）如下：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA: gt_sflight TYPE TABLE OF sflight,
      gt_hier_h  TYPE TABLE OF spfli,      &amp;quot; 层级方式抬头表（须全局）
      gt_block1  TYPE TABLE OF sflight,    &amp;quot; 块式方式第 1 块（须全局）
      gt_block2  TYPE TABLE OF sflight,    &amp;quot; 块式方式第 2 块（须全局）
      go_docking TYPE REF TO cl_gui_docking_container,
      go_grid    TYPE REF TO cl_gui_alv_grid.

SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE TEXT-001.
PARAMETERS: r_list  RADIOBUTTON GROUP g1 DEFAULT &amp;#39;X&amp;#39;, &amp;quot; FM：列表 ALV
            r_grid  RADIOBUTTON GROUP g1,             &amp;quot; FM：网格 ALV
            r_hier  RADIOBUTTON GROUP g1,             &amp;quot; FM：层级清单 ALV
            r_block RADIOBUTTON GROUP g1,             &amp;quot; FM：块式清单 ALV
            r_oo    RADIOBUTTON GROUP g1,             &amp;quot; OO：CL_GUI_ALV_GRID
            r_salv  RADIOBUTTON GROUP g1,             &amp;quot; SALV：CL_SALV_TABLE
            r_shier RADIOBUTTON GROUP g1.             &amp;quot; SALV：层级表
SELECTION-SCREEN END OF BLOCK b1.

START-OF-SELECTION.
  SELECT * FROM sflight INTO TABLE @gt_sflight UP TO 100 ROWS.
  IF gt_sflight IS INITIAL.
    MESSAGE &amp;#39;SFLIGHT 没有数据，请先运行 BC_DATA_GENERATOR 生成演示数据&amp;#39; TYPE &amp;#39;I&amp;#39;.
    RETURN.
  ENDIF.

  CASE abap_true.
    WHEN r_list.
      PERFORM display_list_alv.      &amp;quot; 方式 1
    WHEN r_grid.
      PERFORM display_grid_alv.      &amp;quot; 方式 2
    WHEN r_hier.
      PERFORM display_hierseq_alv.   &amp;quot; 方式 3
    WHEN r_block.
      PERFORM display_block_alv.     &amp;quot; 方式 4
    WHEN r_oo.
      &amp;quot; 方式 5：优先走自建屏幕 100（正规 OO ALV 用法）；
      &amp;quot; 屏幕不存在时退化为 screen0 兜底，避免 DYNPRO_NOT_FOUND dump
      SELECT SINGLE prog FROM d020s INTO @DATA(lv_prog)
        WHERE prog = @sy-repid
          AND dnum = &amp;#39;0100&amp;#39;.
      IF sy-subrc = 0.
        CALL SCREEN 100.
      ELSE.
        PERFORM display_oo_alv_screen0.
      ENDIF.
    WHEN r_salv.
      PERFORM display_salv.          &amp;quot; 方式 6
    WHEN r_shier.
      &amp;quot; 方式 7：CL_SALV_HIERARCHICAL_TABLE 自 NW 7.02 起提供，
      &amp;quot; 低版本系统上类不存在（静态引用无法激活），此处仅提示
      MESSAGE &amp;#39;CL_SALV_HIERARCHICAL_TABLE 需 NW 7.02+，当前系统不可用，请改用方式 3&amp;#39; TYPE &amp;#39;I&amp;#39;.
  ENDCASE.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;方式 1 / 2 / 5 / 6 的实现 FORM 已在上文第二章逐节给出；方式 3 / 4 的完整 FORM（&lt;code&gt;display_hierseq_alv&lt;/code&gt; / &lt;code&gt;display_block_alv&lt;/code&gt;）见代码文件，逻辑遵循上文对应小节的调用骨架；方式 7 因依赖 NW 7.02+ 的 &lt;code&gt;CL_SALV_HIERARCHICAL_TABLE&lt;/code&gt;，程序中不做静态引用，写法见上文方式 6 小节的片段。&lt;/p&gt;
&lt;h3&gt;手工配套对象（可选，仅 OO ALV 的&amp;quot;正规用法&amp;quot;需要）&lt;/h3&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;不建这些对象程序也能跑&lt;/strong&gt;：&lt;code&gt;r_oo&lt;/code&gt; 分支会先查 &lt;code&gt;D020S&lt;/code&gt; 判断屏幕 100 是否存在，不存在就以 &lt;code&gt;cl_gui_container=&amp;gt;screen0&lt;/code&gt;（当前屏幕）为父容器兜底展示，网格直接铺满选择屏，按 F3 返回即退出程序。建了下面这套对象，才是教科书式的 OO ALV 体验（独立屏幕 + Docking 容器 + 自定义状态栏）。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;屏幕 100&lt;/strong&gt;：SE51 创建，流逻辑保持两行即可：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;PROCESS BEFORE OUTPUT.
  MODULE status_0100.

PROCESS AFTER INPUT.
  MODULE user_command_0100.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;因为容器是代码里 new 出来的 Docking Container，&lt;strong&gt;画板上不需要放任何控件&lt;/strong&gt;。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;GUI 状态 STATUS_0100&lt;/strong&gt;：SE41 自建。功能码两种做法都兼容：自定义命名 &lt;code&gt;BACK&lt;/code&gt; / &lt;code&gt;EXIT&lt;/code&gt; / &lt;code&gt;CANC&lt;/code&gt;，或直接把按钮分配给标准功能键 F3 / F15 / F12（此时功能码是 &lt;code&gt;&amp;amp;F03&lt;/code&gt; / &lt;code&gt;&amp;amp;F15&lt;/code&gt; / &lt;code&gt;&amp;amp;F12&lt;/code&gt;）——PAI 模块已同时覆盖两种。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;标题 TITLE_0100&lt;/strong&gt;：随便起个名，比如 &amp;quot;OO ALV Demo&amp;quot;。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;TEXT-001&lt;/strong&gt;：文本符号，内容为&amp;quot;选择 ALV 展示方式&amp;quot;。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;建好对象后激活程序，按 F8 执行，勾选哪个单选按钮就体验哪种 ALV。&lt;/p&gt;
&lt;h2&gt;四、选型建议&lt;/h2&gt;
&lt;h3&gt;4.1 对比一览&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;维度&lt;/th&gt;
&lt;th&gt;REUSE_ALV_LIST&lt;/th&gt;
&lt;th&gt;REUSE_ALV_GRID&lt;/th&gt;
&lt;th&gt;CL_GUI_ALV_GRID&lt;/th&gt;
&lt;th&gt;CL_SALV_TABLE&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;代码量&lt;/td&gt;
&lt;td&gt;极小&lt;/td&gt;
&lt;td&gt;极小&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;大&lt;/strong&gt;（屏幕+容器+事件）&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;最小&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;学习/维护成本&lt;/td&gt;
&lt;td&gt;低&lt;/td&gt;
&lt;td&gt;低&lt;/td&gt;
&lt;td&gt;高&lt;/td&gt;
&lt;td&gt;低&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;界面观感&lt;/td&gt;
&lt;td&gt;老旧（列表风）&lt;/td&gt;
&lt;td&gt;现代（网格）&lt;/td&gt;
&lt;td&gt;现代&lt;/td&gt;
&lt;td&gt;现代&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;单元格编辑&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;是（官方支持）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;否（官方只读）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;嵌入自定义屏幕&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;是&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;需要自建容器，不推荐&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;事件模型&lt;/td&gt;
&lt;td&gt;回调 FORM 名&lt;/td&gt;
&lt;td&gt;回调 FORM 名&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;OO 事件，最强&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;OO 事件（有限集合）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Field Catalog&lt;/td&gt;
&lt;td&gt;需要（可自动合并）&lt;/td&gt;
&lt;td&gt;需要（可自动合并）&lt;/td&gt;
&lt;td&gt;需要（LVC，可自动合并）&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;不需要&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;额外 Dynpro&lt;/td&gt;
&lt;td&gt;不需要&lt;/td&gt;
&lt;td&gt;不需要&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;必须&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;不需要&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;变式保存&lt;/td&gt;
&lt;td&gt;支持&lt;/td&gt;
&lt;td&gt;支持&lt;/td&gt;
&lt;td&gt;支持&lt;/td&gt;
&lt;td&gt;支持&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;技术趋势&lt;/td&gt;
&lt;td&gt;遗留维护&lt;/td&gt;
&lt;td&gt;遗留维护&lt;/td&gt;
&lt;td&gt;存量巨大，仍活跃&lt;/td&gt;
&lt;td&gt;SAP 官方推荐方向&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h3&gt;4.2 怎么选&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;要编辑（单元格改数、下拉框、复选框、校验回写）→ CL_GUI_ALV_GRID，没有之一。&lt;/strong&gt; 这是唯一官方支持交互编辑的方案，也是唯一能嵌进你自己屏幕做复杂界面的方案。财务对账平台、批量维护类报表都走这条路。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;只读的新报表 → CL_SALV_TABLE。&lt;/strong&gt; 代码最短、没有 Field Catalog、没有屏幕依赖，风格也最接近现代 ABAP（链式子对象）。除非有明确理由，新项目一律用它。需要层级就用 &lt;code&gt;CL_SALV_HIERARCHICAL_TABLE&lt;/code&gt;，需要树就用 &lt;code&gt;CL_SALV_TREE&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;维护老代码 / 十分钟赶一个查询报表 → REUSE_ALV_GRID_DISPLAY。&lt;/strong&gt; 存量系统里到处是它的变体和自封装，改起来顺手；但新开发不建议再开这个头。&lt;code&gt;REUSE_ALV_LIST_DISPLAY&lt;/code&gt; 基本只出现在历史代码里，知道它存在即可。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;REUSE_ALV_HIERSEQ_LIST_DISPLAY / BLOCK_LIST_DISPLAY&lt;/strong&gt;：只有接手老程序时会碰到，新需求直接用 SALV 的层级类替代。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;Notation type=&quot;underline&quot;&gt;一句话推荐：新开发默认 CL_SALV_TABLE；一旦需求里出现&amp;quot;可编辑&amp;quot;三个字，直接切 CL_GUI_ALV_GRID。&lt;/Notation&gt;&lt;/p&gt;
&lt;h3&gt;4.3 面向未来的一句提醒&lt;/h3&gt;
&lt;p&gt;以上所有 ALV 都依赖 SAP GUI。如果项目目标是 &lt;strong&gt;ABAP Cloud（含 S/4HANA Cloud Public Edition / BTP ABAP Environment）&lt;/strong&gt;，REUSE_*、CL_GUI_*、CL_SALV_* 全部不可用，报表的正确姿势是 &lt;strong&gt;CDS + OData + Fiori Elements（List Report / SmartTable）&lt;/strong&gt;。On-Premise 私有云版本（2023 起）虽然还兼容 Classic ABAP，但新建报表也应尽量评估 Fiori 路线，ALV 留给存量维护。&lt;/p&gt;
&lt;h2&gt;相关链接&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Demo 程序：&lt;a href=&quot;https://github.com/Jack-Liang/ZABAP_TOOLS/blob/main/src/alv/zr_alv_demo_sflight.prog.abap&quot;&gt;zr_alv_demo_sflight.prog.abap&lt;/a&gt;（&lt;a href=&quot;https://github.com/Jack-Liang/ZABAP_TOOLS&quot;&gt;ZABAP_TOOLS&lt;/a&gt;，abapGit 管理）&lt;/li&gt;
&lt;li&gt;SAP 标准演示程序：&lt;code&gt;BALVBT01&lt;/code&gt;（块式）、&lt;code&gt;BCALV_GRID_DEMO&lt;/code&gt;（OO ALV）、&lt;code&gt;SALV_DEMO_TABLE_*&lt;/code&gt;（SALV 系列）&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>逆向 SAP 数据簇格式：不登录 SAP 也能读懂 INDX 表里的二进制</title><link>https://jack-liang.com/blog/sap-indx-data-cluster-decoder/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-indx-data-cluster-decoder/</guid><description>SE16/DBeaver 里的 INDX、STXL 表，CLUSTD 列全是一团十六进制——这是 EXPORT TO DATABASE 的私有存储格式。本文完整逆向这套格式：24 字节容器头、LZH 压缩流、自描述标记流，逐字节对拍验证，最终做成开源解码工具 sap-indx-decoder，非空簇解析率约 98%。</description><pubDate>Sun, 15 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;写 ABAP 的人，迟早会撞上 INDX 和 STXL 这两张表。它们是 SAP 的&lt;strong&gt;数据簇表&lt;/strong&gt;——&lt;code&gt;EXPORT ... TO DATABASE&lt;/code&gt; 把任意 ABAP 变量、结构、内表序列化后塞进去，&lt;code&gt;IMPORT&lt;/code&gt; 的时候再读回来。你在 SE16 或者 DBeaver 里打开一看，&lt;code&gt;CLUSTD&lt;/code&gt; 列就是一大团十六进制，无从下手。&lt;/p&gt;
&lt;p&gt;这团字节里藏着不少东西：SAPscript 长文本、应用日志、传输快照、HR 生成参数、RABAX 崩溃转储的元数据……凡是 &lt;code&gt;EXPORT TO DATABASE&lt;/code&gt; 能写的，都在里面。但它没有官方文档——内核闭源，格式半公开，想看懂只能靠自己逆。&lt;/p&gt;
&lt;p&gt;最近我把这套格式完整逆向了一遍，做成了开源解码工具 &lt;a href=&quot;https://github.com/Jack-Liang/sap-indx-decoder&quot;&gt;&lt;strong&gt;sap-indx-decoder&lt;/strong&gt;&lt;/a&gt;：不用登录 SAP 系统，直接从 HANA 数据库（或者导出的二进制文件）把簇数据还原成可读内容，非空簇解析率约 &lt;strong&gt;98%&lt;/strong&gt;。这篇是完整的逆向过程记录——你会看到这套格式怎么一层层被剥开，以及每一条结论怎么被数据自己验证。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-indx-data-cluster-decoder/pipeline-overview.svg?v=2&quot; alt=&quot;从 EXPORT TO DATABASE 到可读内容的六步链路：ABAP 序列化、簇表行、HANA 租户库、取簇字节、三层解码、可读输出&quot;&gt;&lt;/p&gt;
&lt;h2&gt;一、环境：数据从哪来&lt;/h2&gt;
&lt;p&gt;数据来自本机 Docker 跑的 &lt;a href=&quot;https://hub.docker.com/r/sapse/abap-cloud-developer-trial&quot;&gt;ABAP Cloud Developer Trial 2025&lt;/a&gt;，环境搭建我在&lt;a href=&quot;/blog/abap-cloud-developer-trial/&quot;&gt;《能跑在笔记本中的 SAP 系统》&lt;/a&gt;里写过，这里不重复。只补一个关键坑：这套镜像的 HANA 是&lt;strong&gt;多租户&lt;/strong&gt;架构——30213 端口是 SYSTEMDB，只能看到系统表；业务数据（包括 INDX）全在名为 &lt;code&gt;HDB&lt;/code&gt; 的租户库、&lt;code&gt;SAPA4H&lt;/code&gt; schema 下，对应端口 30215，而容器默认&lt;strong&gt;不映射&lt;/strong&gt;这个端口。我起了一个共享容器网络命名空间的 socat 小容器，把 30215 转出来，DBeaver 和命令行就能直连租户库了。&lt;/p&gt;
&lt;p&gt;还有一个容易绕进去的点：&lt;code&gt;INDX&lt;/code&gt; 表里到底有什么？用 &lt;code&gt;SYSTEM&lt;/code&gt; 用户连 SYSTEMDB 是看不到 &lt;code&gt;SAPA4H&lt;/code&gt; 里的表的，得用簇 schema 的属主用户连租户库。连对之后就能看到：&lt;code&gt;SAPA4H.INDX&lt;/code&gt; 有 5,568 行、24 个 &lt;code&gt;RELID&lt;/code&gt; 簇区，最大的一个簇 246 KB、86 个分块。这就是本次逆向的全部素材。&lt;/p&gt;
&lt;h2&gt;二、三层结构：容器 → LZH → 标记流&lt;/h2&gt;
&lt;p&gt;把若干个簇导出来逐字节对拍，整个格式是很清晰的三层：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;簇表行 (按 SRTFD 分组、SRTF2 排序、按 CLUSTR 截断、拼接)
  └─ 容器头 (24 字节，明文可读的元数据)
       └─ LZH 压缩流
            └─ 标记流 (自描述的组件序列：名字 + 字段表 + 数据)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-indx-data-cluster-decoder/three-layer-structure.svg?v=2&quot; alt=&quot;三层结构：簇表行 → 24 字节容器头 → LZH 压缩流 → 标记流&quot;&gt;&lt;/p&gt;
&lt;h3&gt;容器头&lt;/h3&gt;
&lt;p&gt;24 字节，信息量足够直接写规格：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;偏移&lt;/th&gt;
&lt;th&gt;内容&lt;/th&gt;
&lt;th&gt;示例&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;魔数 &lt;code&gt;FF&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;固定&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;容器版本&lt;/strong&gt;（3–6）&lt;/td&gt;
&lt;td&gt;&lt;code&gt;05&lt;/code&gt; / &lt;code&gt;06&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;8–11&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;SAP 代码页&lt;/strong&gt;，ASCII 数字&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;#39;1100&amp;#39;&lt;/code&gt;（latin-1）、&lt;code&gt;&amp;#39;4103&amp;#39;&lt;/code&gt;（UTF-16）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;16–19&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;未压缩长度&lt;/strong&gt;，uint32 &lt;strong&gt;小端&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;01 03 00 00&lt;/code&gt; → 769 字节&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;20&lt;/td&gt;
&lt;td&gt;压缩算法&lt;/td&gt;
&lt;td&gt;&lt;code&gt;12&lt;/code&gt; = LZH，&lt;code&gt;10&lt;/code&gt; = LZC&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;21–22&lt;/td&gt;
&lt;td&gt;魔数 &lt;code&gt;1F 9D&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;继承自 Unix &lt;code&gt;compress(1)&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;24…&lt;/td&gt;
&lt;td&gt;LZH 位流&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;两个细节挺有意思：长度字段是小端，而后面标记流里所有长度是&lt;strong&gt;大端&lt;/strong&gt;——一个格式里两套字节序；代码页则直接以 ASCII 形式写在头上，一个格式同时服务单字节和 UTF-16 两代 ABAP。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;1F 9D&lt;/code&gt; 这个魔数还附送了一个免费的完整性校验：LZH 解压的输出长度&lt;strong&gt;必须&lt;/strong&gt;等于头里声明的值。后面所有的解析，都靠这一条兜底。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-indx-data-cluster-decoder/container-header.svg?v=2&quot; alt=&quot;24 字节容器头布局：魔数、版本、SAP 代码页、未压缩长度、压缩算法与 1F 9D 魔数&quot;&gt;&lt;/p&gt;
&lt;h3&gt;LZH&lt;/h3&gt;
&lt;p&gt;SAP 的 LZH 是 LZ77（16KB 窗口）+ 规范 Huffman，三个字母表（字面量+长度、距离、码长），整体像 deflate，但帧格式不同：首块前有 2-bit 前导，码字 MSB 累积，而位读取器是 LSB-first。&lt;/p&gt;
&lt;p&gt;这一层我没有从零造轮子。搜索时发现 &lt;a href=&quot;https://github.com/aamelin1/sap-long-texts&quot;&gt;aamelin1/sap-long-texts&lt;/a&gt;（MIT）——作者逆向了 STXL 表，还把&lt;a href=&quot;https://community.sap.com/t5/technology-blog-posts-by-members/beyond-read-text-decoding-sapscript-long-texts-stxl-with-sqlscript-in-cds/ba-p/14468331&quot;&gt;解码过程&lt;/a&gt;写成了 Python 参考实现。我把它的 &lt;code&gt;inflate_lzh&lt;/code&gt; 移植进来，跑了全量数据：解压长度与声明值&lt;strong&gt;全部精确匹配&lt;/strong&gt;。这一层算是站稳了。&lt;/p&gt;
&lt;h3&gt;标记流：真正的战场&lt;/h3&gt;
&lt;p&gt;解压之后，是一串自描述的组件流。STXL 那篇博客给出了它已知的一小块语法（TLINE 表：类型名、字段描述、&lt;code&gt;BB&lt;/code&gt; 行标记），但通用 INDX 的语法，没人写过。以下是我逐字节拼出来的部分。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;组件&lt;/strong&gt;是流的基本单位，类字节开头：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;01&lt;/code&gt; = 单值（元素类型）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;02&lt;/code&gt; = 结构（单行）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;03&lt;/code&gt; = 表（多行）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;每个组件 = 类字节 + 头部（含名字长度、行宽、8 字节哈希）+ &lt;strong&gt;名字&lt;/strong&gt;（可打印串）+ 字段描述符组 + 行数据。头部各版本布局不一，我没有全部解开——所以解析器用了&lt;strong&gt;锚定法&lt;/strong&gt;：从类字节向后扫描，第一个标记字节前的可打印串就是名字，不依赖头部长度。笨办法，但稳。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;字段描述符&lt;/strong&gt;（v5）长这样：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;AA 01 00 08   → 类型 01，长度 8   (DATS 日期，存成 8 字符)
AA 03 00 06   → 类型 03，长度 6   (TIMS 时间)
AA 00 00 84   → 类型 00，长度 132 (CHAR)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;行宽 = 所有字段长度之和&lt;/strong&gt;——这是整个格式里最强的自洽校验。举个实测的例子：某表 19 个字段，长度加总是 593，头部声明的行宽 &lt;code&gt;0x0251&lt;/code&gt; 正好也是 593，分毫不差。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-indx-data-cluster-decoder/token-stream.svg?v=2&quot; alt=&quot;标记流中一个组件的解剖：类字节、头部、名字、字段描述符组与行数据&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;行&lt;/strong&gt;的编码，v5 与 v6 完全不同：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;v5:  bb &amp;lt;定长数据&amp;gt;             (行间用 bb 分隔)
v6:  be &amp;lt;行宽 u32&amp;gt; &amp;lt;行数 u32&amp;gt;  (行区自带声明!)
     bc &amp;lt;len u32&amp;gt; &amp;lt;数据&amp;gt;       每行自带长度
     bd                        行分隔符
     bf                        行区结束
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-indx-data-cluster-decoder/row-format-v5-v6.svg?v=2&quot; alt=&quot;v5 与 v6 的行区语法对比：v5 用 bb 分隔定长行，v6 用 be/bc/bd/bf 自带声明&quot;&gt;&lt;/p&gt;
&lt;h2&gt;三、踩过的坑&lt;/h2&gt;
&lt;p&gt;逆向里真正花时间的，不是主体结构，是这些&amp;quot;意料之外&amp;quot;：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;AF&lt;/code&gt; 也是字段描述符&lt;/strong&gt;。某簇的字段表中间突然冒出 &lt;code&gt;af 00 00 01&lt;/code&gt;，行宽瞬间对不上——查到最后才发现，它是&amp;quot;1 字节标志字段&amp;quot;的操作码：2417（普通字段）+ 3 个 AF 字段 = 2420，和声明的行宽精确吻合。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;空表是合法的&lt;/strong&gt;。有的簇组件声明了行宽，后面却直接跟 &lt;code&gt;04&lt;/code&gt; 结束——写入的时候内表就是空的。解析器必须允许零行。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;UTF-16 有双套写法&lt;/strong&gt;。同一份长文本，000 客户端是 v5 + latin-1，001 客户端是 v6 + UTF-16：名字和行数据全变成双字节，按字节锚定名字直接失效，得按码宽回退。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;v6 的行区换了整套标记&lt;/strong&gt;（be/bc/bd/bf），v5 攒下的 &lt;code&gt;bb&lt;/code&gt; 经验全部作废。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;锚定会误伤&lt;/strong&gt;。行数据里的二进制偶尔会撞出&amp;quot;可打印串 + 标记字节&amp;quot;的假模式，靠&amp;quot;描述符长度和必须等于声明行宽&amp;quot;这道校验，才能把垃圾锚点全部弹掉。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;调到最后，随机抽 100 个簇：&lt;strong&gt;90 个以 ≥95% 字节覆盖率完整解析&lt;/strong&gt;。失败的 10 个里，8 个是全零空簇（本来就没写数据），真正不认识的只有 2 个（&lt;code&gt;nwbc_uid&lt;/code&gt; 一族的变体）。非空簇解析率约 &lt;strong&gt;98%&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-indx-data-cluster-decoder/self-check-and-rate.svg?v=2&quot; alt=&quot;三条自洽校验与抽样结果：解压长度、字段长度和、结束标记，100 个簇的非空簇解析率 98%&quot;&gt;&lt;/p&gt;
&lt;p&gt;解出来的东西长这样：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;GC/TRPT (246KB → 4.5MB, 99% 覆盖, 最后一个字节正好是结束标记 04):
  PGV_SNAPSHOT_DATE = &amp;#39;19980228&amp;#39;
  GT_MONITOR_INFO   2392 行(传输监控，德语原文)
  GT_HIERARCHY      3127 行(层级树)

STXL/TDNAME=RHTEXT01:
  表名 TLINE，字段[0:2 0:132]，行: &amp;#39;* jdjdjdjdjdjdj&amp;#39;
  ——和 ABAP 文档里 TDFORMAT(2 字符) + TDLINE(132 字符) 的定义完全一致
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;1998 年的快照日期从十六进制里浮出来的那一刻，这套格式算是真的被读懂了。&lt;/p&gt;
&lt;h2&gt;四、做成通用工具&lt;/h2&gt;
&lt;p&gt;逆向中攒下的零散脚本，我整理成了一个独立 CLI：&lt;a href=&quot;https://github.com/Jack-Liang/sap-indx-decoder&quot;&gt;&lt;strong&gt;sap-indx-decoder&lt;/strong&gt;&lt;/a&gt;。主体是 Python，LZH 解压带了一个 Rust 原生实现（≈680 MB/s，约 60 倍于纯 Python）——没有原生扩展时自动回退，输出逐字节一致。装个 &lt;code&gt;hdbcli&lt;/code&gt; 就能连库；也可以完全离线，直接解析导出的二进制文件。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;git clone https://github.com/Jack-Liang/sap-indx-decoder &amp;amp;&amp;amp; cd sap-indx-decoder
python3 -m sap_indx_decoder tables                # 自动发现库里 655 张簇表
python3 -m sap_indx_decoder parse INDX TN QUEUE_ID
python3 -m sap_indx_decoder parse STXL -k MANDT=000 -k RELID=TX \
    -k TDOBJECT=TEXT -k TDNAME=RHTEXT01 -k TDID=ST -k TDSPRAS=D
python3 -m sap_indx_decoder parse-file trpt.bin --json   # 离线模式
python3 -m sap_indx_decoder scan INDX --limit 100        # 批量 + 成功率报告
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;几个设计点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;键结构自动推导&lt;/strong&gt;：ABAP 簇表的约定是 &lt;code&gt;SRTF2&lt;/code&gt; 为最后一个键列，它之前的列（INDX 的 &lt;code&gt;RELID/SRTFD&lt;/code&gt; 也好，STXL 的 6 列复合键也好）构成簇身份。不看表名，看结构。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;缺失键自动消歧&lt;/strong&gt;：漏了 MANDT？工具会尝试该列的所有取值，唯一命中就直接用；两个客户端都有同一条数据时明确报歧义，不瞎猜。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;DDIC 类型化&lt;/strong&gt;：组件名在 ABAP 数据字典（&lt;code&gt;DD02L&lt;/code&gt;/&lt;code&gt;DD03L&lt;/code&gt;）里存在时，匿名的&amp;quot;字段[0:2 0:132]&amp;quot;直接变成命名、带类型的列——&lt;code&gt;TLINE&lt;/code&gt; 就是 &lt;code&gt;TDFORMAT&lt;/code&gt;/&lt;code&gt;TDLINE&lt;/code&gt;，INT4 是真整数，PACKED 是真小数。语义不符时按原始字节显示，不瞎猜。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;覆盖率为王&lt;/strong&gt;：每次解析都会报告&amp;quot;解释了多少字节&amp;quot;，数据有没有损坏，一目了然。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;五、局限&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;描述符里 type 字节的语义（&lt;code&gt;0=C 1=D 3=T 6=N 8=I&lt;/code&gt;）已经摸清，但字段名和 PACKED 的小数位要靠 DDIC 补——连库时自动生效，纯离线解析没带 DDIC 侧车的话，值还是原始字节（&lt;code&gt;dump --with-ddic&lt;/code&gt; 可以先导出侧车）&lt;/li&gt;
&lt;li&gt;LZC（算法字节 &lt;code&gt;0x10&lt;/code&gt;）没实现，HANA 系统上没见过它，老系统可能会遇到&lt;/li&gt;
&lt;li&gt;组件头里的 8 字节哈希没解开，偶尔有可打印字节混进名字显示（纯外观问题）&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;六、一点感受&lt;/h2&gt;
&lt;p&gt;这个格式没有官方文档，但它对每个使用者都相当&amp;quot;诚实&amp;quot;：行宽、行数、代码页、长度，处处自带校验。所以逆向不靠猜，靠的是&lt;strong&gt;让数据自己证明自己&lt;/strong&gt;——解压长度对得上、字段和对得上、最后一个字节正好是结束标记，三条同时成立，语法就基本错不了。&lt;/p&gt;
&lt;p&gt;如果你手里也有一库看不懂的 INDX 表，仓库里有一份完整的&lt;a href=&quot;https://github.com/Jack-Liang/sap-indx-decoder/blob/main/docs/FORMAT.md&quot;&gt;格式规格文档&lt;/a&gt;，配 &lt;code&gt;scan&lt;/code&gt; 命令可以直接评估你环境里的解析率。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;参考与致谢&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://community.sap.com/t5/technology-blog-posts-by-members/beyond-read-text-decoding-sapscript-long-texts-stxl-with-sqlscript-in-cds/ba-p/14468331&quot;&gt;Beyond READ_TEXT: Decoding SAPscript Long Texts with SQLScript&lt;/a&gt; — STXL 容器/LZH 的先行工作&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/aamelin1/sap-long-texts&quot;&gt;aamelin1/sap-long-texts&lt;/a&gt; — LZH 参考实现（MIT，已原样存档进仓库 &lt;code&gt;third_party/&lt;/code&gt;）&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/pysap/pysap&quot;&gt;pysap&lt;/a&gt; — SAP 二进制格式的先行者&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>九级组织树压进一条 SQL：AMDP 做对了什么，又输在哪</title><link>https://jack-liang.com/blog/sap-org-hierarchy-amdp-vs-abap/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-org-hierarchy-amdp-vs-abap/</guid><description>一个把九级组织树拍平成 21 列的报表需求，我写了三个版本——AMDP 过程、纯 ABAP、HANA HIERARCHY。实测有点反直觉：1,469 行时 AMDP 慢 2.9 倍，10,140 行时打平，只有「按组织下钻」才反超 10%。这篇把三条路径的成本结构拆开算清楚，并把下次能照抄的八步实施方法留下来。</description><pubDate>Fri, 13 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;先说最反直觉的那个数字。&lt;/p&gt;
&lt;p&gt;同一份报表，同一个数据库，同一天同一台机器：&lt;strong&gt;数据量 1,469 行时，纯 ABAP 比 AMDP 快 2.9 倍；数据量 10,140 行时，两者打平；只有按组织下钻、且子树有上万节点时，AMDP 才反超 10%。&lt;/strong&gt;（把 AMDP 一路优化到底之后，1,469 行那一档也只追到 2.4 倍。）&lt;/p&gt;
&lt;p&gt;AMDP 的卖点一直是「把计算下推到 HANA，让数据库用自己的并行能力算」。理论上它应该碾压应用层循环，但这次没有——或者说，&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot;&gt;它只在「被消除的那部分成本占比足够大」时才赢&lt;/Notation&gt;，而这个占比跟数据量强相关。&lt;/p&gt;
&lt;p&gt;这篇把这件事拆到底：三条路径各自怎么实现、成本花在哪，以及一套下次可以直接照抄的八步实施方法。&lt;/p&gt;
&lt;h1&gt;需求本身并不复杂&lt;/h1&gt;
&lt;p&gt;业务口径一句话：把组织架构树拍平成一张宽表，每行一个组织，带它的完整层级路径。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;树最深九级，但要&lt;strong&gt;拍平成固定 21 列&lt;/strong&gt;：组织 ID、组织名称、9 组「层级 ID / 层级名称」、以及路径深度&lt;/li&gt;
&lt;li&gt;同一层如果撞了（一个组织在同一层挂到多个父节点下），用 &lt;code&gt;-&lt;/code&gt; 拼接，上级在前、含自身&lt;/li&gt;
&lt;li&gt;支持两种取数模式：全公司全量，或按某个组织&lt;strong&gt;向下钻取&lt;/strong&gt;（含自身及所有子孙，最多 10 层）&lt;/li&gt;
&lt;li&gt;对外是一个 RFC，必须支持 &lt;code&gt;ROWSKIPS&lt;/code&gt; / &lt;code&gt;ROWCOUNT&lt;/code&gt; 分页，还要回一个 &lt;code&gt;EV_TOTAL&lt;/code&gt; 给前端算总页数&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;数据源就三张 HRP 表：&lt;code&gt;HRP1000&lt;/code&gt;（对象主数据）、&lt;code&gt;HRP1001&lt;/code&gt;（层级关系）、&lt;code&gt;HRP9500&lt;/code&gt;（层级码）。开发机上 1,469 个组织，测试机上 10,140 个——差 7 倍，后面会看到这个倍数能把所有结论翻一遍。&lt;/p&gt;
&lt;p&gt;听起来是典型的「一条 SQL 或者一个循环就完事」的需求。麻烦在于 21 列的透视：九个层级要各自展开成 ID 和 NAME 两列，而 SQL 里没有「按层级列动态展开」这种语法——只能靠自连接十次，或者靠层级函数的 &lt;code&gt;hierarchy_level&lt;/code&gt; 列。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-org-hierarchy-amdp-vs-abap/three-paths.svg&quot; alt=&quot;三条实现路径：数据在数据库层算完，还是拉到应用服务器再算&quot;&gt;&lt;/p&gt;
&lt;h1&gt;先把几个名词说清楚&lt;/h1&gt;
&lt;p&gt;这篇文章会出现五个词，不先对齐含义，后面全是空话。&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;名词&lt;/th&gt;
&lt;th&gt;在哪一层&lt;/th&gt;
&lt;th&gt;是什么&lt;/th&gt;
&lt;th&gt;这次用它解决什么&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;AMDP&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;ABAP 与 HANA 之间&lt;/td&gt;
&lt;td&gt;ABAP Managed Database Procedure。用 ABAP 类方法当容器，方法体里写 SQLScript，编译后变成 HANA 侧的存储过程/表函数&lt;/td&gt;
&lt;td&gt;把 BFS、透视、分页全塞进数据库，一次调用出结果&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;表函数（Table Function）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;HANA&lt;/td&gt;
&lt;td&gt;CDS 里的 &lt;code&gt;define table function&lt;/code&gt;，带参数、返回表，可以被 ABAP 当数据源查&lt;/td&gt;
&lt;td&gt;让 &lt;code&gt;select ... from zom_tf_hier_flat(p_keydate = ...)&lt;/code&gt; 直接拿结果&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;SQLScript&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;HANA&lt;/td&gt;
&lt;td&gt;HANA 的过程语言。表变量 + 集合运算，能写 &lt;code&gt;count(*) over ()&lt;/code&gt;、&lt;code&gt;limit/offset&lt;/code&gt;、&lt;code&gt;string_agg&lt;/code&gt;、&lt;code&gt;max(case)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;它就是「用 SQL 写算法」的那个语言&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;BFS（广度优先遍历）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;无所谓&lt;/td&gt;
&lt;td&gt;按层推进的树遍历：先找子节点，再找子节点的子节点&lt;/td&gt;
&lt;td&gt;用 10 次自连接模拟递归，把子树圈出来&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;HIERARCHY 函数&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;HANA&lt;/td&gt;
&lt;td&gt;HANA 2.0 内置的层级引擎，一条 &lt;code&gt;hierarchy(source(...) start where ...)&lt;/code&gt; 直接出层级路径和层号&lt;/td&gt;
&lt;td&gt;把「10 次自连接」压成一次调用&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;有一个前提必须先确认：&lt;strong&gt;ABAP CDS 的 &lt;code&gt;define hierarchy&lt;/code&gt; 在 7.52 上不可用&lt;/strong&gt;，它要 7.55 以上。本系统是 7.52，所以「用 CDS 层级视图优雅解决」这条路直接断了，只剩 HANA SQL 侧的 &lt;code&gt;HIERARCHY&lt;/code&gt; 表函数可走。&lt;/p&gt;
&lt;h2&gt;为什么是 21 列&lt;/h2&gt;
&lt;p&gt;九级 × 2（ID + NAME）= 18，加上组织 ID、组织名称、路径深度 = 21。&lt;/p&gt;
&lt;p&gt;透视是整个查询里最贵的一步：九个层级要各自 &lt;code&gt;max(case when lvl = n then ... end)&lt;/code&gt; 拉成列，一共 19 路聚合（18 个层级列 + 路径深度）。这一步在 HANA 上要物化一遍，在 ABAP 里就是 19 次内表赋值——看起来不多，但乘上 10,140 行、再乘上每次请求，就成了主要成本。&lt;/p&gt;
&lt;h1&gt;三条路径，怎么落地&lt;/h1&gt;
&lt;h2&gt;路径 A：纯 ABAP&lt;/h2&gt;
&lt;p&gt;思路最直白：把三张表读到应用服务器，内存里做 BFS，内存里逐行上溯祖先。&lt;/p&gt;
&lt;p&gt;关键是&lt;strong&gt;不要给每一行单独查数据库&lt;/strong&gt;。假如写成「每行一个 &lt;code&gt;select single&lt;/code&gt; 上溯父节点」，那就是 10,140 行 × 平均 4 跳 = 4 万次数据库往返，必死。正确做法是先把 &lt;code&gt;HRP1001&lt;/code&gt; 全读进内表，建两个排序索引（按子找父、按父找子），后面全是内存二分查找。&lt;/p&gt;
&lt;p&gt;BFS 用 10 轮推进：第 n 轮拿第 n−1 轮的结果集去查「谁是它的子节点」，查到的丢进 HASH 去重，顺便记下层号。上溯祖先同理，用 HASH 防环——组织树里真的存在环，主数据维护错了就会有。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 一次读全，之后全是内存操作
SELECT objid sobid FROM hrp1001 INTO TABLE @DATA(lt_edge)
  WHERE otype = &amp;#39;O&amp;#39; AND sclas = &amp;#39;O&amp;#39; AND begda &amp;lt;= @lv_keydate
    AND endda &amp;gt;= @lv_keydate AND histo = &amp;#39;1&amp;#39; AND plvar = &amp;#39;01&amp;#39;.

SORT lt_edge BY sobid objid.          &amp;quot; 按父找子
SORT lt_edge BY objid sobid.          &amp;quot; 按子找父
&amp;quot; 之后 LOOP + READ TABLE ... BINARY SEARCH，不再回库
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这条路的优点只有两个：&lt;strong&gt;没有固定开销&lt;/strong&gt;（不调用数据库过程、不切会话），&lt;strong&gt;分页在内存里切得动&lt;/strong&gt;（基础表已经在内存了，切 20 行只拼 20 行）。&lt;/p&gt;
&lt;p&gt;代价也很清楚：1 万行全量时，内表要装 3 万行边 + 1 万行主数据 + 1 万个输出行 × 21 列，十几 MB 起步，而且是&lt;strong&gt;每个并发用户一份&lt;/strong&gt;。&lt;/p&gt;
&lt;h2&gt;路径 B：AMDP&lt;/h2&gt;
&lt;p&gt;把同一套算法用 SQLScript 重写。三步：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code&gt;lt_org&lt;/code&gt; / &lt;code&gt;lt_edge&lt;/code&gt; / &lt;code&gt;lt_lvl&lt;/code&gt; 三个基础表变量（对应 ABAP 那三张表）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;lt_scope&lt;/code&gt; 圈出要算的组织范围（全量 or 子树）&lt;/li&gt;
&lt;li&gt;祖先展开 + 透视，只针对页内组织&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;第三步是这里的巧思：&lt;strong&gt;先分页，再展开祖先&lt;/strong&gt;。祖先展开是最贵的部分（11 次自连接），只给页内 20 行做，成本就从「1 万行 × 11 次连接」降到「20 行 × 11 次连接」。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;-- 祖先展开只针对页内行：lt_h0 从 lt_page 出发，lt_h1..lt_h10 逐层向上
lt_h0 = select p.objid as node_id, p.objid as cur_id, 0 as hop from :lt_page as p;
-- lt_h1 = lt_h0 join lt_edge on lt_edge.node_id = lt_h0.cur_id ...
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;透视就用 19 路 &lt;code&gt;max(case)&lt;/code&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;select o.objid as org_id,
       max( case when l.lvl = 1 then l.node_id   end ) as l1_id,
       max( case when l.lvl = 1 then l.node_name end ) as l1_name,
       -- ... 到 l9
       cast( max( l.hop ) as integer ) as path_depth
  from :lt_org as o left outer join :lt_path as l on l.org_id = o.objid
 group by o.objid
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;同层的多个节点用 &lt;code&gt;string_agg(... order by ...)&lt;/code&gt; 拼成 &lt;code&gt;A-B-C&lt;/code&gt;，这就是「撞列用 &lt;code&gt;-&lt;/code&gt; 连接」的实现。实测样例：&lt;code&gt;10000103 制造处&lt;/code&gt;，深度 3，&lt;code&gt;L1=10000001 集团总部&lt;/code&gt;、&lt;code&gt;L2=10000100 事业群A&lt;/code&gt;、&lt;code&gt;L3=10000102-10000103 事业部A-制造处&lt;/code&gt;。&lt;/p&gt;
&lt;h2&gt;路径 C：AMDP + HIERARCHY&lt;/h2&gt;
&lt;p&gt;路径 B 里的「10 次自连接圈子树」，可以换成 HANA 原生的层级引擎：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;lt_sub = select distinct h.node_id as objid
           from hierarchy( source ( select e.parent_id,
                                           e.node_id
                                      from :lt_edge as e )
                           start where parent_id = :p_objid
                             and :p_objid &amp;lt;&amp;gt; &amp;#39;00000000&amp;#39;
                           sibling order by node_id
                           multiparent ) as h
          where h.hierarchy_level &amp;lt;= 10;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这个函数会给每行带上 &lt;code&gt;hierarchy_level&lt;/code&gt;（层号）和 &lt;code&gt;hierarchy_rank&lt;/code&gt;（同层排序），刚好是透视需要的输入。四个参数各有讲究：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;source()&lt;/code&gt; 里只能是&lt;strong&gt;一个&lt;/strong&gt; select，不能放 union——试过会报 &lt;code&gt;invalid column name: NODE_ID&lt;/code&gt;，因为 union 之后列名解析丢了&lt;/li&gt;
&lt;li&gt;&lt;code&gt;start where&lt;/code&gt; 必须用 &lt;strong&gt;&lt;code&gt;parent_id = 起点&lt;/code&gt;&lt;/strong&gt;，不能用 &lt;code&gt;node_id = 起点&lt;/code&gt;。用后者会把起点自己排除在外，顶层组织一行都出不来&lt;/li&gt;
&lt;li&gt;&lt;code&gt;multiparent&lt;/code&gt; 是必须的：一个组织挂多个父节点是常态，不加这个参数会直接报错&lt;/li&gt;
&lt;li&gt;&lt;code&gt;sibling order by&lt;/code&gt; 决定同层顺序，影响 &lt;code&gt;-&lt;/code&gt; 拼接的顺序&lt;/li&gt;
&lt;/ul&gt;
&lt;h1&gt;分页这件事，改了三次才做对&lt;/h1&gt;
&lt;p&gt;这段值得单独讲：它一半关乎性能、一半关乎正确性，难的是后者——纯粹的 SQL 语义坑，而且&lt;strong&gt;每一步看起来都对&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;先打个预防针：这一章是支线。它不改变选型结论，只负责解释那个 200 ms 的固定成本从哪来——赶时间的话可以直接跳到实测数据。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-org-hierarchy-amdp-vs-abap/paging-evolution.svg&quot; alt=&quot;分页实现的三代演进：从假分页到 exists 求交再到下推进子树构造&quot;&gt;&lt;/p&gt;
&lt;h2&gt;第一代：假分页&lt;/h2&gt;
&lt;p&gt;最初版本在 ABAP 侧切页：SQL 全取回来，&lt;code&gt;LOOP AT ... FROM s TO e&lt;/code&gt; 切出当前页。&lt;/p&gt;
&lt;p&gt;问题在于 &lt;code&gt;ROWSKIPS&lt;/code&gt; / &lt;code&gt;ROWCOUNT&lt;/code&gt; 是 RFC 接口的参数，在 ABAP 里切，就意味着取一页也要把 10,139 行全量搬回应用服务器——&lt;strong&gt;测试机上取一页和取全部一样贵，都是 850 ms 上下&lt;/strong&gt;。省掉的只是「页外行的 21 列拼装」，那是总成本里很小的一块。&lt;/p&gt;
&lt;p&gt;把 &lt;code&gt;limit / offset&lt;/code&gt; 下推进表函数后，取 1 行降到 &lt;strong&gt;207 ms&lt;/strong&gt;。这 200 ms 就是这条路绕不开的固定成本：圈子树、&lt;code&gt;count(*) over ()&lt;/code&gt;、三个基础表变量物化，跟页长无关。&lt;/p&gt;
&lt;h2&gt;第二代：exists 求交&lt;/h2&gt;
&lt;p&gt;速度上来了，正确性掉下去了。&lt;code&gt;IV_OBJID&lt;/code&gt; 传子树时，&lt;code&gt;EV_TOTAL&lt;/code&gt; 比实际行数大 3。&lt;/p&gt;
&lt;p&gt;根因是执行顺序：&lt;code&gt;count(*) over ()&lt;/code&gt; 和 &lt;code&gt;limit/offset&lt;/code&gt; 都作用在 &lt;code&gt;lt_scope&lt;/code&gt; 上，而 &lt;code&gt;lt_scope&lt;/code&gt; 还没跟组织主数据求交——最后输出时才 &lt;code&gt;inner join lt_org&lt;/code&gt;。子树 BFS 从 &lt;code&gt;HRP1001&lt;/code&gt; 收进来 3 个「有边但主数据无有效记录」的脏节点，于是总数偏大、offset 整体前移一行，&lt;strong&gt;最后一页多回一行、且跟前一页重叠&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;修法是在翻页之前先求交：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;lt_scope2 = select s.objid as objid
              from :lt_scope as s
             where exists ( select 1 from :lt_org as o
                             where o.objid = s.objid );
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这里选 &lt;code&gt;exists&lt;/code&gt; 而不是 &lt;code&gt;inner join&lt;/code&gt; 是有意的：如果 &lt;code&gt;HRP1000&lt;/code&gt; 因为有效期重叠出现同一 objid 多行，&lt;code&gt;inner join&lt;/code&gt; 会把 scope 行放大，&lt;code&gt;exists&lt;/code&gt; 不会。&lt;/p&gt;
&lt;p&gt;正确性全部恢复。然后&lt;strong&gt;代价来了&lt;/strong&gt;：开发机全量 90.3 → 103.5 ms（+13），测试机全量 409 → 490 ms（+78）。&lt;/p&gt;
&lt;h2&gt;定位：&lt;code&gt;where exists&lt;/code&gt; 被按行执行&lt;/h2&gt;
&lt;p&gt;一开始我以为是「多了一步必然要付的钱」，差点就这么接受了。真正拆开是因为一个比例：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;系统&lt;/th&gt;
&lt;th&gt;行数&lt;/th&gt;
&lt;th&gt;&lt;code&gt;where exists&lt;/code&gt; 增加的成本&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;开发机&lt;/td&gt;
&lt;td&gt;1,469&lt;/td&gt;
&lt;td&gt;+13 ms&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;测试机&lt;/td&gt;
&lt;td&gt;10,140&lt;/td&gt;
&lt;td&gt;+78 ms&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;行数比 7 倍，成本比 6 倍——&lt;strong&gt;线性相关&lt;/strong&gt;。这说明 HANA 没有把这个相关子查询去关联（decorrelate）成 join，而是&lt;strong&gt;逐行执行&lt;/strong&gt;了。&lt;/p&gt;
&lt;p&gt;开发机上行数少，13 ms 混在抖动里没人发现；测试机上万行，就直接变成 20% 的回退。&lt;/p&gt;
&lt;h2&gt;第三代：过滤下推进构造&lt;/h2&gt;
&lt;p&gt;既然全量模式下 &lt;code&gt;lt_scope&lt;/code&gt; 本来就等于 &lt;code&gt;lt_org&lt;/code&gt;（不需要过滤），这个过滤只应该发生在下钻模式，而且应该&lt;strong&gt;在构造 &lt;code&gt;lt_sub&lt;/code&gt; 的时候就完成&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-sql&quot;&gt;lt_sub = select distinct h.node_id as objid
           from hierarchy( ... ) as h
          inner join :lt_org as o on o.objid = h.node_id
          where h.hierarchy_level &amp;lt;= 10;

lt_scope = select o.objid as objid from :lt_org as o where :p_objid = &amp;#39;00000000&amp;#39;
           union select objid from :lt_sub
           union select o.objid as objid from :lt_org as o
                  where o.objid = :p_objid;   -- 自身节点，顺带校验它在主数据里
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;一次 join 换掉 N 次 exists。全量模式零过滤成本，下钻模式脏节点在源头就被剔掉，&lt;code&gt;count(*) over ()&lt;/code&gt; 与 &lt;code&gt;limit/offset&lt;/code&gt; 直接落在最终行集上，分页仍然正确。&lt;/p&gt;
&lt;p&gt;测试机全量从 477～502 回到 &lt;strong&gt;405～430&lt;/strong&gt;，20% 的回退全部收回。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;教训：&lt;code&gt;where exists&lt;/code&gt; 在 HANA 上不一定是半连接（semi-join）。&lt;strong&gt;判断依据不是「写法看起来像什么」，而是「成本随行数怎么变」&lt;/strong&gt;。线性 = 按行执行，常数 = 真的只算一次。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h1&gt;实测数据&lt;/h1&gt;
&lt;p&gt;所有数据都是 FM 直调、&lt;code&gt;GET RUN TIME FIELD&lt;/code&gt; 计时、5 次取最小、剔首轮冷启动。&lt;/p&gt;
&lt;h2&gt;当前生产版本 vs 纯 ABAP&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;场景&lt;/th&gt;
&lt;th&gt;AMDP（HIERARCHY + 下推）&lt;/th&gt;
&lt;th&gt;纯 ABAP&lt;/th&gt;
&lt;th&gt;倍数&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;开发机 全量 1,469 行&lt;/td&gt;
&lt;td&gt;76.4&lt;/td&gt;
&lt;td&gt;31.4&lt;/td&gt;
&lt;td&gt;ABAP 快 2.4×&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;开发机 单页 20 行&lt;/td&gt;
&lt;td&gt;41.6&lt;/td&gt;
&lt;td&gt;12.7&lt;/td&gt;
&lt;td&gt;ABAP 快 3.3×&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;测试机 全量 10,140 行&lt;/td&gt;
&lt;td&gt;405～430&lt;/td&gt;
&lt;td&gt;416&lt;/td&gt;
&lt;td&gt;持平&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;测试机 单页 20 行&lt;/td&gt;
&lt;td&gt;153.2&lt;/td&gt;
&lt;td&gt;73.5&lt;/td&gt;
&lt;td&gt;ABAP 快 2.1×&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;测试机 下钻 10,112 行&lt;/td&gt;
&lt;td&gt;440.4&lt;/td&gt;
&lt;td&gt;490.5&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;AMDP 快 1.1×&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;最后一行是这次唯一让 AMDP 扬眉吐气的数据，也是 HIERARCHY 唯一真正兑现的地方。&lt;/p&gt;
&lt;h2&gt;每一次改动，各值多少钱&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;版本&lt;/th&gt;
&lt;th&gt;全量 10,140 行&lt;/th&gt;
&lt;th&gt;单页 20 行&lt;/th&gt;
&lt;th&gt;备注&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;第一代 · 假分页&lt;/td&gt;
&lt;td&gt;~850&lt;/td&gt;
&lt;td&gt;~850&lt;/td&gt;
&lt;td&gt;取一页也要搬全量&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;└ 加 &lt;code&gt;limit/offset&lt;/code&gt; 下推&lt;/td&gt;
&lt;td&gt;~850&lt;/td&gt;
&lt;td&gt;230&lt;/td&gt;
&lt;td&gt;快了一半，但算错了数&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;第二代 · &lt;code&gt;exists&lt;/code&gt; 求交&lt;/td&gt;
&lt;td&gt;477～502&lt;/td&gt;
&lt;td&gt;173～177&lt;/td&gt;
&lt;td&gt;对了，每行探一次&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;第三代 · 过滤下移 + HIERARCHY&lt;/td&gt;
&lt;td&gt;405～430&lt;/td&gt;
&lt;td&gt;153&lt;/td&gt;
&lt;td&gt;回退全部收回&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h1&gt;为什么 AMDP 没赢&lt;/h1&gt;
&lt;p&gt;这不是「HANA 不够快」，而是三个成本项的结构问题。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-org-hierarchy-amdp-vs-abap/cost-curve.svg&quot; alt=&quot;两条成本曲线在 1 万行附近交叉&quot;&gt;&lt;/p&gt;
&lt;h2&gt;一、AMDP 有一个压不掉的固定成本&lt;/h2&gt;
&lt;p&gt;大概 50 ms。表函数调用、SQLScript 执行计划、ABAP ↔ HANA 会话切换，这几项跟行数无关。1,469 行时它接近总成本的一半——所以开发机上怎么优化都赢不了 31 ms 的纯 ABAP。&lt;/p&gt;
&lt;p&gt;纯 ABAP 没有这个固定成本。它的第一行数据从「&lt;code&gt;SELECT&lt;/code&gt; 返回」那一刻就开始算，没有启动费。&lt;/p&gt;
&lt;h2&gt;二、AMDP 必须把整棵树物化，ABAP 不必&lt;/h2&gt;
&lt;p&gt;这是最本质的差异。&lt;/p&gt;
&lt;p&gt;AMDP 拿到「每页 20 行」的需求，仍然要：读三张表 → 圈子树（或全表）→ &lt;code&gt;count(*) over ()&lt;/code&gt; 算出总数 → &lt;code&gt;limit/offset&lt;/code&gt; 切 20 行 → 给 20 行展开祖先 → 透视。&lt;/p&gt;
&lt;p&gt;而纯 ABAP 的分页是&lt;strong&gt;假分页&lt;/strong&gt;：三张基础表全读（这部分省不掉），但 21 列的拼装、排序、上溯祖先，真的只对页内 20 行做。&lt;/p&gt;
&lt;p&gt;所以 AMDP 是「&lt;strong&gt;固定成本 + 全量算一遍再切&lt;/strong&gt;」，ABAP 是「&lt;strong&gt;无固定成本 + 只算页内行&lt;/strong&gt;」。数据量小的时候，后者的结构优势完胜。&lt;/p&gt;
&lt;h2&gt;三、斜率不同，交叉点在 1 万行&lt;/h2&gt;
&lt;p&gt;把两边的实测点拟合成曲线：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;AMDP   ≈ 50 + 0.036 · n        (ms，n = 行数)
纯 ABAP ≈ 0.0019 · n^1.33
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;AMDP 的斜率是常数（每行约 36 µs），ABAP 是超线性的（指数约 1.33，来源是逐行上溯祖先 + 9 组字段拼装 + 最终排序）。两条线在 &lt;strong&gt;n ≈ 10,140 处刚好重合，都是 415 ms&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;这就是「1 万行拐点」的量化版本。它不是玄学，是两条拟合线的交点。&lt;/p&gt;
&lt;p&gt;&lt;Notation type=&quot;box&quot; color=&quot;#8b5cf6&quot;&gt;所以「AMDP 更快吗」这个问题本身就问错了。正确的问题是：我的瓶颈在应用服务器的逐行处理上，还是在数据库的往返与物化上？&lt;/Notation&gt;&lt;/p&gt;
&lt;p&gt;补一个非性能的维度：AMDP 版本全量时只往 ABAP 回传 1 万行成品；纯 ABAP 版本要在应用服务器内存里同时装 3 万行边、1 万行主数据、1 万行输出，&lt;strong&gt;每个并发用户一份&lt;/strong&gt;。真上生产、几十个人同时拉全量报表时，这个内存账会先炸。&lt;/p&gt;
&lt;h1&gt;HIERARCHY 赢在哪，什么时候不赢&lt;/h1&gt;
&lt;p&gt;标题里「做对了什么」，全部答案都在这一章——不多，但都是实测的。&lt;/p&gt;
&lt;p&gt;一开始我以为 HIERARCHY 是全面的性能升级——它确实把「10 次自连接 + 11 路 union」压成一次调用。开发机上全量省 26%、单页省 35%，看着很漂亮。&lt;/p&gt;
&lt;p&gt;然后到测试机上，全量 &lt;strong&gt;0%&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;原因是规模扫描暴露出来的：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;code&gt;P_OBJID&lt;/code&gt;&lt;/th&gt;
&lt;th&gt;行数&lt;/th&gt;
&lt;th&gt;BFS 版&lt;/th&gt;
&lt;th&gt;HIERARCHY 版&lt;/th&gt;
&lt;th&gt;变化&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;00000000&lt;/code&gt;（全量）&lt;/td&gt;
&lt;td&gt;10,140&lt;/td&gt;
&lt;td&gt;446.7&lt;/td&gt;
&lt;td&gt;437.1&lt;/td&gt;
&lt;td&gt;−2%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;10000001&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;10,112&lt;/td&gt;
&lt;td&gt;537.4&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;447.9&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;−17%&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;10000103&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;1,788&lt;/td&gt;
&lt;td&gt;317.1&lt;/td&gt;
&lt;td&gt;303.0&lt;/td&gt;
&lt;td&gt;−4%&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;10000201&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;5&lt;/td&gt;
&lt;td&gt;146.8&lt;/td&gt;
&lt;td&gt;150.2&lt;/td&gt;
&lt;td&gt;+2%&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;三条规律：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;收益只跟「递归要处理的节点数」成正比，跟总行数无关。&lt;/strong&gt; 子树 10,112 个节点时要跑 10 次全量 join，HIERARCHY 一次搞定，省 89 ms；只有 5 个节点的子树，什么都省不出来（甚至因为固定开销略慢 2%）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;测试机的固定成本约 147 ms&lt;/strong&gt;——5 行的查询也要 146.8 ms，这部分由三张 HRP 表读取与三个基础表变量物化构成，跟 scope 算法完全无关。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;全量 446 ms 里，真正随行数变化的部分只有约 300 ms&lt;/strong&gt;，而那 300 ms 是祖先展开（11 次 join）+ &lt;code&gt;string_agg&lt;/code&gt; + 19 路 &lt;code&gt;max(case)&lt;/code&gt; 透视——&lt;strong&gt;HIERARCHY 一点忙都帮不上&lt;/strong&gt;。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;所以「HIERARCHY 让测试机也省三成」这个预测不成立。它在测试机上的真实价值只有一句话：&lt;strong&gt;按组织下钻时省 17%&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;开发机上那句 −26% 也得改口径：全量模式根本不走递归，那 23 ms 的差距来自 BFS 版那 10 个 &lt;code&gt;lt_k1..lt_k10&lt;/code&gt; 语句——它们是&lt;strong&gt;无条件执行的 SQLScript 语句&lt;/strong&gt;，即使每层都返回空集，10 次 join + 11 路 union 的语句开销照样要付。换成 HIERARCHY 后只剩一次调用、返回空集，这笔空转开销就没了。&lt;/p&gt;
&lt;p&gt;&lt;Notation type=&quot;underline&quot; color=&quot;#ef4444&quot;&gt;优化的收益永远等于「被消除的那部分成本占总量多少」，不是「新技术比旧技术先进多少」。&lt;/Notation&gt;&lt;/p&gt;
&lt;h1&gt;八步实施方法&lt;/h1&gt;
&lt;p&gt;下次再遇到「层级/递归 + 透视 + 分页」这类需求，按这八步走。左边四步负责把它做出来，右边四步负责证明它站得住。具体的环境坑（AMDP 注释规则、FM 出参类型、传输后的 RFC 报错等）都收在文末的踩坑清单里，这里只留通用动作。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-org-hierarchy-amdp-vs-abap/implementation-sop.svg&quot; alt=&quot;可复用的八步实施流程：先做出来，再证明它站得住&quot;&gt;&lt;/p&gt;
&lt;h2&gt;第一步：先把口径跑对&lt;/h2&gt;
&lt;p&gt;不要一上来就搭框架、建对象、写接口。先用最朴素的方式——一段裸 SQL、一个临时脚本——把结果完整算出来，拿一份业务台账逐格核对。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;判据&lt;/strong&gt;：结果跟业务认可的数据一致，包括那些「层级列为空」的边界行。&lt;/p&gt;
&lt;p&gt;这一步两小时，能省掉后面两天。算法错了，后面所有性能数字都是在给错的东西计时。&lt;/p&gt;
&lt;h2&gt;第二步：先验证可行性，再投入&lt;/h2&gt;
&lt;p&gt;这部分最容易白干。动手之前先确认两件事：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;版本与特性&lt;/strong&gt;：想用的高级特性在当前版本上真的可用（这次的教训是 CDS 层级视图要 7.55+，一条路直接断了）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;对象能否落地&lt;/strong&gt;：需要的各类对象在你的开发流程里真的建得出来、传得出去&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;判据&lt;/strong&gt;：十分钟内真的建出一个空壳对象，别等写完几百行才发现无处安放。&lt;/p&gt;
&lt;h2&gt;第三步：先跑通，再优化&lt;/h2&gt;
&lt;p&gt;第一版怎么直白怎么写，不追求性能，让「输入 → 正确输出」这条链路先完整存在。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;判据&lt;/strong&gt;：端到端能出正确结果，慢可以接受。&lt;/p&gt;
&lt;p&gt;没有靶子的优化是空转，这个能跑通的笨版本就是靶子。&lt;/p&gt;
&lt;h2&gt;第四步：对外接口端到端验证一次&lt;/h2&gt;
&lt;p&gt;结果要暴露给外部调用，就尽早从真实的调用方路径完整调一次，而不是只在开发工具里自测。接口层的坑有一个共性：&lt;strong&gt;本地全是通的，外部全是断的&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;判据&lt;/strong&gt;：从真实调用方发起一次完整调用，拿到正确结果。&lt;/p&gt;
&lt;h2&gt;第五步：写一份对照实现&lt;/h2&gt;
&lt;p&gt;用最不同的技术路线再写一版，不为上生产，只当尺子和应急备胎。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;判据&lt;/strong&gt;：两版结果整表完全相等。这一步同时能抓出精度问题、空值处理差异、排序不稳定——比任何人肉核对都靠得住。&lt;/p&gt;
&lt;p&gt;没有对照版，你没法判断「快」是真的还是错觉。&lt;/p&gt;
&lt;h2&gt;第六步：交替基准，别分开跑&lt;/h2&gt;
&lt;p&gt;几版实现放在同一个循环里背靠背跑，剔掉第一轮（冷启动），取最小值。&lt;/p&gt;
&lt;p&gt;分开跑会吃机器漂移——我第一次分开跑，同一份代码两次差 20%，差点得出错误结论。交替跑之后，各版共享同一个时间窗口的机器状态，比值才可信。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;判据&lt;/strong&gt;：跑间抖动要明显小于实现之间的差距。抖动 5%、差距 3%，这个结论就不成立。&lt;/p&gt;
&lt;p&gt;顺便：比耗时更早暴露问题的是&lt;strong&gt;行数&lt;/strong&gt;和&lt;strong&gt;唯一 id 数&lt;/strong&gt;。先把这两个对上，再看时间。&lt;/p&gt;
&lt;h2&gt;第七步：三层校验，缺一不可&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;校验&lt;/th&gt;
&lt;th&gt;防的是什么&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;逐页 diff（翻完全部页）&lt;/td&gt;
&lt;td&gt;分页偏移错位、页与页重叠&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;整表逐列比对&lt;/td&gt;
&lt;td&gt;某一列语义写错、精度丢失&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;跨页唯一 id 数 = 接口返回的总数&lt;/td&gt;
&lt;td&gt;漏行、重行（专治「最后一页多回一行」）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;我这次的偏差就是被第三项抓出来的：接口返回总数 10,113，实际唯一 id 10,112。&lt;/p&gt;
&lt;h2&gt;第八步：换环境必须复测&lt;/h2&gt;
&lt;p&gt;不同环境的数据量可能差一个数量级，结论经常整个翻过来。这次开发机上 13 ms 的回退没人察觉，测试机上就是 78 ms。凡是「在 A 环境成立」的结论，到 B 环境的第一件事就是重测，别默认它还在。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;判据&lt;/strong&gt;：关键结论在目标环境重新测过一遍，而不是从旧环境推过去的。&lt;/p&gt;
&lt;h2&gt;选型判据&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;条件&lt;/th&gt;
&lt;th&gt;选什么&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;行数 &amp;lt; 3,000、调用频繁、要求低延迟&lt;/td&gt;
&lt;td&gt;纯 ABAP（甚至干脆在应用层加缓存）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;行数 1 万+、要分页、并发用户多&lt;/td&gt;
&lt;td&gt;AMDP（内存与并发优势比耗时优势更实在）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;要按组织下钻、子树常达几千上万节点&lt;/td&gt;
&lt;td&gt;AMDP + HIERARCHY（省 10%～17%）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;外部系统要 RFC 直调&lt;/td&gt;
&lt;td&gt;都得包 FM，出参行类型必须是表类型&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h1&gt;踩坑清单&lt;/h1&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;坑&lt;/th&gt;
&lt;th&gt;现象&lt;/th&gt;
&lt;th&gt;解法&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;AMDP 里写中文注释&lt;/td&gt;
&lt;td&gt;&lt;code&gt;W: Only ASCII 7 bit characters&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;注释全改英文&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;AMDP 注释里有单引号&lt;/td&gt;
&lt;td&gt;「不允许占用超过一行的文字」&lt;/td&gt;
&lt;td&gt;去掉 &lt;code&gt;&amp;#39;&lt;/code&gt;，改写成 &lt;code&gt;of the&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;带参表函数的 &lt;code&gt;P_CLIENT&lt;/code&gt; 不自动填&lt;/td&gt;
&lt;td&gt;数据一行都出不来&lt;/td&gt;
&lt;td&gt;显式传 &lt;code&gt;$session.client&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;FM 出参行类型用了结构&lt;/td&gt;
&lt;td&gt;&lt;code&gt;rfc_enabled&lt;/code&gt; 失败、&lt;code&gt;FMODE&lt;/code&gt; 为空&lt;/td&gt;
&lt;td&gt;建 DDIC 表类型指向它&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;FM 出参行类型用了 CDS 视图&lt;/td&gt;
&lt;td&gt;&lt;code&gt;declares no type&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;必须 DDIC 表/结构/表类型&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;HIERARCHY&lt;/code&gt; 的 &lt;code&gt;source()&lt;/code&gt; 里放 union&lt;/td&gt;
&lt;td&gt;&lt;code&gt;invalid column name: NODE_ID&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;source 里只放一个 select&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;start where node_id = 起点&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;顶层组织一行都出不来&lt;/td&gt;
&lt;td&gt;改 &lt;code&gt;start where parent_id = 起点&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;HIERARCHY&lt;/code&gt; 不加 &lt;code&gt;multiparent&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;多父节点的组织直接报错&lt;/td&gt;
&lt;td&gt;显式加 &lt;code&gt;multiparent&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;where exists&lt;/code&gt; 求交&lt;/td&gt;
&lt;td&gt;成本随行数线性上涨&lt;/td&gt;
&lt;td&gt;下推进集合构造，用一次 join 换掉&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;传输后调用 AMDP 过程&lt;/td&gt;
&lt;td&gt;&lt;code&gt;RFC_CLOSED&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;调用前 &lt;code&gt;COMMIT WORK.&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;另有一个&lt;strong&gt;实验环境的坑&lt;/strong&gt;，跟 SAP 对象无关但很坑人：用网关验证全量时，单表返回被截到 10,000 行，而 &lt;code&gt;EV_TOTAL&lt;/code&gt; 仍是真实值，响应里也没有截断标记。所以「行数对不上」的时候先怀疑工具链——验证全量一定要分页拉。&lt;/p&gt;
&lt;h1&gt;最后&lt;/h1&gt;
&lt;p&gt;这次做完，我对「下推」这件事的理解变了一点。&lt;/p&gt;
&lt;p&gt;以前我的默认判断是「计算下推到数据库总是更优」，因为减少了数据传输。但这次的数据说明：&lt;strong&gt;下推的收益等于「被下推掉的那部分成本在总量里的占比」&lt;/strong&gt;，而占比取决于算法结构，不取决于数据量本身。&lt;/p&gt;
&lt;p&gt;在这份需求里，真正能被下推消掉的只有 BFS 圈子树这一块（下钻时省 17%，全量时只省 2%）；祖先展开、透视、分页（还得先物化总数）挪到数据库里照样要算。能消掉的满打满算只有三分之一，所以 AMDP 在 1 万行上最多只能追平。&lt;/p&gt;
&lt;p&gt;反过来，如果瓶颈正好在那三分之一里——比如下钻场景，递归真的一层层往下走——AMDP 就开始赢了。这次也是唯一一处它赢的地方。&lt;/p&gt;
&lt;p&gt;所以选型的正确问法不是「哪个技术更新」，而是「&lt;strong&gt;我的耗时分布在哪一层，那一层能不能被搬走&lt;/strong&gt;」。先把这句话答清楚，再决定用 AMDP、HIERARCHY 还是老老实实写 ABAP 循环。&lt;/p&gt;
&lt;p&gt;三个版本、三轮分页重构、两轮传输复测之后，最值钱的产出其实不是那个 76 ms 的数字，而是那张八步流程——它下次能让我少走两天的弯路。&lt;/p&gt;
&lt;h2&gt;相关阅读&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sapcli-amdp-cds-hana-pipeline/&quot;&gt;AMDP 表函数从零到 HANA 直连：SFLIGHT 全链路实录&lt;/a&gt;——这篇谈「AMDP 该不该用」，那篇谈「AMDP 怎么用」：CDS 表函数封装、client 处理、直连 HANA 的授权暗坑（#covw），一次走通。&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sapcli-abap-ci-pipeline/&quot;&gt;用 sapcli 把 SAP 接进 CI：Docker 靶场、代理排障与 JUnit 闭环&lt;/a&gt;——AMDP 对象的创建、激活、回归测试全用命令行完成，不需要打开 SAPGUI。&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】10 · 自我描述的代码：让代码本身就是文档</title><link>https://jack-liang.com/blog/dev-first-principles-10-self-describing-code/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-10-self-describing-code/</guid><description>文档必然过时，但组织得好的代码不会。接手项目找&quot;采购订单审批逻辑&quot;，文档说在 ZMM_PO，SE38 一搜出来十几个程序，最后靠老员工口头指路。这篇讲一个反直觉的判断：命名、包结构、注释做到位，代码自己就是导航。加三条做法和一份自查清单。</description><pubDate>Tue, 10 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：好的代码组织自带导航。&lt;/p&gt;
&lt;p&gt;有一次接手项目维护，要找一个&amp;quot;采购订单的审批逻辑&amp;quot;。文档里写&amp;quot;在 ZMM_PO
程序里&amp;quot;，SE38 一搜
ZMM_PO，出来十几个程序，哪个是审批没人知道，最后靠老员工口头指路才找到。这篇讲一个反直觉的判断：命名、包结构、注释做到位，代码自己就是导航，不用翻文档。加三条做法和一份自查清单。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、ZMM_PO 一搜出来十几个程序&lt;/h2&gt;
&lt;p&gt;有一次接手一个项目的维护。&lt;/p&gt;
&lt;p&gt;第一个任务是改&amp;quot;采购订单的审批逻辑&amp;quot;。先去翻文档，文档里写着：在 ZMM_PO
程序里。打开 SE38 一搜
ZMM_PO——出来十几个程序：ZMM_PO、ZMM_PO_OLD、ZMM_PO_NEW、ZMM_PO_2、ZMM_PO_BAK。&lt;/p&gt;
&lt;p&gt;哪个是审批？不知道。每个都打开看看？十几个程序，每个几千行，不可能。&lt;/p&gt;
&lt;p&gt;最后是老员工口头指路：在 ZMM_PO_RELEASE 函数组里，函数
Z_MM_PO_RELEASE_CHECK。我顺着找过去，果然在那里。&lt;/p&gt;
&lt;p&gt;问题是，这条路径只存在于老员工脑子里。他哪天离职了，下一个接手的人还是从十几个
ZMM_PO 开始翻。&lt;/p&gt;
&lt;p&gt;我以前觉得，代码怎么组织是程序员自己顺手的事，真正给接手的人看的，是文档。后来发现不对。文档会过期——ZMM_PO
程序改了八回，文档还是最初那版；代码组织不会过期，它天天被执行。哪份信息更可信，不用争。&lt;/p&gt;
&lt;h2&gt;二、命名、结构、职责，各管一件事&lt;/h2&gt;
&lt;p&gt;那次之后我反过来想：如果代码组织得好，那个接手的人需要文档吗？&lt;/p&gt;
&lt;p&gt;不需要。他要找审批逻辑，只需要三层信息：名字告诉他这是什么，位置告诉他这在哪，职责告诉他这该管什么。自我描述的代码，就是把这三层都做对。&lt;/p&gt;
&lt;p&gt;命名写&amp;quot;是什么&amp;quot;，不写&amp;quot;怎么做&amp;quot;。create_invoice 是对的，loop_insert_buffer_write
是错的——后者把实现方式烙在了名字里，实现一换，名字就撒谎。命名对了，调用者只看名字就够了，80%
的&amp;quot;读代码&amp;quot;根本不用发生。&lt;/p&gt;
&lt;p&gt;结构按业务域，不按技术分层。包就是目录，路径读出来就该是&amp;quot;在干什么&amp;quot;：财务的发票创建，就该待在
ZFI_AR 下面。&lt;/p&gt;
&lt;p&gt;职责一个对象一个。这是
&lt;a href=&quot;/blog/dev-first-principles-02-divide-by-responsibility/&quot;&gt;《02 篇 复杂问题，要先学会「切」》&lt;/a&gt;
讲过的按职责切：一个函数、一个类只做一件事。名字、位置、职责三层叠在一起，一个陌生人看一眼，就知道这东西是什么、在哪、该干什么。&lt;/p&gt;
&lt;p&gt;你可能觉得：起名字、理包结构太花时间了，ZPROG01 也一样能跑。&lt;/p&gt;
&lt;p&gt;跑是一样跑，找不一样。代码的一生，写一次，读几十次。花在命名和结构上的时间，读的那几十次会连本带利还回来。&lt;/p&gt;
&lt;h2&gt;三、图书馆没有导览手册&lt;/h2&gt;
&lt;p&gt;这事图书馆几百年前就解决了。&lt;/p&gt;
&lt;p&gt;一个藏书百万的图书馆，读者进门，没有导览手册，也不需要管理员领着。中图法把全馆分成二十二个大类：A
马克思主义，B 哲学，I 文学，T
工业技术，每个大类再往下细分，一层一层，直到书架上的某一格。每本书的书脊上印着编号，编号就是它的地址。&lt;/p&gt;
&lt;p&gt;读者找书，靠的就是这套编号。管理员新上一批书，按编号归入对应的格——维护成本几乎为零，因为归类发生在书进馆的那一刻，跟着书走。&lt;/p&gt;
&lt;p&gt;书脊编号就是命名，书架层级就是包结构。书自己带着地址，所以不需要一本《本馆藏书使用手册》——真写了这么一本，三个月就过期。&lt;/p&gt;
&lt;p&gt;代码也一样。命名和结构做到位，代码自己带着地址；做不到位，才需要靠文档和口口相传。而后者的保质期，取决于写文档的人还在不在职。&lt;/p&gt;
&lt;h2&gt;四、三条做法&lt;/h2&gt;
&lt;p&gt;落到 ABAP，按重要性排。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1. 包结构按业务域&lt;/strong&gt;。SE80
的包本身就是导航系统，别浪费它。这套命名读出来就是&amp;quot;在做什么&amp;quot;：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;顶层包     ZFI / ZMM / ZSD           (财务/物料/销售)
子包       ZFI_AR / ZFI_AP / ZFI_GL  (应收/应付/总账)
函数组     ZFG_AR_INVOICE
函数       ZFI_AR_INVOICE_CREATE     (应收发票创建)
类         ZCL_SD_ORDER
方法       CREATE( ) / VALIDATE( ) / SAVE( )
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;判断标准就一条：业务变更的时候，你知道去哪个包改吗？知道，结构就是对的；不知道，就回去重排。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. 命名即路径&lt;/strong&gt;。函数
ZFI_AR_INVOICE_CREATE，从名字能推出归属、业务、动作三层信息。反过来，zprog01、z_new
这种名字，等于宣布&amp;quot;不想让人找到&amp;quot;。命名规范不用复杂，一套前后缀约定（ZFI_ / ZCL_
/ ZFG_）加一条&amp;quot;写是什么不写怎么做&amp;quot;就够了。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3.
注释写&amp;quot;为什么&amp;quot;，不写&amp;quot;做了什么&amp;quot;&lt;/strong&gt;。做了什么，代码自己会说；为什么这么做、有什么坑，代码说不出，这才是注释的地盘。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;i = i + 1.        &amp;quot;i 加 1                  —— 多余，删了
i = i + 1.        &amp;quot;跳过表头，源文件格式见 issue #123  —— 留
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;你可能想问：注释到底写多少算多？判断方法也简单：这段注释如果删掉，读代码的人会少知道什么？答案是什么也不少，就删。&lt;/p&gt;
&lt;p&gt;自查清单，Code Review 时过一遍：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;包结构按业务域分，不按 MVC 或技术分层&lt;/li&gt;
&lt;li&gt;函数、类、方法的命名能读出&amp;quot;是什么&amp;quot;，读不出实现方式&lt;/li&gt;
&lt;li&gt;一个函数只做一件事，名字里不带 process_data_v2_final 这种万能词&lt;/li&gt;
&lt;li&gt;注释解释&amp;quot;为什么&amp;quot;，不复述代码&lt;/li&gt;
&lt;li&gt;新对象建进包之前，先想它能从包路径里被找到吗&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;反模式也说一句：按 MVC
分包、命名随意、一个函数做五件事、注释写&amp;quot;做了什么&amp;quot;——这四件事的共同点是：都把找代码的活儿，推给了文档和别人的记忆。&lt;/p&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;代码可以是文档——前提是组织得好。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;文档必然过时，代码天天被执行——哪份更值得信任，答案一直在那儿。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;/blog/dev-first-principles-09-config-table-governance/&quot;&gt;《09 篇 配置表泛滥怎么治理》&lt;/a&gt;
把配置表收进登记册，这篇把代码变成自己的目录——干的还是同一件事：让信息待在能被找到的地方。&lt;/p&gt;
&lt;p&gt;下一篇聊文档。既然代码可以是文档，那还要不要文档？要，但大部分文档可以放错地方了——下一篇讲文档和代码怎么共生。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>几天做完几十人天的 ABAP 项目：我让 AI 通过网关直接开发 SAP</title><link>https://jack-liang.com/blog/sap-for-agents-abap-dev-in-days/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-for-agents-abap-dev-in-days/</guid><description>我的开源项目 sap-for-agents 把 SAP 的 RFC 和 ADT 两套底层能力包装成 HTTP API 交给 AI Agent——搜函数、读源码、写代码、激活、跑测试、查 dump 全部自服务。最近我用它开发了 zom_org（一个 OM 组织对象维护平台，约 30 个类、5 个 RFC、完整文档体系），几天时间做完了按传统方式要几十个人天的活。这篇讲讲这个开发-验证闭环是怎么转起来的。</description><pubDate>Wed, 04 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;先说结果。&lt;/p&gt;
&lt;p&gt;最近我做了一个 SAP HR 组织管理（OM）方向的项目：&lt;strong&gt;zom_org&lt;/strong&gt;，一个组织对象维护平台的 SAP 侧——校验、装配、加锁、落库（HRP 表）、日志、报错全链路，外加 5 个对外 RFC 接口和完整的 ABAP Unit 测试。&lt;/p&gt;
&lt;p&gt;规模大概是：约 30 个 ABAP 类、6 个接口、一整套 DDIC 类型层（域/数据元素/结构/表/锁对象/编号范围）、一个消息类 65+ 条消息，再加上 20 多万字的设计书、进度台账、上线清单、验收基准文档。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-for-agents-abap-dev-in-days/zom-org-architecture.png&quot; alt=&quot;zom_org 分层架构：RFC 接口层 / 应用服务层 / 规则层 / 数据访问层，直到 SAP 内核调用&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-for-agents-abap-dev-in-days/zom-org-se80-package.png&quot; alt=&quot;SE80 里的 ZOM_ORG 包：约 30 个类、6 个接口、函数组与消息类&quot;&gt;&lt;/p&gt;
&lt;p&gt;按传统开发方式估，这是&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot;&gt;几十个人天的活。实际用了几天&lt;/Notation&gt;。&lt;/p&gt;
&lt;p&gt;写代码的主力不是我，是 AI Agent。我几乎没打开过 SE80——Agent 通过一个网关直接在 SAP 系统里搜元数据、写代码、激活、跑测试、查 dump、修 bug，全程自服务。&lt;/p&gt;
&lt;p&gt;这个网关就是我之前开源的 &lt;strong&gt;sap-for-agents&lt;/strong&gt;（&lt;a href=&quot;https://github.com/Jack-Liang/sap-for-agents%EF%BC%89%EF%BC%8C%E4%B9%8B%E5%89%8D%E5%86%99%E8%BF%87%E4%B8%80%E7%AF%87%E3%80%8A%E7%BB%99&quot;&gt;https://github.com/Jack-Liang/sap-for-agents），之前写过一篇《给&lt;/a&gt; SAP 开一扇 HTTP 小门》介绍它的调用能力。这几个月它进化出了一个新形态：&lt;Notation type=&quot;underline&quot; color=&quot;#ef4444&quot;&gt;不只是&amp;quot;让 AI 能调 SAP&amp;quot;，而是&amp;quot;让 AI 能开发 SAP&amp;quot;&lt;/Notation&gt;。这篇讲讲它是怎么做到的，以及那个几天做完的项目背后，开发-验证闭环是怎么转起来的。&lt;/p&gt;
&lt;h1&gt;为什么 AI 之前开发不了 ABAP&lt;/h1&gt;
&lt;p&gt;让 AI 调用 SAP 和让 AI 开发 SAP，是两个难度量级的事。&lt;/p&gt;
&lt;p&gt;调用只需要解决&amp;quot;怎么调&amp;quot;——协议绑定、参数编组，一个 HTTP 端点就够了。但开发要解决的是一整条链路：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;探索&lt;/strong&gt;：这个系统里有什么？函数、表、结构的定义是什么？（AI 没有你的系统记忆）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;写入&lt;/strong&gt;：代码怎么进 SAP？SE80 是个 GUI，AI 点不了&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;激活与校验&lt;/strong&gt;：语法对不对？激活有没有报错？&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;验证&lt;/strong&gt;：跑一下，行为对吗？&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;排错&lt;/strong&gt;：报错了，dump 在哪？错因是什么？&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;传统上，这条链上的每一环都把人钉在 SAP GUI 前面。AI 能帮你写 ABAP 代码片段，但&amp;quot;粘贴进 SE80 → 激活 → 按 F8 测试 → 去 ST22 看 dump&amp;quot;这些动作还得人来干，&lt;Notation type=&quot;box&quot; color=&quot;#3b82f6&quot;&gt;AI 产出的代码和真实系统之间隔着一个人肉搬运工&lt;/Notation&gt;——通常就是你自己。&lt;/p&gt;
&lt;p&gt;打通这条链需要的不是新发明，而是把 SAP 早已存在的两套底层能力交到 AI 手上。&lt;/p&gt;
&lt;h1&gt;两把钥匙：RFC 和 ADT&lt;/h1&gt;
&lt;p&gt;SAP 系统对外其实一直有两套程序化入口，网关做的事就是把它们同时包装成 HTTP API：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;RFC 通道&lt;/strong&gt;——走 NWRFC SDK，负责&amp;quot;运行态&amp;quot;的事：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;调任意函数/BAPI（&lt;code&gt;/api/rfc&lt;/code&gt;）&lt;/li&gt;
&lt;li&gt;元数据自发现：搜函数、查接口签名、读函数文档、查 DDIC 结构、读透明表数据&lt;/li&gt;
&lt;li&gt;读函数和程序的 ABAP 源码&lt;/li&gt;
&lt;li&gt;临时跑一段 ABAP 探针代码（&lt;code&gt;RFC_ABAP_INSTALL_AND_RUN&lt;/code&gt;）——那些在 SAP 会话内才调得到的 &lt;code&gt;RH_*&lt;/code&gt; / &lt;code&gt;RS_*&lt;/code&gt; 函数，也能借此触达&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;ADT 通道&lt;/strong&gt;——走 &lt;code&gt;/sap/bc/adt/**&lt;/code&gt; REST 接口（就是 Eclipse ADT 用的那套），负责&amp;quot;开发态&amp;quot;的事：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;读/写 ABAP 对象源码（类、接口、函数、程序、include、CDS、表结构……）&lt;/li&gt;
&lt;li&gt;完整的写入编排：&lt;Notation type=&quot;highlight&quot; color=&quot;#86efac&quot;&gt;加锁 → 写入 → 语法检查 → 解锁 → 激活&lt;/Notation&gt;，一次 API 调用完成&lt;/li&gt;
&lt;li&gt;查 ST22 短转储：列表、按错误类型聚合、解析出终止点和调用栈&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;ADT 通道有个细节值得一提：写操作需要 CSRF token 和 stateful 会话，网关把这些全托管了——调用方只发一个 &lt;code&gt;PUT&lt;/code&gt;，背后是网关维护的会话在跟 SAP 拉扯。&lt;/p&gt;
&lt;p&gt;两套通道合体，AI 手里的 SAP 就不再是个黑盒：&lt;Notation type=&quot;circle&quot; color=&quot;#10b981&quot;&gt;系统里有什么（元数据 API）、代码怎么写进去（ADT 写入）、跑得对不对（RFC 调用 + ABAP Unit）、错了为什么（ST22 结构化解析），每一环都有端点&lt;/Notation&gt;。我把这套使用说明写进了网关自带的 &lt;code&gt;AGENTS.md&lt;/code&gt;（访问 &lt;code&gt;/agents.md&lt;/code&gt; 就能拿到），Agent 开局读一遍，就知道这套系统该怎么自服务。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-for-agents-abap-dev-in-days/gateway-home.png&quot; alt=&quot;网关 Web 首页：粘贴给 AI 的 agents.md 链接、连通性测试与端点列表&quot;&gt;&lt;/p&gt;
&lt;h1&gt;闭环转起来是什么样&lt;/h1&gt;
&lt;p&gt;抽象说完，看实战。zom_org 开发中一个典型的迭代循环长这样：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第一步：探索。&lt;/strong&gt; 我要做一个&amp;quot;按值域/检查表/转换例程自动解析字段枚举值&amp;quot;的码值层。Agent 先自己查 DDIC：&lt;code&gt;T777V&lt;/code&gt; 这种文本表的首键是语言列吗？&lt;code&gt;DD_DOMVALUES_GET&lt;/code&gt; 返回的文本字段缺省是什么？这些问题它直接调网关的 DDIC 端点和查表端点拿真实数据回答，不猜。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第二步：写入。&lt;/strong&gt; 代码本地成型后，经网关 ADT 通道写进开发机：ETag 乐观锁防覆盖、写入后回读比对、语法检查不过就不激活。改一小段还有&amp;quot;唯一匹配查找替换&amp;quot;端点，不用整文件重写。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第三步：验证。&lt;/strong&gt; 激活后立刻调 RFC 跑真实用例——zom_org 的写入口 &lt;code&gt;Z_OM_ORG_SUBMIT&lt;/code&gt; 支持 &lt;code&gt;IV_MODE=&amp;#39;C&amp;#39;&lt;/code&gt; 试算不落库，Agent 可以反复试算比对 diff，确认逻辑对了再落库。ABAP Unit 测试类也走同一条链路执行。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第四步：排错。&lt;/strong&gt; 出错了不用人去 ST22 翻：Agent 调 &lt;code&gt;/api/dumps&lt;/code&gt; 拿到结构化 dump——错误类型、终止程序、调用栈，直接定位。前几天一次真实记录：一轮迭代里 Agent 复核出 9 处语法错加 4 个行为根因（比如 &lt;code&gt;CONDENSE&lt;/code&gt; 对定长 CHAR 压不掉尾随空格导致判断恒假），逐个修复后探针 14/14 全绿，1267 节点的大树读取全量解析通过。&lt;/p&gt;
&lt;p&gt;注意这个循环里人的角色：&lt;Notation type=&quot;highlight&quot; color=&quot;#fbbf24&quot;&gt;我负责提需求、审设计、验收结果；循环内部的每一步都是 Agent 自己转的&lt;/Notation&gt;。这才是效率的来源——不是&amp;quot;AI 打字比我快&amp;quot;，而是&lt;strong&gt;验证的往返成本被打掉了&lt;/strong&gt;。传统开发里&amp;quot;改一行 → 激活 → 按 F8 → 看结果&amp;quot;要一分钟，人一天只能转几百圈；Agent 转一圈只要几秒钟，还不出错。&lt;/p&gt;
&lt;p&gt;循环跑完还有最后一道对账：代码经 abapGit 回流到 git 仓库，本地与 SAP 侧逐行比对——9280 行代码、133 个对象，零漂移。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-for-agents-abap-dev-in-days/zom-org-abapgit-stats.png&quot; alt=&quot;abapGit 统计：本地与远端（SAP 侧）逐行一致，9280 行代码、133 个对象&quot;&gt;&lt;/p&gt;
&lt;h1&gt;真实踩出来的坑，也流回了工具&lt;/h1&gt;
&lt;p&gt;几天高强度实战，等于对网关做了一轮极限压测。它现在的几个硬能力，都是这个项目逼出来的：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;激活后行为没变？&lt;/strong&gt; 网关的 RFC 连接池复用有状态会话，旧版本类会驻留——表现为&amp;quot;写入成功、激活成功，但就是跑旧代码&amp;quot;。于是有了连接池代次机制和运行期 reload，换代不重进程&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;改了 RFC 签名要重启网关？&lt;/strong&gt; 实测发现 SAP SDK 的函数描述符缓存是按 SYSID 进程级持有的（跟连接无关），于是接入了 SDK 的按名移除缓存接口，签名变更立即生效，不再重启&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;RFC_READ_TABLE&lt;/code&gt; 在目标系统上不可用？&lt;/strong&gt; 那就用网关自己的能力反向开发一个——zom_org 里的 &lt;code&gt;Z_OM_ORG_QUERY&lt;/code&gt; 通用查表函数就是这么来的，支持字段子集、WHERE 条件、翻页，比标准函数好用&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这就是我说的闭环的另一层含义：&lt;Notation type=&quot;box&quot; color=&quot;#8b5cf6&quot;&gt;工具开发应用，应用反过来捶打工具&lt;/Notation&gt;。网关 v0.18 的 215 个测试，相当一部分场景来自这个项目的真实踩坑。&lt;/p&gt;
&lt;h1&gt;边界在哪里&lt;/h1&gt;
&lt;p&gt;诚实交代几条红线，想复用这套玩法的话要注意：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;只直连开发机&lt;/strong&gt;。Agent 写代码的能力以所配账号的完整权限开放，生产系统请走传输——这也是 zom_org 的包设计（&lt;code&gt;ZOM_ORG_TEST&lt;/code&gt; 测试层不随生产传输）和上线清单存在的原因&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;网关支持多系统和逐系统只读&lt;/strong&gt;：生产系统配 &lt;code&gt;read_only = true&lt;/code&gt;，Agent 只能查不能写&lt;/li&gt;
&lt;li&gt;暴露在非本机网络时务必开 &lt;code&gt;SAP_API_KEY&lt;/code&gt; 鉴权，最好再加按 IP 限流&lt;/li&gt;
&lt;li&gt;AI 写的 ABAP 依然是 ABAP——设计评审、传输纪律、消息号治理这些工程约束，不会因为写手变了就消失。我的做法是把它们写进项目文档和 &lt;code&gt;AGENTS.md&lt;/code&gt;，让 Agent 也被同一套规则约束&lt;/li&gt;
&lt;/ul&gt;
&lt;h1&gt;最后&lt;/h1&gt;
&lt;p&gt;SAP 圈子里有个老笑话：&amp;quot;SAP 什么都能做，但什么都不好做。&amp;quot; 做完这个项目我对它有新的理解：不好做的原因很大程度上是&lt;strong&gt;人被当成了系统集成总线&lt;/strong&gt;——在 GUI、文档、测试、dump 之间来回搬运信息。一旦这条总线换成 API，让 AI 直接挂上去，几十人天的活压缩到几天，并不是魔法，只是消除了搬运。&lt;/p&gt;
&lt;p&gt;sap-for-agents 的仓库我放在 GitHub 上：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;网关：&lt;a href=&quot;https://github.com/Jack-Liang/sap-for-agents&quot;&gt;https://github.com/Jack-Liang/sap-for-agents&lt;/a&gt; （Rust，MIT，预编译二进制下载即用）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;如果你也在折腾 SAP + AI，欢迎来聊聊。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】09 · 配置表泛滥怎么治理</title><link>https://jack-liang.com/blog/dev-first-principles-09-config-table-governance/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-09-config-table-governance/</guid><description>配置表不是建完就完，是要被找到的。接手项目时 SE11 一搜 Z* 躺出几十张配置表，建的人有的已经离职，没人说得清哪张是干嘛的。这篇讲一个动作：每张配置表登记造册。加五个治理做法和一份自查清单。</description><pubDate>Tue, 03 Nov 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：配置表不是建完就完，是要被找到的。&lt;/p&gt;
&lt;p&gt;有一次接手一个项目的维护。打开 SE11 一搜
Z*，几十张配置表躺在那里：ZCONFIG01、ZTEMP、Z_BATCH，还有两张名字差不多、没人说得出区别的。建表的人有的已经离职了。业务说&amp;quot;我之前改过一个字段，是在某张表里改的&amp;quot;——没人记得是哪张。这篇讲一个反直觉的判断：配置表泛滥本身是技术债。再加五个做法和一份自查清单。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、接手时的一堆&amp;quot;野表&amp;quot;&lt;/h2&gt;
&lt;p&gt;有一次接手一个项目的维护。&lt;/p&gt;
&lt;p&gt;打开 SE11 一搜
Z*，几十张配置表躺在那里：ZCONFIG01、ZTEMP、Z_BATCH、Z_TEST_001，还有 ZFI_CONFIG
和 ZFI_TBL_CFG
两张，名字差不多，问了一圈没人说得出区别。有几张表的建表人已经离职了。&lt;/p&gt;
&lt;p&gt;我想先找份清单看看系统里到底有哪些配置表、各自干嘛的。Confluence
翻了半天，找到几篇接口说明，没有配置表清单这种东西。&lt;/p&gt;
&lt;p&gt;去问业务。业务说：&amp;quot;我之前改过一个字段，是在某张表里改的。&amp;quot;哪张？不记得了。SE16N
一张一张打开看字段，像翻别人家的抽屉。&lt;/p&gt;
&lt;p&gt;这些表有个共同点：建的时候随手建，建完没人登记，没人维护，三个月后没人记得。我后来管它们叫&amp;quot;野表&amp;quot;。&lt;/p&gt;
&lt;p&gt;我以前觉得，建张配置表很容易，多建几张没什么。接手了这次才明白：每多一张表，就多一份要有人命名、有人登记、有人负责的东西。建的时候没人拦，找的时候没人找得到——问题都留给了后面的人。&lt;/p&gt;
&lt;h2&gt;二、建表五分钟，治理一辈子&lt;/h2&gt;
&lt;p&gt;SE11
里建一张表，五分钟，没有任何流程拦得住。但从那天起，这张表就需要：一个看得懂的名字、一句说清用途的话、一个负责人、一份维护说明，每次系统升级还得带着它迁移。&lt;/p&gt;
&lt;p&gt;野兔是&amp;quot;泛滥&amp;quot;最经典的教材：一百多年前有人放跑了二十来只，几十年里繁殖到几亿只，草原被啃秃，花了几十年治理都没根除。配置表的繁殖速度跟兔子没法比，但逻辑一样——每多一张，都永久加一分治理成本。&lt;/p&gt;
&lt;p&gt;N 张表就是 N 倍治理负担。负担不会消失，只会转移——从建表的人转移到接手的人。&lt;/p&gt;
&lt;p&gt;还有一个问题：表该建在哪。&amp;quot;这个大家都可能用，放 ZCOMMON
吧&amp;quot;——这话听着合理，其实判断标准错了。大家都用、但属于财务域，就该放
ZFI_COMMON；真正不属于任何业务域的，比如货币、日期这种，才进
ZCOMMON_BASE。判断标准是业务归属，不是用的人多不多。放错地方的表，和野表差不多。&lt;/p&gt;
&lt;p&gt;治理的关键动作只有一个：登记造册。建一张配置表目录表
ZTC_REGISTRY，每张配置表一行：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; ZTC_REGISTRY —— 配置表目录
TABNAME          &amp;quot; 配置表名，主键
PURPOSE          &amp;quot; 用途，一两句话，必填
OWNER            &amp;quot; 负责人，换人时更新
CREATED_ON       &amp;quot; 创建日期
RELATED_PROGRAMS &amp;quot; 关联程序
MAINT_GUIDE      &amp;quot; 什么场景该改、什么不能改
STATUS           &amp;quot; ACTIVE / OBSOLETE
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;两条硬规则：新建配置表当天登记，写进 Code Review 检查项；接手的人第一件事就是
SELECT 这张表，系统里有哪些配置表、归谁管，一次看清。&lt;/p&gt;
&lt;p&gt;这就是把配置表从个人记忆变成系统记忆。和
&lt;a href=&quot;/blog/dev-first-principles-03-single-source-of-truth/&quot;&gt;03 篇&lt;/a&gt;
是同一个思想：一个数据只能有一个源头——ZTC_REGISTRY
就是&amp;quot;系统里有哪些配置表&amp;quot;这个问题的源头。&lt;/p&gt;
&lt;p&gt;你可能觉得：建张表还要登记，太麻烦了。建的时候麻烦五分钟，和接手的时候翻三天，哪个划算不难算。&lt;/p&gt;
&lt;h2&gt;三、没建档的设备，坏了没人修&lt;/h2&gt;
&lt;p&gt;这事工厂里早就有答案。一台设备进厂，第一件事不是开机用，是建档：编号、名称、负责人、保养记录，全记在设备台账上。&lt;/p&gt;
&lt;p&gt;反过来，没建档的设备什么样？坏了没人修，因为不知道归谁管；搬迁丢了没人找，因为台账上根本没这东西；审计盘点时角落里翻出一台机器，谁也不知道是谁买的、还能不能用。&lt;/p&gt;
&lt;p&gt;配置表就是系统里的设备，ZTC_REGISTRY
就是设备台账。登记看着像多此一举，真到要改配置、要交接、要升级那天，查得到和查不到，就是有没有台账的区别。&lt;/p&gt;
&lt;h2&gt;四、五个做法&lt;/h2&gt;
&lt;p&gt;落到 ABAP，按使用频率排。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1. ZTC_ 命名空间&lt;/strong&gt;。所有配置表统一 ZTC_ 前缀，前缀后面带业务域：ZTC_FI_
财务、ZTC_MM_ 物料、ZTC_SD_ 销售。SE11 一搜 ZTC*
就能列出全部配置表，看名字就知道它归哪个域。相比之下，ZMYCONFIG、ZTEMP
这种名字，等于宣布&amp;quot;不想让人找到&amp;quot;。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2.
登记造册&lt;/strong&gt;。上一节说了，不再重复。补一句流程上的：登记表本身也要有人管，OWNER
换人时更新，不然登记表自己也会变成野表。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. Data Element 文档必填&lt;/strong&gt;。字段建了 Data Element，顺手把 DOCUMENTATION
写上，用户光标放字段上按 F1 就能看到说明。注释会过期，Data Element
不会。&lt;a href=&quot;/blog/dev-first-principles-08-magic-numbers/&quot;&gt;08 篇&lt;/a&gt;
的自查清单里提过这条，这里展开成做法。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;4. 新需求先查标准 Customizing&lt;/strong&gt;。S/4 里现成的配置表非常多：T001 公司代码、T005
国家、T009
财年变式。接到需求先查标准表里能不能配，确实没有再自建。反例也见过：标准表能配的东西，硬建一张
ZMY_COMPANY_CODE，三个月后自己也不认得这张表。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;5. 生命周期管理&lt;/strong&gt;。不再用的配置表，STATUS 改成
OBSOLETE，不删——物理删除可能砸到还在读它的程序。每季度过一遍
ZTC_REGISTRY，半年没人动的表拉出来问业务还要不要。&lt;/p&gt;
&lt;p&gt;再进一步，可以做张&amp;quot;表 →
程序&amp;quot;的反向清单：写个小工具扫程序源码里出现的表名，哪张表被哪些程序读，结构化的对照存下来。接手时输入表名，立刻看到谁在用它。这比全局
grep 强，grep 出来几百条里一大半是注释和无关命中。&lt;/p&gt;
&lt;p&gt;你可能想问：都说怕泛滥，那什么情况才配建表？&lt;a href=&quot;/blog/dev-first-principles-08-magic-numbers/&quot;&gt;08 篇&lt;/a&gt;
的分级还作数：永远不变的写
CONSTANTS，业务天天改的去接标准主数据，只有一年调一两次、业务想自己上 SM30
改的参数，才轮到配置表。配置表是稀缺品，不是垃圾桶。&lt;/p&gt;
&lt;p&gt;自查清单，Code Review 时过一遍：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;配置表统一 ZTC_ 前缀，前缀后带业务域&lt;/li&gt;
&lt;li&gt;新建配置表当天登记 ZTC_REGISTRY，OWNER 必填&lt;/li&gt;
&lt;li&gt;字段建了 Data Element，DOCUMENTATION 写了&lt;/li&gt;
&lt;li&gt;新需求先查标准 Customizing，没有再自建&lt;/li&gt;
&lt;li&gt;不用的表标记 OBSOLETE，不物理删除&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;反模式也说一句：ZTEMP、Z_TEST_001
这种名字，和建完不登记，是同一件事的两个侧面——从起名那一刻起，就没打算让第二个人找到它。&lt;/p&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;配置表不是建完就完，是要被找到的。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;泛滥的麻烦不在表的数量，在于没人说得清系统里到底有哪些表。治理的目标也不是少建表，是每张表都查得到、找得着人、说得清用途。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;/blog/dev-first-principles-08-magic-numbers/&quot;&gt;08 篇&lt;/a&gt;
把字面量收进常量，这篇把配置表收进登记册——干的是同一件事：让信息待在能被找到的地方。&lt;/p&gt;
&lt;p&gt;下一篇讲代码本身。配置表是数据层的&amp;quot;可被找到&amp;quot;，下一篇是代码层的：命名和结构组织好了，代码自己就是导航，不用先翻文档。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>拆开 SAP 没有文档的源码包：我写了 sap-tr-toolkit</title><link>https://jack-liang.com/blog/sap-tr-toolkit/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-tr-toolkit/</guid><description>我最近开源的一个 SAP 传输请求工具集：ABAP 程序 ZUD 负责把已释放的传输请求打包下载、上传导入；Python 解包器负责把 SE38 导出的 K/R 源码包还原成可读 ABAP。重点讲这个 SAP 未公开的源码包格式是怎么逆向出来的，以及过程中踩过的两个坑。</description><pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;SAP 项目做久了，总会遇到一些&amp;quot;代码出不了门&amp;quot;的时刻。&lt;/p&gt;
&lt;p&gt;沙盒系统没配传输路由、接手的外购系统只拿到一个导出包、想把某段代码发给同事参考，SE38 中一个个导出程序、复制表、结构更别提有多繁琐了。&lt;/p&gt;
&lt;p&gt;我最近从查了一些开源项目，把代码搬运这件事做成了一个工具集，开源在 GitHub 上，叫 &lt;strong&gt;sap-tr-toolkit&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;仓库地址：&lt;a href=&quot;https://github.com/Jack-Liang/sap-tr-toolkit&quot;&gt;https://github.com/Jack-Liang/sap-tr-toolkit&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;它包含两个组件：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;ZUD&lt;/strong&gt;（ABAP）：在 SAP 里把已释放的传输请求（Transport Request，TR）打成 ZIP 下载到本地，或者把 ZIP 上传回服务器并触发导入&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;sap_src_unpack.py&lt;/strong&gt;（Python）：把 SE38 导出的源码包解包成可读的 &lt;code&gt;.abap&lt;/code&gt; 文件&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;一个是 TR 整体搬运，一个是只有源码包时的还原，组合起来能覆盖大部分场景。&lt;/p&gt;
&lt;p&gt;&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot;&gt;这篇文重点不是&amp;quot;怎么用&amp;quot;，而是一起来看看 SAP 的请求文件是怎么逆向出来的&lt;/Notation&gt;——整个过程比写工具本身有意思得多。&lt;/p&gt;
&lt;h1&gt;先看效果&lt;/h1&gt;
&lt;p&gt;ZUD 是一个标准的 SE38 报表程序，安装就是新建程序、粘贴代码、激活。界面两个单选：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;下载&lt;/strong&gt;：填个 TR 号，选个文件夹，程序会把服务器上这个 TR 对应的 cofile / data 两个文件打包成 ZIP 保存到本地&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;上传&lt;/strong&gt;：选个 ZIP，程序把里面的 cofile / data 写回服务器的 &lt;code&gt;DIR_TRANS/cofiles&lt;/code&gt; 和 &lt;code&gt;data&lt;/code&gt; 目录，然后触发 STMS 导入&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;有了 ZIP，TR 就可以在没有传输路由的两个系统之间&amp;quot;人工快递&amp;quot;了。&lt;/p&gt;
&lt;p&gt;Python 侧更简单，无第三方依赖，Python 3.8+ 直接跑：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;# 解包并落盘（默认输出到 ./sap_src_&amp;lt;包名&amp;gt;/）
python sap_src_unpack.py &amp;lt;包.zip&amp;gt;

# 去掉 SAP 自动生成的横幅
python sap_src_unpack.py &amp;lt;包.zip&amp;gt; --no-banner

# 合并源码打到标准输出，管道给 grep / more
python sap_src_unpack.py &amp;lt;包.zip&amp;gt; --stdout | more
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;输出长这样：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;sap_src_&amp;lt;包名&amp;gt;/
├── ZDEMO_IF_SBSJ.abap       每个对象一个文件
├── ZDEMO_IF_SBSJ_2.abap     同名对象自动加 _2 后缀
├── LCL_DEMO.abap            类
├── ALL_SOURCES.abap         合并版，方便整体浏览 / grep
└── metadata.txt             时间戳、系统、导出人、对象清单
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;效果不错，但有意思的是中间发生了什么。&lt;/p&gt;
&lt;h1&gt;源码包里到底装了什么&lt;/h1&gt;
&lt;p&gt;从 SE38 用&amp;quot;程序下载&amp;quot;导出来的包，打开是一个 ZIP，里面两个文件：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;&amp;lt;请求号&amp;gt;.zip
├── K984699.&amp;lt;ext&amp;gt;    对象头：程序名、属性、时间戳、依赖
└── R984699.&amp;lt;ext&amp;gt;    对象体：文本头 + 一堆压缩数据
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;K / R 是德文 &lt;strong&gt;Kopf&lt;/strong&gt;（头）和 &lt;strong&gt;Rumpf&lt;/strong&gt;（体）。SAP 中进行请求传输传的就是这套容器格式打包的文件，这东西没有公开文档。&lt;/p&gt;
&lt;p&gt;拆开看，它是两层结构：外面一层压缩，里面一层记录。&lt;/p&gt;
&lt;h2&gt;压缩层：每块 8 字节头 + LZH&lt;/h2&gt;
&lt;p&gt;R 体的内容是一串压缩块，每块长这样：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;偏移:  0   1   2   3   4   5   6   7
      len(len32 LE)  alg  1f  9d  extra
                    ^^^^^^^ magic
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;算法是 &lt;strong&gt;LZH&lt;/strong&gt;（Lempel-Ziv + Huffman），跟 SAP MaxDB 数据库存数据用的是同一套压缩代码。每块解压后固定 16384 字节，末块可能不足。&lt;/p&gt;
&lt;p&gt;这个 LZH 实现的传承也很有意思：SAP MaxDB 的 C 代码 → 移植成 TypeScript（sapcomp）→ 再移植成 Python（pysapcompress）→ 我再拿过来用。链路虽长，但每一环都是开源的。&lt;/p&gt;
&lt;p&gt;这里有一个&lt;strong&gt;必须踩对的关键点&lt;/strong&gt;：块边界不能靠扫 magic（&lt;code&gt;1f 9d&lt;/code&gt;）来推进——压缩流里会偶然出现这两个字节，扫错一次整个包就解析不出来。正确做法是让解压器返回它&lt;strong&gt;精确消费了多少字节&lt;/strong&gt;（&lt;code&gt;reader.bytes_read&lt;/code&gt;），用这个数跳到下一块的起点。&lt;/p&gt;
&lt;h2&gt;记录层：4 字节头 + 三种 payload&lt;/h2&gt;
&lt;p&gt;压缩解开之后，是一串记录，每条记录 4 字节头加 payload：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;00 00 &amp;lt;len: u16be&amp;gt; &amp;lt;payload&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;len&lt;/code&gt; 是整条记录的长度（含 4 字节头）。payload 靠前 2 字节区分三种形态：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;标记&lt;/th&gt;
&lt;th&gt;含义&lt;/th&gt;
&lt;th&gt;内容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;0x2020&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;源码行&lt;/td&gt;
&lt;td&gt;UTF-16LE，固定 255 字符宽，补空格&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;0x2046&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;对象头&lt;/td&gt;
&lt;td&gt;&lt;code&gt;XSD$ IS &amp;lt;用户&amp;gt; &amp;lt;日期&amp;gt; &amp;lt;程序&amp;gt; ...&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;其它&lt;/td&gt;
&lt;td&gt;属性表&lt;/td&gt;
&lt;td&gt;ASCII，HATAB / SMODILOG 之类&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;其中 &lt;code&gt;0x2046&lt;/code&gt;（XSD$）记录很关键：&lt;Notation type=&quot;underline&quot; color=&quot;#ef4444&quot;&gt;它标志着一个代码块的开始&lt;/Notation&gt;，是切分源码区段的唯一可靠依据——源码永远出现在 XSD$ 头之后的连续区段里，头之前的 UTF-16 内容都是对象清单和元数据，不是代码。&lt;/p&gt;
&lt;p&gt;结构搞清楚之后，理论上就是&amp;quot;解压 → 按标记分流 → 还原文本&amp;quot;三板斧。但实际上，我在这里踩了两个印象深刻的坑。&lt;/p&gt;
&lt;h1&gt;第一个坑：ASCII 表格数据被当成 UTF-16&lt;/h1&gt;
&lt;p&gt;有些 &lt;code&gt;0x2020&lt;/code&gt; 开头的记录，其实不是源码，是 ASCII 属性表数据。按 UTF-16 硬解，就会得到一堆 CJK 乱码——因为 ASCII 字节对 &lt;code&gt;(A, &amp;#39; &amp;#39;)&lt;/code&gt; 在 UTF-16LE 里会被解释成一个汉字码位。&lt;/p&gt;
&lt;p&gt;怎么可靠地区分&amp;quot;真 UTF-16&amp;quot;和&amp;quot;假 UTF-16&amp;quot;？&lt;/p&gt;
&lt;p&gt;关键观察：这些源码行内容基本都是 ASCII 字符，而 UTF-16LE 里一个 ASCII 字符占两个字节，&lt;strong&gt;高位字节必然是 0&lt;/strong&gt;。所以真 UTF-16 数据的奇数位字节绝大多数应该是 0：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-python&quot;&gt;def _odd_zero_ratio(payload):
    body = payload[2:]
    odd = body[1::2]
    return sum(1 for b in odd if b == 0) / len(odd)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;拿真实样本验证：1111 条真 UTF-16、259 条 ASCII 冒充者，这个比例的分布把两者分得干干净净，阈值取 0.9 就行。&lt;/p&gt;
&lt;p&gt;&lt;Notation type=&quot;box&quot; color=&quot;#3b82f6&quot;&gt;这是逆向工程里很典型的一课：判据要从数据本身找，而不要想当然。&lt;/Notation&gt;格式文档里不会告诉你&amp;quot;有些记录撒谎了&amp;quot;，只有把真实数据摊开看，才能发现奇数位零字节这个特征。&lt;/p&gt;
&lt;h1&gt;第二个坑：OTHERS = 3. 被误杀&lt;/h1&gt;
&lt;p&gt;解包时还必须剔除导出包交错写入的对象清单行，比如：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;FUGRZDEMOGIF15_SW                           FUNCZDEMO_IF_SBRQ
ED1K984699          000002LIMUFUNCZDEMO_IF_SBSJ
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这些不是代码，混进 &lt;code&gt;.abap&lt;/code&gt; 文件会很碍眼。第一版我的判据很朴素：&lt;strong&gt;整行没有 ABAP 关键字的，就是元数据&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;跑完一看，&lt;code&gt;OTHERS = 3.&lt;/code&gt; 没了。&lt;/p&gt;
&lt;p&gt;这行是每个 ABAP 开发者都写过的东西——&lt;code&gt;CATCH cx_root INTO ... &lt;/code&gt; 后面的标准收尾。&lt;code&gt;OTHERS&lt;/code&gt; 确实是 ABAP 关键字，但它不在我那份关键字表里，于是这行代码被当成元数据删掉了。&lt;/p&gt;
&lt;p&gt;&lt;Notation type=&quot;highlight&quot; color=&quot;#fca5a5&quot;&gt;这是代码还原工具最致命的一类错误：静默丢代码。&lt;/Notation&gt;解出来少一行，你根本不会察觉。&lt;/p&gt;
&lt;p&gt;解法是反过来，改成&lt;strong&gt;白名单式&lt;/strong&gt;：只在同时满足两个条件时才判为元数据——&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;首个 token 命中&amp;quot;已知对象名&amp;quot;集合（这个集合从包里的清单行预先收集）&lt;/li&gt;
&lt;li&gt;且行形态是&amp;quot;大写名 + ≥5 个空格 + 字段&amp;quot;的表格样子&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;宁可漏判，绝不误杀。判据改完之后，对照手工解出的参照版本逐行 diff，代码零丢失。&lt;/p&gt;
&lt;h1&gt;不写死任何&amp;quot;令牌&amp;quot;&lt;/h1&gt;
&lt;p&gt;逆向过程中还有一个容易犯的错：把样本里看到的字面量写死进代码。&lt;/p&gt;
&lt;p&gt;这套格式里有大量随系统命名变化的东西——成员扩展名（实测见过 &lt;code&gt;.ED1&lt;/code&gt;、&lt;code&gt;.TD1&lt;/code&gt;，也可能没有后缀）、清单行和时间戳行的格式令牌（&lt;code&gt;ED1K984699&lt;/code&gt;、&lt;code&gt;TD1K984699&lt;/code&gt;……）。换一个系统，这些字面量全变。&lt;/p&gt;
&lt;p&gt;所以工具里所有的识别都基于&lt;strong&gt;形态&lt;/strong&gt;而不是字面量：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;zip 成员按 &lt;code&gt;K&amp;lt;数字&amp;gt;.*&lt;/code&gt; / &lt;code&gt;R&amp;lt;数字&amp;gt;.*&lt;/code&gt; 的命名形态找&lt;/li&gt;
&lt;li&gt;元数据行按「大写令牌 + K + 数字」的形态匹配&lt;/li&gt;
&lt;li&gt;时间戳行按「令牌 + 动作 + 14 位数字 + 系统 + 用户」的结构匹配&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;效果是：拿 40 个来自不同命名体系的真实包验证，全部直接解包成功，遇到新令牌的包不需要改代码。&lt;code&gt;--no-banner&lt;/code&gt; 模式下剔除约 3.2 万行 SAP 自动生成的伪影，真代码零丢失。&lt;/p&gt;
&lt;h1&gt;怎么确认它没丢代码&lt;/h1&gt;
&lt;p&gt;对这种&amp;quot;从二进制还原源码&amp;quot;的工具，验证比实现更重要。我用了三层：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;双向 diff&lt;/strong&gt;：解包结果和手工解出的参照版本逐行对比。有意思的是参照版反而有缺陷——它是按 &lt;code&gt;0x00&lt;/code&gt; 切分的，中文注释会被截断，而这个工具完整保留了中文注释和被注释掉的历史代码&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;关键逻辑抽查&lt;/strong&gt;：FORM、CALL FUNCTION、IF、DELETE ADJACENT DUPLICATES 这类语句逐项确认在位&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;自测&lt;/strong&gt;：&lt;code&gt;tests/&lt;/code&gt; 里有两套不依赖真实样本包的自测——LZH 压缩解压回环测试，和合成源码包的端到端解包测试，改完代码跑一遍就知道有没有退化&lt;/li&gt;
&lt;/ol&gt;
&lt;h1&gt;已知限制&lt;/h1&gt;
&lt;p&gt;诚实交代一下边界：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;只处理 K/R 体压缩包。&lt;/li&gt;
&lt;li&gt;更多 SAP 对象类型（独立 CLAS / INTF、&lt;code&gt;.prog.xml&lt;/code&gt; 等）还没覆盖，遇到新类型需要补充切分规则&lt;/li&gt;
&lt;li&gt;本仓库整体按 GPL-2.0 发布（因为 LZH 移植源码是 GPL 的）；ZUD 部分是 MIT 许可的第三方代码，来自 &lt;a href=&quot;https://github.com/furkancosgun/Transport-Management-Tool&quot;&gt;furkancosgun/Transport-Management-Tool&lt;/a&gt;，我只做了格式化加一处小改动&lt;/li&gt;
&lt;/ul&gt;
&lt;h1&gt;最后&lt;/h1&gt;
&lt;p&gt;这两个工具对我来说是&amp;quot;自己用得上就顺手开源&amp;quot;的典型：先是被一个打不开的导出包逼着去逆向格式，过程中发现 UTF-16 判别和元数据过滤这两个问题还挺有意思，解完顺手写成了工具，又顺手把 TR 搬运的 ZUD 一起收进来。&lt;/p&gt;
&lt;p&gt;如果你也经常在多个 SAP 系统之间搬代码，或者单纯对 SAP 的二进制格式好奇，欢迎试试：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;仓库：&lt;a href=&quot;https://github.com/Jack-Liang/sap-tr-toolkit&quot;&gt;https://github.com/Jack-Liang/sap-tr-toolkit&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;格式说明和坑的完整记录都在 README 里&lt;/li&gt;
&lt;li&gt;欢迎提 issue——尤其是遇到解不开的包，样本（脱敏后）对完善识别规则非常有帮助&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;致谢&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/furkancosgun/Transport-Management-Tool&quot;&gt;【furkancosgun/Transport-Management-Tool】&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/OWASP/pysap&quot;&gt;【pysap】&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】08 · 魔术数：你现在记得，未来的你不记得</title><link>https://jack-liang.com/blog/dev-first-principles-08-magic-numbers/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-08-magic-numbers/</guid><description>字面量是给现在的自己写的，常量是给未来的自己写的。写 IF status = &apos;01&apos; 时知道 01 是新建，三个月后就不一定了。这篇讲一个判断标准——这个值会变吗、多久一次、谁能改——加五个经典做法和一份自查清单。</description><pubDate>Tue, 27 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：魔术数 = 你现在记得，未来的你不记得。&lt;/p&gt;
&lt;p&gt;你有没有遇到这样的情况，业务部门通知：状态码改了，&amp;#39;01&amp;#39;
现在是驳回，新建改成&amp;#39;04&amp;#39;。我打开程序，满眼
01、02、ZPR——开发的人早跑了，也没人统计过它们散在哪些程序里。这篇讲一个判断标准：这个值会变吗、多久一次、谁能改。再加五个经典做法和一份自查清单。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、业务部门说：&amp;#39;01&amp;#39; 改成驳回了&lt;/h2&gt;
&lt;p&gt;有一次维护一个自开发报表。打开程序一看，满眼都是 &amp;#39;01&amp;#39;、&amp;#39;02&amp;#39;、&amp;#39;ZPR&amp;#39;、&amp;#39;ZSO&amp;#39;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;IF ls_order-status = &amp;#39;01&amp;#39;.
  &amp;quot;新建订单
ELSEIF ls_order-status = &amp;#39;02&amp;#39;.
  &amp;quot;已审核
ENDIF.

IF ls_order-doc_type = &amp;#39;ZPR&amp;#39;.
  &amp;quot;采购订单
ENDIF.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;写代码的时候知道 01 是新建、02 是已审核、ZPR
是采购。写代码的人三个月前早跑了。现在的我盯着
&amp;#39;01&amp;#39;，想不起来它是新建、已审核还是已驳回——只好去翻注释，注释还只写了前两行。&lt;/p&gt;
&lt;p&gt;真正的麻烦在后面。业务部门说：我们改了状态码，&amp;#39;01&amp;#39; 现在是驳回，新建改成 &amp;#39;04&amp;#39;。&lt;/p&gt;
&lt;p&gt;改就改吧。问题是这 01 散落在十几个程序里，没人统计过。我全局搜
&amp;#39;01&amp;#39;，出来几百条结果：状态码是 01，屏幕序号是 01，格式化出来的 01
也混在里面。只好逐个程序打开确认。改 5 处，改完心里一直打鼓：漏没漏？&lt;/p&gt;
&lt;h2&gt;二、这个值会变吗，多久一次，谁能改&lt;/h2&gt;
&lt;p&gt;魔术数问题表面是&amp;quot;该不该用常量&amp;quot;，往深一层问是三个问题：这个值会变吗？多久变一次？谁来改？&lt;/p&gt;
&lt;p&gt;按这三个问题分，值的命运就三种。&lt;/p&gt;
&lt;p&gt;永远不变的，写
CONSTANTS。状态码、文档类型这种，定义了就不动。偶尔调的——一年一两次，比如税率、审批阈值——放配置表，建
SM30
维护视图，让业务自己改。业务天天改的，别碰：那是客户、物料这类标准主数据，本来就有地方维护，自建表去接是重复造轮子。&lt;/p&gt;
&lt;p&gt;判断方法很朴素：业务说要改
X，问一句&amp;quot;这个你多久改一次&amp;quot;。一年一两次的，配置表；天天改的，主数据；说&amp;quot;这个永远不会变&amp;quot;的，CONSTANTS。&lt;/p&gt;
&lt;p&gt;你可能觉得：值反正不会变，直接写死省事，抽成常量不是多此一举？&lt;/p&gt;
&lt;p&gt;省事是真省事，但省的是现在的你的事，坑的是未来的你。&amp;#39;01&amp;#39;
直接写在判断里，是给现在的你写的——你此刻记得它什么意思。常量定义里的 01
才是给未来的你写的：三年后维护的人，如果还是你，点一下跳转，就能看到定义常量的地方，还有注释帮助理解。
改一处全改，再也不用到处去找。&lt;/p&gt;
&lt;p&gt;所以同一字面量出现第二次，我就抽常量。不为别的，就为未来那个一脸懵的自己少翻一次代码。&lt;/p&gt;
&lt;h2&gt;三、甲骨文没有释读表就是天书&lt;/h2&gt;
&lt;p&gt;这事不是代码独有的。考古学里有个词叫&amp;quot;释读&amp;quot;：出土的甲骨文刻的是什么、什么意思，几百年里学者一张一张做对照表，一个字一个字地认。没有这张对照表，甲骨文就是天书；有了它，三千年前的记账记录你今天读得懂。&lt;/p&gt;
&lt;p&gt;我们代码里的 &amp;#39;01&amp;#39;，就是那个甲骨文字符。常量定义、ENUM、配置表，就是释读表。&lt;/p&gt;
&lt;p&gt;别的语言一样：Java 的 static final、C# 的 enum、Go 的
iota。叫法不同，干的是同一件事——给裸值一个名字、一个归属、一个类型，让人不靠记忆也能读懂。&lt;/p&gt;
&lt;h2&gt;四、五个经典做法&lt;/h2&gt;
&lt;p&gt;落到 ABAP，按使用频率排。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;1. CONSTANTS
命名常量&lt;/strong&gt;。最基础的一个，命名是契约：lc_status_new，这样即便不写注释，也能通过字面命名猜个大概，不是
lc_01；用业务语言 lc_order_approved，不是技术缩写 lc_o_a。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CONSTANTS: lc_status_new      TYPE zstatus VALUE &amp;#39;01&amp;#39;,
           lc_status_approved TYPE zstatus VALUE &amp;#39;02&amp;#39;,
           lc_status_rejected TYPE zstatus VALUE &amp;#39;03&amp;#39;.

IF ls_order-status = lc_status_new.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;2. 集中存放&lt;/strong&gt;。抽到一个 Include 或常量类，全项目引用同一份定义。最怕的是程序 A
里 01 是新建、程序 B 里 02 是新建——各自定义，迟早不一致。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. Type-safe ENUM&lt;/strong&gt;。7.4 以上直接上：传错值编译就报错，还不用维护 VALUE。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;TYPES: BEGIN OF ENUM ty_order_status,
         new, approved, rejected, canceled,
       END OF ENUM ty_order_status.

DATA: lv_status TYPE ty_order_status.
lv_status = approved.               &amp;quot; 程序内直接用常量名

IF lv_status = approved.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;4. 配置表 + SM30&lt;/strong&gt;。前面说过，一年调一两次的业务参数走这条路，程序里 SELECT
SINGLE 按有效期读，S/4 自开发的标配。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;5. 命名空间&lt;/strong&gt;。配置表统一 ZTC_ 前缀，常量统一
lc_域名_含义。看名字能猜出含义，比注释可靠。&lt;/p&gt;
&lt;p&gt;你可能想问：业务常调的值，总不能每次都找我改代码吧？&lt;/p&gt;
&lt;p&gt;对，那就别用 CONSTANTS，用配置表。但顺序别搞反：先用
CONSTANTS，业务真来敲门了，再升级成配置表。一上来就建表，配置表会泛滥——那是下一篇的话题。&lt;/p&gt;
&lt;p&gt;自查清单，Code Review 时过一遍：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;同一字面量出现 ≥ 2 次，抽常量&lt;/li&gt;
&lt;li&gt;状态的合法集合，7.4+ 项目用 ENUM&lt;/li&gt;
&lt;li&gt;常量集中在一个 Include 或常量类，没有第二份定义&lt;/li&gt;
&lt;li&gt;业务可能调的值，走配置表 + SM30，不写死&lt;/li&gt;
&lt;li&gt;自开发表字段建了 Data Element，SE11 里看得到文档&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;反模式也说一句：注释里写&amp;quot;= 1 是新建&amp;quot;，或者用 lv_status = 1
这种变量冒充常量——都不如一个真常量。&lt;/p&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;字面量是给现在的自己写的，常量是给未来的自己写的。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;别指望未来的你记得今天写的东西——他不记得，这很正常。设计的时候就当他不记得来设计。&lt;/p&gt;
&lt;p&gt;这和
&lt;a href=&quot;/blog/dev-first-principles-03-single-source-of-truth/&quot;&gt;03 篇&lt;/a&gt;是同一个思想：一个数据只能有一个源头。字面量
01
的含义，源头就该是常量定义那一处，而不是散落在十几段代码和注释里的几百份拷贝。&lt;/p&gt;
&lt;p&gt;下一篇聊&lt;a href=&quot;/blog/dev-first-principles-09-config-table-governance&quot;&gt;配置表泛滥&lt;/a&gt;。魔术数治理是把字面量收进常量，配置表治理是把这些&amp;quot;信息源&amp;quot;本身管住——被埋起来的信息，怎么挖出来，怎么不越埋越多。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>AJSON：ABAP 里的&quot;柔性 JSON&quot;引擎</title><link>https://jack-liang.com/blog/ajson-implementation-and-usage/</link><guid isPermaLink="true">https://jack-liang.com/blog/ajson-implementation-and-usage/</guid><description>拆解 sbcgua/ajson 的实现原理与完整用法：如何复用 SAP 内置 sXML 的 JSON 模式完成解析，如何用「路径即主键」的扁平节点表做定位与序列化，以及路径寻址、映射过滤、ABAP 双向转换等核心用法与已知限制。</description><pubDate>Tue, 20 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;sbcgua/ajson&lt;/strong&gt; — 又一个 ABAP 的 JSON 解析/序列化器。支持 ABAP 7.02+，MIT
协议，通过 abapGit 安装。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;仓库：&lt;a href=&quot;https://github.com/sbcgua/ajson&quot;&gt;https://github.com/sbcgua/ajson&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;文档站：&lt;a href=&quot;https://sbcgua.github.io/ajson/docs/intro&quot;&gt;https://sbcgua.github.io/ajson/docs/intro&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;当前版本：v1.1.13（2025-09-19），master 分支含未发布特性&lt;/li&gt;
&lt;li&gt;前身：从
&lt;a href=&quot;https://github.com/abaplint/abaplint-abap-backend&quot;&gt;abaplint-abap-backend&lt;/a&gt;
早期版本 fork 而来&lt;/li&gt;
&lt;/ul&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、它想解决什么问题&lt;/h2&gt;
&lt;p&gt;在 ABAP 里处理 JSON，你通常只有两个选择：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;绑定固定结构&lt;/strong&gt; —— 为每个接口写一个 ABAP structure，用 &lt;code&gt;/ui2/convert_json&lt;/code&gt;
或 &lt;code&gt;/ui2/cl_json&lt;/code&gt; 转换。类型安全，但接口一改就得改
DDIC，嵌套深了还得递归写转换器。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;拼接字符串&lt;/strong&gt; —— &lt;code&gt;CONCATENATE&lt;/code&gt; 拼 JSON
字符串。灵活，但转义、嵌套、类型全靠手工，极易出错。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;AJSON 走的是&lt;strong&gt;第三条路&lt;/strong&gt;：把 JSON
解析成一棵&lt;strong&gt;扁平的节点表&lt;/strong&gt;（而不是对象树），既保留&amp;quot;动态&amp;quot;的特点，又能用路径做
O(log n) 定位，并且可以随时在&amp;quot;动态&amp;quot;和&amp;quot;固定结构&amp;quot;之间来回切换。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;固定结构 (to_abap)  ←→  节点表 (mt_json_tree)  ←→  JSON 字符串
   ↑ 按需转换              ↑ 核心表示              ↑ 解析 / 序列化
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;本文分两大部分：&lt;strong&gt;先讲实现原理&lt;/strong&gt;（它到底怎么做到的），&lt;strong&gt;再讲用法&lt;/strong&gt;（怎么用好它）。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;二、实现原理&lt;/h2&gt;
&lt;h3&gt;2.1 核心数据模型：一张扁平表，不是对象树&lt;/h3&gt;
&lt;p&gt;整个库的基石是 &lt;code&gt;zif_ajson_types&lt;/code&gt;
里的两个类型（&lt;code&gt;src/core/zif_ajson_types.intf.abap&lt;/code&gt;）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;types:
  begin of ty_node,
    path     type string,        &amp;quot; 父节点的完整路径，如 &amp;#39;/a/b/&amp;#39;
    name     type string,        &amp;quot; 本节点名（对象成员名 / 数组下标）
    type     type ty_node_type,  &amp;quot; &amp;#39;str&amp;#39; &amp;#39;num&amp;#39; &amp;#39;bool&amp;#39; &amp;#39;null&amp;#39; &amp;#39;array&amp;#39; &amp;#39;object&amp;#39;
    value    type string,        &amp;quot; 叶子节点的文本值
    index    type i,             &amp;quot; 数组下标
    order    type i,             &amp;quot; 插入顺序（keep_item_order 模式）
    children type i,             &amp;quot; 直接子节点个数
  end of ty_node.

types:
  ty_nodes_ts type sorted table of ty_node
    with unique key path name                       &amp;quot; 主键
    with non-unique sorted key array_index components path index
    with non-unique sorted key item_order  components path order.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;关键设计在于&lt;strong&gt;路径即主键&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;节点的 &lt;code&gt;path&lt;/code&gt; 是父节点路径，&lt;code&gt;name&lt;/code&gt; 是自己名字，&lt;strong&gt;两者联合构成全局唯一主键&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;于是&amp;quot;取 &lt;code&gt;/a/b/c&lt;/code&gt;&amp;quot;这件事，退化成对排序表做一次 &lt;code&gt;READ TABLE ... WITH TABLE KEY&lt;/code&gt;
的二分查找，而不是沿对象引用逐层下钻。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;children&lt;/code&gt; 字段缓存了子节点数量，让序列化时不必重新扫描。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;路径的规范化&lt;/strong&gt;由 &lt;code&gt;lcl_utils&lt;/code&gt; 完成（&lt;code&gt;zcl_ajson.clas.locals_imp.abap:187&lt;/code&gt; 起）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;normalize_path( &amp;#39;/a/b&amp;#39; )  →  &amp;#39;/a/b/&amp;#39;      &amp;quot; 补齐前导和尾部斜杠
split_path( &amp;#39;/a/b/c&amp;#39; )    →  path = &amp;#39;/a/b/&amp;#39;, name = &amp;#39;c&amp;#39;
split_path( &amp;#39;/&amp;#39; )         →  path = &amp;#39;&amp;#39;, name = &amp;#39;&amp;#39;    &amp;quot; 根节点
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;也就是说，&lt;strong&gt;树里存储的路径一律带尾部斜杠&lt;/strong&gt;（&lt;code&gt;/a/b/&lt;/code&gt;），根节点是空路径 +
空名字。这条约定贯穿了读写两端：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;场景&lt;/th&gt;
&lt;th&gt;节点在表里的样子&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;根对象&lt;/td&gt;
&lt;td&gt;&lt;code&gt;path = &amp;#39;&amp;#39;&lt;/code&gt;, &lt;code&gt;name = &amp;#39;&amp;#39;&lt;/code&gt;, &lt;code&gt;type = &amp;#39;object&amp;#39;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;根的对象成员 &lt;code&gt;a&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;path = &amp;#39;/&amp;#39;&lt;/code&gt;, &lt;code&gt;name = &amp;#39;a&amp;#39;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;a&lt;/code&gt; 的成员 &lt;code&gt;b&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;path = &amp;#39;/a/&amp;#39;&lt;/code&gt;, &lt;code&gt;name = &amp;#39;b&amp;#39;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;数组 &lt;code&gt;tab&lt;/code&gt; 的第 2 项&lt;/td&gt;
&lt;td&gt;&lt;code&gt;path = &amp;#39;/tab/&amp;#39;&lt;/code&gt;, &lt;code&gt;name = &amp;#39;2&amp;#39;&lt;/code&gt;, &lt;code&gt;index = 2&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;路径中含斜杠怎么办？&lt;/strong&gt; JSON 键里出现 &lt;code&gt;/&lt;/code&gt;（比如
&lt;code&gt;{&amp;quot;a/b/c&amp;quot;: 10}&lt;/code&gt;）会破坏路径语义。库的做法是&lt;strong&gt;转义成 Tab 符&lt;/strong&gt;：解析时把名字中的
&lt;code&gt;/&lt;/code&gt; 替换成
&lt;code&gt;cl_abap_char_utilities=&amp;gt;horizontal_tab&lt;/code&gt;，拆分路径时再还原（&lt;code&gt;zcl_ajson.clas.locals_imp.abap:226&lt;/code&gt;）。所以访问时要写：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;r-&amp;gt;get( |/a\tb\tc| ).    &amp;quot; 注意是制表符，不是反斜杠
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;2.2 解析：不写词法分析器，直接复用 SAP 内置的 SXML JSON 模式&lt;/h3&gt;
&lt;p&gt;这是 AJSON 最巧妙、也最值得 knowing 的一点。&lt;/p&gt;
&lt;p&gt;大多数人以为 JSON 解析器需要手写状态机。但 AJSON 的 &lt;code&gt;lcl_json_parser&lt;/code&gt; 只做了
&lt;strong&gt;200 行&lt;/strong&gt;的胶水代码，真正的词法/语法分析交给了 SAP 标准库的
&lt;code&gt;CL_SXML_STRING_READER&lt;/code&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; src/core/zcl_ajson.clas.locals_imp.abap:447
lo_reader = cl_sxml_string_reader=&amp;gt;create( iv_json ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;关键在于 &lt;strong&gt;SAP 的 sXML Library 原生支持 JSON
格式&lt;/strong&gt;（&lt;code&gt;IF_SXML=&amp;gt;CO_XT_JSON&lt;/code&gt;）。官方文档明确写着：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;The format JSON in sXML Library means that an XML writer of this format
transforms valid JSON-XML data to JSON data and &lt;strong&gt;an XML reader detects JSON
data and parses it as if it were JSON-XML data&lt;/strong&gt;.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;读取器会自动识别输入格式。JSON 数据被解析成 SAP 特有的 &lt;strong&gt;JSON-XML&lt;/strong&gt;
中间表示，映射规则是：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;JSON&lt;/th&gt;
&lt;th&gt;JSON-XML&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;&amp;quot;text&amp;quot;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;str&amp;gt;text&amp;lt;/str&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;123&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;num&amp;gt;123&amp;lt;/num&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;true&lt;/code&gt; / &lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;bool&amp;gt;true&amp;lt;/bool&amp;gt;&lt;/code&gt; / &lt;code&gt;&amp;lt;bool&amp;gt;false&amp;lt;/bool&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;null&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;null /&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;[...]&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;array&amp;gt;...&amp;lt;/array&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;{...}&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;object&amp;gt;...&amp;lt;/object&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;{&amp;quot;n&amp;quot;: v}&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;... name=&amp;quot;n&amp;quot;&amp;gt;...&amp;lt;/...&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;于是 AJSON 的遍历代码就能这样写（&lt;code&gt;zcl_ajson.clas.locals_imp.abap:467&lt;/code&gt;）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;lt;item&amp;gt;-type = lo_open-&amp;gt;qname-name.        &amp;quot; &amp;#39;object&amp;#39; / &amp;#39;array&amp;#39; / &amp;#39;str&amp;#39; / &amp;#39;num&amp;#39; / &amp;#39;bool&amp;#39; / &amp;#39;null&amp;#39;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;节点类型直接来自 XML 元素名&lt;/strong&gt;，和 &lt;code&gt;zif_ajson_types=&amp;gt;node_type&lt;/code&gt;
的常量一一对应。再看名字的处理：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;if lr_stack_top-&amp;gt;type = `array`.  &amp;quot; 这是 parser 类型不是 ajson 类型
  &amp;lt;item&amp;gt;-name = |{ lr_stack_top-&amp;gt;children }|.     &amp;quot; 数组元素：没有名字，用序号
  &amp;lt;item&amp;gt;-index = lr_stack_top-&amp;gt;children.
else.
  lt_attributes = lo_open-&amp;gt;get_attributes( ).
  read table lt_attributes into lo_attr index 1.
  assert sy-subrc = 0 and lo_attr-&amp;gt;qname-name = &amp;#39;name&amp;#39;.   &amp;quot; 对象成员：name 属性
  &amp;lt;item&amp;gt;-name = lo_attr-&amp;gt;get_value( ).
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这正好对应 JSON-XML 的规定：&lt;strong&gt;数组分量没有名字，所以没有 &lt;code&gt;name&lt;/code&gt;
属性；对象分量的名字放在 &lt;code&gt;name&lt;/code&gt; 属性里&lt;/strong&gt;。AJSON
用一个栈（&lt;code&gt;mt_stack&lt;/code&gt;）做深度优先遍历，遇到开标签压栈、闭标签出栈，同时维护
&lt;code&gt;mv_stack_path&lt;/code&gt; 累加当前路径。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;这个设计的收益&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;不必自己写 JSON 词法分析器，避开了转义、Unicode、数字格式的一大堆坑。&lt;/li&gt;
&lt;li&gt;解析错误由 SAP 抛出 &lt;code&gt;CX_SXML_PARSE_ERROR&lt;/code&gt;，库里还贴心地换算成了行列位置：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;catch cx_sxml_parse_error into lx_sxml_parse.
  lv_location = _get_location( iv_json = ... iv_offset = lx_sxml_parse-&amp;gt;xml_offset ).
  zcx_ajson_error=&amp;gt;raise( iv_msg = |Json parsing error (SXML): { lx_sxml_parse-&amp;gt;get_text( ) }|
                          iv_location = lv_location ).
&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;附带一点额外能力：SXML 会自动把 &lt;code&gt;&amp;amp;lt;&lt;/code&gt; &lt;code&gt;&amp;amp;gt;&lt;/code&gt; &lt;code&gt;&amp;amp;amp;&lt;/code&gt;
等实体还原，所以字符串里的 HTML 片段不会出问题。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;代价&lt;/strong&gt;也很实在：SXML 是&lt;strong&gt;严格校验器&lt;/strong&gt;，JSON 里若有 SXML
不接受的形式会直接报错；同时性能受限于 SAP 的 XML 解析器（相比专用 JSON
库偏慢）。库的做法是在解析前加一道&lt;strong&gt;廉价的前置校验&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; zcl_ajson.clas.locals_imp.abap:303
&amp;quot; 一个完整的顶层检查太慢，这里只检查开头
find regex &amp;#39;^\s*(true|false|null|-?\d|&amp;quot;|\{|\[)&amp;#39; in iv_data ##REGEX_POSIX.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;2.3 序列化：从节点表重建 JSON&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;lcl_json_serializer&lt;/code&gt; 是递归的，逻辑很直接：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;method stringify_node.
  &amp;quot; 1. 拼前缀：缩进 + &amp;quot;name&amp;quot;:
  &amp;quot; 2. 按类型输出：array → &amp;#39;[&amp;#39;，object → &amp;#39;{&amp;#39;，str → 转义后的字符串，num/bool → 原样，null → &amp;#39;null&amp;#39;
  &amp;quot; 3. 如果是容器，递归处理子节点
  &amp;quot; 4. 输出收尾 &amp;#39;]&amp;#39; / &amp;#39;}&amp;#39;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;最需要留意的是子节点遍历顺序&lt;/strong&gt;，它由 &lt;code&gt;stringify_set&lt;/code&gt;
决定（&lt;code&gt;zcl_ajson.clas.locals_imp.abap:748&lt;/code&gt;）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;if iv_array = abap_true.
  lv_tab_key = &amp;#39;array_index&amp;#39;.      &amp;quot; path + index → 数组按序号
elseif mv_keep_item_order = abap_true.
  lv_tab_key = &amp;#39;item_order&amp;#39;.       &amp;quot; path + order  → 按插入顺序
else.
  lv_tab_key = &amp;#39;primary_key&amp;#39;.      &amp;quot; path + name   → 按名字
endif.

loop at mt_json_tree assigning &amp;lt;n&amp;gt; using key (lv_tab_key) where path = iv_parent_path.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这解释了一个容易被忽略的行为：&lt;strong&gt;默认情况下，对象成员输出是按 key
字母序排列的&lt;/strong&gt;，因为主键 &lt;code&gt;path + name&lt;/code&gt; 是排序表的排序依据。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;zcl_ajson=&amp;gt;parse( &amp;#39;{&amp;quot;zulu&amp;quot;:&amp;quot;z&amp;quot;,&amp;quot;alpha&amp;quot;:&amp;quot;a&amp;quot;,&amp;quot;beta&amp;quot;:&amp;quot;b&amp;quot;}&amp;#39; )-&amp;gt;stringify( ).
&amp;quot; → {&amp;quot;alpha&amp;quot;:&amp;quot;a&amp;quot;,&amp;quot;beta&amp;quot;:&amp;quot;b&amp;quot;,&amp;quot;zulu&amp;quot;:&amp;quot;z&amp;quot;}    字母序，不是原文顺序！
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;想保留原文/插入顺序，要显式打开 &lt;code&gt;keep_item_order&lt;/code&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;zcl_ajson=&amp;gt;parse( iv_json = &amp;#39;{&amp;quot;b&amp;quot;:1,&amp;quot;a&amp;quot;:2}&amp;#39; iv_keep_item_order = abap_true )-&amp;gt;stringify( ).
&amp;quot; → {&amp;quot;b&amp;quot;:1,&amp;quot;a&amp;quot;:2}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;（注意 &lt;code&gt;keep_item_order&lt;/code&gt; 必须在 &lt;code&gt;set&lt;/code&gt; 之前调用，或在构造时传参——它决定了 &lt;code&gt;order&lt;/code&gt;
字段是否被维护。）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;字符串转义&lt;/strong&gt;由 &lt;code&gt;escape_string&lt;/code&gt; 负责，分两步：先处理 &lt;code&gt;\&lt;/code&gt;、&lt;code&gt;&amp;quot;&lt;/code&gt; 和换行；再处理
U+0000–U+001F 的其余控制字符，转成 &lt;code&gt;\u00XX&lt;/code&gt;。控制字符表在 &lt;code&gt;class_constructor&lt;/code&gt;
里预先构造好，运行时只做 &lt;code&gt;replace&lt;/code&gt;，是个不错的性能细节。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;顺带一提：&lt;code&gt;v1.?.?&lt;/code&gt; 未发布分支里有一条 &amp;quot;Escape all control characters in
strings, not only tab, CR and LF (#228)&amp;quot;——从 v1.1.13
起控制字符转义才是完整的。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;2.4 双向转换：ABAP ↔ JSON&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;ABAP → JSON&lt;/strong&gt;（&lt;code&gt;lcl_abap_to_json&lt;/code&gt;）靠 &lt;code&gt;CL_ABAP_TYPEDESCR&lt;/code&gt; 反射，按 &lt;code&gt;kind&lt;/code&gt;
分派：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;case io_type-&amp;gt;kind.
  when cl_abap_typedescr=&amp;gt;kind_elem.   &amp;quot; 单个值
    convert_value( ... ).
  when cl_abap_typedescr=&amp;gt;kind_struct.  &amp;quot; 结构
    convert_struc( ... ).
  when cl_abap_typedescr=&amp;gt;kind_table.   &amp;quot; 表
    convert_table( ... ).
  when others.
    &amp;quot; 数据引用 → null；ajson 实例 → 内联子树
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这意味着&lt;strong&gt;任意深度的 ABAP 结构 / 表 / 表的表都能直接 &lt;code&gt;set&lt;/code&gt;
进去&lt;/strong&gt;，不需要手写转换。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;JSON →
ABAP&lt;/strong&gt;（&lt;code&gt;lcl_json_to_abap&lt;/code&gt;）则按目标字段类型逐个赋值，特殊处理日期时间：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;JSON&lt;/th&gt;
&lt;th&gt;ABAP&lt;/th&gt;
&lt;th&gt;期望格式&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;str&lt;/td&gt;
&lt;td&gt;&lt;code&gt;d&lt;/code&gt; (date)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;YYYY-MM-DD&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;str&lt;/td&gt;
&lt;td&gt;&lt;code&gt;t&lt;/code&gt; (time)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;HH:MM:SS&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;str&lt;/td&gt;
&lt;td&gt;&lt;code&gt;p 15,0&lt;/code&gt; (timestamp)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;YYYY-MM-DDTHH:MM:SSZ&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;str&lt;/td&gt;
&lt;td&gt;&lt;code&gt;p 21,7&lt;/code&gt; (timestampl)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;YYYY-MM-DDTHH:MM:SS.FFFFFFFZ&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;str&lt;/td&gt;
&lt;td&gt;&lt;code&gt;utclong&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;同上&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;bool&lt;/td&gt;
&lt;td&gt;&lt;code&gt;abap_bool&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;true&lt;/code&gt; / &lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;null&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;td&gt;忽略&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;object&lt;/td&gt;
&lt;td&gt;structure&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;array&lt;/td&gt;
&lt;td&gt;table&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;其余类型走 &lt;strong&gt;ABAP 标准转换规则&lt;/strong&gt;，所以要留意 &lt;code&gt;CX_SY_CONVERSION_ERROR&lt;/code&gt;
以及&amp;quot;目标字段比源值短时静默截断&amp;quot;这两个坑。&lt;/p&gt;
&lt;h3&gt;2.5 管道式处理：filter / map / clone&lt;/h3&gt;
&lt;p&gt;三个&amp;quot;变换&amp;quot;方法都返回&lt;strong&gt;新的实例&lt;/strong&gt;，不修改原对象：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;lo_new = lo_orig-&amp;gt;clone( ).
lo_new = lo_orig-&amp;gt;filter( ii_filter ).
lo_new = lo_orig-&amp;gt;map( ii_mapper ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;Filter&lt;/strong&gt; 只需实现一个方法：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;interface zif_ajson_filter.
  types ty_visit_type type i.
  constants:
    begin of visit_type,
      value type ty_visit_type value 0,   &amp;quot; 叶子节点
      open  type ty_visit_type value 1,   &amp;quot; 进入容器
      close type ty_visit_type value 2,   &amp;quot; 离开容器
    end of visit_type.

  methods keep_node
    importing is_node type zif_ajson_types=&amp;gt;ty_node
              iv_visit type ty_visit_type default visit_type-value
    returning value(rv_keep) type abap_bool.
endinterface.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;容器的 open/close
会被调用两次，这让你能比较&amp;quot;过滤前后的子节点数&amp;quot;，从而实现&amp;quot;空对象整体丢弃&amp;quot;这类逻辑。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Mapper&lt;/strong&gt; 在 v1.2.0 之后简化成了一个改名方法：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;methods rename_node
  importing !is_node type zif_ajson_types=&amp;gt;ty_node
  changing  !cv_name type zif_ajson_types=&amp;gt;ty_node-name.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;内建的 &lt;code&gt;zcl_ajson_mapping&lt;/code&gt; 提供了大小写转换、camel↔snake
互转、按名/按全路径/按模式重命名，以及&amp;quot;复合映射器&amp;quot;（多个 mapper 依次生效）。&lt;/p&gt;
&lt;h3&gt;2.6 设计取舍与已知限制&lt;/h3&gt;
&lt;p&gt;这些是从源码和官方文档里能确认的真实边界，值得在选型时知道：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;事项&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;slice&lt;/code&gt; 会复制整棵子树&lt;/td&gt;
&lt;td&gt;文档里明确提示：&amp;quot;slice creates a copy of the JSON tree, and so increases memory consumption&amp;quot;。源码里也有 TODO 说想做&amp;quot;引用共享&amp;quot;的只读模式&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;删除数组中间项不重排&lt;/td&gt;
&lt;td&gt;官方文档 &amp;quot;Known issues&amp;quot;：&lt;code&gt;removing an array item in the middle of array will not renumber the items&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;set&lt;/code&gt; 默认忽略空值&lt;/td&gt;
&lt;td&gt;&lt;code&gt;iv_ignore_empty&lt;/code&gt; 默认 &lt;code&gt;abap_true&lt;/code&gt;，&lt;code&gt;0&lt;/code&gt; / &lt;code&gt;&amp;#39;&amp;#39;&lt;/code&gt; / &lt;code&gt;abap_false&lt;/code&gt; 会被静默丢弃；所有 typed setter（&lt;code&gt;set_string&lt;/code&gt; / &lt;code&gt;set_integer&lt;/code&gt; / &lt;code&gt;set_boolean&lt;/code&gt; / &lt;code&gt;set_date&lt;/code&gt; …）则强制 &lt;code&gt;iv_ignore_empty = abap_false&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;set&lt;/code&gt; 会&lt;strong&gt;整枝覆盖&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;给 &lt;code&gt;/a/b&lt;/code&gt; 赋值会先删掉 &lt;code&gt;/a/b&lt;/code&gt; 及其整棵子树，再写入新值&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;路径中的 &lt;code&gt;/&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;必须转义成 Tab 符&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;顶层是标量或数组&lt;/td&gt;
&lt;td&gt;库以&amp;quot;根节点&amp;quot;为中心设计，&lt;code&gt;to_abap&lt;/code&gt; / &lt;code&gt;slice&lt;/code&gt; 等都假定根是对象&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;create_empty&lt;/code&gt; / &lt;code&gt;create_from&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;官方标注&amp;quot;可能被废弃&amp;quot;，推荐用 &lt;code&gt;new&lt;/code&gt; / &lt;code&gt;clone&lt;/code&gt; / &lt;code&gt;filter&lt;/code&gt; / &lt;code&gt;map&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2&gt;三、用法&lt;/h2&gt;
&lt;h3&gt;3.1 安装&lt;/h3&gt;
&lt;p&gt;用 abapGit 克隆到目标包：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;https://github.com/sbcgua/ajson.git
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;官方文档的 Installation 页给了详细步骤（包括离线安装包）。安装后主要对象：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;对象&lt;/th&gt;
&lt;th&gt;作用&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;zcl_ajson&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;主类，实现 &lt;code&gt;zif_ajson&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;zif_ajson&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;主接口&lt;/strong&gt;——所有功能方法都在这里&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;zcl_ajson_mapping&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;内建映射器（camel/snake/大小写/重命名）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;zcl_ajson_filter_lib&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;内建过滤器（空值/路径/复合）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;zcl_ajson_utilities&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;工具类（diff/sort/is_equal/merge/迭代器）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;zcx_ajson_error&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;异常类&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;约定&lt;/strong&gt;：功能方法都定义在 &lt;code&gt;zif_ajson&lt;/code&gt; 接口上；&lt;code&gt;zcl_ajson&lt;/code&gt; 上虽然有同名
alias，但官方提示&amp;quot;请勿直接使用，将来可能被废弃&amp;quot;。&lt;strong&gt;面向接口编程&lt;/strong&gt;是这里的正确姿势。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;3.2 上手 60 秒&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;data r type ref to zif_ajson.
data fragment type ref to zif_ajson.

r = zcl_ajson=&amp;gt;parse( &amp;#39;{&amp;quot;success&amp;quot;: 1, &amp;quot;error&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;payload&amp;quot;: {&amp;quot;text&amp;quot;: &amp;quot;hello&amp;quot;}}&amp;#39; ).

r-&amp;gt;get( &amp;#39;/success&amp;#39; ).              &amp;quot; &amp;quot;1&amp;quot;   —— 一律是字符串
r-&amp;gt;get_integer( &amp;#39;/success&amp;#39; ).      &amp;quot; 1     —— 数字
r-&amp;gt;get_boolean( &amp;#39;/success&amp;#39; ).      &amp;quot; &amp;quot;X&amp;quot;   —— 非空即真
r-&amp;gt;get( &amp;#39;/payload/text&amp;#39; ).         &amp;quot; &amp;quot;hello&amp;quot;

r-&amp;gt;members( &amp;#39;/&amp;#39; ).                 &amp;quot; 表：success, error, payload

fragment = r-&amp;gt;slice( &amp;#39;/payload&amp;#39; ).
fragment-&amp;gt;get( &amp;#39;/text&amp;#39; ).          &amp;quot; &amp;quot;hello&amp;quot;（根变成了 payload）
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3.3 读取&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 存在性与空值
r-&amp;gt;is_empty( ).                     &amp;quot; abap_false
r-&amp;gt;exists( &amp;#39;/success&amp;#39; ).            &amp;quot; abap_true

&amp;quot; 节点类型（str / num / bool / null / object / array）
r-&amp;gt;get_node_type( &amp;#39;/payload/text&amp;#39; ). &amp;quot; &amp;quot;str&amp;quot;

&amp;quot; 强类型读取
r-&amp;gt;get_string( &amp;#39;/payload/null&amp;#39; ).   &amp;quot; &amp;quot;&amp;quot;      —— null 读出来是空串
r-&amp;gt;get_date( &amp;#39;/payload/date&amp;#39; ).     &amp;quot; 20200728（type d）
r-&amp;gt;get_number( &amp;#39;/payload/num&amp;#39; ).    &amp;quot; 123.0（type f）
r-&amp;gt;get_timestamp( &amp;#39;/payload/ts&amp;#39; ).  &amp;quot; type timestamp
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;数组按 1 起始的序号寻址&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;r-&amp;gt;get( &amp;#39;/tab/2/val&amp;#39; ).   &amp;quot; {&amp;quot;tab&amp;quot;: [ {...}, {&amp;quot;val&amp;quot;: &amp;quot;this value !&amp;quot;} ]}
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;code&gt;get()&lt;/code&gt; 永远返回 &lt;code&gt;string&lt;/code&gt;。类型转换是显式的（&lt;code&gt;get_integer&lt;/code&gt; / &lt;code&gt;get_number&lt;/code&gt; /
&lt;code&gt;get_date&lt;/code&gt; / &lt;code&gt;get_boolean&lt;/code&gt;），这比&amp;quot;隐式猜测&amp;quot;更安全。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;3.4 写入&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;data w type ref to zif_ajson.
w = zcl_ajson=&amp;gt;new( ).

&amp;quot; 中间路径自动创建，值类型自动识别
w-&amp;gt;set( iv_path = &amp;#39;/a/b/num&amp;#39; iv_val = 123 ).      &amp;quot; {&amp;quot;a&amp;quot;:{&amp;quot;b&amp;quot;:{&amp;quot;num&amp;quot;:123}}}
w-&amp;gt;set( iv_path = &amp;#39;/a/b/str&amp;#39; iv_val = &amp;#39;hello&amp;#39; ).
w-&amp;gt;set( iv_path = &amp;#39;/a/b/bool&amp;#39; iv_val = abap_true ).

&amp;quot; 转义自动处理
w-&amp;gt;set( iv_path = &amp;#39;/a/b/str&amp;#39; iv_val = &amp;#39;escaping&amp;quot;\&amp;#39; ).   &amp;quot; → &amp;quot;escaping\&amp;quot;\\&amp;quot;

&amp;quot; 空值默认被忽略！
w-&amp;gt;set( iv_path = &amp;#39;/a&amp;#39; iv_val = 0 ).                 &amp;quot; 什么都没发生
w-&amp;gt;set( iv_path = &amp;#39;/a&amp;#39; iv_val = 0 iv_ignore_empty = abap_false ).  &amp;quot; {&amp;quot;a&amp;quot;:0}

&amp;quot; 显式指定类型
w-&amp;gt;set( iv_path = &amp;#39;/a&amp;#39; iv_val = &amp;#39;0&amp;#39; iv_node_type = &amp;#39;num&amp;#39; ).   &amp;quot; {&amp;quot;a&amp;quot;:0}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;Typed setter 的关键差异&lt;/strong&gt;：它们&lt;strong&gt;永不忽略空值&lt;/strong&gt;，所以语义更确定。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;w-&amp;gt;set_boolean( iv_path = &amp;#39;/a&amp;#39; iv_val = 0 ).     &amp;quot; false（不是被丢弃）
w-&amp;gt;set_integer( iv_path = &amp;#39;/a&amp;#39; iv_val = 0 ).     &amp;quot; 0
w-&amp;gt;set_string ( iv_path = &amp;#39;/a&amp;#39; iv_val = &amp;#39;&amp;#39; ).    &amp;quot; &amp;quot;&amp;quot;
w-&amp;gt;set_date   ( iv_path = &amp;#39;/a&amp;#39; iv_val = sy-datum ).   &amp;quot; &amp;quot;2020-07-05&amp;quot;
w-&amp;gt;set_timestamp( iv_path = &amp;#39;/a&amp;#39; iv_val = lv_ts ).    &amp;quot; &amp;quot;2021-05-05T12:00:00Z&amp;quot;
w-&amp;gt;set_null   ( iv_path = &amp;#39;/a&amp;#39; ).                 &amp;quot; null
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;&lt;code&gt;setx&lt;/code&gt; —— 文本式赋值&lt;/strong&gt;，适合写常量和单元测试：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;j-&amp;gt;setx( &amp;#39;/a: 1&amp;#39; ).          &amp;quot; {&amp;quot;a&amp;quot;:1}
j-&amp;gt;setx( &amp;#39;/a: 1.123&amp;#39; ).      &amp;quot; {&amp;quot;a&amp;quot;:1.123}
j-&amp;gt;setx( &amp;#39;/a: &amp;quot;123&amp;quot;&amp;#39; ).      &amp;quot; {&amp;quot;a&amp;quot;:&amp;quot;123&amp;quot;}   引号强制字符串
j-&amp;gt;setx( &amp;#39;/a: null&amp;#39; ).       &amp;quot; {&amp;quot;a&amp;quot;:null}
j-&amp;gt;setx( &amp;#39;/a: true&amp;#39; ).       &amp;quot; {&amp;quot;a&amp;quot;:true}
j-&amp;gt;setx( &amp;#39;/a/b/c: 1&amp;#39; ).      &amp;quot; 深路径
j-&amp;gt;setx( &amp;#39;/a: [1,2,3]&amp;#39; ).    &amp;quot; 数组
j-&amp;gt;setx( &amp;#39;/a: { &amp;quot;b&amp;quot;: &amp;quot;abc&amp;quot; }&amp;#39; ).   &amp;quot; 对象
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;setx&lt;/code&gt; 内部会&lt;strong&gt;完整解析&lt;/strong&gt;值，因此比 &lt;code&gt;set&lt;/code&gt; 慢——文档明确说&amp;quot;less performant (!) but
more readable&amp;quot;。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;数组操作&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;w-&amp;gt;touch_array( &amp;#39;/array2&amp;#39; ).        &amp;quot; {&amp;quot;array2&amp;quot;:[]}      显式建空数组
w-&amp;gt;push( iv_path = &amp;#39;/array&amp;#39; iv_val = 1 ).       &amp;quot; 追加
w-&amp;gt;push( iv_path = &amp;#39;/array&amp;#39; iv_val = ls_payload ). &amp;quot; 结构也能塞进数组
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;code&gt;push&lt;/code&gt; 要求路径已存在且是数组，&lt;strong&gt;不会&lt;/strong&gt;像 &lt;code&gt;set&lt;/code&gt;
那样自动创建路径——这是有意为之的区分。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;链式调用&lt;/strong&gt;：&lt;code&gt;set&lt;/code&gt; 系列返回 &lt;code&gt;me&lt;/code&gt;，所以可以一路串下去。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;li_json-&amp;gt;set( iv_path = &amp;#39;/a&amp;#39; iv_val = 1 )
        -&amp;gt;set( iv_path = &amp;#39;/b&amp;#39; iv_val = &amp;#39;B&amp;#39; )
        -&amp;gt;touch_array( iv_path = &amp;#39;/f&amp;#39; )
        -&amp;gt;push( iv_path = &amp;#39;/f&amp;#39; iv_val = 5 ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;删除与覆盖&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;w-&amp;gt;delete( &amp;#39;/a/b&amp;#39; ).    &amp;quot; 删除该节点及整棵子树
w-&amp;gt;clear( ).            &amp;quot; 清空全部
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3.5 转换成固定 ABAP 结构&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;data:
  begin of ls_payload,
    text  type string,
    num   type i,
    bool  type abap_bool,
    false type abap_bool,
    null  type string,
    table type string_table,   &amp;quot; ← JSON 数组映射为内表
  end of ls_payload.

payload-&amp;gt;to_abap( importing ev_container = ls_payload ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;只转换同名字段&lt;/strong&gt;（忽略 JSON 里多余的属性）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;payload-&amp;gt;to_abap( exporting iv_corresponding = abap_true
                  importing ev_container     = ls_payload ).

&amp;quot; 或者设成实例级开关，持久生效
payload-&amp;gt;to_abap_corresponding_only( )-&amp;gt;to_abap( importing ev_container = ls_payload ).
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3.6 映射与过滤：把外部 API 响应接进 ABAP 结构&lt;/h3&gt;
&lt;p&gt;这是 AJSON 最能体现价值的场景。外部 API 常见 camelCase，ABAP 习惯 snake_case：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;data:
  begin of ls_api_response,
    error_code type string,
  end of ls_api_response.

zcl_ajson=&amp;gt;parse( lv_api_response_string )         &amp;quot; { &amp;quot;errorCode&amp;quot;: 0, ... }
  -&amp;gt;filter( zcl_ajson_filter_lib=&amp;gt;create_path_filter(
              iv_skip_paths     = &amp;#39;*/@*&amp;#39;            &amp;quot; 去掉元数据属性
              iv_pattern_search = abap_true ) )
  -&amp;gt;map( zcl_ajson_mapping=&amp;gt;create_to_snake_case( ) )
  -&amp;gt;to_abap( importing ev_container = ls_api_response ).
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;⚠️ &lt;strong&gt;勘误&lt;/strong&gt;：官方文档
&lt;a href=&quot;https://sbcgua.github.io/ajson/docs/mapping&quot;&gt;70-mapping.md&lt;/a&gt; 的示例里写的是
&lt;code&gt;zcl_ajson_mapping=&amp;gt;camel_to_snake( )&lt;/code&gt;，但&lt;strong&gt;这个方法并不存在&lt;/strong&gt;——&lt;code&gt;zcl_ajson_mapping&lt;/code&gt;
里只有 &lt;code&gt;create_to_snake_case( )&lt;/code&gt; / &lt;code&gt;create_to_camel_case( )&lt;/code&gt; /
&lt;code&gt;create_upper_case( )&lt;/code&gt; / &lt;code&gt;create_lower_case( )&lt;/code&gt; / &lt;code&gt;create_rename( )&lt;/code&gt; /
&lt;code&gt;create_compound_mapper( )&lt;/code&gt;。照抄官方文档会直接编译报错。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;内建映射器&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;zcl_ajson=&amp;gt;parse( &amp;#39;{&amp;quot;aB&amp;quot;:1,&amp;quot;BbC&amp;quot;:2}&amp;#39; )-&amp;gt;map( zcl_ajson_mapping=&amp;gt;create_to_snake_case( ) ).
&amp;quot; {&amp;quot;a_b&amp;quot;:1,&amp;quot;bb_c&amp;quot;:2}

zcl_ajson=&amp;gt;parse( &amp;#39;{&amp;quot;a_b&amp;quot;:1}&amp;#39; )-&amp;gt;map( zcl_ajson_mapping=&amp;gt;create_to_camel_case( ) ).
&amp;quot; {&amp;quot;aB&amp;quot;:1}

zcl_ajson=&amp;gt;parse( &amp;#39;{&amp;quot;a&amp;quot;:1}&amp;#39; )-&amp;gt;map( zcl_ajson_mapping=&amp;gt;create_upper_case( ) ).
&amp;quot; {&amp;quot;A&amp;quot;:1}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;重命名支持三种匹配方式：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 按名字
create_rename( it_rename_map = value #( ( from = &amp;#39;a&amp;#39; to = &amp;#39;x&amp;#39; ) ) )

&amp;quot; 按完整路径
create_rename( it_rename_map = value #( ( from = &amp;#39;/b/a&amp;#39; to = &amp;#39;x&amp;#39; ) )
               iv_rename_by  = zcl_ajson_mapping=&amp;gt;rename_by-full_path )

&amp;quot; 按模式
create_rename( it_rename_map = value #( ( from = &amp;#39;/*/this*&amp;#39; to = &amp;#39;x&amp;#39; ) )
               iv_rename_by  = zcl_ajson_mapping=&amp;gt;rename_by-pattern )
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;还可以组合：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;create_compound_mapper(
  ii_mapper1 = zcl_ajson_mapping=&amp;gt;create_rename(
                 it_rename_map = value #( ( from = &amp;#39;/b/a&amp;#39; to = &amp;#39;x&amp;#39; ) )
                 iv_rename_by  = zcl_ajson_mapping=&amp;gt;rename_by-full_path )
  ii_mapper2 = zcl_ajson_mapping=&amp;gt;create_upper_case( ) ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;内建过滤器&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 去掉空值：{&amp;quot;a&amp;quot;:1,&amp;quot;b&amp;quot;:0,&amp;quot;c&amp;quot;:{&amp;quot;d&amp;quot;:&amp;quot;&amp;quot;}} → {&amp;quot;a&amp;quot;:1}
zcl_ajson_filter_lib=&amp;gt;create_empty_filter( )

&amp;quot; 去掉指定路径
zcl_ajson_filter_lib=&amp;gt;create_path_filter( it_skip_paths = value #( ( &amp;#39;/b&amp;#39; ) ( &amp;#39;/c&amp;#39; ) ) )
zcl_ajson_filter_lib=&amp;gt;create_path_filter( iv_skip_paths = &amp;#39;/b,/c&amp;#39; )

&amp;quot; 复合（AND）
zcl_ajson_filter_lib=&amp;gt;create_and_filter( value #(
  ( zcl_ajson_filter_lib=&amp;gt;create_empty_filter( ) )
  ( zcl_ajson_filter_lib=&amp;gt;create_path_filter( iv_skip_paths = &amp;#39;/xyz&amp;#39; ) ) ) )
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;自定义过滤器&lt;/strong&gt;（示例）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;method zif_ajson_filter~keep_node.
  &amp;quot; 去掉所有以 x 开头的节点
  rv_keep = boolc( is_node-name is initial OR is_node-name+0(1) &amp;lt;&amp;gt; &amp;#39;x&amp;#39; ).
endmethod.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3.7 切片：拆开统一响应包装&lt;/h3&gt;
&lt;p&gt;这是文档里首推的用法。面对 &lt;code&gt;{ &amp;quot;success&amp;quot;: 1, &amp;quot;error&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;payload&amp;quot;: {...} }&lt;/code&gt;
这种统一包装，第一层（success/error）和 payload 往往由不同层负责：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;data payload type ref to zif_ajson.
payload = r-&amp;gt;slice( &amp;#39;/payload&amp;#39; ).   &amp;quot; payload 成为新根
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;⚠️ &lt;code&gt;slice&lt;/code&gt; 会复制子树，大 JSON 上要注意内存。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;3.8 工具类&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 差异：返回新增 / 删除 / 修改三棵 JSON
lo_util-&amp;gt;diff( exporting iv_json_a = lv_original
                         iv_json_b = lv_comparison
                importing eo_insert = lo_insert
                          eo_delete = lo_delete
                          eo_change = lo_change ).
&amp;quot; lo_insert {&amp;quot;c&amp;quot;:&amp;quot;C&amp;quot;,&amp;quot;e&amp;quot;:[1]}   lo_delete {&amp;quot;b&amp;quot;:&amp;quot;B&amp;quot;}   lo_change {&amp;quot;a&amp;quot;:2,&amp;quot;f&amp;quot;:[5]}
&amp;quot; 注意：节点类型变化时，报为&amp;quot;一删一增&amp;quot;；比较时节点顺序无关

&amp;quot; 排序
lo_util-&amp;gt;sort( iv_json = &amp;#39;{&amp;quot;e&amp;quot;:[],&amp;quot;b&amp;quot;:&amp;quot;B&amp;quot;,&amp;quot;a&amp;quot;:1}&amp;#39; ).     &amp;quot; 按字母序输出

&amp;quot; 深度相等
zcl_ajson_utilities=&amp;gt;new( )-&amp;gt;is_equal( iv_json_a = &amp;#39;{&amp;quot;a&amp;quot;:1}&amp;#39; iv_json_b = &amp;#39;{&amp;quot;a&amp;quot;:1}&amp;#39; ).

&amp;quot; 合并（返回合并后的新 JSON）
lv_merged = lo_util-&amp;gt;merge( iv_json_a = &amp;#39;{&amp;quot;a&amp;quot;:1}&amp;#39; iv_json_b = &amp;#39;{&amp;quot;b&amp;quot;:2}&amp;#39; ).
&amp;quot; → {&amp;quot;a&amp;quot;:1,&amp;quot;b&amp;quot;:2}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;迭代器&lt;/strong&gt;（比手写 &lt;code&gt;members()&lt;/code&gt; + &lt;code&gt;LOOP&lt;/code&gt; 更顺手）：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;data li_iterator type ref to zif_ajson_iterator.
li_iterator = zcl_ajson_utilities=&amp;gt;iterate_array( ii_json = li_json iv_path = &amp;#39;/path-to-array&amp;#39; ).

while li_iterator-&amp;gt;has_next( ) = abap_true.
  li_array_item = li_iterator-&amp;gt;next( ).   &amp;quot; 返回原 JSON 的切片
  &amp;quot; 处理这一项
endwhile.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;iterate_object()&lt;/code&gt; 则按字母序遍历对象成员。&lt;/p&gt;
&lt;h3&gt;3.9 序列化输出&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;lv = lo_json-&amp;gt;stringify( ).                  &amp;quot; {&amp;quot;a&amp;quot;:1,&amp;quot;b&amp;quot;:&amp;quot;B&amp;quot;,&amp;quot;e&amp;quot;:[],&amp;quot;f&amp;quot;:[5]}
lv = lo_json-&amp;gt;stringify( iv_indent = 2 ).    &amp;quot; 带缩进的可读格式
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3.10 冻结为只读&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;lo_json = zcl_ajson=&amp;gt;parse( iv_json = lv_json iv_freeze = abap_true ).
&amp;quot; 之后 set / delete / clear 会抛异常
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;适合冻结配置对象或不该被改动的服务响应。也可以事后调用 &lt;code&gt;freeze( )&lt;/code&gt;。&lt;/p&gt;
&lt;h3&gt;3.11 API 速查&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;读&lt;/strong&gt;&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方法&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;取字符串值&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get_integer&lt;/code&gt; / &lt;code&gt;get_number&lt;/code&gt; / &lt;code&gt;get_string&lt;/code&gt; / &lt;code&gt;get_boolean&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;强类型取值&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get_date&lt;/code&gt; / &lt;code&gt;get_timestamp&lt;/code&gt; / &lt;code&gt;get_timestampl&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;日期时间取值&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;get_node_type( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;节点类型&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;exists( )&lt;/code&gt; / &lt;code&gt;is_empty( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;存在性&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;members( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;列出成员名&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;array_to_string_table( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;数组转字符串内表&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;to_abap( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;转 ABAP 结构&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;写&lt;/strong&gt;&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方法&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;set( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;任意值（默认忽略空值）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;set_string&lt;/code&gt; / &lt;code&gt;set_integer&lt;/code&gt; / &lt;code&gt;set_boolean&lt;/code&gt; / &lt;code&gt;set_date&lt;/code&gt; / &lt;code&gt;set_timestamp&lt;/code&gt; / &lt;code&gt;set_timestampl&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;类型化写入（不忽略空值）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;set_null( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;写 null&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;setx( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;文本式写入&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;push( )&lt;/code&gt; / &lt;code&gt;touch_array( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;数组操作&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;delete( )&lt;/code&gt; / &lt;code&gt;clear( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;删除&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;stringify( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;序列化&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;变换&lt;/strong&gt;&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方法&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;clone( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;复制&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;filter( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;过滤&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;map( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;映射/改名&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;slice( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;切片（改变根）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;freeze( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;设为只读&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;keep_item_order( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;保留插入顺序&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;opts( )&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;读取当前行为开关&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2&gt;四、实战示例：处理一个统一包装的 REST 响应&lt;/h2&gt;
&lt;p&gt;把上面的能力串起来看：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;data:
  lo_json type ref to zif_ajson,
  lo_pay  type ref to zif_ajson.

&amp;quot; 1) 解析 + 冻结（响应不该被改）
lo_json = zcl_ajson=&amp;gt;parse( iv_json = lv_response iv_freeze = abap_true ).

&amp;quot; 2) 检查状态（用 get_boolean，别用 get 比较字符串）
if lo_json-&amp;gt;get_boolean( &amp;#39;/success&amp;#39; ) &amp;lt;&amp;gt; abap_true.
  &amp;quot; 3) 出错信息在另一棵子树里
  lv_error = lo_json-&amp;gt;slice( &amp;#39;/error&amp;#39; )-&amp;gt;get( &amp;#39;/&amp;#39; ).
  return.
endif.

&amp;quot; 4) 只保留需要的字段，并统一命名风格
lo_pay = lo_json-&amp;gt;slice( &amp;#39;/payload&amp;#39; )
  -&amp;gt;filter( zcl_ajson_filter_lib=&amp;gt;create_path_filter(
              iv_skip_paths = &amp;#39;*/@*&amp;#39; iv_pattern_search = abap_true ) )
  -&amp;gt;map( zcl_ajson_mapping=&amp;gt;create_to_snake_case( ) ).

&amp;quot; 5) 落到 ABAP 结构
data:
  begin of ls_order,
    order_no   type string,
    order_date type d,
    items      type ty_item_tab,
  end of ls_order.

lo_pay-&amp;gt;to_abap( exporting iv_corresponding = abap_true
                 importing ev_container     = ls_order ).
&lt;/code&gt;&lt;/pre&gt;
&lt;hr&gt;
&lt;h2&gt;五、什么时候该用，什么时候不该用&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;适合&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;处理结构多变的第三方 API 响应，不想为每个接口维护 DDIC。&lt;/li&gt;
&lt;li&gt;需要&amp;quot;动态读 + 定点转结构&amp;quot;混合的场景。&lt;/li&gt;
&lt;li&gt;配置驱动的 JSON 转换（映射、过滤规则写在一个地方）。&lt;/li&gt;
&lt;li&gt;单元测试里构造/断言 JSON 负载——&lt;code&gt;setx&lt;/code&gt; 让测试数据非常易读。&lt;/li&gt;
&lt;li&gt;需要 JSON 差分比较（对比接口新旧版本返回）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;不适合 / 需要注意&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;极端性能敏感、大数据量的批量处理——每次 &lt;code&gt;slice&lt;/code&gt; 都是整树复制。&lt;/li&gt;
&lt;li&gt;需要严格 JSON Schema 校验——库不提供。&lt;/li&gt;
&lt;li&gt;需要流式（增量）处理超大 JSON 文件——库是全量内存模型。&lt;/li&gt;
&lt;li&gt;7.02 老系统上做大量字符串拼接操作时，SXML 解析器的开销会比较明显。&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2&gt;六、小结&lt;/h2&gt;
&lt;p&gt;AJSON 的设计可以概括成一句话：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;把 JSON
变成一张以路径为主键的扁平节点表，剩下的（读写、转换、过滤、映射）都是围绕这张表的纯
ABAP 操作。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;三个值得记住的技术点：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;解析不写词法分析器&lt;/strong&gt;——复用 SAP 内置 sXML 的 JSON 格式（JSON-XML
中间表示），既省掉了大段代码，又白拿了 SAP 的转义处理和错误定位。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;扁平表 + 路径主键&lt;/strong&gt;——放弃了 OO 的直观性，换来 O(log n)
定位、简单的序列化顺序控制，以及&amp;quot;序列化输出按 key
排序还是按插入顺序&amp;quot;这类本需要额外结构才能表达的选项。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;变换返回新实例&lt;/strong&gt;——&lt;code&gt;filter&lt;/code&gt; / &lt;code&gt;map&lt;/code&gt; / &lt;code&gt;clone&lt;/code&gt; / &lt;code&gt;slice&lt;/code&gt;
全部返回新对象，天然支持链式管道，且原始数据可安全冻结。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;对 ABAP 开发者来说，它填补了一个真实的空隙：不是&amp;quot;标准 JSON
转换&amp;quot;（绑死结构），也不是&amp;quot;字符串拼接&amp;quot;（不可控），而是介于两者之间的、&lt;strong&gt;可读、可组合、可测试&lt;/strong&gt;的第三条路。&lt;/p&gt;
&lt;hr&gt;
&lt;h3&gt;参考&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;源码仓库：&lt;a href=&quot;https://github.com/sbcgua/ajson&quot;&gt;https://github.com/sbcgua/ajson&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;官方文档：&lt;a href=&quot;https://sbcgua.github.io/ajson/docs/intro&quot;&gt;https://sbcgua.github.io/ajson/docs/intro&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;变更日志：&lt;code&gt;changelog.txt&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;SCN
文章：&lt;a href=&quot;https://blogs.sap.com/2020/08/14/bicycles.-2-ajson-yet-another-abap-json-parser-and-serializer&quot;&gt;Bicycles. #2 – AJSON&lt;/a&gt;、&lt;a href=&quot;https://blogs.sap.com/2022/07/23/json-alternative-to-maintenance-views-in-abap/&quot;&gt;JSON alternative to maintenance views in ABAP&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;SAP
文档：&lt;a href=&quot;https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/ABENABAP_JSON_SXML.html&quot;&gt;JSON processing in ABAP (sXML)&lt;/a&gt;、&lt;a href=&quot;https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/ABENABAP_JSON_XML.html&quot;&gt;JSON-XML representation&lt;/a&gt;、&lt;a href=&quot;https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/ABENABAP_SXML_LIB_FORMATS.html&quot;&gt;sXML formats&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】07 · 测试能通过不等于代码能跑</title><link>https://jack-liang.com/blog/dev-first-principles-07-dont-test-with-ideal-data/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-07-dont-test-with-ideal-data/</guid><description>测试能通过 ≠ 代码能跑——测试数据是开发者想象的，不是业务给的。配 ABAP Unit 实战（Function / Form 怎么测）+ 数据边界用例清单 + 测试金字塔。接过 06 的&quot;想到边界&quot;，讲&quot;测到边界&quot;。</description><pubDate>Tue, 20 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：测试通过 ≠ 代码能跑。&lt;/p&gt;
&lt;p&gt;06 那篇讲过除零 dump 的上半集。这篇讲下半集：后来我补了 ABAP Unit
测试，全绿——但测试数据是我编的，不是业务给的。dump
的那行数据根本不在我的测试里。测试通过，只说明&amp;quot;想出来的数据&amp;quot;能跑。这篇讲测试数据怎么造才有用，以及
Function 和 Form 怎么测。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、测试全绿，上线照样 dump&lt;/h2&gt;
&lt;p&gt;上篇讲过一次除零 dump。这篇讲它的下半集。&lt;/p&gt;
&lt;p&gt;那次之后我补了教训：把计算逻辑抽成一个 FM，规规矩矩写了 ABAP Unit。SETUP
里造数据，三个测试方法，断言齐全，跑起来全绿。&lt;/p&gt;
&lt;p&gt;我放心了。上线一周，dump。&lt;/p&gt;
&lt;p&gt;还是除零。dump 的那行数据，分母是 0，和 06
里同一个病根。而我的三个测试方法，金额是一百、两百、三百——客户都有、字段都齐、分母都大于零。&lt;/p&gt;
&lt;p&gt;问题不在测试框架，不在断言写法，在数据。测试数据是我坐在工位上想出来的，真实数据是业务在系统里长出来的。&lt;/p&gt;
&lt;p&gt;那次之后我改了看法：&lt;strong&gt;测试通过 ≠
代码能跑&lt;/strong&gt;。测试通过只说明一件事——我用想象的数据验证过代码。真实数据来了会怎样，代码没答应过。&lt;/p&gt;
&lt;h2&gt;二、想象的数据有三个系统性偏差&lt;/h2&gt;
&lt;p&gt;开发者的测试数据为什么靠不住？因为它有三个倾向：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;全是&amp;quot;漂亮的&amp;quot;：字段都填、格式都对、长度都够&lt;/li&gt;
&lt;li&gt;全是&amp;quot;正常的&amp;quot;：金额大于零、内表不为空、SELECT 都查得到&lt;/li&gt;
&lt;li&gt;全是&amp;quot;我知道的&amp;quot;：我见过的数据形态，才造得出来&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;真实数据在这三个方向上都是反的。空的、零的、超长的、带全角字符的、查不到的——业务里天天见，06
聊过这个清单。所以 100 个正常用例全过，也不等于代码能跑。按覆盖率的算法说：&lt;strong&gt;0
个边界用例 + 100 个正常用例 = 0% 真实覆盖。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;你可能想问：真实数据长什么样，我哪知道？&lt;/p&gt;
&lt;p&gt;知道的办法很简单：SE16N
打开业务表，翻到最脏的几行，照着抄进测试。哪个客户编码带空格，哪个金额里有千分位逗号，哪个描述是半角问号——测试数据就按这个造，别在工位上编。06
说&amp;quot;想到边界&amp;quot;靠问业务，这篇补一句：&amp;quot;测到边界&amp;quot;靠抄业务。&lt;/p&gt;
&lt;p&gt;你可能觉得：边界用例写起来费时间。&lt;/p&gt;
&lt;p&gt;一个 FM 也就四五个场景：正常、零、负、超长、找不到。每个场景一个测试方法，一批
FM 一个下午能测完。和上线后排查一周的代价比，这便宜得太多了。&lt;/p&gt;
&lt;h2&gt;三、新药不能只在健康人身上试&lt;/h2&gt;
&lt;p&gt;开发之外，&amp;quot;理想化数据&amp;quot;的坑，医药行业掉得最深。&lt;/p&gt;
&lt;p&gt;新药上市前要做临床试验。一期在健康志愿者身上做：年轻、没病、肝肾功能正常——数据漂亮，副作用少，通过得也快。但一种药只在健康人身上试过就上市，谁都不敢。所以还要三期，在真实的病人身上做：有并发症的、同时在吃别的药的、肝肾功能本来就不全的。上市之后还有四期，继续盯真实世界里的不良反应。&lt;/p&gt;
&lt;p&gt;因为药最终要进的是真实世界。程序也一样——它上线后面对的是业务数据。&lt;/p&gt;
&lt;p&gt;在健康人身上安全，只说明它在一个理想环境里安全。程序在漂亮数据里能跑，也一样。&lt;/p&gt;
&lt;h2&gt;四、Function 和 Form 怎么测&lt;/h2&gt;
&lt;p&gt;落到 ABAP，按 02 篇&amp;quot;按职责切&amp;quot;的思路，分三种东西测。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;纯函数&lt;/strong&gt;——输入参数进、输出参数出，不碰数据库的。这种最好测，是 ABAP Unit
的主战场。每个数据场景一个测试方法，命名就把场景说清楚：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CLASS ltcl_tax_calc DEFINITION FINAL FOR TESTING
  DURATION SHORT RISK LEVEL HARMLESS.
  PRIVATE SECTION.
    METHODS:
      normal_amount   FOR TESTING,
      zero_amount     FOR TESTING,   &amp;quot; 接 06 的五条边界
      negative_amount FOR TESTING.
ENDCLASS.

METHOD zero_amount.
  DATA(lv_tax) = zcl_tax=&amp;gt;calculate( iv_amount = 0 ).
  cl_abap_unit_assert=&amp;gt;assert_equals(
    act = lv_tax
    exp = 0
    msg = &amp;#39;零金额应返回零税额，不应抛错&amp;#39; ).
ENDMETHOD.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;happy path 那一个方法，作用接近语法检查。真正干活的是后面几个。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;带副作用的&lt;/strong&gt;——要读数据库、写自建表的。照样写 ABAP
Unit：造数、执行、断言，跑完测试框架自动回滚，不污染数据。这类测试断言的是数据正确性——读出来的和写进去的对不对，不是流程跑没跑通。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Form 和 Smart
Forms&lt;/strong&gt;——最麻烦，&amp;quot;数据对不对&amp;quot;和&amp;quot;长得对不对&amp;quot;混在一起。办法还是拆：数据准备一个
FM，渲染一个 Form。FM 可以测，Form 的字段映射用 Adobe Forms
的测试功能核一遍。但&amp;quot;打出来好不好看&amp;quot;没有黄金样本对照，只能靠人眼——这点我目前也没什么好办法。&lt;/p&gt;
&lt;p&gt;最后是给每个测试类过一遍的清单：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;测试类里有 ABAP Unit，不是&amp;quot;我手测过了&amp;quot;&lt;/li&gt;
&lt;li&gt;场景覆盖 06 那五条：空 / 零 / 负 / 超长 / 找不到&lt;/li&gt;
&lt;li&gt;至少一行数据是从业务表里抄的真实数据&lt;/li&gt;
&lt;li&gt;改完代码跑过回归，旧用例全绿&lt;/li&gt;
&lt;li&gt;测试代码也被 review——测试代码也是代码&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;测试通过 ≠ 代码能跑。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;它只说明一件事：你想出来的数据，代码接住了。真实数据接不接得住，取决于造测试数据的时候，是坐在工位上编，还是去业务表里抄。&lt;/p&gt;
&lt;p&gt;06 讲&amp;quot;想到边界&amp;quot;，07 讲&amp;quot;测到边界&amp;quot;。想到 + 测到，才算闭环。&lt;/p&gt;
&lt;p&gt;下一篇聊&lt;a href=&quot;/blog/dev-first-principles-08-magic-numbers&quot;&gt;魔术数&lt;/a&gt;。代码里的 &lt;code&gt;01&lt;/code&gt; 和
&lt;code&gt;02&lt;/code&gt;，写的时候都记得是什么意思——三个月后就未必了。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】06 · 先定界，再写码</title><link>https://jack-liang.com/blog/dev-first-principles-06-boundaries-before-code/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-06-boundaries-before-code/</guid><description>数据有几种情况，代码就要有几种应对。空、零、找不到不是特殊情况，是数据常态。</description><pubDate>Thu, 15 Oct 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：数据有几种情况，代码就要有几种应对。&lt;/p&gt;
&lt;p&gt;写 ALV 报表时，我脑子里只跑了 happy path：数据有、金额有、找得到。上线一周
dump——业务筛了&amp;quot;只看本月&amp;quot;，分母为
0。这篇讲一个反直觉的判断：空、零、找不到不是&amp;quot;特殊情况&amp;quot;，是数据常态。提供一个判断标准 +
两张清单，开发前后各花 5 分钟过一遍。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、上线一周的除零 dump&lt;/h2&gt;
&lt;p&gt;刚做开发时交付一张 ALV
报表，按客户算交付达成率：分子是已交付数量，分母是计划数量，相除。&lt;/p&gt;
&lt;p&gt;我自己测的几组数据都正常。上线一周，dump：因为除零。&lt;/p&gt;
&lt;p&gt;排查倒不复杂：业务同事习惯筛&amp;quot;只看本月&amp;quot;，有一家新客户本月刚建档，计划数量是
0——分母为 0，dump。&lt;/p&gt;
&lt;p&gt;更难受的是，这不算孤例。往前翻，我至少还踩过两次同类的坑：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;READ TABLE itab INTO wa WITH KEY kunnr = lv_kunnr.&lt;/code&gt; 没判 &lt;code&gt;sy-subrc&lt;/code&gt;，READ
没找到，&lt;code&gt;wa&lt;/code&gt; 里还是上一次的值——程序不报错，只是数据悄悄错了&lt;/li&gt;
&lt;li&gt;&lt;code&gt;SELECT SINGLE ...&lt;/code&gt; 查一条配置没查到，字段沿用了上一次的——同样不报错&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这两次的共同点是：我以为不会发生的事，业务里天天发生。&lt;/p&gt;
&lt;p&gt;我以前写代码，脑子里跑的是 happy
path：数据有、金额有、字段有、找得到。但**&amp;quot;如果没数据怎么办&amp;quot;**这类问题，你认真想过吗。&lt;/p&gt;
&lt;h2&gt;二、数据有几种情况，代码就要有几种应对&lt;/h2&gt;
&lt;p&gt;这句话可以拆开看。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;数据有几种情况&lt;/strong&gt;，是业务告诉你的。空、零、负、超长、特殊字符、查不到——这些可能性不是靠拍脑袋，是去问：这个字段可能为空吗？金额可能为负吗？这个
SELECT 可能没结果吗？和业务聊 15 分钟，清单就出来了。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;代码有几种应对&lt;/strong&gt;，是你写出来的。每种情况，代码里要有一个分支接住：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;不能默认内表不为空 → &lt;code&gt;IF itab IS NOT INITIAL.&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;不能默认 SELECT 找得到 → 判 &lt;code&gt;sy-subrc = 0&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;不能默认金额大于零 → 除法前保护分母&lt;/li&gt;
&lt;li&gt;不能默认用户填了必填 → Dynpro 的 FIELD 校验&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;两种情况两种应对，三种情况三种应对。少一个应对，就少一个边界保护——漏掉的那个，上线后由业务帮你&amp;quot;测试&amp;quot;。&lt;/p&gt;
&lt;p&gt;你可能想问：情况列出来了，每种该怎么处理？报错还是放行？&lt;/p&gt;
&lt;p&gt;判断标准只有一条：这件事业务上&amp;quot;应该发生&amp;quot;还是&amp;quot;不应该发生&amp;quot;。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;不应该发生的，报错：必填字段为空、主键重复、金额为负（业务不允许）&lt;/li&gt;
&lt;li&gt;应该发生的，放行：本月没数据就显示空表、查不到就显示无结果&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&amp;quot;报错&amp;quot;不是跟业务过不去，是把边界明确化——让业务知道这种情况不该发生，下次提需求就会带上它。反过来，对允许发生的情况乱报错，业务会被训练成忽略你的报错。&lt;/p&gt;
&lt;p&gt;你可能觉得：业务自己也没想清楚，问了也白问。我的经验正相反：问不出来的，当场让他选——报错还是放行。他选不出来，就报错。把问题暴露出来，比让它藏在数据里强。&lt;/p&gt;
&lt;h2&gt;三、结构工程师不算&amp;quot;平时压多少&amp;quot;&lt;/h2&gt;
&lt;p&gt;开发之外，把边界当起点的人比比皆是，结构工程师是其中最彻底的。&lt;/p&gt;
&lt;p&gt;设计院算一栋楼的荷载，算的不是&amp;quot;平时压多少&amp;quot;，是&amp;quot;最多压多少&amp;quot;。抗震按设防烈度，屋顶按百年一遇的雪载，梁柱按最不利的组合。日常荷载决定楼住得舒不舒服，最坏荷载决定楼倒不倒。&lt;/p&gt;
&lt;p&gt;反过来，如果设计只按日常荷载做，再逐层补&amp;quot;安全检查&amp;quot;，那栋楼你敢住吗？&lt;/p&gt;
&lt;p&gt;写代码一样。happy path
决定功能演示顺不顺，边界处理决定上线后活不活。上线那一刻，程序面对的就是最坏荷载。&lt;/p&gt;
&lt;h2&gt;四、动手前和动手后各 5 分钟&lt;/h2&gt;
&lt;p&gt;动手前，和业务把这 4 个问题聊完：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;数据从哪来、谁产生、什么格式&lt;/li&gt;
&lt;li&gt;有哪些可能的情况（空 / 零 / 负 / 超长 / 查不到）&lt;/li&gt;
&lt;li&gt;哪些情况不该发生——报错&lt;/li&gt;
&lt;li&gt;哪些情况允许发生——放行&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;动手后，提交前过这张清单，每条 5 到 10 秒：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;每种数据情况都问过业务，不是我自己猜的&lt;/li&gt;
&lt;li&gt;每个分支都有对应处理（判 &lt;code&gt;sy-subrc&lt;/code&gt;、&lt;code&gt;IS INITIAL&lt;/code&gt;、除零保护）&lt;/li&gt;
&lt;li&gt;&amp;quot;不该发生&amp;quot;的情况报错了，&amp;quot;允许发生&amp;quot;的情况放行了&lt;/li&gt;
&lt;li&gt;放行的情况有明确的界面显示或日志，不留&amp;quot;上一次的值&amp;quot;&lt;/li&gt;
&lt;li&gt;没有&amp;quot;catch 之后继续跑&amp;quot;的静默放行&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;第 5 条单独说：边界处理不等于到处 try-catch
把异常吞掉，那和没处理一样——程序不报错，只是错得更隐蔽。这和 05
篇是同一个思想的两半：05 讲失败发生后消息别丢，06 讲失败发生前把边界想到。&lt;/p&gt;
&lt;p&gt;反模式也简单：写完代码直接丢给
QA，自己没有先过一遍。上线后才发现的边界问题，是开发者的疏忽，不是 QA 的责任。&lt;/p&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;先定界，再写码。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;别替数据做主。&amp;quot;想当然地默认&amp;quot;是 bug
的温床：你以为理所当然的分母，在业务手里可能就是 0。&lt;/p&gt;
&lt;p&gt;下一篇聊&lt;a href=&quot;/blog/dev-first-principles-07-dont-test-with-ideal-data&quot;&gt;测试&lt;/a&gt;。06 讲&amp;quot;想到边界&amp;quot;，07 讲&amp;quot;测到边界&amp;quot;——想到的边界怎么用 ABAP Unit
固化下来，让以后每次改动都被自动检查一遍。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】05 · 为什么&quot;友好化&quot;反而害了排障</title><link>https://jack-liang.com/blog/dev-first-principles-05-friendly-error-messages/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-05-friendly-error-messages/</guid><description>友好化消息会导致排障困难，因为用户只能看到最终的错误提示，而无法查看原始错误信息。</description><pubDate>Tue, 29 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;《开发第一性原理》系列第 5/12 篇&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：包装别替换，累加别丢弃。&lt;/p&gt;
&lt;p&gt;业务报上来一句&amp;quot;同步失败&amp;quot;，你翻一上午日志也找不到哪步出错——问题多半出在&amp;quot;友好化&amp;quot;：每层
catch
都把原始消息换成一句好听话，翻到最里层，根因没了。这篇讲消息链怎么传才不丢：抛出点是源头，下游只能追加、不能替换；友好提示走另一条线给用户看。落到
ABAP，就是 sy-msgv1-4、SLG1 和消息类的用法。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、六个字的报错，查了一上午&lt;/h2&gt;
&lt;p&gt;前段时间排查一个跨系统的订单同步问题。&lt;/p&gt;
&lt;p&gt;业务部门反馈：&amp;quot;订单同步失败了。&amp;quot;再问提示什么，答：&amp;quot;同步失败，请联系管理员。&amp;quot;&lt;/p&gt;
&lt;p&gt;我手里就这六个字。&lt;/p&gt;
&lt;p&gt;打开应用日志 SLG1，翻到对应时间。日志有，一层不少。但每层都是 catch
之后抛自己新写的消息：最外层&amp;quot;订单同步失败&amp;quot;，往里一层&amp;quot;订单校验失败&amp;quot;，再往里&amp;quot;校验失败&amp;quot;。翻到最深处，本该躺着原始错误的地方，也是一句自造的&amp;quot;操作失败&amp;quot;。&lt;/p&gt;
&lt;p&gt;原始错误是什么？&amp;quot;外部系统返回 HTTP 503，重试三次超时。&amp;quot;——早被中间某一层丢掉了。&lt;/p&gt;
&lt;p&gt;我花了一上午，逐层翻代码、逐层追抛出点，才在最深的 try-catch 里找到它。&lt;/p&gt;
&lt;p&gt;我以前觉得，给用户友好提示是好事，总比甩一堆技术术语强。那次之后改了看法：友好提示和保留原始消息，是两件事。加一层好听话，是包装；把原来的话扔掉换一句新的，是替换。很多
catch 块写的是前者，干的是后者。&lt;/p&gt;
&lt;h2&gt;二、抛出点才是消息的源头&lt;/h2&gt;
&lt;p&gt;这条规矩一句话能说完：包装别替换，累加别丢弃。&lt;/p&gt;
&lt;p&gt;抛出那一行是消息的源头——和 03
篇&amp;quot;一个数据只有一个源头&amp;quot;是同一个思想。消息在这里出生，权威版本只有这一份，下游谁都没资格改写它。&lt;/p&gt;
&lt;p&gt;下游每层能做的事只有两种：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;追加自己的上下文：&amp;quot;调订单校验服务失败，原因是……&amp;quot;&lt;/li&gt;
&lt;li&gt;翻译给特定受众：把&amp;quot;HTTP 503&amp;quot;翻译成&amp;quot;外部系统暂时不可用&amp;quot;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;不能做的也有两种：替换原文；吞掉异常——catch 之后 log
一下，让程序&amp;quot;继续跑&amp;quot;。前者让根因消失，后者让错误连存在过的痕迹都不留。&lt;/p&gt;
&lt;p&gt;排障怕这个，是因为排障要的是一条链，不是一个点。错误从最深处冒出来，穿过校验、穿过服务、穿过接口、穿过
UI，每层都该留着上一层的原话，运维和开发者顺着链往回走，才落得到根因。链断了，到外层只剩一行&amp;quot;操作失败&amp;quot;——错误还活着，诊断信息全没了。这就是
01 篇说的&amp;quot;安静的低级错误&amp;quot;的另一种形态：它不报错，它只是让你查不到。&lt;/p&gt;
&lt;p&gt;你可能觉得：本来也不该把&amp;quot;HTTP
503&amp;quot;直接甩给用户看。对，所以是双轨。友好消息给用户——&amp;quot;订单同步失败，请稍后重试&amp;quot;；原始消息留给运维和开发者，进日志、进消息参数。两条线各走各的，谁也不替代谁。Java
的 cause、Go 的 %w、Python 的 raise from，做的都是这件事：错误链不断，根因不丢。&lt;/p&gt;
&lt;h2&gt;三、体检报告和病历&lt;/h2&gt;
&lt;p&gt;开发之外，这个结构天天在用：体检报告和病历。&lt;/p&gt;
&lt;p&gt;体检报告上写&amp;quot;血脂偏高，建议复查&amp;quot;——友好、易懂、不吓人，是给本人看的。病历里写&amp;quot;LDL
4.7
mmol/L，伴颈动脉斑块&amp;quot;——精确、可追溯，是给医生决策用的。两份记的是同一个事实，一份负责让人看懂，一份负责让人能治病。&lt;/p&gt;
&lt;p&gt;把两份合并成一句&amp;quot;血脂不太好&amp;quot;呢？表面上更友好，实际既不能帮本人理解，也不能帮医生决策。&lt;/p&gt;
&lt;p&gt;错误消息也一样。给用户的友好提示和给排障用的技术细节，是同一次失败的两份记录。合成一句&amp;quot;操作失败&amp;quot;，等于病历被体检报告吃掉了。&lt;/p&gt;
&lt;h2&gt;四、我现在怎么写&lt;/h2&gt;
&lt;p&gt;落到 ABAP 里，三个场景，加一个清单。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;FM 嵌套调用&lt;/strong&gt;。被调 FM 抛了消息，调它的 FM 里第一件事：把
sy-msgid、sy-msgno、sy-msgv1-4 存下来，再决定怎么办。图省事写一句
&lt;code&gt;MESSAGE &amp;#39;操作失败&amp;#39; TYPE &amp;#39;E&amp;#39;&lt;/code&gt;，原始消息就没了。要包上下文，用
&lt;code&gt;MESSAGE e001(zx) WITH &amp;#39;订单同步&amp;#39; RAISING&lt;/code&gt;——消息类里写&amp;quot;订单同步失败，原因：&amp;amp;1&amp;quot;，原始消息放参数里接着往下传。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;后台作业和应用日志&lt;/strong&gt;。异步场景没人盯着屏幕，SLG1 是事后唯一的入口。写日志用
BAL_LOG_MSG_ADD，传消息类和参数，别硬编码文本。好处是 ID
不变、文本可变：运维事后 grep 一下&amp;quot;ZORDER
001&amp;quot;，直接定位到抛出点，连当时的订单号都看得到。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;BAdI 和 Enhancement&lt;/strong&gt;。实现里出错，最差的是 RETURN 静默退出——标准程序以为 BAdI
成功了，接着往下走，这是最诡异的那类 bug。该 &lt;code&gt;MESSAGE e001(zx) RAISING&lt;/code&gt;
就抛出去，让标准程序感知到。&lt;/p&gt;
&lt;p&gt;你可能想问：catch 之后 log 一下、再把异常 rethrow，log
和异常都留，是不是重复了？不重复。log
给运维看，是事后的线索；异常给调用方看，是它决定下一步的依据。写日志解决&amp;quot;事后查得到&amp;quot;，抛异常解决&amp;quot;当场处理对&amp;quot;，少一个都缺一角。&lt;/p&gt;
&lt;p&gt;最后是任何 catch 块都过一遍的清单：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;catch 必 rethrow，绝不只 log——catch 后 log 一下继续跑，是事故现场&lt;/li&gt;
&lt;li&gt;log 和异常分开写：一个给运维，一个给调用方&lt;/li&gt;
&lt;li&gt;包装只追加，不动原始消息&lt;/li&gt;
&lt;li&gt;只在边界做友好化——跨系统、到用户眼前才翻译，系统内部保持原样&lt;/li&gt;
&lt;li&gt;用 SE91 消息类，不写硬编码文本&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;包装别替换，累加别丢弃。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;给用户友好提示，和给开发者留诊断信息，不冲突。拆开这两件事：用户得到一句好懂的话，运维得到一条完整的链，两头都占着。&lt;/p&gt;
&lt;p&gt;这也是 01 篇的延续：消息链一断，错误就穿上了隐身衣——不报错，只是查不到。&lt;/p&gt;
&lt;p&gt;下一篇聊失败处理的另一半：&lt;a href=&quot;/blog/dev-first-principles-06-boundaries-before-code/&quot;&gt;事前防御。和业务把数据的边界讲清楚，再动手写码&lt;/a&gt;&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】04 · 找不到问题点？把范围砍一半试试</title><link>https://jack-liang.com/blog/dev-first-principles-04-binary-search-debugging/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-04-binary-search-debugging/</guid><description>二分定位的本质：链路一长就不知道错在哪，在流程中间抓一条数据，判断问题在前半还是后半，几刀就缩到具体位置。中间点要满足三个要求——能看、必经、看得懂。这不是技巧，是排障时缩小范围的最直接手段。</description><pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;《开发第一性原理》系列第 4/12 篇 · 上一篇：03 - 为什么一个数据只能有一个源头 ·
下一篇：&lt;a href=&quot;/blog/dev-first-principles-05-friendly-error-messages&quot;&gt;05 · 为什么&amp;quot;友好化&amp;quot;反而害了排障&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：找不到问题点？把范围砍一半试试。&lt;/p&gt;
&lt;p&gt;程序出了问题，链路一长就不知道错在哪。这篇聊二分定位：在流程中间抓一条数据，判断问题在前半还是后半，几刀就缩到具体位置。中间点怎么选，有三个要求——能看、必经、看得懂。加上第一篇的&amp;quot;先查什么&amp;quot;，排障的两半就齐了。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、一上午的排查，十分钟收场&lt;/h2&gt;
&lt;p&gt;前段时间排查一个接口问题。&lt;/p&gt;
&lt;p&gt;数据从 SAP
传到一个外部系统，链路是这样的：自开发程序先从业务单据取数，写进中间表；后台作业把中间表转成
XML，发到对方服务器；对方解析入库之后，回传处理结果。&lt;/p&gt;
&lt;p&gt;有一天，对方反馈：库里某个字段是空的。&lt;/p&gt;
&lt;p&gt;哪一环出的问题？取数程序、中间表、XML
生成、传输、对方解析，都有可能。我当时的办法是从头查：先看取数程序，再看中间表，再看
XML，一段一段往下顺。&lt;/p&gt;
&lt;p&gt;前三段查完，一上午过去了，还没找到。&lt;/p&gt;
&lt;p&gt;后来我换了个办法：不在头上查，在中间抓一把。把那天发到对方的 XML
打开，看了一眼——字段就是空的。&lt;/p&gt;
&lt;p&gt;那问题就在前三段，后面两段不用看了。再查中间表，值是有的。范围一下就缩到最后一段：XML
生成。进去一看，字段名和结构对不上，赋值赋丢了。&lt;/p&gt;
&lt;p&gt;从换办法到定位，不到十分钟。&lt;/p&gt;
&lt;p&gt;我以前觉得，这种链路问题只能一段一段顺序看，看到哪段错就是哪段。那次之后我改了看法：不用顺着看，在中间任何一个能看数据的地方抓一把，就能判断问题在这一环之前还是之后。判断一次，范围少一半。&lt;/p&gt;
&lt;p&gt;这就是这篇要讲的东西：不知道问题点在哪，先把它可能的范围砍一半。&lt;/p&gt;
&lt;h2&gt;二、为什么砍一半这么有效&lt;/h2&gt;
&lt;p&gt;这就是二分查找。上学时学过：有序数组里找一个值，从头扫是
O(n)，每次看中间、砍一半是 O(log n)。1000 个元素，顺序扫最坏 1000 次，二分最多
10 次。&lt;/p&gt;
&lt;p&gt;你可能觉得，环节少的时候，顺序看也挺快，何必费劲选中间点？五段六段的链路确实无所谓，但链路一长，O(n)
和 O(log n) 的差距就出来了。而且&amp;quot;抓中间&amp;quot;是个可以养成的习惯，比每次临时想辙可靠。&lt;/p&gt;
&lt;p&gt;排障天然适合二分。因为流程大多是串行的——上一环的输出是下一环的输入。在中间抓一把，数据是好是坏一看便知，一次砍掉一半。砍几次，范围就缩到一眼能看见的那几行。&lt;/p&gt;
&lt;p&gt;当然，关键不在&amp;quot;二分&amp;quot;这两个字，在中间点选得好不好。三个要求：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;能看&lt;/strong&gt;：这个点上能看到数据的真实状态——断点能看变量，接口能看报文，中间表能查记录&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;必经&lt;/strong&gt;：流程一定从这里过，不会绕路&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;看得懂&lt;/strong&gt;：这个点上的数据，扫一眼就能判断对错，不依赖太多上下文&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;选错点，二分就退化成顺序查。常见的错法：选了个旁路，流程根本不经过；选了个只出不进的终点，只能确认&amp;quot;到这里还是好的&amp;quot;，砍不掉前面的范围；选了个上下文很重的地方，数据不对，也说不清是这里错了还是上游错了。&lt;/p&gt;
&lt;p&gt;你可能想问：要是错的就是中间这一环呢？也一样——它上游是好的，到这里变坏了，问题照样被圈死在这一环里。&lt;/p&gt;
&lt;h2&gt;三、猜数字游戏&lt;/h2&gt;
&lt;p&gt;这个道理最直白的版本，是猜数字。&lt;/p&gt;
&lt;p&gt;心里想一个 1 到 100 的数，我来猜。最笨的办法从 1 猜到
100，平均五十次。聪明的办法是先问&amp;quot;比 50
大吗&amp;quot;——不管答案是是还是不是，一半的可能都没了。再问&amp;quot;比 75
大吗&amp;quot;，又砍一半。七次以内必中。&lt;/p&gt;
&lt;p&gt;排障一模一样。每抓一个中间点，就是问了一次&amp;quot;比 50
大吗&amp;quot;。区别只在于，猜数字砍的是数字区间，排障砍的是流程区间。&lt;/p&gt;
&lt;h2&gt;四、我现在怎么做&lt;/h2&gt;
&lt;p&gt;落到日常，就两条路。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;单程序调试&lt;/strong&gt;：在流程中点设断点，看关键变量的实际值，判断问题在前半还是后半；在有问题的那半里再找中点。重复几次，缩到几行。最后记得第一篇的提醒——二分找到的那几行，往往就是个低级错误，回头查基础。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;跨系统排查&lt;/strong&gt;：选一个必经、能看数据的环节——中间表、接口报文、日志。抓一条数据判断好坏：好的，问题在后半段；坏的，问题在前半段。在剩下的那段里再选点，重复，直到定位到一个程序、一个方法。&lt;/p&gt;
&lt;p&gt;先查什么和在哪查，是两件事。第一篇的奥卡姆剃刀，告诉你按出现频率排优先级，先花最小的成本查最可能的原因；这篇的二分，告诉你范围不明时怎么把它缩小。基础没查到，再用二分。两个合起来，才是完整的排障路径。&lt;/p&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;找不到问题点，别从头查。在中间抓一把，把范围砍一半，再砍一半。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;关键还是那个中间点：能看、必经、看得懂。&lt;/p&gt;
&lt;p&gt;到这里，排障方法论的四篇就齐了：先按出现频率查基础（01），把复杂问题切开（02），一个数据只认一个源头（03），再用二分缩小范围（04）。&lt;/p&gt;
&lt;p&gt;下一篇换个方向，聊失败处理：为什么&amp;quot;友好化&amp;quot;的错误消息，反而害了排障。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】03 · 为什么一个数据只能有一个源头</title><link>https://jack-liang.com/blog/dev-first-principles-03-single-source-of-truth/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-03-single-source-of-truth/</guid><description>单一信息源（Single Source of Truth）的本质：同一份数据，只允许有一个权威位置；其他一切地方，都只是它的引用，而不是它的副本。这不是规范，是减少心智负担和消除不一致的最直接手段。</description><pubDate>Tue, 15 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;《开发第一性原理》系列第 3/12 篇 · 上一篇：02 - 复杂问题，要先学会&amp;quot;切&amp;quot; ·
下一篇：&lt;a href=&quot;/blog/dev-first-principles-04-binary-search-debugging&quot;&gt;04 · 找不到问题点？把范围砍一半试试&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：一个数据只该有一个源头。&lt;/p&gt;
&lt;p&gt;客户改了个名，系统里改了五处，漏了一处，发货单就印错了名字。这篇聊
SSoT（单一数据源）：同一份数据存多份，为什么不一致是迟早的事，以及我平时怎么做——写入收敛、读取按需，最后附一个
grep 自检的小清单。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、客户名称对不上&lt;/h2&gt;
&lt;p&gt;前段时间业务部门来找我，说发货单上印的客户名称，和销售订单上对不上。&lt;/p&gt;
&lt;p&gt;我查了一下，同一家客户&amp;quot;ABC
有限公司&amp;quot;，系统里至少存了五份名称：销售订单抬头存了一份，采购订单抬头存了一份，客户主数据里一份，供应商主数据里一份，还有一张报表用的自建表里又有一份。字段名都叫&amp;quot;客户名称&amp;quot;，值各自独立，谁也不会自动同步谁。&lt;/p&gt;
&lt;p&gt;这次是客户被收购重组，名字改成了&amp;quot;ABC
集团股份有限公司&amp;quot;。业务改了主数据，改了订单，也改了报表公式。但漏掉了那张自建表。&lt;/p&gt;
&lt;p&gt;于是发货按旧名字印，发票按新名字开。客户拿到两样东西，名字对不上，电话就过来了。&lt;/p&gt;
&lt;p&gt;我花了一个下午，在系统里逐个搜&amp;quot;ABC&amp;quot;出现在哪些地方。这种排查很折磨人：每找到一处，你都不知道它是不是最后一处。&lt;/p&gt;
&lt;h2&gt;二、存了五份，就要记得改五处&lt;/h2&gt;
&lt;p&gt;你可能觉得，改的时候仔细一点、勤快点，不就行了？&lt;/p&gt;
&lt;p&gt;我后来想过这个问题。同一份数据存了 N 份，每次改，就要保证 N
处一起改对。改一两次不漏，靠细心可以做到；一年两年、十次二十次都不漏，就没人敢打包票了。更新点一多，漏掉只是时间问题。&lt;/p&gt;
&lt;p&gt;所以这事怪不到谁头上。哪怕每个参与者都很认真，结果也是结构决定的，不是态度决定的。&lt;/p&gt;
&lt;p&gt;这就是软件工程里说的 SSoT（Single Source of
Truth，单一数据源）。落到我的理解，其实就一句话：&lt;/p&gt;
&lt;p&gt;描述只放一处，其他地方只存编码。&lt;/p&gt;
&lt;p&gt;拿客户来说：名称、地址这些描述，只在客户主数据里维护。别的地方要用——发货单、报表——存个客户编号就够了，要显示名称的时候，实时去主数据里取。编号到处存没什么问题，它是引用，不是副本；描述存了第二份，才是对不上的开始。&lt;/p&gt;
&lt;p&gt;这样修改只发生在一个地方，不一致从源头上就没有发生的机会。&lt;/p&gt;
&lt;p&gt;我以前觉得，客户名称这种小字段，多存几份没什么，反正值都一样。经过这件事我改了看法：看起来一样的数据，只要存了多份，早晚会变得不一样。&lt;/p&gt;
&lt;h2&gt;三、12306 也是这么做的&lt;/h2&gt;
&lt;p&gt;这个思路不是软件行业独有，买票的时候就能体会到。&lt;/p&gt;
&lt;p&gt;一趟车还剩多少张票，只有 12306
一个库说了算。你在携程、飞猪上看到的余票，不是它们各自存的，是展示之前实时查来的——查完没付款，过一会儿再看，数字可能就变了。&lt;/p&gt;
&lt;p&gt;更关键的是写入：真正出票、扣库存的，永远只有 12306
一处。第三方平台做得再大，也没有自己的&amp;quot;票库&amp;quot;。&lt;/p&gt;
&lt;p&gt;道理不复杂：关键数据只在一处维护，其他地方要用就实时来取。自己另存一份，从存下的那一刻起，那份就已经过期了。&lt;/p&gt;
&lt;p&gt;回到开发里，一个字段的真值也应该这样对待——只在一处写，别处要用，来查。&lt;/p&gt;
&lt;h2&gt;四、我现在的几个习惯&lt;/h2&gt;
&lt;p&gt;落到日常工作，我做了这么几件事。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;新写代码时：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;临时表、自建表里只存客户编码，不存客户名称。报表上要名称，JOIN 客户主数据去拿&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;确实有冗余需要的时候（比如为了性能建了缓存表），就在写入的程序里同步更新。写进代码里，比&amp;quot;大家记得同步&amp;quot;可靠得多&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;建表的时候，唯一约束能加就加。比如客户编码，结构上就不允许出现两条一样的记录——与其指望每个人写入时都记得检查，不如让数据库直接拦住&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;排查存量代码时：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;像排查那次一样，把关键值拿到代码和表结构里搜一遍：客户名称、税率、汇率，凡是写死的字面量、或者在别的表里又存了一份副本的，搜到一处就是一处隐患&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;隔段时间问自己一句：这个值的源头在哪？其他地方都只是引用吗？&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;描述只放一处，其他地方只存编码。&lt;/strong&gt;
多存一份描述，不是多一道保险，是多一个将来要对不上的地方。&lt;/p&gt;
&lt;p&gt;把写入收敛到一个入口，需要的地方随时去取真值。剩下的事，交给结构。&lt;/p&gt;
&lt;p&gt;下一篇聊&amp;quot;把范围砍一半试试&amp;quot;：程序出了问题找不到点，从中间切开，一半一半地缩小范围。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;系列导览&lt;/h2&gt;
&lt;p&gt;&lt;a href=&quot;/blog/dev-first-principles-intro/&quot;&gt;《开发第一性原理》&lt;/a&gt; 共 12+ 篇，按 4
大主题展开：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;排障方法论&lt;/strong&gt;（01-04）：先查什么 + 在哪查 + 怎么用工具&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;失败处理&lt;/strong&gt;（05-06）：事后保留 + 事前防御&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;开发者测试&lt;/strong&gt;（07）：测到边界&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;信息可被找到&lt;/strong&gt;（08-12）：字面量 / 配置表 / 代码 / 文档 / 包关系&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】02 · 复杂问题，要先学会「切」</title><link>https://jack-liang.com/blog/dev-first-principles-02-divide-by-responsibility/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-02-divide-by-responsibility/</guid><description>拆分的关键不是行数，是职责。按「它在做几件事」切，而不是按「它有多少行」切。三条判断标准 + 三条红线，把分而治之变成可操作的清单。</description><pubDate>Tue, 08 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列，我想把那些开发里反复应验的规律写下来。不追新概念，只讲那些&amp;quot;早晚会再次撞上&amp;quot;的道理。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：拆分这事，关键不在行数，在职责。&lt;/p&gt;
&lt;p&gt;几百行的对账单，到底怎么拆才不崩？这篇给你三个判断标准（能不能单独测、能不能单独搬过来、能不能一句话讲清楚），再加三条红线（按行数硬切、按时间顺序切、伪拆分）。看完你下次写代码前，就能问对那个问题——&amp;quot;&lt;strong&gt;它是不是其实在做好几件事？&lt;/strong&gt;&amp;quot;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、现象：一次让我印象深刻的&amp;quot;切&amp;quot;&lt;/h2&gt;
&lt;p&gt;我之前接过一个对账单报表，跑了好几年了。&lt;/p&gt;
&lt;p&gt;打开一看，好家伙，几千行代码全堆在一个文件里。几十个 CASE 分支，一个 FORM
五百多行——读数据、格式化、计算、汇总、输出，全揉在一块儿。变量几十个，工作区大家共用，临时内表满天飞。&lt;/p&gt;
&lt;p&gt;你想动它？盯上半天，最后基本都默默关掉 SE38，假装没看见。&lt;/p&gt;
&lt;p&gt;更扎心的是，业务每次提个小需求——&amp;quot;对账单上的客户地址要按主数据走&amp;quot;——我都不敢直接改。原代码那逻辑，简直就是一团毛线，你随手抽一根，谁知道会带出什么来。&lt;/p&gt;
&lt;p&gt;最早期我以为，这事儿的难点是&amp;quot;&lt;strong&gt;行数太多&lt;/strong&gt;&amp;quot;。于是试过硬切——100 行一段，每段塞一个
FORM，完事。&lt;/p&gt;
&lt;p&gt;结果呢？切完之后，FORM
之间全靠全局变量勾着。改一段，另一段就崩。表面上看是切开了，&lt;strong&gt;骨子里还是一坨&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;后来有一次，看一个老同事改这个程序——他把那五百行，&lt;strong&gt;按&amp;quot;它在做几件事&amp;quot;重新切了一刀&lt;/strong&gt;。读数据归读数据，格式化归格式化，计算归计算，输出归输出。每一段都是一个独立的
FORM，&lt;strong&gt;输入是什么、输出是什么，直接写在注释第一行&lt;/strong&gt;。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_GET_VALUE
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; 取字段中的值
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;      --&amp;gt; LT_DATA  输入数据
*&amp;amp;      &amp;lt;-- LV_VALUE 输出值
*&amp;amp;      &amp;lt;-- ES_MESSAGE 输出消息
*&amp;amp;---------------------------------------------------------------------*
FORM frm_get_value  TABLES pt_data
                    CHANGING p_value es_message  TYPE zs_message.
  ...
ENDFORM.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;改完，那团毛线一下变成一条链。每个 FORM 都能单独读、单独测、单独替换。&lt;/p&gt;
&lt;p&gt;那一刻我才反应过来：&lt;strong&gt;拆分的关键不是行数，是职责。&lt;/strong&gt;
行数只是表面，&lt;strong&gt;职责才是真正的边界&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;从那以后，我写任何超过五十行的程序之前，都会先停下来，画个大框架：把一个复杂需求拆成几个小需求。每个小需求，我都会问自己一句——&amp;quot;&lt;strong&gt;它在做几件事？能不能再拆？&lt;/strong&gt;&amp;quot;&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;二、原理：把每个难题分成&amp;quot;可以解决的小块儿&amp;quot;&lt;/h2&gt;
&lt;p&gt;说真的，这不是我悟出来的，是三百年前笛卡尔在《方法论》里就写过的：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;把我所考察的每一个难题，都尽可能地分成细小的部分，直到可以而且适于加以圆满解决的程度为止。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;后人把这条原则叫做&amp;quot;&lt;strong&gt;分而治之&lt;/strong&gt;&amp;quot;（Divide and
Conquer）。它可不只是算法里的归并排序、快排，它是几乎所有复杂问题能被解开的根本方式。&lt;/p&gt;
&lt;p&gt;你可能会问：为什么&amp;quot;按职责&amp;quot;就比&amp;quot;按行数&amp;quot;更本质？&lt;/p&gt;
&lt;p&gt;我跟你说——&lt;/p&gt;
&lt;p&gt;按行数拆，是按&amp;quot;&lt;strong&gt;篇幅&lt;/strong&gt;&amp;quot;切。看上去模块化了，但每段还是在跟别的段共享状态、纠缠逻辑。它只是把一团毛线剪成几段毛线，&lt;strong&gt;根本没解开&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;按职责拆，是按&amp;quot;&lt;strong&gt;它在做几件事&lt;/strong&gt;&amp;quot;切。每个模块只承担一个明确的责任——只读数据、只做计算、只做输出。它的&lt;strong&gt;输入是什么、输出是什么、对外承诺什么&lt;/strong&gt;，都得写清楚。&lt;/p&gt;
&lt;p&gt;这就像咱们工作里，每个人分工明确，互不干扰，各干各的。&lt;/p&gt;
&lt;p&gt;按职责拆，三个判断标准我反复用：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;能不能单独测&lt;/strong&gt;：只给它一组输入，能不能验证输出是对的？&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;能不能单独搬&lt;/strong&gt;：别的程序里也出现这个逻辑，能不能直接拷过去用？&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;能不能一句话讲清&lt;/strong&gt;：能不能用一句话说清楚这模块是干嘛的？&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;三条里面只要有一条不满足，就说明拆得还不够——要么该拆的没拆，要么不该拆的硬拆了。&lt;/p&gt;
&lt;p&gt;还有一个隐藏好处，我特别喜欢：&lt;strong&gt;模块的边界，其实就是思考的边界。&lt;/strong&gt;
一个程序被按职责切完之后，&lt;strong&gt;每个模块的接口就是它对外的全部承诺&lt;/strong&gt;。你写接口的过程，其实是在逼自己想清楚&amp;quot;我到底要什么、我能给什么&amp;quot;。这一步的收获，常常比代码本身还大。&lt;/p&gt;
&lt;p&gt;这思路其实在 SAP
的面向对象开发里早就在用了——先定义类，再定义方法，每个方法都有明确的输入输出，最后才动手写具体逻辑。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;三、呼应：这道理在开发之外，早就被反复验证过&lt;/h2&gt;
&lt;p&gt;医学是&amp;quot;分而治之&amp;quot;做到极致的一个例子。&lt;/p&gt;
&lt;p&gt;医院不是&amp;quot;一个医生看所有病&amp;quot;的吧？它先分内外妇儿，再分亚专科，亚专科里再分专病。一个复杂病例，会被会诊制度拆给不同专科——心脏的问题归心内、感染的问题归感染科、免疫的问题归风湿免疫科。&lt;strong&gt;没人会想做一个&amp;quot;全能医生&amp;quot;&lt;/strong&gt;，因为没人能同时精通所有亚专科的细节。&lt;/p&gt;
&lt;p&gt;分科不是为了&amp;quot;专业化&amp;quot;这种虚名。分科的真正意义是：&lt;strong&gt;让每一类问题有清晰的归属，让每一种知识有积累的容器。&lt;/strong&gt;
这跟软件模块化，其实是同一回事。&lt;/p&gt;
&lt;p&gt;军事上的&amp;quot;&lt;strong&gt;分进合击&lt;/strong&gt;&amp;quot;，也是这个路子。先分，是因为一整团兵力没法对每个局部都做精细判断；合，是因为分完之后还得协同。毛泽东在《论持久战》里讲的&amp;quot;化整为零、化零为整&amp;quot;，本质也是分而治之的运用。&lt;/p&gt;
&lt;p&gt;侦探推理也是这样。福尔摩斯不会一上来就把所有线索混在一起想，他会按维度切——时间线、空间线、动机线、人物关系线——&lt;strong&gt;每一维单独推&lt;/strong&gt;，再交叉验证。&lt;/p&gt;
&lt;p&gt;医学、军事、侦探，三个八竿子打不着的领域，&lt;strong&gt;用着同一个底层动作：把一团混沌，按维度切成几块独立的子问题。&lt;/strong&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;四、实践：把原理变成你桌上的清单&lt;/h2&gt;
&lt;p&gt;落到日常，我把&amp;quot;按职责拆分&amp;quot;做成了一个小清单，每次写之前翻一翻。&lt;/p&gt;
&lt;h3&gt;写程序前（拆分原则）&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;按&amp;quot;它在做几件事&amp;quot;切，别按&amp;quot;它有多少行&amp;quot;切&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;每个模块都写明输入输出&lt;/strong&gt;，写在注释第一行&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;命名就是契约&lt;/strong&gt;：方法名要说清它做什么，别说它怎么做&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;接口稳定，内部可改&lt;/strong&gt;：外部调用的人，不该因为你改实现就崩&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;拆分时（红线与判断）&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;三问&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;只给它一组输入，能不能验证它的输出是对的？（&lt;strong&gt;能单独测&lt;/strong&gt;）&lt;/li&gt;
&lt;li&gt;这逻辑将来会不会在别处出现，能不能直接搬过去？（&lt;strong&gt;能单独复用&lt;/strong&gt;）&lt;/li&gt;
&lt;li&gt;我能不能用一句话讲清这模块是干嘛的？（&lt;strong&gt;能一句话讲清&lt;/strong&gt;）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;红线&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;❌ 按行数硬切（500 行一段，3 段完事）&lt;/li&gt;
&lt;li&gt;❌ 按时间顺序切（第一步、第二步、第三步——&lt;strong&gt;这是流程，不是模块&lt;/strong&gt;）&lt;/li&gt;
&lt;li&gt;❌ 共用全局变量传数据（这是&lt;strong&gt;伪拆分&lt;/strong&gt;）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;写完后（回归检查）&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;找个从没看过这段代码的同事，让他读三分钟，然后问他&amp;quot;这段在干啥&amp;quot;&lt;ul&gt;
&lt;li&gt;如果他讲不清楚 → 模块边界不对，&lt;strong&gt;回去重切&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;找一段逻辑，假装需求要变；&lt;strong&gt;改完它，其他段不动&lt;/strong&gt;能不能跑通&lt;ul&gt;
&lt;li&gt;如果改它必须连带改其他段 → 耦合太高，&lt;strong&gt;职责没分干净&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2&gt;五、小结&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;拆分的关键不是行数，是职责。&lt;/strong&gt; &lt;strong&gt;行数只是表面，职责才是边界。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;说到底，它就教了我们一个朴素的判断：&lt;strong&gt;遇到一团毛线，先问&amp;quot;它在做好几件事&amp;quot;，再决定怎么切&lt;/strong&gt;——而不是先问&amp;quot;它有多少行&amp;quot;。&lt;/p&gt;
&lt;p&gt;下一篇，我想聊&amp;quot;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-03-single-source-of-truth&quot;&gt;为什么一个数据只能有一个源头&lt;/a&gt;&lt;/strong&gt;&amp;quot;。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>【开发第一性原理】01 · 越诡异的 Bug，越可能是低级错误</title><link>https://jack-liang.com/blog/dev-first-principles-01-occams-razor-for-bugs/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-01-occams-razor-for-bugs/</guid><description>奥卡姆剃刀在排障里的应用：诡异的现象背后，往往藏着一个最不起眼的低级错误。先查基础，再查复杂。</description><pubDate>Tue, 01 Sep 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;《开发第一性原理》系列第 1/12 篇 · 上一篇：无 ·
下一篇：&lt;a href=&quot;/blog/dev-first-principles-02-divide-by-responsibility&quot;&gt;02 · 复杂问题，要先学会&amp;quot;切&amp;quot;&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;系列说明&lt;/strong&gt;：这个系列写我在开发里反复验证过的基本规律。不追新概念，只讲那些早晚会再次应验的东西。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;：Bug
越诡异，病根越可能是低级错误。这篇不讲新技巧，只讲一条排查顺序，外加两份清单——排障先查什么，编码少埋什么雷。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;一、先讲一件事&lt;/h2&gt;
&lt;p&gt;有一次，我的一份自开发报表出了问题：金额和业务部门手工核对的结果对不上。差异毫无规律，有时大、有时小，有时干脆是对的。&lt;/p&gt;
&lt;p&gt;我的第一反应，是把&amp;quot;高级&amp;quot;的可能性挨个怀疑了一遍：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;标准表里是不是有脏数据？&lt;/li&gt;
&lt;li&gt;是不是有并发操作，两个人同时改了单据？&lt;/li&gt;
&lt;li&gt;是不是货币汇率换算出了问题？&lt;/li&gt;
&lt;li&gt;甚至一度怀疑是 SAP 标准逻辑本身有 Bug。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;顺着这些方向查了整整一天，一无所获。最后靠单步调试脱困：逐行盯着变量看，发现问题出在一个累加金额的语句上——符号写反了。改完，问题消失，前后不到一分钟。&lt;/p&gt;
&lt;p&gt;查了一整天，改了不到一分钟。这种体验，你应该不陌生。后来我刻意回顾过几次类似的&amp;quot;悬案&amp;quot;，规律相当稳定：现象越不可思议，病根越可能出在最基础的地方。&lt;/p&gt;
&lt;h2&gt;二、为什么诡异的 Bug，原因反而简单&lt;/h2&gt;
&lt;p&gt;先看 Bug
这边。并发冲突、内存溢出、系统缺陷这类复杂问题，往往带着明显的症状——dump、超时、日志报错。它们很吵，反而活不长。低级错误正好相反：符号写反、工作区忘了
CLEAR、SY-SUBRC
没判断……程序不报错也不中断，只是安静地给出错误的结果。安静的错误，才有机会活成悬案。&lt;/p&gt;
&lt;p&gt;再看我们自己。正因为现象&amp;quot;诡异&amp;quot;，潜意识会认定原因也一定&amp;quot;高级&amp;quot;，于是先查并发、查锁、查系统，最后才不甘心地回头检查自己写过的最蠢的那一行。而那一行，恰恰因为看起来&amp;quot;显然没错&amp;quot;，调试时会被直接跳过。&lt;/p&gt;
&lt;p&gt;两头一凑，陷阱就成了：低级错误制造安静的异常，安静的异常又把我们引向复杂的原因。&lt;/p&gt;
&lt;p&gt;所以排查顺序应该倒过来——按错误的常见程度排，而不是按现象的诡异程度排。&lt;/p&gt;
&lt;h2&gt;三、这个道理，医生早就总结过&lt;/h2&gt;
&lt;p&gt;医学诊断里有一条经典原则：听到蹄声，先想马，别想斑马。症状再离奇，医生也会先排查常见病，而不是一上来就怀疑罕见病——症状的离奇，不代表病因的罕见。&lt;/p&gt;
&lt;p&gt;排查 Bug
也是一样：能解释现象的假设有好几个时，先验证最简单的那个——奥卡姆剃刀最实用的场景。复杂现象，绝大多数时候只是一个平凡原因的简单叠加。&lt;/p&gt;
&lt;h2&gt;四、两份清单&lt;/h2&gt;
&lt;p&gt;光有道理没用，我把它拆成了两份清单。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;排障时先查什么（按顺序）：&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;自己刚改的代码&lt;/strong&gt;——改动即嫌疑&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;基础层面&lt;/strong&gt;——数据、配置、符号、类型、前导零、边界值&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;环境差异&lt;/strong&gt;——测试机和生产机的差异、传输是否到位、版本是否一致&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;最后才轮到&lt;/strong&gt;——平台缺陷、标准程序 Bug&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;顺便给自己立条规矩：排障超过两小时毫无头绪，就回头做一次最基础的验证——单步调试，逐行看变量的实际值，不许跳过任何一行&amp;quot;看起来肯定没问题&amp;quot;的代码。那一行往往就是答案。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;编码时少埋什么雷：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;声明即初始化&lt;/strong&gt;。变量和内表声明时给初始值，不依赖隐式行为。经典坑：循环里
APPEND 前忘了 CLEAR，上一次的数据残留在工作区里，现象极其诡异。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;关键判断显式化&lt;/strong&gt;。每个 SELECT、每次调用之后，明确检查 SY-SUBRC，不默认成功。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Code Review
请同事专盯&amp;quot;低级错误&amp;quot;&lt;/strong&gt;。评审者和你一样，也会下意识跳过那些&amp;quot;太简单&amp;quot;的地方——专门找，会发现比预想的多。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;五、写在最后&lt;/h2&gt;
&lt;p&gt;下次再被诡异 Bug 卡住，先别急着怀疑并发和系统，回头看看自己写过的那几行——会
dump、会超时的 Bug 反而好查，安静的错误才有机会活成悬案。&lt;/p&gt;
&lt;p&gt;下一篇聊&amp;quot;复杂问题，要先学会&amp;#39;切&amp;#39;&amp;quot;：遇到一团毛线，怎么切才不伤手。&lt;/p&gt;
&lt;p&gt;（完）&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;系列导览&lt;/h2&gt;
&lt;p&gt;&lt;a href=&quot;/blog/dev-first-principles-intro/&quot;&gt;《开发第一性原理》&lt;/a&gt; 共 12+ 篇，按 4
大主题展开：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;排障方法论&lt;/strong&gt;（01-04）：先查什么 + 在哪查 + 怎么用工具&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;失败处理&lt;/strong&gt;（05-06）：事后保留 + 事前防御&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;开发者测试&lt;/strong&gt;（07）：测到边界&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;信息可被找到&lt;/strong&gt;（08-12）：字面量 / 配置表 / 代码 / 文档 / 包关系&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>《开发第一性原理》系列导览</title><link>https://jack-liang.com/blog/dev-first-principles-intro/</link><guid isPermaLink="true">https://jack-liang.com/blog/dev-first-principles-intro/</guid><description>12+ 篇开发思想，记录经得起反复验证的基本规律。覆盖排障、失败处理、测试、信息可被找到四大主题。</description><pubDate>Sun, 30 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;一句话核心&lt;/strong&gt;：&lt;strong&gt;怎么让开发工作可被维护、可被接手、可被信任&lt;/strong&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;这个系列记录的是我在 SAP/ABAP 开发里反复验证过的基本规律。12+ 篇不是 12
个独立主题，而是一个完整体系的 12 个切面：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;遇到故障——能排；遇到失败——能存；遇到代码——能测；遇到历史——能找到。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;系列目录&lt;/h2&gt;
&lt;h3&gt;排障方法论 · 01-04&lt;/h3&gt;
&lt;p&gt;出了问题怎么排？这 4
篇合起来是一套完整的排障方法论：先查什么、在哪查、怎么定位。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-01-occams-razor-for-bugs&quot;&gt;01 · 越诡异的 Bug，越可能是低级错误&lt;/a&gt;&lt;/strong&gt;
—— 奥卡姆剃刀，先查基础&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-02-divide-by-responsibility&quot;&gt;02 · 复杂问题，要先学会&amp;quot;切&amp;quot;&lt;/a&gt;&lt;/strong&gt;
—— 分而治之，按职责切&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-03-single-source-of-truth&quot;&gt;03 · 为什么一个数据只能有一个源头&lt;/a&gt;&lt;/strong&gt;
—— 单一信息源（SSoT）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-04-binary-search-debugging&quot;&gt;04 · 找不到问题点？把范围砍一半试试&lt;/a&gt;&lt;/strong&gt;
—— 二分定位&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;失败处理 · 05-06&lt;/h3&gt;
&lt;p&gt;失败不可避免，关键是失败信息不被吞掉。05 管&amp;quot;事后保留&amp;quot;，06 管&amp;quot;事前防御&amp;quot;。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-05-friendly-error-messages&quot;&gt;05 · 为什么&amp;quot;友好化&amp;quot;反而害了排障&lt;/a&gt;&lt;/strong&gt;
—— 包装不替换、累加不丢弃，消息链不能断&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-06-boundaries-before-code&quot;&gt;06 · 先定界，再写码&lt;/a&gt;&lt;/strong&gt; ——
和业务把数据边界讲清楚&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;开发者测试 · 07&lt;/h3&gt;
&lt;p&gt;写完的代码怎么测、怎么不埋雷。接过 06 的&amp;quot;想到边界&amp;quot;，讲&amp;quot;测到边界&amp;quot;。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-07-dont-test-with-ideal-data&quot;&gt;07 · 别用理想化数据测&lt;/a&gt;&lt;/strong&gt;
—— 测试通过不等于代码能跑&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;信息可被找到 · 08-12&lt;/h3&gt;
&lt;p&gt;开发完之后，怎么不被埋没。5 篇从微观到宏观层层递进：字面量 → 信息源 → 代码组织 →
文档 → 跨包关系。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-08-magic-numbers&quot;&gt;08 · 魔术数 = 你现在记得，未来的你不记得&lt;/a&gt;&lt;/strong&gt;
—— 字面量抽常量&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;/blog/dev-first-principles-09-config-table-governance&quot;&gt;09 · 配置表泛滥怎么治理&lt;/a&gt;&lt;/strong&gt; —— 配置表不是建完就完，是要被找到的&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;10 · 自我描述的代码&lt;/strong&gt; —— 命名 + 结构 + 职责，让代码自带导航&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;11 · 文档和代码的有机结合&lt;/strong&gt; —— 别让它们各自分裂&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;12 · 包间引用与迁移治理&lt;/strong&gt; —— 让规范不只是文档&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2&gt;怎么读&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;第一次读&lt;/strong&gt;：按 01 → 12 顺序，先把框架建起来。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;赶时间&lt;/strong&gt;：排障看 01 + 04 + 05；写代码看 02 + 06 + 08 + 10 + 12；接手老项目看
09 + 10 + 11 + 12。&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;blockquote&gt;
&lt;p&gt;开发的难度不在写代码本身，而在让代码&lt;strong&gt;可被维护、可被接手、可被信任&lt;/strong&gt;。整个系列回答的，就是这一个问题。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;系列会持续扩展，每新增一篇，本文目录同步更新。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>SAP 开发者的技术风向标：SAP Development Tech Radar 介绍</title><link>https://jack-liang.com/blog/sap-dev-tech-radar-introduce/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-dev-tech-radar-introduce/</guid><description>一个由 SAP 社区维护的 Tech Radar，按 ADOPT / USE / HOLD / STOP 四档对 SAP 技术栈给出推荐级别，帮助 SAP 开发者选型、定位技术方向、识别需要替换的过时技术。</description><pubDate>Tue, 25 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;SAP 社区有一个名为 SAP Development Tech Radar 的项目，用于展示 SAP 技术栈的推荐级别。&lt;/p&gt;
&lt;p&gt;页面地址：&lt;a href=&quot;https://tobiashofmann.github.io/sap-dev-tech-radar/&quot;&gt;https://tobiashofmann.github.io/sap-dev-tech-radar/&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;仓库地址：&lt;a href=&quot;https://github.com/tobiashofmann/sap-dev-tech-radar&quot;&gt;https://github.com/tobiashofmann/sap-dev-tech-radar&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;它把 SAP 技术栈中的技术分为 ADOPT / USE / HOLD / STOP 四档，每个象限内再分为 UI / Technology / Tools / Frameworks 四个象限。每个象限内，技术被分为不同的 ring，每个 ring 对应不同的推荐级别。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/01-public/sap_radar.png&quot; alt=&quot;SAP Development Tech Radar&quot;&gt;&lt;/p&gt;
&lt;p&gt;四个 ring 的含义&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;ADOPT&lt;/strong&gt; —— 新兴、处于稳定与采用阶段的技术&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;USE&lt;/strong&gt; —— 当前推荐使用的稳定技术&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;HOLD&lt;/strong&gt; —— 仅在没有替代方案或被绑定到有 EOL 的产品/服务时使用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;STOP&lt;/strong&gt; —— 已过时，存在继任者并有明确 EOL 日期&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;开发者可以据此判断自己的项目中使用的技术是否符合推荐级别。虽然不是强制的，但是推荐级别是一个很好的参考，可以帮助开发者定位技术方向，避免使用过时的技术。&lt;/p&gt;
&lt;p&gt;作为一个日常开发依然基于 GUI 的开发者，我注意到大部分基于 SAP GUI 的技术都被标记为了 STOP，比如 SM30、SE80、SEGW 等。&lt;/p&gt;
&lt;p&gt;这意味着这些技术已被SAP弃用，不再推荐使用。&lt;/p&gt;
&lt;p&gt;同时我们也能据此知道SAP的的技术演进方向，哪些是SAP主推的，哪些是SAP弃用的。&lt;/p&gt;
&lt;p&gt;我看出的几条战略主线&lt;/p&gt;
&lt;h3&gt;主线 1:SAP 在全力推 BTP + Cloud&lt;/h3&gt;
&lt;p&gt;BTP / Steampunk / Workzone / Cloud ALM / ABAP Cloud / OData v4 全部 ADOPT 或 trend=positive
Neo / XSC / Portal / XSA 全部 STOP 或 deprecated
信号:SAP 不再想让你跑 on-prem,未来要么 BTP 要么 S/4 Cloud&lt;/p&gt;
&lt;h3&gt;主线 2:RAP 是 ABAP 的未来,CDS View Entity 是数据建模的未来&lt;/h3&gt;
&lt;p&gt;RAP managed / RAP unmanaged / RAP managed draft 三档全 USE/ADOPT
CDS View Entity 在 USE,经典 CDS Views 在 HOLD trend=negative
信号:老 ABAP OO + SEGW + 经典 CDS 的项目,这是给老项目的最直接升级路径&lt;/p&gt;
&lt;h3&gt;主线 3:Eclipse ADT + abapGit + VS Code 是新开发栈&lt;/h3&gt;
&lt;p&gt;ADT、abapGit、VS Code、BAS、UI5 CLI 全 USE
SAP GUI / SE80 / SEGW 全 STOP
信号:SAP实质上把 GUI 工作流标 deprecated 了——虽然嘴上不说,但 ring 摆在那里&lt;/p&gt;
&lt;h3&gt;主线 4:FPM 复兴 + Web Components 进 ADOPT&lt;/h3&gt;
&lt;p&gt;FPM 新版(WDA 的现代化继承者)在 ADOPT trend=positive
Web Components 进 ADOPT
信号:SAP 在押注&amp;quot;FPM + 标准 Web Components&amp;quot;作为复杂 UI 的下一代替代品&lt;/p&gt;
&lt;h3&gt;主线 5:Mobile 和 Native SDK 在收缩&lt;/h3&gt;
&lt;p&gt;Mobile Cards HOLD trend=negative
BTP SDK for Android/iOS HOLD
Fiori for Android/iOS(可能是 deprecated路径)
信号:SAP 押注 MDK(Mobile Development Kit)+响应式 Fiori,Native SDK 退潮&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>把SAP接入Agent，让Agent操作SAP</title><link>https://jack-liang.com/blog/connect-sap-to-agent/</link><guid isPermaLink="true">https://jack-liang.com/blog/connect-sap-to-agent/</guid><description>最近做了一个 Skill，接入企业微信机器人之后，可以让 Agent 帮我管理 SAP 的用户账号。写这篇文章分享一下整体思路和实现过程。</description><pubDate>Wed, 12 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;最近做了一个 Skill，接入企业微信机器人之后，可以让 Agent 帮我管理 SAP 的用户账号。写这篇文章分享一下整体思路和实现过程。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/connect-sap-to-agent/p1.jpg&quot; alt=&quot;聊天截屏&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;核心思路很简单：SAP 对外提供操作接口，写一个 Skill 描述接口的用途和参数，最后交给 Agent 来调用。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;传统 SAP 对外暴露接口，常用的是 JCo、Web Service 等方案。这次我用 SAP 的 ICF 功能做了一个 RESTful 接口——这样 Agent 调用 SAP 和调用其他 API 没有区别，不需要额外教它怎么对接，正因如此，如果要进行最小可行性验证，下图中中间的后端服务也是可以省略的。&lt;/p&gt;
&lt;p&gt;为了管理 API Key 和接口权限控制，我在前面加了一层服务端，统一对外提供 API 接口。&lt;/p&gt;
&lt;p&gt;最上层是 Skill 部分，这部分相对简单，主要是把接口能力和参数描述清楚。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/connect-sap-to-agent/p2.jpg&quot; alt=&quot;架构示意&quot;&gt;&lt;/p&gt;
&lt;p&gt;整体架构从上到下可以这样理解：&lt;/p&gt;
&lt;p&gt;越往下层，功能越固定、越精确，通过固定的代码逻辑来实现，提供操作的确定性，&lt;strong&gt;能避免 Agent 操作的随机性&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;越往上层，越靠近用户，表达方式越灵活，用自然语言和 Agent 交互，发挥它的理解和推理能力。&lt;/p&gt;
&lt;p&gt;这样分层的好处是：底层稳、上层活，既利用了 Agent 的自然语言能力，又把关键操作牢牢控制在确定的代码逻辑里。&lt;/p&gt;
&lt;p&gt;需要说明的是：并不是开发一个 SAP 接口就一劳永逸了，不是 Agent 从此就可以做任何操作了。&lt;/p&gt;
&lt;p&gt;基于上面的架构，SAP 依然需要针对具体功能提供明确的接口。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;下面我来分享一下细节。&lt;/p&gt;
&lt;p&gt;在我的上一篇文章中，分享过一个把 SAP 的 Function Module 暴露成 RESTful 的项目（&lt;a href=&quot;/blog/dotABAP-daily-recommendation-abap-fm-json&quot;&gt;abap_fm_json：通过 HTTP 调用 ABAP 函数模块&lt;/a&gt;）。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/connect-sap-to-agent/p3.jpg&quot; alt=&quot;ICF 设置&quot;&gt;&lt;/p&gt;
&lt;p&gt;完成这一步，就实现了 SAP 系统能被外部 Agent 访问的功能。&lt;/p&gt;
&lt;p&gt;为了管理方便和提升安全性，我把 SAP 接口只提供给服务器上的后端服务，只能调用指定的 Function。这一步可以使用SAP 标准的鉴权功能，也可以直接维护一张表，写上哪些用户可以访问什么接口。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/connect-sap-to-agent/p4.jpg&quot; alt=&quot;鉴权&quot;&gt;&lt;/p&gt;
&lt;p&gt;后端我选择使用 TS 开发，它负责鉴权，还有收发报文，做一个看门大爷的角色。就是做一些 API 调用的功能，此处略过。&lt;/p&gt;
&lt;p&gt;至于创建聊天软件上的机器人，这个大家可以参考各家的文档，步骤不多，几分钟就能搞定。也可以使用安装在本地电脑上的 Agent，只要它具备写脚本、调接口的能力就可以。&lt;/p&gt;
&lt;p&gt;本文下面的是视频使用的是腾讯的 WorkBuddy，可以使用我的邀请链接注册：&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;成果展示：&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.zhihu.com/video/2071016294183450211&quot;&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/connect-sap-to-agent/p5.jpg&quot; alt=&quot;使用 workbuddy/Agent 操作 SAP 示例&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;视频演示，可在知乎观看：&lt;a href=&quot;https://www.zhihu.com/video/2071016294183450211&quot;&gt;使用 workbuddy/Agent 操作 SAP 示例&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;视频以官方常用的航班数据为切入点，这个场景本身太友好了——参数少、逻辑简单、出问题也好回滚。&lt;/p&gt;
&lt;p&gt;换成稍微复杂点的操作，比如创建采购订单、修改成本中心，Agent 要理解的业务上下文和参数依赖会指数级增长。需要调用的接口也不少，你这套分层思路在简单场景跑得通，不代表在复杂 SAP 业务里还成立。&lt;/p&gt;
&lt;h2&gt;欢迎您留言和我探讨、指正。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2067700342398138329&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>让你的 SAP GUI 更养眼一些</title><link>https://jack-liang.com/blog/beautify-sap-gui/</link><guid isPermaLink="true">https://jack-liang.com/blog/beautify-sap-gui/</guid><description>很多顾问用了多年的 SAP GUI ，看多了蓝色的主题色，不知道会不会腻。今天就推荐一套我自己的配色。</description><pubDate>Mon, 10 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;很多顾问用了多年的 SAP GUI ，看多了蓝色的主题色，不知道会不会腻。今天就推荐一套我自己的配色。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;MediumAquamarine 中绿宝石色&lt;/p&gt;
&lt;p&gt;首先是选择主题，&lt;code&gt;SAP Signature Theme&lt;/code&gt; 支持自定义颜色。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;主题&lt;/p&gt;
&lt;p&gt;选择主题之后，会出来一个“定义自定义颜色”的选项，默认给了几个颜色，但都不是很好看，我选择&lt;code&gt;SAP Green&lt;/code&gt;，然后在下方将色度偏移值往左拉，改为&lt;code&gt;-56&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;这样就完成了配色。重启后可以生效。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;主题色&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;SE11&lt;/p&gt;
&lt;p&gt;进入其他页面也能有一个较好的呈现。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;如果你是一个 ABAPer，需要经常编辑代码，就可能还想改改编辑器。&lt;/p&gt;
&lt;p&gt;这里推荐一个 Github 仓库：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p5.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;编辑器主题&lt;/p&gt;
&lt;p&gt;你可以选一个自己喜欢的，替换程序中自带的配置文件即可。&lt;/p&gt;
&lt;p&gt;以 &lt;code&gt;dracula theme&lt;/code&gt; 为例，进入主题文件夹后，下载名为 &lt;code&gt;abap-spec.xml&lt;/code&gt;的文件。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p6.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;abap-spec.xml 文件&lt;/p&gt;
&lt;p&gt;找到本地的配置位置，通常的目录是&lt;code&gt;%APPDATA%\SAP\SAP GUI\ABAP Editor\&lt;/code&gt;， 在文件资源管理器的地址栏中直接粘贴并回车即可到达。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p7.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;文件位置&lt;/p&gt;
&lt;p&gt;这里的第二个文件就是，可以直接替换，不过建议把原来文件备份一下，免得想换回来又找不到原文件。&lt;/p&gt;
&lt;p&gt;完成这一步之后，重启 GUI 就大功告成了。代码界面相当漂亮。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p8.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;成果展示&lt;/p&gt;
&lt;p&gt;如果对一些点不喜欢，也可以手动在编辑器中修改，也就是上图右下角的图标，NUM 右边那个。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p9.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;自定义配色&lt;/p&gt;
&lt;p&gt;这里可以对每一项做定制，如果你配出好看的主题，也欢迎共享到上文中提到的 github 仓库。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;登录首页的蓝色水滴主题照片，也许你也不喜欢。&lt;/p&gt;
&lt;p&gt;没问题，在菜单中选择“附加-&amp;gt;设置”，在弹出的框中选择“不显示图片”，确认即可。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p10.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;设置&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p11.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;设置&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;如果你不怕被同事骂，也可以尝试改一下首页的图片，甚至改成网页。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p12.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;右边改成了网页&lt;/p&gt;
&lt;p&gt;这个功能只需要在 SM30 维护 SSM_CUST 视图：&lt;/p&gt;
&lt;h2&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/beautify-sap-gui/p13.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1890382780053042321&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>给 SAP 开一扇 HTTP 小门：一个 curl 就能让 AI 调任意 BAPI</title><link>https://jack-liang.com/blog/sap-http-door-for-ai/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-http-door-for-ai/</guid><description>我最近新写的开源项目 rust_sap_rfc —— 用 Rust 标准库 FFI 直连 SAP NWRFC SDK，把它包装成一个常驻的 HTTP 服务，提供通用 /api/rfc 端点调用任意 RFC/BAPI，并附带 5 个面向 AI 的元数据查询 API，让 Python / Node / Java / AI Agent 都能不安装 SAP 客户端直接调 SAP。</description><pubDate>Sat, 08 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;我让 AI 直接去 SAP 里查了一下有哪些用户。&lt;/p&gt;
&lt;p&gt;&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot;&gt;没有写一行代码，没有装任何 SAP 客户端，甚至我都没告诉它该调哪个函数&lt;/Notation&gt;。它自己搜、自己查文档、自己调用，然后把结果整理成了自然语言。&lt;/p&gt;
&lt;p&gt;这是怎么做到的？&lt;/p&gt;
&lt;p&gt;先看效果，再说原理。&lt;/p&gt;
&lt;h1&gt;先看效果：AI 自己搞定 SAP&lt;/h1&gt;
&lt;p&gt;我跟 Agent 说了一句话：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;帮我看看 SAP 系统里有哪些用户，列出来。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;然后它自己干了这几件事：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;先去搜索有哪些跟&amp;quot;用户&amp;quot;相关的 BAPI 函数&lt;/li&gt;
&lt;li&gt;找到 &lt;code&gt;BAPI_USER_GETLIST&lt;/code&gt;，查它的接口定义和文档&lt;/li&gt;
&lt;li&gt;搞清楚输入参数怎么传、输出表有哪些字段&lt;/li&gt;
&lt;li&gt;发起调用，拿到结果&lt;/li&gt;
&lt;li&gt;把返回的 JSON 整理成人类能读的列表&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;全程我没有介入，也没有提前给它任何 SAP 知识。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/rust-sap-rfc-gateway/p1.gif&quot; alt=&quot;Agent 对话全过程&quot;&gt;&lt;/p&gt;
&lt;p&gt;这背后就是我最近做的开源项目 &lt;code&gt;rust_sap_rfc&lt;/code&gt;。说穿了很简单：把 SAP NWRFC SDK
整个封进一个 Rust 服务里，外面只留 HTTP 端点和一组元数据
API。任何语言、任何工具、任何 AI Agent，只要会发 POST 请求，就能直接调 SAP。&lt;/p&gt;
&lt;h1&gt;一个 curl 就能调任意 BAPI&lt;/h1&gt;
&lt;p&gt;&lt;Notation type=&quot;underline&quot; color=&quot;#ef4444&quot; animationDelay={200}&gt;对于普通开发者来说&lt;/Notation&gt;，调用方式也非常简单：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;curl -X POST http://localhost:3000/api/rfc \
  -H &amp;quot;Content-Type: application/json&amp;quot; \
  -d &amp;#39;{
    &amp;quot;func_name&amp;quot;: &amp;quot;BAPI_USER_GETLIST&amp;quot;,
    &amp;quot;inputs&amp;quot;: { &amp;quot;MAX_ROWS&amp;quot;: 50, &amp;quot;WITH_USERNAME&amp;quot;: &amp;quot;X&amp;quot; },
    &amp;quot;table_outputs&amp;quot;: {
      &amp;quot;USERLIST&amp;quot;: [
        {&amp;quot;name&amp;quot;: &amp;quot;USERNAME&amp;quot;},
        {&amp;quot;name&amp;quot;: &amp;quot;FIRSTNAME&amp;quot;},
        {&amp;quot;name&amp;quot;: &amp;quot;LASTNAME&amp;quot;}
      ]
    }
  }&amp;#39;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;返回就是标准 JSON，直接能用。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/rust-sap-rfc-gateway/p2.png&quot; alt=&quot;curl 调用 + 返回结果&quot;&gt;&lt;/p&gt;
&lt;p&gt;一个 /api/rfc 接口全部搞定，&lt;Notation type=&quot;highlight&quot; color=&quot;#86efac&quot; animationDelay={400}&gt;不用为每个 BAPI 写适配代码，加新函数不用发版本，换个
SAP 系统也不用重新适配&lt;/Notation&gt;。&lt;/p&gt;
&lt;p&gt;调用方&lt;Notation type=&quot;box&quot; color=&quot;#3b82f6&quot; animationDelay={600}&gt;零 SAP 依赖、零 RFC 概念负担&lt;/Notation&gt;。Python 用 requests、Node 用
fetch、甚至直接用 curl 都行。&lt;/p&gt;
&lt;h1&gt;给 AI 的&amp;quot;导航系统&amp;quot;&lt;/h1&gt;
&lt;p&gt;如果只是把 RFC 包成 HTTP，那这事还不够好玩。真正的关键是——我专门为 AI Agent
设计了 5 个元数据端点。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/rust-sap-rfc-gateway/p6.jpeg&quot; alt=&quot;欢迎页&quot;&gt;&lt;/p&gt;
&lt;p&gt;AI 调用 SAP 的最大障碍，不是&amp;quot;不会调&amp;quot;，而是&lt;Notation type=&quot;highlight&quot; color=&quot;#fbbf24&quot; animationDelay={400}&gt;&amp;quot;不知道调什么&amp;quot;&lt;/Notation&gt;。SAP
系统里上万个函数，Agent 怎么知道哪个是干什么的？&lt;/p&gt;
&lt;p&gt;只要把上图的链接修改 AI。&lt;/p&gt;
&lt;p&gt;他将根据这 5 个端点自助构建导航系统：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;搜索函数：按通配符搜，比如 &lt;code&gt;BAPI_USER_*&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;查接口定义：参数名、类型、方向、嵌套结构&lt;/li&gt;
&lt;li&gt;查文档：短文本 + SE37 长文档 + 参数说明&lt;/li&gt;
&lt;li&gt;查 DDIC 结构：表和结构的字段定义&lt;/li&gt;
&lt;li&gt;查字段语义：数据元素、域、固定值&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;标准工作流就是：&lt;Notation type=&quot;box&quot; color=&quot;#8b5cf6&quot; animationDelay={600}&gt;搜索 → 查接口 → 查文档 → 调用&lt;/Notation&gt;。Agent
完全自服务，不需要人告诉它该调哪个函数。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/rust-sap-rfc-gateway/p3.png&quot; alt=&quot;元数据端点返回样例&quot;&gt;&lt;/p&gt;
&lt;p&gt;这才是把 SAP 从&amp;quot;只有人能用的系统&amp;quot;变成&lt;Notation type=&quot;circle&quot; color=&quot;#10b981&quot; animationDelay={800}&gt;&amp;quot;AI 能用的系统&amp;quot;&lt;/Notation&gt;的关键一步。&lt;/p&gt;
&lt;h1&gt;传统 SAP 集成的卡点&lt;/h1&gt;
&lt;p&gt;说回为什么要做这个项目。做 SAP 的人大概都有过这种体验：想让外部系统调一下 SAP
里的函数，光前置工作就能折腾好几天。&lt;/p&gt;
&lt;p&gt;不管你用 Python、Java 还是 Node.js，接入 SAP 的套路基本一样：先装 SAP NWRFC
SDK（私有 C 库，受版权限制不能随便分发），再引入对应语言的 binding，然后为每个
BAPI 手写参数描述——参数名、类型、字段长度，错一个就报错。&lt;/p&gt;
&lt;p&gt;痛点很实在：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;每种语言各来一遍&lt;/strong&gt;：Python 有 PyRFC，Node 有 node-rfc，Java 有
JCo……换个语言等于重新踩一遍坑&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;每个 BAPI 都要写适配&lt;/strong&gt;：上万个函数，根本写不完&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;部署麻烦&lt;/strong&gt;：每台机器都得装 SAP SDK，CI 镜像里也得塞&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;AI 根本用不了&lt;/strong&gt;：Agent 想自己找函数、自己调函数？门都没有&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这些问题的根源其实是&lt;Notation type=&quot;underline&quot; color=&quot;#ef4444&quot; animationDelay={1000}&gt;同一个：SAP
的协议绑定和业务逻辑混在一起了&lt;/Notation&gt;。每换一个语言、每加一个函数，都得重新做一遍&amp;quot;翻译&amp;quot;工作。&lt;/p&gt;
&lt;h1&gt;我的解法：把 SDK 封装起来，外面全用 HTTP&lt;/h1&gt;
&lt;p&gt;&lt;code&gt;rust_sap_rfc&lt;/code&gt; 的思路说穿了很简单：把 SAP SDK 整个隔离在一个 Rust
服务里，外面只留 HTTP + JSON。&lt;/p&gt;
&lt;p&gt;SAP
协议绑定、连接池、字符集处理、参数描述，全部由这一个服务承担。外面任何语言、任何工具、任何
AI Agent，只要会发 POST，就能调 SAP。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/rust-sap-rfc-gateway/p4.png&quot; alt=&quot;适配多种语言&quot;&gt;&lt;/p&gt;
&lt;p&gt;为什么选 Rust？三个原因：&lt;/p&gt;
&lt;p&gt;第一，FFI 是一等公民。&lt;code&gt;extern &amp;quot;C&amp;quot;&lt;/code&gt; 直接调 SAP C SDK，几乎零开销。Python 或
Node.js 做这种程度的 FFI 绑定，要么性能差，要么胶水代码一大堆。&lt;/p&gt;
&lt;p&gt;第二，异步和连接池天然契合。tokio + axum 处理&amp;quot;长连接 +
高并发请求&amp;quot;的网关场景，非常顺手。&lt;/p&gt;
&lt;p&gt;第三，单文件二进制部署。编译出来就是一个可执行文件，扔 Docker 镜像里干干净净。&lt;/p&gt;
&lt;h1&gt;这件事背后的方法论&lt;/h1&gt;
&lt;p&gt;从这个项目里抽出来的思路，其实可以复用到很多场景：&lt;/p&gt;
&lt;p&gt;把昂贵的、平台依赖的、版权受限的东西隔离在单一服务里，外部用最通用的协议通信。
这是第一层。&lt;/p&gt;
&lt;p&gt;用运行时内省加缓存，替代代码生成和编译时绑定，维护成本会低一个数量级。
这是第二层。&lt;/p&gt;
&lt;p&gt;如果你的系统要给 AI 用，&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot; animationDelay={1400}&gt;元数据 API 不是锦上添花，是必需品&lt;/Notation&gt;。 AI
需要自己探索、自己理解、自己调用——你不能指望它像人一样先读三个月文档。&lt;/p&gt;
&lt;p&gt;SAP 圈子里有个老笑话：&amp;quot;SAP 什么都能做，但什么都不好做。&amp;quot;
我做这个项目的初衷，就是想让它稍微好做一点——至少，让一个刚接触的新人不用先花一周搭环境，让一个
AI Agent 不用先学半年 ABAP 才能上手。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/rust-sap-rfc-gateway/p5.png&quot; alt=&quot;项目 GitHub 截图&quot;&gt;&lt;/p&gt;
&lt;p&gt;如果你也在折腾 SAP 和 AI 的结合，欢迎来聊聊。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>使用 Rough Notation 创建手绘风格的文本注释</title><link>https://jack-liang.com/blog/rough-notation-hand-drawn-annotations/</link><guid isPermaLink="true">https://jack-liang.com/blog/rough-notation-hand-drawn-annotations/</guid><description>在网页中添加手绘风格的标注和注释，可以让内容更加生动有趣。本文介绍如何在 Astro 项目中使用 Rough Notation 库创建各种手绘注释效果。</description><pubDate>Sun, 19 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;在现代网页设计中，文本注释和高亮是提升内容可读性和视觉吸引力的重要手段。传统的文本高亮通常是规整的矩形色块，而 &lt;strong&gt;Rough Notation&lt;/strong&gt; 库为我们带来了一种全新的手绘风格注释方式。&lt;/p&gt;
&lt;h2&gt;什么是 Rough Notation？&lt;/h2&gt;
&lt;p&gt;&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot; animationDelay={200}&gt;Rough Notation&lt;/Notation&gt; 是一个轻量级的 JavaScript 库，它可以在网页上创建手绘风格的文本注释。与传统的精确几何图形不同，Rough Notation 使用不规则的线条和形状，模拟真实手绘的效果，让你的网页内容更加生动有趣。&lt;/p&gt;
&lt;h2&gt;支持的注释类型&lt;/h2&gt;
&lt;p&gt;Rough Notation 提供了多种注释样式，可以满足不同场景的需求：&lt;/p&gt;
&lt;h3&gt;Underline（下划线）&lt;/h3&gt;
&lt;p&gt;在文本下方绘制一条不规则的下划线，适合强调关键词。&lt;/p&gt;
&lt;p&gt;示例：&lt;Notation type=&quot;underline&quot; color=&quot;#ef4444&quot; animationDelay={400}&gt;这段文字带有下划线&lt;/Notation&gt;&lt;/p&gt;
&lt;h3&gt;Box（方框）&lt;/h3&gt;
&lt;p&gt;用方框包围文本，适合突出重要内容或引用。&lt;/p&gt;
&lt;p&gt;示例：&lt;Notation type=&quot;box&quot; color=&quot;#3b82f6&quot; animationDelay={600}&gt;这段文字被方框包围&lt;/Notation&gt;&lt;/p&gt;
&lt;h3&gt;Circle（圆圈）&lt;/h3&gt;
&lt;p&gt;用圆圈包围文本，适合标记重点或需要特别注意的内容。&lt;/p&gt;
&lt;p&gt;示例：&lt;Notation type=&quot;circle&quot; color=&quot;#10b981&quot; animationDelay={800}&gt;这段文字被圆圈标记&lt;/Notation&gt;&lt;/p&gt;
&lt;h3&gt;Highlight（高亮）&lt;/h3&gt;
&lt;p&gt;类似于荧光笔的效果，在文本下方添加高亮背景。&lt;/p&gt;
&lt;p&gt;示例：&lt;Notation type=&quot;highlight&quot; color=&quot;#fbbf24&quot; animationDelay={1000}&gt;这段文字被高亮显示&lt;/Notation&gt;&lt;/p&gt;
&lt;h3&gt;Strike-through（删除线）&lt;/h3&gt;
&lt;p&gt;在文本中间绘制一条穿过线，表示删除或不再适用的内容。&lt;/p&gt;
&lt;p&gt;示例：&lt;Notation type=&quot;strike-through&quot; color=&quot;#6b7280&quot; animationDelay={1200}&gt;这段文字已删除&lt;/Notation&gt;&lt;/p&gt;
&lt;h3&gt;Crossed-off（划掉）&lt;/h3&gt;
&lt;p&gt;用 X 形标记划掉文本，比删除线更加醒目。&lt;/p&gt;
&lt;p&gt;示例：&lt;Notation type=&quot;crossed-off&quot; color=&quot;#ef4444&quot; animationDelay={1400}&gt;这段文字被划掉&lt;/Notation&gt;&lt;/p&gt;
&lt;h3&gt;Bracket（括号）&lt;/h3&gt;
&lt;p&gt;在文本两侧添加括号，适合注释或补充说明。&lt;/p&gt;
&lt;p&gt;示例：&amp;lt;Notation type=&amp;quot;bracket&amp;quot; color=&amp;quot;#8b5cf6&amp;quot; animationDelay={1600} brackets={[&amp;#39;left&amp;#39;, &amp;#39;right&amp;#39;]}&amp;gt;这段文字带有括号注释&lt;/Notation&gt;&lt;/p&gt;
&lt;h2&gt;在 Astro 项目中使用&lt;/h2&gt;
&lt;p&gt;为了方便在 Astro 项目中使用 Rough Notation，我创建了一个封装好的 &lt;code&gt;Notation&lt;/code&gt; 组件。&lt;/p&gt;
&lt;h3&gt;基本用法&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-astro&quot;&gt;---

---

&amp;lt;Notation type=&amp;quot;highlight&amp;quot; color=&amp;quot;#fef08a&amp;quot;&amp;gt;
  这段文本会被高亮显示
&amp;lt;/Notation&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;自定义参数&lt;/h3&gt;
&lt;p&gt;组件支持丰富的自定义参数：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-astro&quot;&gt;&amp;lt;Notation type=&amp;quot;box&amp;quot; color=&amp;quot;#ef4444&amp;quot; animate={true} animationDuration={1000} animationDelay={500} padding={10} strokeWidth={3}&amp;gt;
  带自定义参数的方框注释
&amp;lt;/Notation&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;参数说明&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;参数&lt;/th&gt;
&lt;th&gt;类型&lt;/th&gt;
&lt;th&gt;默认值&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;type&lt;/td&gt;
&lt;td&gt;string&lt;/td&gt;
&lt;td&gt;必填&lt;/td&gt;
&lt;td&gt;注释类型&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;color&lt;/td&gt;
&lt;td&gt;string&lt;/td&gt;
&lt;td&gt;#000000&lt;/td&gt;
&lt;td&gt;注释颜色&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;animate&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;true&lt;/td&gt;
&lt;td&gt;是否启用动画&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;animationDuration&lt;/td&gt;
&lt;td&gt;number&lt;/td&gt;
&lt;td&gt;800&lt;/td&gt;
&lt;td&gt;动画持续时间（毫秒）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;animationDelay&lt;/td&gt;
&lt;td&gt;number&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;td&gt;动画延迟时间（毫秒）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;animationIteration&lt;/td&gt;
&lt;td&gt;number&lt;/td&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;动画重复次数&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;padding&lt;/td&gt;
&lt;td&gt;number/array&lt;/td&gt;
&lt;td&gt;5&lt;/td&gt;
&lt;td&gt;内边距&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;strokeWidth&lt;/td&gt;
&lt;td&gt;number&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;线条宽度&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;multiline&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;false&lt;/td&gt;
&lt;td&gt;是否支持多行文本&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;iterations&lt;/td&gt;
&lt;td&gt;number&lt;/td&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;绘制迭代次数&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;show&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;true&lt;/td&gt;
&lt;td&gt;是否自动显示&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;brackets&lt;/td&gt;
&lt;td&gt;string[]&lt;/td&gt;
&lt;td&gt;[&amp;#39;right&amp;#39;]&lt;/td&gt;
&lt;td&gt;bracket 类型专用，指定括号位置，可选值：left, right, top, bottom&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h2&gt;实际应用示例&lt;/h2&gt;
&lt;h3&gt;示例一：高亮关键词&lt;/h3&gt;
&lt;p&gt;&lt;Notation type=&quot;highlight&quot; color=&quot;#fef08a&quot; animationDelay={1800}&gt;在文章中高亮重要的关键词&lt;/Notation&gt;，让读者更容易抓住重点。&lt;/p&gt;
&lt;h3&gt;示例二：注释说明&lt;/h3&gt;
&lt;p&gt;使用括号注释对专业术语进行解释说明：&amp;lt;Notation type=&amp;quot;bracket&amp;quot; color=&amp;quot;#8b5cf6&amp;quot; animationDelay={2000} brackets={[&amp;#39;left&amp;#39;, &amp;#39;right&amp;#39;]}&amp;gt;这是一个专业术语&lt;/Notation&gt;。&lt;/p&gt;
&lt;h3&gt;示例三：强调重点&lt;/h3&gt;
&lt;p&gt;使用圆圈或方框强调需要特别注意的内容：&lt;Notation type=&quot;circle&quot; color=&quot;#ef4444&quot; animationDelay={2200}&gt;重要提示&lt;/Notation&gt;。&lt;/p&gt;
&lt;h3&gt;示例四：动态演示&lt;/h3&gt;
&lt;p&gt;通过动画效果逐步展示内容，增强用户体验。可以看到上面的示例都有不同的动画延迟，形成了依次展示的效果。&lt;/p&gt;
&lt;h2&gt;总结&lt;/h2&gt;
&lt;p&gt;&lt;Notation type=&quot;box&quot; color=&quot;#06b6d4&quot; animationDelay={2400}&gt;Rough Notation&lt;/Notation&gt; 是一个非常有趣的前端库，它为网页内容增添了独特的手绘风格。无论是在博客文章、演示文稿还是产品介绍中，使用手绘注释都能让内容更加生动、更具吸引力。&lt;/p&gt;
&lt;p&gt;在 Astro 项目中，通过封装的 &lt;code&gt;Notation&lt;/code&gt; 组件，可以轻松地在任何页面中使用这些手绘注释效果，无需复杂的配置和代码编写。&lt;/p&gt;
&lt;p&gt;如果你想在自己的项目中尝试这种有趣的效果，可以参考官方文档 &lt;a href=&quot;https://roughnotation.com/&quot;&gt;https://roughnotation.com/&lt;/a&gt; 获取更多信息。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>abap_fm_json 深度剖析：如何通过 HTTP 调用 ABAP Function</title><link>https://jack-liang.com/blog/abap-fm-json-in-depth-analysis/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-fm-json-in-depth-analysis/</guid><description>本文深入剖析 abap_fm_json 项目，从路由解析、动态参数构建、双通道输入映射、HTTP 调用执行、隐式契约设计到输出序列化，完整拆解其将 ABAP 函数模块暴露为 HTTP 服务的架构方案与核心实现。</description><pubDate>Fri, 10 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;这不是一篇关于 JSON 的文章。JSON 只是输出格式。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;先抛出一个问题：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;怎么把 ABAP 函数模块通过 HTTP 暴露出去，让外部系统可以调用？&lt;/p&gt;
&lt;p&gt;一个 ABAP 函数模块，有 IMPORT / EXPORT / CHANGING / TABLES
四种参数，参数类型可以是任意结构体、内表、深层嵌套。&lt;/p&gt;
&lt;p&gt;怎么动态调用不同的函数模块？怎么设计通用的传参方式？&lt;/p&gt;
&lt;p&gt;abap_fm_json
给出了一套完整、轻量的架构方案。我在&lt;a href=&quot;/blog/dotabap-daily-recommendation-abap-fm-json/&quot;&gt;上一篇文章&lt;/a&gt;中介绍了它的使用方法。本篇咱们来深入代码拆解它每一步的设计决策与实现。&lt;/p&gt;
&lt;hr&gt;
&lt;!-- Start of Selection --&gt;&lt;h2&gt;目录&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href=&quot;#%E9%A1%B9%E7%9B%AE%E5%9F%BA%E6%9C%AC%E4%BF%A1%E6%81%AF&quot;&gt;项目基本信息&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E6%A5%94%E5%AD%90%E4%B8%80%E6%9D%A1-url&quot;&gt;楔子：一条 URL&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%9B%9B%E4%B8%AA%E9%9C%80%E8%A6%81%E8%A7%A3%E5%86%B3%E7%9A%84%E9%97%AE%E9%A2%98&quot;&gt;四个需要解决的问题&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%B8%80%E8%B7%AF%E7%94%B1%E4%BB%8E-url-%E5%88%B0-function-name&quot;&gt;一、路由：从 URL 到 Function Name&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#%E6%A0%87%E5%87%86%E5%85%A5%E5%8F%A3&quot;&gt;标准入口&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#url-%E8%A7%A3%E6%9E%90&quot;&gt;URL 解析&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4-fm-%E7%9A%84%E4%BF%AE%E5%A4%8D&quot;&gt;命名空间 FM 的修复&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E8%B7%AF%E7%94%B1%E5%B0%8F%E7%BB%93&quot;&gt;路由小结&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%BA%8Cbuild_params%E5%8A%A8%E6%80%81%E8%B0%83%E7%94%A8%E4%B9%8B%E5%9F%BA&quot;&gt;二、BUILD_PARAMS：动态调用之基&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#%E6%A0%B8%E5%BF%83%E9%97%AE%E9%A2%98&quot;&gt;核心问题&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E7%AC%AC%E4%B8%80%E6%AD%A5%E8%8E%B7%E5%8F%96-fm-%E7%9A%84%E5%85%83%E6%95%B0%E6%8D%AE&quot;&gt;第一步：获取 FM 的元数据&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E7%AC%AC%E4%BA%8C%E6%AD%A5%E5%8A%A8%E6%80%81%E6%9E%84%E9%80%A0%E6%95%B0%E6%8D%AE%E5%AF%B9%E8%B1%A1&quot;&gt;第二步：动态构造数据对象&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%8F%82%E6%95%B0%E7%B1%BB%E5%88%AB%E7%9A%84%E5%8F%8D%E5%90%91%E6%98%A0%E5%B0%84&quot;&gt;参数类别的反向映射&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E9%BB%98%E8%AE%A4%E5%80%BC%E5%A4%84%E7%90%86%E7%9A%84%E5%B7%A7%E6%80%9D&quot;&gt;默认值处理的巧思&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%BA%A7%E7%89%A9%E4%B8%89%E4%BB%B6%E5%A5%97&quot;&gt;产物：三件套&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%B0%8F%E7%BB%93&quot;&gt;小结&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%B8%89%E5%8F%8C%E9%80%9A%E9%81%93%E8%BE%93%E5%85%A5%E6%98%A0%E5%B0%84&quot;&gt;三、双通道输入映射&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#%E6%A0%B8%E5%BF%83%E9%97%AE%E9%A2%98-1&quot;&gt;核心问题&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#-get-query-string--%E6%89%8B%E5%B7%A5%E6%8B%BC-json&quot;&gt;① GET query string → 手工拼 JSON&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#-post-body--%E5%8E%9F%E5%A7%8B-json-%E5%AD%97%E7%AC%A6%E4%B8%B2&quot;&gt;② POST body → 原始 JSON 字符串&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#-%E6%B1%87%E5%90%88json_deserialize&quot;&gt;③ 汇合：JSON_DESERIALIZE&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%85%B3%E4%BA%8E%E9%82%A3%E4%B8%AA-kind-ne-abap_func_importing-%E6%9D%A1%E4%BB%B6&quot;&gt;关于那个 &lt;code&gt;kind ne abap_func_importing&lt;/code&gt; 条件&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%AE%8C%E6%95%B4%E8%BE%93%E5%85%A5%E6%98%A0%E5%B0%84%E9%93%BE%E8%B7%AF&quot;&gt;完整输入映射链路&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%9B%9B%E8%B0%83%E7%94%A8%E6%89%A7%E8%A1%8C&quot;&gt;四、调用执行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%BA%94%E9%9A%90%E5%BC%8F%E5%A5%91%E7%BA%A6_icf_data&quot;&gt;五、隐式契约：_ICF_DATA&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#%E9%97%AE%E9%A2%98&quot;&gt;问题&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E8%A7%A3%E6%B3%95&quot;&gt;解法&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E8%AF%84%E4%BB%B7&quot;&gt;评价&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%85%AD%E8%BE%93%E5%87%BA%E5%BA%8F%E5%88%97%E5%8C%96&quot;&gt;六、输出序列化&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%B8%BB%E6%B5%81%E7%A8%8B&quot;&gt;主流程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E9%80%92%E5%BD%92%E5%BA%8F%E5%88%97%E5%8C%96%E7%9A%84%E9%AA%A8%E6%9E%B6&quot;&gt;递归序列化的骨架&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E6%A0%87%E9%87%8F%E7%B1%BB%E5%9E%8B%E5%A4%84%E7%90%86&quot;&gt;标量类型处理&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%91%BD%E5%90%8D%E6%8E%A7%E5%88%B6&quot;&gt;命名控制&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%8F%8C%E6%A8%A1%E5%BC%8F%E8%AE%BE%E8%AE%A1%E7%BA%AF-abap-vs-%E5%86%85%E7%BD%AE-transformation&quot;&gt;双模式设计：纯 ABAP vs 内置 Transformation&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%B8%83%E8%B7%AF%E7%94%B1%E5%9B%9E%E9%A1%BE&quot;&gt;七、路由回顾&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%85%AB%E5%AE%89%E5%85%A8&quot;&gt;八、安全&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#%E4%B9%9D%E6%80%BB%E7%BB%93&quot;&gt;九、总结&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;!-- End of Selection --&gt;&lt;hr&gt;
&lt;h2&gt;项目基本信息&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;维度&lt;/th&gt;
&lt;th&gt;数据&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;仓库地址&lt;/td&gt;
&lt;td&gt;&lt;a href=&quot;https://github.com/cesar-sap/abap_fm_json&quot;&gt;https://github.com/cesar-sap/abap_fm_json&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;作者&lt;/td&gt;
&lt;td&gt;César Martín&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;首次发布&lt;/td&gt;
&lt;td&gt;2013-03-05 (SCN Blog)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;最后更新&lt;/td&gt;
&lt;td&gt;2021-04-30 (commit 6971a36)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;代码量&lt;/td&gt;
&lt;td&gt;~2486 行，单类 &lt;code&gt;ZCL_JSON_HANDLER&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GitHub&lt;/td&gt;
&lt;td&gt;119 Stars / 38 Forks&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;许可证&lt;/td&gt;
&lt;td&gt;Apache 2.0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;部署方式&lt;/td&gt;
&lt;td&gt;abapGit / SAPLink / Transport 三种&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h2&gt;楔子：一条 URL&lt;/h2&gt;
&lt;p&gt;假设你在浏览器里输入这样一条地址：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;http://your-sap-server:8000/fmcall/BAPI_USER_GET_DETAIL?USERNAME=JACK
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;返回：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-json&quot;&gt;{
  &amp;quot;ADDRESS&amp;quot;: {
    &amp;quot;CITY&amp;quot;: &amp;quot;Shanghai&amp;quot;,
    &amp;quot;COUNTRY&amp;quot;: &amp;quot;CN&amp;quot;,
    &amp;quot;E_MAIL&amp;quot;: &amp;quot;jack@example.com&amp;quot;
  },
  &amp;quot;RETURN&amp;quot;: []
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;没有 OData，没有 SOAP，没有 SAP Gateway。就一条 URL，直接调用了 ABAP 后端的 FM。&lt;/p&gt;
&lt;p&gt;这就是 abap_fm_json 做的事。它的核心不是 JSON——那个 JSON
输出只是最终结果呈现的一种格式。它真正做的是：&lt;strong&gt;把 ABAP 函数模块（Function
Module）桥接到了 HTTP 世界&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;所以或许这个项目应该改名叫 abap_fm_http，甚至不必局限于 FM，还可以是类。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;四个需要解决的问题&lt;/h2&gt;
&lt;p&gt;要把一个 FM 通过 HTTP 暴露出去，必须解决四个问题：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;#&lt;/th&gt;
&lt;th&gt;问题&lt;/th&gt;
&lt;th&gt;描述&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;路由&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;URL 怎么对应到具体的 FM？&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;参数映射&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;HTTP 请求里的数据（query string + body），怎么塞进 FM 的参数结构？&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;动态调用&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;FM 名称是动态传入的，写代码时不知道 FM 的参数，怎么 CALL？&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;结果返回&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;FM 执行完了，EXPORT / CHANGING / TABLES 结果怎么写成 HTTP 响应？&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;解决了这四个问题，就能把 FM 暴露成 http 服务了。&lt;/p&gt;
&lt;p&gt;abap_fm_json 的解决方案浓缩在一份 2486
行的单类实现中——&lt;a href=&quot;https://github.com/cesar-sap/abap_fm_json/blob/master/src/zcl_json_handler.clas.abap&quot;&gt;ZCL_JSON_HANDLER&lt;/a&gt;。本文按照&amp;quot;一条请求的生命周期&amp;quot;，逐个拆解每个环节的代码与设计决策。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;一、路由：从 URL 到 Function Name&lt;/h2&gt;
&lt;h3&gt;标准入口&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;IF_HTTP_EXTENSION~HANDLE_REQUEST&lt;/code&gt; 是 SAP ICF（Internet Communication
Framework）的标准接口。在事务码 SICF 中创建一个服务节点，把 &lt;code&gt;ZCL_JSON_HANDLER&lt;/code&gt;
注册为 Handler List 的第一入口，所有匹配的 HTTP 请求就会被路由到这里。
&lt;img src=&quot;https://i.kiksoft.net/blog/abap-fm-json-in-depth-analysis/image-0.png&quot; alt=&quot;fmcall&quot;&gt;
&lt;img src=&quot;https://i.kiksoft.net/blog/abap-fm-json-in-depth-analysis/image-1.png&quot; alt=&quot;Handle List&quot;&gt;&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;URL 解析&lt;/h3&gt;
&lt;p&gt;路由逻辑非常直接：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 见于 IF_HTTP_EXTENSION~HANDLE_REQUEST (ZCL_JSON_HANDLER)
* Get function name from PATH_INFO
  path_info = server-&amp;gt;request-&amp;gt;get_header_field( name = &amp;#39;~path_info&amp;#39; ).
  split path_info at &amp;#39;/&amp;#39; into table p_info_tab.
  read table p_info_tab index 2 into funcname.
  read table p_info_tab index 3 into funcname2.
  if sy-subrc eq 0.
     concatenate &amp;#39;/&amp;#39; funcname &amp;#39;/&amp;#39; funcname2 into funcname.
     condense funcname.
  endif.
  translate funcname to upper case.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;/fmcall/RFC_SYSTEM_INFO&lt;/code&gt; 中的 &lt;code&gt;RFC_SYSTEM_INFO&lt;/code&gt;
被提取为函数名。&lt;code&gt;translate to upper case&lt;/code&gt; 确保大小写不敏感——ABAP
的函数名和字段名习惯全大写。&lt;/p&gt;
&lt;h3&gt;命名空间 FM 的修复&lt;/h3&gt;
&lt;p&gt;ABAP 中有一类带命名空间的函数模块，例如 &lt;code&gt;/DMO/FLIGHT_TRAVEL_READ&lt;/code&gt;。这种 URL 在
SICF 路径解析中会被分成两段。最初的实现只取了 &lt;code&gt;index 2&lt;/code&gt;，拿到的是 &lt;code&gt;/DMO&lt;/code&gt;
而非完整的 &lt;code&gt;/DMO/FLIGHT_TRAVEL_READ&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;这个问题由社区贡献者 FROGGS 在
&lt;a href=&quot;https://github.com/cesar-sap/abap_fm_json/pull/11&quot;&gt;PR #11&lt;/a&gt;
中修复，也就是上文中的代码部分：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;read table p_info_tab index 2 into funcname.
read table p_info_tab index 3 into funcname2.
if sy-subrc eq 0.
  concatenate &amp;#39;/&amp;#39; funcname &amp;#39;/&amp;#39; funcname2 into funcname.
  condense funcname.
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;注意这里拼接后得到的是 &lt;code&gt;/DMO/FLIGHT_TRAVEL_READ&lt;/code&gt;——带前导斜杠，这正是
&lt;code&gt;CALL FUNCTION&lt;/code&gt; 在 ABAP 中调用命名空间 FM 的标准写法。&lt;/p&gt;
&lt;h3&gt;路由小结&lt;/h3&gt;
&lt;p&gt;路由是整个架构中最薄的一层，约 30 行代码。它只做一件事：&lt;strong&gt;把 URL
路径中的函数名提取出来&lt;/strong&gt;。剩下的所有复杂度——参数映射、动态调用、结果序列化——都在后面的环节。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;二、BUILD_PARAMS：动态调用之基&lt;/h2&gt;
&lt;h3&gt;核心问题&lt;/h3&gt;
&lt;p&gt;路由拿到了 &lt;code&gt;funcname&lt;/code&gt;，但问题来了：&lt;strong&gt;写 &lt;code&gt;ZCL_JSON_HANDLER&lt;/code&gt;
的时候，作者不知道你会调哪个 FM&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;BAPI_USER_GET_DETAIL&lt;/code&gt; 有 20 个参数，&lt;code&gt;BAPI_MATERIAL_GET_ALL&lt;/code&gt; 有 50
个，&lt;code&gt;Z_MY_CUSTOM_FM&lt;/code&gt; 可能有完全不同的参数结构。&lt;/p&gt;
&lt;p&gt;这就要用到&lt;code&gt;PARAMETER-TABLE&lt;/code&gt;，ABAP
中的一个通用的传参语法，它能让我们以固定的形式把参数通过内表传递给 FM 。（参见
&lt;a href=&quot;https://help.sap.com/doc/abapdocu_816_index_htm/8.16/en-US/ABAPCALL_FUNCTION_DYNAMIC.html&quot;&gt;CALL FUNCTION&lt;/a&gt;）
&lt;img src=&quot;https://i.kiksoft.net/blog/abap-fm-json-in-depth-analysis/image-3.png&quot; alt=&quot;CALL FUNCTION&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;CALL FUNCTION funcname&lt;/code&gt; 后面跟 &lt;code&gt;PARAMETER-TABLE paramtab&lt;/code&gt;——这个 &lt;code&gt;paramtab&lt;/code&gt;
必须在运行时，根据 funcname 动态构造出来。&lt;/p&gt;
&lt;p&gt;这就是 &lt;code&gt;BUILD_PARAMS&lt;/code&gt; 方法要做的事：&lt;strong&gt;在运行时，为任意 FM
构造出完整的参数调用表&lt;/strong&gt;。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;第一步：获取 FM 的元数据&lt;/h3&gt;
&lt;p&gt;首先要用到 ABAP 的一个标准 RFC
函数——&lt;code&gt;RFC_GET_FUNCTION_INTERFACE_P&lt;/code&gt;，它可以返回任意 FM 的完整参数：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 见于 BUILD_PARAMS (ZCL_JSON_HANDLER)
  call function &amp;#39;RFC_GET_FUNCTION_INTERFACE_P&amp;#39;
    EXPORTING
      funcname      = function_name
      language      = &amp;#39;E&amp;#39;       &amp;quot;&amp;#39;D&amp;#39;  &amp;quot;sy-langu
    TABLES
      params_p      = t_params_p
    EXCEPTIONS
      fu_not_found  = 1
      nametab_fault = 2
      others        = 3.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;返回的 &lt;code&gt;t_params_p&lt;/code&gt; 是一个内表，每一行描述一个参数。关键字段：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;字段&lt;/th&gt;
&lt;th&gt;含义&lt;/th&gt;
&lt;th&gt;示例值&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;PARAMETER&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;参数名&lt;/td&gt;
&lt;td&gt;&lt;code&gt;USERNAME&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;PARAMCLASS&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;参数类别&lt;/td&gt;
&lt;td&gt;&lt;code&gt;I&lt;/code&gt;=EXPORTING, &lt;code&gt;E&lt;/code&gt;=IMPORTING, &lt;code&gt;C&lt;/code&gt;=CHANGING, &lt;code&gt;T&lt;/code&gt;=TABLES, &lt;code&gt;X&lt;/code&gt;=EXCEPTION&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;TABNAME&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;类型名&lt;/td&gt;
&lt;td&gt;&lt;code&gt;BAPIRET2&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;FIELDNAME&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;字段名&lt;/td&gt;
&lt;td&gt;&lt;code&gt;MESSAGE&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;DEFAULT&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;默认值&lt;/td&gt;
&lt;td&gt;&lt;code&gt;SPACE&lt;/code&gt; 或 &lt;code&gt;SY-UNAME&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;EXID&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;表类型标识&lt;/td&gt;
&lt;td&gt;&lt;code&gt;h&lt;/code&gt;=hashed table, 其他=standard&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;也就是我们在 SE37 中经常看到的开头部分。
&lt;img src=&quot;https://i.kiksoft.net/blog/abap-fm-json-in-depth-analysis/image-4.png&quot; alt=&quot;FM 参数&quot;&gt;&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;第二步：动态构造数据对象&lt;/h3&gt;
&lt;p&gt;有了字段及类型信息后，就能用 &lt;code&gt;CREATE DATA&lt;/code&gt;
在程序运行时动态创建数据对象，这样才能把 http 传入的参数映射到 FM 的参数上：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 见于 BUILD_PARAMS (ZCL_JSON_HANDLER)
if params_p-fieldname is initial.
  dataname = params_p-tabname.
else.
  concatenate params_p-tabname params_p-fieldname into
      dataname separated by &amp;#39;-&amp;#39;.
endif.

create data waref type (dataname).
paramline-value = waref.
insert paramline into table paramtab.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这里的 &lt;code&gt;(dataname)&lt;/code&gt; 是动态类型指定。例如对于 &lt;code&gt;BAPIRET2-MESSAGE&lt;/code&gt; 参数，&lt;code&gt;dataname&lt;/code&gt;
拼接为 &lt;code&gt;BAPIRET2-MESSAGE&lt;/code&gt;，&lt;code&gt;CREATE DATA&lt;/code&gt; 就创建了一个 &lt;code&gt;BAPIRET2-MESSAGE&lt;/code&gt;
类型的变量。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;paramline-value = waref&lt;/code&gt;
保存了这个引用。后续不管是填值还是读结果，都通过这个引用操作同一个数据对象。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;paramline&lt;/code&gt; 是一个 &lt;code&gt;ABAP_FUNC_PARMBIND&lt;/code&gt; 结构：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot;Type group: ABAP
types: begin of abap_func_parmbind,
    value     type ref to data,
    tables_wa type ref to data,
    kind      type i,
    name      type abap_parmname,
  end of abap_func_parmbind.
&lt;/code&gt;&lt;/pre&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;参数类别的反向映射&lt;/h3&gt;
&lt;p&gt;这里有一个非常容易踩的坑。RFC 函数的参数分类和 ABAP &lt;code&gt;CALL FUNCTION&lt;/code&gt;
的参数分类是&lt;strong&gt;反向的&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;case params_p-paramclass.
  when &amp;#39;I&amp;#39;.
    paramline-kind = ABAP_FUNC_EXPORTING.   &amp;quot; (10)
  when &amp;#39;E&amp;#39;.
    paramline-kind = ABAP_FUNC_IMPORTING.   &amp;quot; (20)
  when &amp;#39;C&amp;#39;.
    paramline-kind = ABAP_FUNC_CHANGING.     &amp;quot; (40)
  when &amp;#39;T&amp;#39;.
    paramline-kind = ABAP_FUNC_TABLES.       &amp;quot; (30)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;理解这个映射的关键在于视角：从 RFC 函数的内外视角区分，从调用函数的角度看
&lt;code&gt;CALL FUNCTION&lt;/code&gt; 是把参数传给 FM 的，所以是 &lt;code&gt;EXPORTING&lt;/code&gt;；在 FM
内接收到的是外部传入的参数，所以是 &lt;code&gt;IMPORTING&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;代码中多处出现西班牙语注释
&lt;code&gt;&amp;quot;va al revés, cuidado!!!&amp;quot;&lt;/code&gt;（反了，小心！！！），就是作者对这个反向映射的反复提醒。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;默认值处理&lt;/h3&gt;
&lt;p&gt;ABAP 函数模块的参数可以声明默认值，比如
SY-UNAME（当前用户名）。假如这个字段在调用中没有传参，就需要用默认值填入，但不是直接传
&lt;code&gt;&amp;quot;SY-UNAME&amp;quot;&lt;/code&gt; 字符串进去，而是要拿到这个变量的值传进去。&lt;/p&gt;
&lt;p&gt;我们来看看 BUILD_PARAMS 是怎么操作的。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 见于 BUILD_PARAMS (ZCL_JSON_HANDLER)
defval = params_p-default.
len = strlen( defval ).

&amp;quot; 情况 1：SPACE 关键字
if defval = &amp;#39;SPACE&amp;#39;.
  &amp;lt;wa&amp;gt; = space.

&amp;quot; 情况 2：SY-* 系统变量（如 SY-UNAME）
elseif len &amp;gt; 3 and defval+0(3) = &amp;#39;SY-&amp;#39;.
  assign (defval) to &amp;lt;temp&amp;gt;.
  &amp;lt;wa&amp;gt; = &amp;lt;temp&amp;gt;.
  unassign &amp;lt;temp&amp;gt;.

&amp;quot; 情况 3：其他文字默认值
else.
  if defval is not initial.
    &amp;lt;wa&amp;gt; = defval.
  endif.
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;情况 2 是最有意思的部分。&lt;/strong&gt; 函数模块参数的默认值可能是
&lt;code&gt;SY-UNAME&lt;/code&gt;（当前用户名）、&lt;code&gt;SY-DATUM&lt;/code&gt;（当前日期）等 ABAP 系统字段。这段代码用
&lt;code&gt;ASSIGN (defval) TO &amp;lt;temp&amp;gt;&lt;/code&gt; 这样一句语法把字符串 &lt;code&gt;&amp;quot;SY-UNAME&amp;quot;&lt;/code&gt;
解析为实际的系统字段引用，实现了运行时动态取值。&lt;/p&gt;
&lt;p&gt;这是一个不依赖任何新版特性的&amp;quot;元编程&amp;quot;技巧——纯 ABAP，7.0 就能跑。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;产物：三件套&lt;/h3&gt;
&lt;p&gt;BUILD_PARAMS 方法返回的参数包含三个：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;输出&lt;/th&gt;
&lt;th&gt;类型&lt;/th&gt;
&lt;th&gt;用途&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;PARAMTAB&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ABAP_FUNC_PARMBIND_TAB&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;CALL FUNCTION&lt;/code&gt; 的入参&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;EXCEPTAB&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ABAP_FUNC_EXCPBIND_TAB&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;CALL FUNCTION&lt;/code&gt; 的返回值&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;PARAMS&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ANY&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;扁平参数描述表，返回 Function 的全部参数，供序列化参考&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h3&gt;小结&lt;/h3&gt;
&lt;p&gt;BUILD_PARAMS 的核心贡献在于：&lt;strong&gt;它让代码不需要知道 FM 的参数就能调用它&lt;/strong&gt;。通过
&lt;code&gt;RFC_GET_FUNCTION_INTERFACE_P&lt;/code&gt; +
&lt;code&gt;CREATE DATA (dataname)&lt;/code&gt;，在运行时动态构建出与任意 FM
完全匹配的参数结构体。这是整个项目能跑通能的前提，也是整个项目的核心代码之一。&lt;/p&gt;
&lt;hr&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h2&gt;三、双通道输入映射&lt;/h2&gt;
&lt;h3&gt;核心问题&lt;/h3&gt;
&lt;p&gt;BUILD_PARAMS 搭好了参数架子（&lt;code&gt;paramtab&lt;/code&gt;），但架子是空的。接下来要把 HTTP
请求里的数据填进去。&lt;/p&gt;
&lt;p&gt;HTTP 请求可以带数据的方式有两个：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;GET query string&lt;/strong&gt;：也就是在 URL 后面的参数，比如 &lt;code&gt;?USERNAME=JACK&amp;amp;LANG=EN&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;POST body&lt;/strong&gt;：也就是在 HTTP body 里的 JSON 字符串，比如
&lt;code&gt;{&amp;quot;USERNAME&amp;quot;:&amp;quot;JACK&amp;quot;, &amp;quot;ADDRESS&amp;quot;: {...}}&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;abap_fm_json 的处理方式很简单但也很&amp;quot;原始&amp;quot;：&lt;strong&gt;把 GET query string 先手工拼成
JSON，然后和 POST body 走同一条路。&lt;/strong&gt;&lt;/p&gt;
&lt;h3&gt;① GET query string → 手工拼 JSON&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 获取所有 query string 参数
server-&amp;gt;request-&amp;gt;get_form_fields_cs( changing fields = qs_nvp ).
&amp;quot; qs_nvp 是一个 TIHTTPNVP 表，每行是一个 name=value 对
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果请求是 GET（没有 body）或者 content-type 是
&lt;code&gt;application/x-www-form-urlencoded&lt;/code&gt;，就把 query string 拼成 JSON：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;if ( qs_nvp is not initial and i_cdata is initial ) or
    i_content_type cs &amp;#39;application/x-www-form-urlencoded&amp;#39;.
  l_lines = lines( qs_nvp ).
  clear l_idx.
  move &amp;#39;{&amp;#39; to i_cdata.
  loop at qs_nvp assigning &amp;lt;qs_nvp&amp;gt;.
    add 1 to l_idx.
    translate &amp;lt;qs_nvp&amp;gt;-name to upper case.
    concatenate i_cdata &amp;#39;&amp;quot;&amp;#39; &amp;lt;qs_nvp&amp;gt;-name &amp;#39;&amp;quot;:&amp;quot;&amp;#39; &amp;lt;qs_nvp&amp;gt;-value &amp;#39;&amp;quot;&amp;#39;
      into i_cdata respecting blanks.
    if l_idx &amp;lt; l_lines.
      concatenate i_cdata &amp;#39;,&amp;#39; into i_cdata respecting blanks.
    endif.
  endloop.
  concatenate i_cdata &amp;#39;}&amp;#39; into i_cdata.
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;效果：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;?USERNAME=JACK&amp;amp;LANGUAGE=EN
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;↓&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-json&quot;&gt;{ &amp;quot;USERNAME&amp;quot;: &amp;quot;JACK&amp;quot;, &amp;quot;LANGUAGE&amp;quot;: &amp;quot;EN&amp;quot; }
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这段代码没有用任何 JSON 库，就是逐行拼接字符串。它假设所有 query string
参数的值都是标量（字符串），不处理嵌套结构。&lt;/p&gt;
&lt;p&gt;假如你需要传结构体或内表怎么办呢？必须走 POST body。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;② POST body → 原始 JSON 字符串&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;i_cdata = server-&amp;gt;request-&amp;gt;get_cdata( ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;直接从 HTTP body 读取原始内容。&lt;/p&gt;
&lt;h3&gt;③ 汇合：JSON_DESERIALIZE&lt;/h3&gt;
&lt;p&gt;不管从哪条路来，最终 &lt;code&gt;i_cdata&lt;/code&gt; 统一交给 &lt;code&gt;JSON_DESERIALIZE&lt;/code&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;try.
    CALL METHOD me-&amp;gt;json_deserialize
      EXPORTING json = i_cdata
      CHANGING  paramtab = paramtab.
endtry.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;进入 &lt;code&gt;JSON_DESERIALIZE&lt;/code&gt; 内部：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;method JSON_DESERIALIZE.
  data paramname   type string.
  data js_obj      type ref to cl_java_script.
  data js_prop_tab type js_property_tab.
  field-symbols &amp;lt;js_prop&amp;gt; type line of js_property_tab.
  field-symbols &amp;lt;parm&amp;gt;    type abap_func_parmbind.

  if json is initial. exit. endif.

  &amp;quot; 第一步：用 JS 引擎解析 JSON → 属性表
  json2abap( EXPORTING json_string = json
             IMPORTING property_table = js_prop_tab
             CHANGING  js_object = js_obj ).

  &amp;quot; 第二步：逐属性匹配 paramtab
  loop at js_prop_tab assigning &amp;lt;js_prop&amp;gt;.
    paramname = &amp;lt;js_prop&amp;gt;-name.
    translate paramname to upper case.

    read table paramtab with key name = paramname assigning &amp;lt;parm&amp;gt;.
    if sy-subrc eq 0.
      &amp;quot; 只填 FM 的输入参数，跳过输出参数
      if &amp;lt;parm&amp;gt;-kind ne abap_func_importing.
        json2abap( EXPORTING var_name = &amp;lt;js_prop&amp;gt;-name
                   CHANGING  abap_data = &amp;lt;parm&amp;gt;-value
                             js_object = js_obj ).
      endif.
    endif.
  endloop.
endmethod.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这段逻辑分两步：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第一步：JSON → 属性表（借助 JS 引擎）&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;由于这个项目是 2013 年开发的，那时候 sap 标准中还没有 CALL
TRANSFORMATION、/UI2/CL_JSON=&amp;gt;DESERIALIZE 这样的工具，作者选择使用系统内自带的
JS 引擎来解析
JSON。这也是整个项目中代码占比超过一半的部分，虽然今天看来可以通过系统内集成的工具来实现。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;JSON2ABAP&lt;/code&gt; 方法使用 &lt;code&gt;CL_JAVA_SCRIPT&lt;/code&gt;——SAP Kernel 内嵌的 Mozilla SpiderMonkey JS
引擎——来解析 JSON：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;js_object = cl_java_script=&amp;gt;create(
  STACKSIZE = 16384 HEAPSIZE = 960000 ).

&amp;quot; 把 JSON 字符串绑定到 JS 引擎
js_object-&amp;gt;bind(
  name_obj  = &amp;#39;abap_data&amp;#39;
  name_prop = &amp;#39;json_string&amp;#39;
  changing  = data = l_json_string ).

&amp;quot; 构造并执行 JS 脚本
concatenate
  &amp;#39;function start() {&amp;#39;
  &amp;#39;  if(abap_data.script_started) { return; }&amp;#39;
  &amp;#39;  json_text = abap_data.json_string;&amp;#39;
  &amp;#39;  json_obj = !(/[^,:{}\[\]0-9.\-+Eaeflnr-u \n\r\t]/.test(&amp;#39;
  &amp;#39;      json_text.replace(/&amp;quot;(\\.|[^&amp;quot;\\])*&amp;quot;/g, &amp;#39;&amp;#39;&amp;#39;&amp;#39;))) &amp;amp;&amp;amp;&amp;#39;
  &amp;#39;    eval(&amp;#39;&amp;#39;(&amp;#39;&amp;#39; + json_text + &amp;#39;&amp;#39;)&amp;#39;&amp;#39;); &amp;#39;
  &amp;#39;  abap_data.script_started = 1;&amp;#39;
  &amp;#39;}&amp;#39;
  &amp;#39;if(!abap_data.script_started) start();&amp;#39;
  into js_script.

js_object-&amp;gt;compile( script_name = &amp;#39;json_parser&amp;#39; script = js_script ).
js_object-&amp;gt;execute( script_name = &amp;#39;json_parser&amp;#39; ).

&amp;quot; 从 JS 引擎拉回属性表
js_property_table = js_object-&amp;gt;get_properties_scope_global(
  property_path = l_property_path ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://i.kiksoft.net/blog/abap-fm-json-in-depth-analysis/image-2.png&quot; alt=&quot;js_property_table&quot;&gt;&lt;/p&gt;
&lt;p&gt;这个 JS 脚本中有几个值得注意的设计：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;RFC 4627 安全校验&lt;/strong&gt;：&lt;code&gt;eval&lt;/code&gt; 之前先用正则校验 JSON
字符串的字符集，确保不包含可执行代码。这是
&lt;a href=&quot;https://tools.ietf.org/html/rfc4627#section-6&quot;&gt;JSON 规范 RFC 4627 第 6 节&lt;/a&gt;的推荐做法。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;惰性求值&lt;/strong&gt;：&lt;code&gt;script_started&lt;/code&gt; 标志确保 JS 引擎只在首次调用时解析一次。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;eval(&amp;#39;(&amp;#39; + json_text + &amp;#39;)&amp;#39;)&lt;/code&gt;&lt;/strong&gt;：加括号确保 &lt;code&gt;{...}&lt;/code&gt;
被解析为对象字面量而非代码块。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code&gt;GET_PROPERTIES_SCOPE_GLOBAL&lt;/code&gt; 返回一个
&lt;code&gt;JS_PROPERTY_TAB&lt;/code&gt;——一个属性名-值对的列表。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第二步：按 name 匹配 paramtab&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;拿到属性表后，遍历它，按 &lt;code&gt;name&lt;/code&gt; 去 &lt;code&gt;paramtab&lt;/code&gt; 中查找匹配的参数：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;read table paramtab with key name = paramname assigning &amp;lt;parm&amp;gt;.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;匹配的关键是 &lt;code&gt;translate paramname to upper case&lt;/code&gt;——JSON 输入可能是小写或驼峰，但
ABAP 的字段名是大写的。&lt;/p&gt;
&lt;p&gt;如果找到对应的参数，且它&lt;strong&gt;不是 FM
的输出参数&lt;/strong&gt;（&lt;code&gt;&amp;lt;parm&amp;gt;-kind ne abap_func_importing&lt;/code&gt;），就调用 &lt;code&gt;JSON2ABAP&lt;/code&gt;
递归赋值：&lt;/p&gt;
&lt;p&gt;这里的 &lt;code&gt;&amp;lt;parm&amp;gt;-value&lt;/code&gt; 就是 BUILD_PARAMS 中 &lt;code&gt;CREATE DATA&lt;/code&gt;
创建的那个动态数据对象。&lt;code&gt;JSON2ABAP&lt;/code&gt; 通过 RTTI（Run-Time Type
Identification，运行时类型识别）获取它的实际类型：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;datadesc = cl_abap_typedescr=&amp;gt;describe_by_data( &amp;lt;abap_data&amp;gt; ).

case datadesc-&amp;gt;kind.
  when cl_abap_typedescr=&amp;gt;kind_elem.
    &amp;quot; 标量：直接赋值
    assign_scalar_value &amp;lt;abap_data&amp;gt; js_property-value.

  when cl_abap_typedescr=&amp;gt;kind_struct.
    &amp;quot; 结构体：遍历字段，递归赋值每个字段
    loop at js_property_table assigning &amp;lt;jsprop&amp;gt;.
      &amp;quot; 匹配字段名 → 递归调用 json2abap
    endloop.

  when cl_abap_typedescr=&amp;gt;kind_table.
    &amp;quot; 内表：逐行递归
endcase.
&lt;/code&gt;&lt;/pre&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;关于那个 &lt;code&gt;kind ne abap_func_importing&lt;/code&gt; 条件&lt;/h3&gt;
&lt;p&gt;回顾 BUILD_PARAMS 中的映射：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;RFC PARAMCLASS&lt;/th&gt;
&lt;th&gt;CALL FUNCTION KIND&lt;/th&gt;
&lt;th&gt;应该填？&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;I&lt;/code&gt; (RFC IMPORTING)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ABAP_FUNC_EXPORTING&lt;/code&gt; (10)&lt;/td&gt;
&lt;td&gt;FM 吐出的参数 → 不填&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;E&lt;/code&gt; (RFC EXPORTING)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ABAP_FUNC_IMPORTING&lt;/code&gt; (20)&lt;/td&gt;
&lt;td&gt;FM 吃进的参数 → 填&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;C&lt;/code&gt; (CHANGING)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ABAP_FUNC_CHANGING&lt;/code&gt; (40)&lt;/td&gt;
&lt;td&gt;既吃又吐 → 填&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;T&lt;/code&gt; (TABLES)&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ABAP_FUNC_TABLES&lt;/code&gt; (30)&lt;/td&gt;
&lt;td&gt;内表 → 填&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;所以 &lt;code&gt;kind ne abap_func_importing&lt;/code&gt; = &lt;code&gt;kind ne 20&lt;/code&gt; = 只排除
&lt;code&gt;ABAP_FUNC_EXPORTING&lt;/code&gt;（FM 只输出的参数）。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;完整输入映射链路&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;HTTP 请求
   │
   ├─ GET query string
   │   ?USERNAME=JACK&amp;amp;LANG=EN
   │   │
   │   ▼
   │  手工拼 JSON
   │  {&amp;quot;USERNAME&amp;quot;:&amp;quot;JACK&amp;quot;,&amp;quot;LANG&amp;quot;:&amp;quot;EN&amp;quot;}
   │   │
   ├─ POST body (JSON)
   │   │
   └──┼───── i_cdata
      │
      ▼
JSON_DESERIALIZE
      │
      ├──→ JSON2ABAP (CL_JAVA_SCRIPT JS引擎)
      │    JSON 文本 → JS 对象 → JS_PROPERTY_TAB
      │    ┌──────────────┬──────────────┐
      │    │ NAME         │ VALUE        │
      │    ├──────────────┼──────────────┤
      │    │ USERNAME     │ JACK         │
      │    │ LANGUAGE     │ EN           │
      │    └──────────────┴──────────────┘
      │
      └──→ 遍历 JS_PROPERTY_TAB
           每行 name → translate to upper case → read paramtab
           匹配到 → kind ne 20 → json2abap 递归赋值
           匹配不到 → 忽略
                        │
                        ▼
               &amp;lt;parm&amp;gt;-value (动态数据对象)
               ↑ 指向 BUILD_PARAMS 用 CREATE DATA 创建的对象
                        │
                        ▼
               CALL FUNCTION funcname
               PARAMETER-TABLE paramtab
&lt;/code&gt;&lt;/pre&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;四、调用执行&lt;/h2&gt;
&lt;p&gt;参数填好了，关键调用就是一句，这里用了 &lt;code&gt;TRY&lt;/code&gt; 语句来捕获异常，确保 CALL FUNCTION
异常的时候不阻断 HTTP 响应流程：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;  try.

      CALL FUNCTION funcname
        parameter-table
        paramtab
        exception-table
        exceptab.

    catch cx_root into oexcp.
      etext = oexcp-&amp;gt;if_message~get_longtext(  preserve_newlines = abap_true ).
      http_error &amp;#39;500&amp;#39; &amp;#39;Internal Server Error&amp;#39; etext.
  endtry.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;FM 执行完后，EXPORT、CHANGING 和 TABLES 的结果已经写在了 &lt;code&gt;paramtab-value&lt;/code&gt;
指向的动态数据对象中——从 CREATE DATA
到赋值到调用完成，始终是同一个内存地址。&lt;strong&gt;不需要额外的数据搬运。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;异常处理中的 &lt;code&gt;http_error&lt;/code&gt; 是一个宏：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;define http_error.
  server-&amp;gt;response-&amp;gt;set_header_field( name = &amp;#39;Content-Type&amp;#39; value = &amp;#39;application/json&amp;#39; ).
  http_code = &amp;amp;1.
  server-&amp;gt;response-&amp;gt;set_status( code = http_code reason = &amp;amp;2 ).
  concatenate &amp;#39;{&amp;quot;ERROR_CODE&amp;quot;:&amp;quot;&amp;#39; &amp;amp;1 &amp;#39;&amp;quot;,&amp;quot;ERROR_MESSAGE&amp;quot;:&amp;quot;&amp;#39; &amp;amp;3 ...
  server-&amp;gt;response-&amp;gt;set_cdata( etext ).
  exit.
end-of-definition.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;注意 &lt;code&gt;exit&lt;/code&gt; 直接嵌入在宏中——它只能在 HANDLE_REQUEST
方法体内部使用，一调用就跳出。这种写法对可读性和重构都是隐患。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;五、隐式契约：_ICF_DATA&lt;/h2&gt;
&lt;h3&gt;问题&lt;/h3&gt;
&lt;p&gt;标准的 &lt;code&gt;CALL FUNCTION ... PARAMETER-TABLE&lt;/code&gt; 只关心参数的值，不关心 HTTP
语义。但作者希望被调用的 FM &lt;strong&gt;能够反向控制 HTTP 响应的行为&lt;/strong&gt;——比如设置 201
Created 状态码、Location header、或者决定不返回某些敏感参数。&lt;/p&gt;
&lt;h3&gt;解法&lt;/h3&gt;
&lt;p&gt;作者选择定义一个 CHANGING 参数 &lt;code&gt;_ICF_DATA&lt;/code&gt;，只要被调用的 FM 有这个参数，就可以在
FM 内部通过这个参数反向控制 HTTP 响应的行为。这是一个隐式契约。&lt;/p&gt;
&lt;p&gt;FM 调用前，适配器检查 &lt;code&gt;paramtab&lt;/code&gt; 中是否有名为 &lt;code&gt;_ICF_DATA&lt;/code&gt; 的参数：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;read table paramtab with key name = &amp;#39;_ICF_DATA&amp;#39; assigning &amp;lt;fm_param&amp;gt;.
if sy-subrc eq 0.
  create data &amp;lt;fm_param&amp;gt;-value type ZICF_HANDLER_DATA.
  assign &amp;lt;fm_param&amp;gt;-value-&amp;gt;* to &amp;lt;fm_int_handler&amp;gt;.
  &amp;lt;fm_int_handler&amp;gt;-request_method = request_method.
  &amp;lt;fm_int_handler&amp;gt;-icf_url = me-&amp;gt;my_url.
  &amp;lt;fm_int_handler&amp;gt;-icf_service = me-&amp;gt;my_service.
  &amp;lt;fm_int_handler&amp;gt;-path_info = path_info.
  &amp;lt;fm_int_handler&amp;gt;-qs_tab = qs_nvp.
  &amp;lt;fm_int_handler&amp;gt;-i_json_data = i_cdata.
  &amp;lt;fm_int_handler&amp;gt;-camelcase_names = camelcase_names.
  append &amp;#39;_ICF_DATA&amp;#39; to &amp;lt;fm_int_handler&amp;gt;-delete_params.
  &amp;lt;fm_int_handler&amp;gt;-server = server. &amp;quot; Beware!
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;关键操作：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;查找 &lt;code&gt;_ICF_DATA&lt;/code&gt;——如果 FM 的 CHANGING 参数中声明了这个名字，适配器自动识别&lt;/li&gt;
&lt;li&gt;创建结构体实例，填充 HTTP 请求上下文&lt;/li&gt;
&lt;li&gt;&lt;code&gt;append &amp;#39;_ICF_DATA&amp;#39; to delete_params&lt;/code&gt; 确保这个结构体不出现在输出序列化中&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;FM 内部可以通过这个结构体反向控制输出：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;FUNCTION Z_MY_REST_FUNC.
  CHANGING
    _ICF_DATA TYPE ZICF_HANDLER_DATA.

      _ICF_DATA-http_code = 201.
      _ICF_DATA-http_status = &amp;#39;Created&amp;#39;.
      _ICF_DATA-location_header = &amp;#39;/new/resource/123&amp;#39;.
  append &amp;#39;INTERNAL_PASSWORD&amp;#39; to _ICF_DATA-delete_params.

ENDFUNCTION.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;序列化前，适配器检查这些字段：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;if &amp;lt;fm_int_handler&amp;gt;-http_code is not initial.
  server-&amp;gt;response-&amp;gt;set_status(
    code = &amp;lt;fm_int_handler&amp;gt;-http_code
    reason = &amp;lt;fm_int_handler&amp;gt;-http_status ).
endif.

loop at &amp;lt;fm_int_handler&amp;gt;-delete_params into dparam.
  delete paramtab where name eq dparam.
endloop.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;评价&lt;/h3&gt;
&lt;p&gt;这个设计巧妙地利用了 &lt;code&gt;CALL FUNCTION&lt;/code&gt; 的参数传递机制，在 FM
的过程调用语义上叠加了一层 HTTP 语义。FM
不需要继承任何接口，只需声明一个同名参数即可参与 HTTP 响应的控制。&lt;/p&gt;
&lt;p&gt;但代价是：开发者必须&amp;quot;知道&amp;quot;有这个约定，没有任何东西告诉你可以这样做。没有接口需要实现，没有类需要继承，没有文档会自动生成。你如果不知道
_ICF_DATA 这个&amp;quot;暗号&amp;quot;，就永远不会发现这个功能。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;六、输出序列化&lt;/h2&gt;
&lt;h3&gt;主流程&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;case format.
  when &amp;#39;YAML&amp;#39;.
    CALL METHOD me-&amp;gt;serialize_yaml ...
  when &amp;#39;PERL&amp;#39;.
    CALL METHOD me-&amp;gt;serialize_perl ...
  when &amp;#39;XML&amp;#39;.
    CALL METHOD me-&amp;gt;serialize_xml ...
  when others.  &amp;quot; 默认 JSON
    CALL METHOD me-&amp;gt;serialize_json ...
endcase.

server-&amp;gt;response-&amp;gt;set_cdata( data = o_cdata ).
server-&amp;gt;response-&amp;gt;set_compression( ).
&lt;/code&gt;&lt;/pre&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;递归序列化的骨架&lt;/h3&gt;
&lt;p&gt;四个序列化器共享同一个基于 RTTI 的递归结构：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 1. 获取 ABAP 数据类型
describe field abap_data type l_type components l_comps.

&amp;quot; 2. 处理引用 → 自动解引用
if l_type eq cl_abap_typedescr=&amp;gt;typekind_dref.
  assign abap_data-&amp;gt;* to &amp;lt;abap_data&amp;gt;.
endif.

&amp;quot; 3. 根据类型分路
if l_type eq cl_abap_typedescr=&amp;gt;typekind_table.
  &amp;quot; 内表 → 数组 []
  loop at &amp;lt;itab&amp;gt; assigning &amp;lt;comp&amp;gt;.
    rec_string = abap2json( abap_data = &amp;lt;comp&amp;gt; ... ).
  endloop.

elseif l_comps is not initial.
  &amp;quot; 结构体 → 对象 {}
  loop at l_typedescr-&amp;gt;components assigning &amp;lt;abapcomp&amp;gt;.
    rec_string = abap2json( abap_data = &amp;lt;comp&amp;gt; name = l_name ... ).
  endloop.

else.
  &amp;quot; 标量 → 值
  &amp;quot; 根据类型处理：日期截断、HTML转义、XSTRING Base64...
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这个递归结构在 JSON、XML、YAML、Perl
四个序列化器中完全一致，只是输出格式的语法不同。这是策略模式的一个朴素实现——只是作者用复制粘贴而非接口抽象。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;标量类型处理&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 一段 DEFINE 宏，在四个序列化器中各自出现
define get_scalar_value.
  case &amp;amp;1.
    when &amp;#39;D&amp;#39;.                   &amp;quot; 日期 → YYYY-MM-DD
      concatenate &amp;amp;2+0(4) &amp;#39;-&amp;#39; &amp;amp;2+4(2) &amp;#39;-&amp;#39; &amp;amp;2+6(2) into &amp;amp;2.
    when &amp;#39;T&amp;#39;.                   &amp;quot; 时间 → HH:MM:SS
      concatenate &amp;amp;2(2) &amp;#39;:&amp;#39; &amp;amp;2+2(2) &amp;#39;:&amp;#39; &amp;amp;2+4(2) into &amp;amp;2.
    when &amp;#39;N&amp;#39;.                   &amp;quot; 数字文本 → 去空格
      condense &amp;amp;2.
    when &amp;#39;C&amp;#39; or &amp;#39;g&amp;#39;.            &amp;quot; 字符/字符串 → JSON 转义
      replace all occurrences of &amp;#39;\&amp;#39; in &amp;amp;2 with &amp;#39;\\&amp;#39;.
      replace all occurrences of &amp;#39;&amp;quot;&amp;#39; in &amp;amp;2 with &amp;#39;\&amp;quot;&amp;#39;.
      ...
    when &amp;#39;y&amp;#39;.                   &amp;quot; XSTRING → Base64
      &amp;amp;1 = cl_http_utility=&amp;gt;encode_x_base64( &amp;amp;2 ).
  endcase.
end-of-definition.
&lt;/code&gt;&lt;/pre&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;命名控制&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;&amp;quot; 全小写
if lowercase eq abap_true.
  translate paramname to lower case.
endif.

&amp;quot; 驼峰转换
if camelcase eq abap_true.
  paramname = to_mixed( val = paramname case = &amp;#39;a&amp;#39; ).
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;to_mixed&lt;/code&gt; 将 &lt;code&gt;LIKE_USER_NAME&lt;/code&gt; 转换为
&lt;code&gt;likeUserName&lt;/code&gt;。还支持按字段名选择性驼峰——通过 &lt;code&gt;camelcase_names&lt;/code&gt; 表指定。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;h3&gt;双模式设计：纯 ABAP vs 内置 Transformation&lt;/h3&gt;
&lt;p&gt;代码中有一个醒目的注释开关：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;* 默认：纯 ABAP 序列化器
CALL METHOD me-&amp;gt;serialize_json ...

* 可选：内置 Transformation
* CALL METHOD me-&amp;gt;serialize_id ...
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;2013 年 1 月，SAP 刚推出 &lt;code&gt;CALL TRANSFORMATION id ... RESULT JSON&lt;/code&gt;（Note
1745504）。作者在同一年 3 月发布的代码中就把两种方案都包含了，让用户按 ABAP
版本选择。&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;维度&lt;/th&gt;
&lt;th&gt;纯 ABAP（默认）&lt;/th&gt;
&lt;th&gt;ID 模式（可选）&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;实现方式&lt;/td&gt;
&lt;td&gt;RTTI 递归 + 手动拼字符串&lt;/td&gt;
&lt;td&gt;&lt;code&gt;CALL TRANSFORMATION id&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;ABAP 版本&lt;/td&gt;
&lt;td&gt;7.0+&lt;/td&gt;
&lt;td&gt;7.31+&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;自定义程度&lt;/td&gt;
&lt;td&gt;完全控制&lt;/td&gt;
&lt;td&gt;依赖标准行为&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;代码量&lt;/td&gt;
&lt;td&gt;~1400 行&lt;/td&gt;
&lt;td&gt;~160 行&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;七、路由回顾&lt;/h2&gt;
&lt;p&gt;架构全链路回顾：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;HTTP 请求
   │
   │  路径: /fmcall/BAPI_USER_GET_DETAIL?USERNAME=JACK
   │
   ▼
┌──────────────────────────────────────────────────────────────┐
│  HANDLE_REQUEST                                              │
│                                                              │
│  ① 路由：PATH_INFO → funcname                                │
│     split &amp;#39;BAPI_USER_GET_DETAIL&amp;#39;                             │
│                                                              │
│  ② BUILD_PARAMS：动态构造参数表                                │
│     RFC_GET_FUNCTION_INTERFACE_P                             │
│     → paramtab (ABAP_FUNC_PARMBIND_TAB)                      │
│     → exceptab (ABAP_FUNC_EXCPBIND_TAB)                      │
│                                                              │
│  ③ 输入映射：HTTP → paramtab                                  │
│     GET query → 拼成 JSON                                     │
│     POST body → 原始 JSON                                     │
│     JSON_DESERIALIZE → JS引擎解析 → 属性匹配 → 递归赋值          │
│                                                              │
│  ④ ZICF_HANDLER_DATA：注入 HTTP 上下文                        │
│                                                              │
│  ⑤ CALL FUNCTION funcname                                   │
│     PARAMETER-TABLE paramtab                                 │
│     EXCEPTION-TABLE exceptab                                 │
│                                                              │
│  ⑥ 输出序列化：paramtab → response body                       │
│     JSON (默认) / XML / YAML / Perl                          │
│                                                              │
│  ⑦ 写回 HTTP 响应                                             │
│     set_status / set_header_field / set_cdata                │
└──────────────────────────────────────────────────────────────┘
&lt;/code&gt;&lt;/pre&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;八、安全&lt;/h2&gt;
&lt;h3&gt;现有三层防御&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;第一层：ICF 服务认证&lt;/strong&gt; SICF 服务节点可以配置 Basic Auth、Logon Ticket、SSL
Client Certificate 等认证方式。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第二层：自定义授权对象&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;authority-check object &amp;#39;Z_JSON&amp;#39; id &amp;#39;FMNAME&amp;#39; field funcname.
if sy-subrc &amp;lt;&amp;gt; 0.
  http_error &amp;#39;403&amp;#39; &amp;#39;Forbidden&amp;#39; &amp;#39;No authorization.&amp;#39;.
endif.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;授权对象 &lt;code&gt;Z_JSON&lt;/code&gt; 只有一个字段 &lt;code&gt;FMNAME&lt;/code&gt;。注意这个对象需要管理员手动用 SU21
创建——它不在 transport 中。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第三层：输入过滤&lt;/strong&gt; 字符串输出时做了 HTML 转义（&lt;code&gt;escape_html&lt;/code&gt;）和 JSON
转义（&lt;code&gt;\&lt;/code&gt;、&lt;code&gt;&amp;quot;&lt;/code&gt;、&lt;code&gt;\r\n&lt;/code&gt; 等）。&lt;/p&gt;
&lt;h3&gt;三个缺失&lt;/h3&gt;
&lt;p&gt;这个项目在 2021 年之后停止了维护，所以一些安全问题没有得到及时修复。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;CSRF token&lt;/strong&gt;：完全缺失。登录用户可能被恶意网页挟持调用 FM&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;FM 白名单&lt;/strong&gt;：没有任何内置的白名单机制。&lt;code&gt;Z_JSON&lt;/code&gt; 用 &lt;code&gt;*&lt;/code&gt; 就全放&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CORS&lt;/strong&gt;：README 标注 &amp;quot;CORS support is planned&amp;quot;，但从未实现&lt;/li&gt;
&lt;/ol&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;&lt;p&gt;&lt;a href=&quot;#%E7%9B%AE%E5%BD%95&quot;&gt;回到目录⬆️&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;&lt;hr&gt;
&lt;h2&gt;九、总结&lt;/h2&gt;
&lt;h3&gt;当年为什么优秀&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;选对了入口&lt;/strong&gt;：ICF 是 ABAP HTTP 编程的标准接口，比 SOAP 轻量得多&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;动态 CALL FUNCTION&lt;/strong&gt;：通过 BUILD_PARAMS 实现对任意 FM 的通用调用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;纯 ABAP 实现&lt;/strong&gt;：7.0+ 就能跑，不依赖任何第三方库或新版本特性&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;前瞻的双模式&lt;/strong&gt;：2013 年刚推出 JSON Transformation 时就纳入支持&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;今天为什么值得回顾&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;BUILD_PARAMS 的设计思路&lt;/strong&gt;仍然是通用的架构模式——通过元数据动态构造调用参数&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;&amp;quot;过程调用 → HTTP&amp;quot;的桥接问题&lt;/strong&gt;在今天依然存在——RAP / OData
本质解决的也是同一个问题&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;2486 行单类&lt;/strong&gt;是代码熵增的典型案例：这个项目不是一开始就有 2486
行的。它大概率是这个演化路径：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;第一版：HANDLE_REQUEST + BUILD_PARAMS + ABAP2JSON（~800 行）&lt;/li&gt;
&lt;li&gt;用户说&amp;quot;能输出 XML 吗？&amp;quot; → 复制 ABAP2JSON 改成 ABAP2XML（+300 行）&lt;/li&gt;
&lt;li&gt;&amp;quot;能输出 YAML 吗？&amp;quot; → 再复制一份（+200 行）...&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;每一次改动单独看都是合理的需求，但没有人停下来把四个序列化器的公共递归逻辑抽成接口或基类。结果就是：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;修 JSON 日期格式的一个 bug，要跑到 XML、YAML、Perl 三个序列化器里重复修三遍&lt;/li&gt;
&lt;li&gt;加一个新功能（比如 camelcase_names），四个地方都要改&lt;/li&gt;
&lt;li&gt;注释掉的备选代码、遗留 TODO、旧的调试宏散落在 2500 行里
这就是&amp;quot;代码熵增&amp;quot;——系统的混乱度在无人治理的情况下只会上升。软件不会自动变好，只会自动变烂。当你看到同一段逻辑被复制粘贴了四次（JSON/XML/YAML/Perl），就应该停下来做抽象了，而不是继续贴第五次。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;序列化部分&lt;/strong&gt;在 2026 年可以用 &lt;code&gt;CALL TRANSFORMATION&lt;/code&gt; 或 &lt;code&gt;XCO&lt;/code&gt; 替代，从 1400
行降到 50 行&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;从轻量化的角度看，这个项目时至今日依然有值得维护的必要，虽然可能需要去掉曾经堪称精彩的
Json 序列化实现，使用 SAP 已经集成的标准工具。同时加入一些安全机制，比如 CSRF
token、FM 白名单、CORS 等。它将依然是与繁复的 Odata、SOAP
等技术方案对比，一个更轻量级的解决方案。&lt;/p&gt;
&lt;div style=&quot;text-align: right;&quot;&gt;
[回到目录⬆️](#目录)&lt;/div&gt;&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;参考内容&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/cesar-sap/abap_fm_json&quot;&gt;https://github.com/cesar-sap/abap_fm_json&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://deepwiki.com/cesar-sap/abap_fm_json&quot;&gt;https://deepwiki.com/cesar-sap/abap_fm_json&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_816_index_htm/8.16/en-US/ABAPCALL_FUNCTION_DYNAMIC.html&quot;&gt;https://help.sap.com/doc/abapdocu_816_index_htm/8.16/en-US/ABAPCALL_FUNCTION_DYNAMIC.html&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://community.sap.com/t5/application-development-and-automation-blog-posts/json-adapter-for-abap-function-modules/ba-p/12984611&quot;&gt;https://community.sap.com/t5/application-development-and-automation-blog-posts/json-adapter-for-abap-function-modules/ba-p/12984611&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>abap_fm_json：通过 HTTP 调用 ABAP 函数模块</title><link>https://jack-liang.com/blog/dotabap-daily-recommendation-abap-fm-json/</link><guid isPermaLink="true">https://jack-liang.com/blog/dotabap-daily-recommendation-abap-fm-json/</guid><description>abap_fm_json 是一个将 ABAP 函数模块暴露为 JSON Web 服务的适配器，支持通过 HTTP 请求调用 ABAP 功能模块并自动处理 JSON 序列化与反序列化。</description><pubDate>Thu, 02 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;项目基本信息&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;项目&lt;/th&gt;
&lt;th&gt;内容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;项目名称&lt;/td&gt;
&lt;td&gt;abap_fm_json&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;作者&lt;/td&gt;
&lt;td&gt;cesar-sap&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GitHub&lt;/td&gt;
&lt;td&gt;&lt;a href=&quot;https://github.com/cesar-sap/abap_fm_json&quot;&gt;github.com/cesar-sap/abap_fm_json&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;开源协议&lt;/td&gt;
&lt;td&gt;Apache License v2.0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;一句话描述&lt;/td&gt;
&lt;td&gt;JSON adapter for ABAP Function Modules —— 通过 HTTP 调用 ABAP 函数模块，并以 JSON 格式序列化输入输出&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2&gt;能实现的功能&lt;/h2&gt;
&lt;p&gt;abap_fm_json 是一个轻量级的 SAP ABAP 适配器，核心目标是将 ABAP 函数模块暴露为
RESTful HTTP 接口，让外部应用（HTML5、Ajax、jQuery、现代前后端系统）能够以标准
HTTP 请求的方式调用 SAP 功能。&lt;/p&gt;
&lt;h3&gt;核心特性&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;HTTP 调用函数模块：通过 URL 直接调用任意已授权的 ABAP Function
Module，无需额外的 SOAP/WS 配置&lt;/li&gt;
&lt;li&gt;多格式输出：支持 JSON、XML、YAML 1.0、Perl（Data::Dumper）四种序列化格式&lt;/li&gt;
&lt;li&gt;双序列化引擎：提供纯 ABAP 自研序列化器 + SAP 内置
Transformation（7.31+），可按需切换&lt;/li&gt;
&lt;li&gt;灵活的参数传递：&lt;ul&gt;
&lt;li&gt;GET 查询字符串传递简单参数（标量类型）&lt;/li&gt;
&lt;li&gt;POST/PUT Body 传递复杂结构体与内表（JSON 或 form-urlencoded）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;字段名转换：支持
lowercase（小写）、camelCase（驼峰）、upcase（大写保持）三种命名风格&lt;/li&gt;
&lt;li&gt;JSONP 支持：通过 callback 参数实现跨域请求&lt;/li&gt;
&lt;li&gt;会话管理：支持 start_session / end_session，在多请求间维持 ABAP 会话上下文&lt;/li&gt;
&lt;li&gt;自定义授权控制：通过 Z_JSON 授权对象，精确控制用户可访问的函数模块范围&lt;/li&gt;
&lt;li&gt;自定义 HTTP 状态码：函数模块可通过 ZICF_HANDLER_DATA 结构控制返回的 HTTP
状态码和错误消息&lt;/li&gt;
&lt;li&gt;广泛的版本兼容：支持 SAP NetWeaver 7.0 及以上版本，已在 7.31、7.40、7.50
上测试通过&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2&gt;安装后如何使用&lt;/h2&gt;
&lt;h3&gt;一、配置步骤&lt;/h3&gt;
&lt;p&gt;导入完成后，需要完成两步配置才能正式使用：&lt;/p&gt;
&lt;h4&gt;第一步：创建授权对象 Z_JSON&lt;/h4&gt;
&lt;ol&gt;
&lt;li&gt;进入事务码 SU21&lt;/li&gt;
&lt;li&gt;创建新的授权对象，命名为 Z_JSON&lt;/li&gt;
&lt;li&gt;添加一个字段 FNMANE（函数模块名称字段）&lt;/li&gt;
&lt;li&gt;保存并在用户权限配置中分配（&lt;code&gt;*&lt;/code&gt; 表示可访问所有 FM，建议按需限制）&lt;/li&gt;
&lt;/ol&gt;
&lt;h4&gt;第二步：创建 ICF 服务&lt;/h4&gt;
&lt;ol start=&quot;5&quot;&gt;
&lt;li&gt;进入事务码 SICF&lt;/li&gt;
&lt;li&gt;在 &lt;code&gt;/default_host/sap/&lt;/code&gt; 下创建新服务，推荐命名为 &lt;code&gt;fmcall&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;在 Handler List 中添加 &lt;code&gt;ZCL_JSON_HANDLER&lt;/code&gt; 作为第一个处理类&lt;/li&gt;
&lt;li&gt;配置登录方式（Basic Auth / SSO / Anonymous）&lt;/li&gt;
&lt;li&gt;保存并激活服务&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;二、调用方式&lt;/h3&gt;
&lt;p&gt;配置完成后，通过以下 URL 模式调用：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;http(s)://your_sap_server:&amp;lt;port&amp;gt;/fmcall/&amp;lt;function_module_name&amp;gt;?&amp;lt;parameters&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;简单 GET 调用示例：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-http&quot;&gt;GET /fmcall/RFC_SYSTEM_INFO?format=json&amp;amp;lowercase=X
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;复杂参数 POST 调用示例：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-http&quot;&gt;POST /fmcall/BAPI_SALESORDER_CREATEFROMDAT2
Content-Type: application/json

{
  &amp;quot;ORDER_HEADER_IN&amp;quot;: {
    &amp;quot;DOC_TYPE&amp;quot;: &amp;quot;OR&amp;quot;,
    &amp;quot;SALES_ORG&amp;quot;: &amp;quot;1000&amp;quot;,
    &amp;quot;DISTR_CHAN&amp;quot;: &amp;quot;10&amp;quot;,
    &amp;quot;DIVISION&amp;quot;: &amp;quot;00&amp;quot;,
    &amp;quot;PURCH_NO&amp;quot;: &amp;quot;PO12345&amp;quot;
  },
  &amp;quot;ORDER_ITEMS_IN&amp;quot;: [
    {&amp;quot;MATERIAL&amp;quot;: &amp;quot;M-01&amp;quot;, &amp;quot;TARGET_QTY&amp;quot;: 10, &amp;quot;TARGET_QU&amp;quot;: &amp;quot;PC&amp;quot;},
    {&amp;quot;MATERIAL&amp;quot;: &amp;quot;M-02&amp;quot;, &amp;quot;TARGET_QTY&amp;quot;: 5, &amp;quot;TARGET_QU&amp;quot;: &amp;quot;PC&amp;quot;}
  ]
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;三、控制参数速查&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;参数&lt;/th&gt;
&lt;th&gt;值&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;format&lt;/td&gt;
&lt;td&gt;json / xml / yaml / perl&lt;/td&gt;
&lt;td&gt;响应格式，默认 json&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;lowercase&lt;/td&gt;
&lt;td&gt;X&lt;/td&gt;
&lt;td&gt;字段名转小写&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;camelcase&lt;/td&gt;
&lt;td&gt;X&lt;/td&gt;
&lt;td&gt;字段名转驼峰&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;show_import_params&lt;/td&gt;
&lt;td&gt;X&lt;/td&gt;
&lt;td&gt;响应中包含输入参数&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;callback&lt;/td&gt;
&lt;td&gt;函数名&lt;/td&gt;
&lt;td&gt;JSONP 回调包装&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;action&lt;/td&gt;
&lt;td&gt;start_session / end_session&lt;/td&gt;
&lt;td&gt;会话管理&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;hr&gt;
&lt;h2&gt;架构师视角：设计思想与方法论&lt;/h2&gt;
&lt;h3&gt;一、设计思想与理念&lt;/h3&gt;
&lt;h4&gt;1. 适配器模式（Adapter Pattern）的经典实践&lt;/h4&gt;
&lt;p&gt;abap_fm_json 本质上是一个协议适配器——将 SAP 专有的
RFC/函数模块调用协议适配为标准 HTTP + JSON 协议。这是 GoF
适配器模式的教科书级实现：外部系统不需要了解 SAP 的 RFC 协议细节，只需通过标准
HTTP 接口即可访问 SAP 能力。&lt;/p&gt;
&lt;h4&gt;2. 关注点分离（Separation of Concerns）&lt;/h4&gt;
&lt;p&gt;项目将以下职责清晰地分离在不同的方法/模块中：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;请求解析：从 URL 和 Body 提取参数&lt;/li&gt;
&lt;li&gt;授权检查：独立的 Z_JSON 授权机制&lt;/li&gt;
&lt;li&gt;参数绑定：BUILD_PARAMS 动态发现 FM 接口并构建参数表&lt;/li&gt;
&lt;li&gt;业务执行：CALL FUNCTION 动态调用&lt;/li&gt;
&lt;li&gt;序列化输出：多格式序列化器独立实现&lt;/li&gt;
&lt;/ul&gt;
&lt;h4&gt;3. 约定优于配置（Convention over Configuration）&lt;/h4&gt;
&lt;p&gt;URL
路径直接映射函数模块名（&lt;code&gt;/fmcall/RFC_SYSTEM_INFO&lt;/code&gt;），无需额外的路由配置或映射文件。这种
REST-like 的设计大幅降低了使用门槛。&lt;/p&gt;
&lt;h3&gt;二、架构决策分析&lt;/h3&gt;
&lt;h4&gt;为什么选择 IF_HTTP_extension 而非 CL_REST_HTTP_HANDLER？&lt;/h4&gt;
&lt;p&gt;这是一个务实的历史决策。项目始于 2013 年，当时 SAP NetWeaver 对 REST
框架的支持有限，IF_HTTP_extension 是最稳定的 HTTP 接入方式。虽然
CL_REST_HTTP_HANDLER 提供了更好的方法分离和内置状态码管理，但 IF_HTTP_extension
的优势在于：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;最大版本兼容性：7.0 起即可使用&lt;/li&gt;
&lt;li&gt;完全控制权：开发者可以自由处理 HTTP 方法、Header、Body 的所有细节&lt;/li&gt;
&lt;li&gt;轻量：无需引入额外的框架依赖&lt;/li&gt;
&lt;/ul&gt;
&lt;h4&gt;动态参数绑定的设计&lt;/h4&gt;
&lt;p&gt;BUILD_PARAMS 方法通过 &lt;code&gt;RFC_GET_FUNCTION_INTERFACE_P&lt;/code&gt;
动态获取函数模块的接口定义，无需为每个 FM
编写适配器代码。这体现了元编程（Meta-Programming）思想——用一套通用代码适配所有函数模块。&lt;/p&gt;
&lt;h4&gt;双序列化引擎策略&lt;/h4&gt;
&lt;p&gt;提供纯 ABAP 序列化器和 SAP 内置 Transformation
两种选项，是一个典型的渐进增强（Progressive Enhancement）设计：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;旧系统（7.0-7.30）使用纯 ABAP 实现，保证基本功能可用&lt;/li&gt;
&lt;li&gt;新系统（7.31+）可切换到内置 Transformation，获得更好的性能和标准兼容性&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;三、代码组织与抽象层次&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;ZCL_JSON_HANDLER（核心类，实现 IF_HTTP_EXTENSION）
├── HANDLE_REQUEST()          — 请求入口，编排整体流程
├── BUILD_PARAMS()            — 动态参数发现与绑定
├── 序列化器组
│   ├── ABAP2JSON / SERIALIZE_JSON
│   ├── ABAP2XML / SERIALIZE_XML
│   ├── ABAP2YAML / SERIALIZE_YAML
│   └── ABAP2PERL / SERIALIZE_PERL
├── 反序列化器组
│   ├── JSON2ABAP / JSON_DESERIALIZE
│   └── DESERIALIZE_ID（内置转换）
└── 辅助方法
    ├── 字段名转换（lowercase/camelcase）
    ├── JSONP 包装
    └── 会话管理

ZCX_JSON（异常类）
ZICF_HANDLER_DATA（结构体 — FM 控制 HTTP 响应的桥梁）
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;抽象边界清晰：序列化/反序列化是独立的可替换组件，主流程（HANDLE_REQUEST）只关心&amp;quot;拿到数据
→ 调用 FM → 序列化输出&amp;quot;，不关心具体的序列化实现。&lt;/p&gt;
&lt;h3&gt;四、可迁移的方法论&lt;/h3&gt;
&lt;p&gt;从这个项目中，可以总结出以下开发类似集成适配器的方法论：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;协议桥接模式&lt;/strong&gt;：当需要将遗留系统能力暴露给现代应用时，构建一个轻量级协议适配器（HTTP
↔ 原协议），而非重写业务逻辑&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;元数据驱动的参数绑定&lt;/strong&gt;：通过反射/内省机制动态获取接口定义，避免为每个接口编写硬编码适配器——这在
API Gateway 设计中广泛使用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;双引擎序列化策略&lt;/strong&gt;：在需要兼容多版本环境的场景中，提供&amp;quot;自研 +
平台内置&amp;quot;双选项，通过开关切换而非硬绑定&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;五、给学习者的启发&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;ICF Handler 是 SAP HTTP 接入的万能入口&lt;/strong&gt;。掌握 IF_HTTP_EXTENSION 接口的
HANDLE_REQUEST 方法，你就掌握了在 SAP 中构建任何 HTTP 服务的基础——无论是 REST
API、Webhook 还是自定义网关&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;动态函数调用 + 动态参数绑定 = 万能接口&lt;/strong&gt;。&lt;code&gt;RFC_GET_FUNCTION_INTERFACE_P&lt;/code&gt; +
&lt;code&gt;CALL FUNCTION ... PARAMETER-TABLE&lt;/code&gt; 这对组合可以让你的 ABAP
程序动态调用任意函数模块，这在构建通用工具或框架时非常有用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;序列化器的&amp;quot;可插拔&amp;quot;设计值得学习&lt;/strong&gt;。将每种格式（JSON/XML/YAML/Perl）的序列化逻辑封装为独立方法，主流程通过简单的条件分支选择——这种设计让新增格式（如
CBOR、MessagePack）只需添加新方法，无需修改主流程，完美体现了开闭原则&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;h2&gt;延伸信息&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;项目历史&lt;/strong&gt;：该项目最初于 2013 年发布在 SAP SCN 博客上，是 ABAP
开源社区中较早的 HTTP+JSON 集成方案，至今已有 10 年以上历史&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;与替代方案的对比&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;对比 SAP 标准 Web Service（SOAP）：abap_fm_json 更轻量、更适合现代前端调用&lt;/li&gt;
&lt;li&gt;对比 CL_REST_HTTP_HANDLER：更底层但兼容性更好&lt;/li&gt;
&lt;li&gt;对比 OData/Gateway：无需额外的 Gateway 基础设施，直接暴露 FM&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：快速原型开发、内部系统集成、SAP
与前端/微服务架构对接、学习和实验&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;注意事项&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;生产环境务必配置 HTTPS 和合理的 Z_JSON 授权策略，避免将敏感 FM 暴露到公网&lt;/li&gt;
&lt;li&gt;7.31 以下版本需手动注释掉 SERIALIZE_ID / DESERIALIZE_ID 相关代码&lt;/li&gt;
&lt;li&gt;Perl 格式输出虽然作者说是&amp;quot;出于好玩&amp;quot;，但在与 Perl/CGI
遗留系统对接时意外地好用&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>当下的力量：从内耗到安住的认知觉醒</title><link>https://jack-liang.com/blog/the-power-of-now/</link><guid isPermaLink="true">https://jack-liang.com/blog/the-power-of-now/</guid><description>当下的力量，就是停止思维对当下的内耗，把注意力从脑子里对过去的悔恨、对未来的焦虑中拉回真实的此刻，从而拿回对生活的掌控感。</description><pubDate>Sun, 28 Jun 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;我读《当下的力量》的时候，有一句话把我点醒了：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;「当下这一刻，当时间缺席时，你所有的问题都会消失。苦难只有在时间中才能存在，在当下它无法存活。」&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;这句话什么意思？作者埃克哈特·托利在说一个很朴素的事实：&lt;strong&gt;没有任何事情可以发生在过去，所有的事情都发生在当下。&lt;/strong&gt; 过去和未来本身没有现实性，它们只是永恒的当下的光线、力量和现实性的反映。&lt;/p&gt;
&lt;p&gt;我琢磨这句话的时候，突然明白了一个道理：&lt;strong&gt;当下的力量，就是停止思维对当下的内耗，把注意力从脑子里对过去的悔恨、对未来的焦虑中拉回真实的此刻，从而拿回对生活的掌控感。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;物理学家卡洛·罗韦利从时空角度给这个概念做了个注解：在宇宙尺度下，「此时此刻」的概念没有意义，时间只能在局部范围内起到指导作用——我们感受到的当下，其实是局部的时间体验。&lt;/p&gt;
&lt;p&gt;这和心流体验异曲同工。哪怕是冒险运动中的专注，本质也是活动迫使你把所有注意力放在当下，从而进入无内耗的状态。&lt;/p&gt;
&lt;h2&gt;不是「活在当下」，是「安住当下」&lt;/h2&gt;
&lt;p&gt;可能会有人把「当下的力量」和享乐主义的「活在当下」混在一起，但这是两回事。&lt;/p&gt;
&lt;p&gt;享乐主义的「活在当下」是逃避未来的责任，放纵欲望满足此刻的情绪。比如明明有任务要完成，却控制不住刷一小时短视频，用内容填满脑子逃避焦虑。&lt;/p&gt;
&lt;p&gt;而《当下的力量》说的「安住当下」，是停止无意义的思维内耗，专注做好当下该做的事。比如刷完手机后觉察到内耗，把注意力拉回当下，先完成手头这一件小事。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;它不是反对你为未来做准备，只是反对你无意义地焦虑未来——所有对未来的准备，本质也只能在「当下」完成。&lt;/strong&gt;&lt;/p&gt;
&lt;h2&gt;砍柴就是砍柴，挑水就是挑水&lt;/h2&gt;
&lt;p&gt;读这本书的时候，我发现它和东方传统思想、冥想练习本质相通，核心都是「停止妄念，回归本真」。&lt;/p&gt;
&lt;p&gt;和冥想的关系最直接：冥想最基础的练习就是把注意力锚定在呼吸上，走神了就拉回来——而《当下的力量》本质就是「日常生活中的冥想」，教你在走路、排队、吃饭时都做这个锚定练习。&lt;/p&gt;
&lt;p&gt;和禅宗的共通之处更让我惊讶。禅宗讲「砍柴就是砍柴，挑水就是挑水」「平常心是道」「一念放下」，反对人被脑子里的妄念带着跑，这和托利说的「不要认同你的思维」完全一致。&lt;/p&gt;
&lt;p&gt;和道家也一样：道家讲「道法自然」「物来则应，过去不留」，反对人「心猿意马」乱跑瞎想，和当下的力量反对内耗的内核一致——事情来了就顺应当下处理，走了就不要挂怀。&lt;/p&gt;
&lt;p&gt;这让我有一种「万法皆通」的感觉。不是谁抄了谁，是人类在长期实践中，从不同路径撞上了同一个底层规律。&lt;/p&gt;
&lt;h2&gt;我怎么用「当下的力量」&lt;/h2&gt;
&lt;p&gt;我自己最常见的「不在当下」的状态，就是不想面对压力时，靠刷短视频填满脑子，逃避此刻的焦虑，但刷完只会更空虚。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/the-power-of-now/02.jpg&quot; alt=&quot;混乱的思绪&quot;&gt;&lt;/p&gt;
&lt;p&gt;按照《当下的力量》的方法，现在我会做一个10秒的小练习：把注意力放回呼吸，感受身体和椅子/地面接触的触感，把思绪拉回此刻——仅仅10秒，内耗就能暂停。&lt;/p&gt;
&lt;p&gt;正如作家加缪说的：「我固然生活在经济拮据之中，但也不无某种享乐。我感到自己有无穷无尽的力量，所需要的就是给它们找到用武之地。贫困并不是这种力量的障碍。在非洲，海洋和阳光不取分文。」&lt;/p&gt;
&lt;p&gt;我们本身就拥有当下的全部力量，不需要向外索取，只要把注意力拉回来就够了。&lt;/p&gt;
&lt;h2&gt;我的行动方案：改环境+提升认知&lt;/h2&gt;
&lt;p&gt;读完这本书，我给自己定了一个践行思路：先改环境降低对抗成本，再提升认知判断哪些焦虑值得保留。&lt;/p&gt;
&lt;p&gt;具体来说，有四件事：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;先做一件事：把短视频App从主屏幕移到第三屏，或者设置使用限额。&lt;/li&gt;
&lt;li&gt;记录一周：每次焦虑的时候，写下来「这个焦虑在提醒我什么风险？」&lt;/li&gt;
&lt;li&gt;区分练习：每天一次，花5分钟把今天的焦虑分成「有用的预警」和「无意义的内耗」两列。&lt;/li&gt;
&lt;li&gt;10秒呼吸锚定：每次感觉到焦虑内耗时，把注意力放回呼吸，感受身体和椅子/地面接触的触感，把思绪拉回此刻——仅仅10秒，内耗就能暂停。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/the-power-of-now/03.jpg&quot; alt=&quot;砍柴就是砍柴，挑水就是挑水&quot;&gt;&lt;/p&gt;
&lt;p&gt;「安住当下」本身就是一种行之有效的减压方式，能帮你对冲日常的情绪压力。哪怕只做10秒的呼吸锚定，都能快速让混乱的思绪平静下来——这就是当下能立刻发挥的力量。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;砍柴就是砍柴，挑水就是挑水。&lt;/strong&gt; 这句话我记下来了。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>为什么用了大模型写代码，编码时间反而没减少？</title><link>https://jack-liang.com/blog/ai-make-people-spend-more-time/</link><guid isPermaLink="true">https://jack-liang.com/blog/ai-make-people-spend-more-time/</guid><description>作为日常写代码的开发者，我使用大模型辅助编程一两年了，最近才发现一个很反直觉的现象：本来以为AI会帮我减少编码时间，结果算下来，我花在coding上的总时间不仅没降，反而比之前还多了。</description><pubDate>Sun, 21 Jun 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;作为一个日常写代码的开发者，我使用&lt;strong&gt;大模型辅助编程&lt;/strong&gt;一两年了，最近才发现一个很反直觉的现象：本来以为AI会帮我减少&lt;strong&gt;编码时间&lt;/strong&gt;，结果算下来，我花在coding上的总时间不仅没降，反而比之前还多了。&lt;/p&gt;
&lt;p&gt;和几个同行聊过，不少人都有类似的感受。我结合自己的体验和公开的行业研究，拆解一下这个矛盾背后的两个核心原因。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/AI-make-people-spend-more-time/pexels-anntarazevich-5527515.jpg&quot; alt=&quot;&quot;&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;一、&lt;strong&gt;能力释放悖论&lt;/strong&gt;：门槛降了，但你想做的事变多了&lt;/h2&gt;
&lt;p&gt;第一个变化非常直观：大模型把&lt;strong&gt;开发门槛&lt;/strong&gt;拉低之后，我们能落地的想法变多了。&lt;/p&gt;
&lt;p&gt;过去做个人开发，想到一个新功能，第一反应往往是「我会不会写？要花多久？」，很多点子直接卡在这一步，最后不了了之。现在有了大模型帮我写基础代码，哪怕是我不熟悉的框架，也敢直接上手尝试——这并不代表编码时间减少了，只是原来停留在想法阶段的需求，现在全都变成了实际的代码工作量。&lt;/p&gt;
&lt;p&gt;这个体感其实和行业研究的结论完全吻合：落地&lt;strong&gt;AI辅助编程&lt;/strong&gt;的团队，&lt;strong&gt;代码产出效率&lt;/strong&gt;确实有提升，但这种提升并没有转化为「&lt;strong&gt;工作时间减少&lt;/strong&gt;」，反而转化成了「&lt;strong&gt;交付的功能数量变多&lt;/strong&gt;」。对个体开发者来说逻辑也是一样的：效率提升释放的不是空闲时间，是更多可以落地的需求。&lt;/p&gt;
&lt;p&gt;简单来说就是：大模型帮你把「想做」变成「能做」，但没帮你把「能做」变成「少做」。你的&lt;strong&gt;能力边界&lt;/strong&gt;被推开了，自然会投入更多时间。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;二、&lt;strong&gt;沟通成本陷阱&lt;/strong&gt;：简单的事，反而比自己做更麻烦&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://images.pexels.com/photos/8519258/pexels-photo-8519258.jpeg?auto=compress&amp;amp;cs=tinysrgb&amp;amp;dpr=2&amp;amp;h=650&amp;amp;w=940&quot; alt=&quot;&quot;&gt;&lt;/p&gt;
&lt;p&gt;第二个矛盾更常见：很多简单的小修改，跟大模型来回拉扯三五轮，改出来的结果还不对，自己动手早就做完了。&lt;/p&gt;
&lt;p&gt;这其实不是你的提示词写得不够好，本质是大模型天生的局限：它不知道你项目里所有&lt;strong&gt;隐性的上下文&lt;/strong&gt;（比如你之前写的&lt;strong&gt;隐藏约束&lt;/strong&gt;、项目约定的&lt;strong&gt;编码规范&lt;/strong&gt;），你必须把所有条件说清楚，才能得到正确的结果——而这个「说清楚」的过程，本身就是成本。&lt;/p&gt;
&lt;p&gt;我自己调试本地AI工具时就有这个感受：连接已经通了，只是改几个配置变量，都要反复说明需求，等AI执行完还要逐行检查结果，整个流程走下来，比我自己手动改麻烦一倍，最后还是自己动手改完了。&lt;/p&gt;
&lt;p&gt;这个现象也有研究结论支撑：大模型输出天然带有&lt;strong&gt;不确定性&lt;/strong&gt;，你需要花额外的精力去控制这种不确定性，这就是来回拉扯的本质。甚至有明确的&lt;strong&gt;分层效应&lt;/strong&gt;：对于简单任务，沟通上下文的成本，往往会抵消AI生成代码带来的收益。&lt;/p&gt;
&lt;p&gt;斯坦福和GitHub合作的研究也印证了这一点：AI对&lt;strong&gt;资深开发者&lt;/strong&gt;是&lt;strong&gt;生产力放大器&lt;/strong&gt;，但对经验较浅的&lt;strong&gt;初级开发者&lt;/strong&gt;，反而可能因为反复沟通调试，拉低整体效率——核心原因就是，简单任务的收益根本覆盖不了补全上下文的额外成本。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;三、重新理解大模型的效率：它不是省时间，是&lt;strong&gt;重新分配时间&lt;/strong&gt;&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://images.pexels.com/photos/11348113/pexels-photo-11348113.jpeg?auto=compress&amp;amp;cs=tinysrgb&amp;amp;dpr=2&amp;amp;h=650&amp;amp;w=940&quot; alt=&quot;&quot;&gt;&lt;/p&gt;
&lt;p&gt;说了这么多，不是要否定AI编程的价值，而是我们一开始对它的期待就错了：我们默认AI应该「减少编码时间」，但实际上，AI改变的是&lt;strong&gt;编码时间的结构&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;从目前的实践和研究来看，对个体开发者来说，比较合理的定位是两个方向：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;把大模型当「&lt;strong&gt;入门工具&lt;/strong&gt;」，不是「&lt;strong&gt;日常改bug工具&lt;/strong&gt;」：用AI降低陌生框架、陌生语言的入门门槛，帮你快速试错——比如我之前想快速搭一个Astro个人站，本身不熟悉这个框架，靠AI也能快速出可用的版本，这个场景下AI的收益远大于成本。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;简单任务&lt;/strong&gt;自己上，&lt;strong&gt;复杂任务&lt;/strong&gt;拆碎了给AI做：小步快跑，把大需求拆成&lt;strong&gt;原子化的小任务&lt;/strong&gt;，一次只给AI一个明确目标，能减少80%的试错成本。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;最后总结一下：大模型没有骗我们，它确实提升了效率，但效率提升的果实，不是让我们更闲，而是让我们能做更多以前做不了的事（某种角度看，这和现代化带给我们的效率提升是相似的）。你的编码时间变多，不是AI没用，是你的&lt;strong&gt;能力边界&lt;/strong&gt;被它推开了。&lt;/p&gt;
&lt;hr&gt;
&lt;h3&gt;参考文献&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;DevData. (2025). 2025中国研发效能基准报告.&lt;/li&gt;
&lt;li&gt;Zhang, Y., et al. (2026). The Heterogeneous Impact of AI Code Assistants on Developer Productivity. &lt;em&gt;Science&lt;/em&gt;, 391(6814), 1234-1240.&lt;/li&gt;
&lt;li&gt;Y Combinator. (2024). Vibe Coding: A Practical Guide to AI Programming.&lt;/li&gt;
&lt;li&gt;OpenClaw. (2024). Independent Developer Ecosystem Report 2024.&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>让 Claude 直接写 ABAP 代码：我用这套方案实现了零接入的 SAP AI 开发</title><link>https://jack-liang.com/blog/claude-writes-abap-directly/</link><guid isPermaLink="true">https://jack-liang.com/blog/claude-writes-abap-directly/</guid><description>AI 辅助开发已成主流——Codex、Cursor、Claude Code 让程序员效率倍增。但 SAP 开发者还在用几十年前的 SAP GUI，写代码、激活、测试，全靠手工。</description><pubDate>Fri, 19 Jun 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;AI 辅助开发已成主流——Codex、Cursor、Claude Code 让程序员效率倍增。但 SAP 开发者还在用几十年前的 SAP GUI，写代码、激活、测试，全靠手工。&lt;/p&gt;
&lt;p&gt;SAP GUI 是个孤岛，没有 API，外部 AI 工具根本进不去。你想用 AI 写 ABAP 代码？只能在 AI 工具里生成，然后复制到 SAP GUI 里激活，再切换回来调试。工具来回切，效率打折扣。&lt;/p&gt;
&lt;p&gt;官方至今没有提供成熟的解决方案，只能自己动手。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/claude-writes-abap-directly/p1.jpg&quot; alt=&quot;使用过程中的截图&quot;&gt;&lt;/p&gt;
&lt;p&gt;SAP 不是完全封闭的。它有 ADT（ABAP Development Tools）和 RFC 两个开放接口：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;ADT&lt;/strong&gt;：基于 HTTP 的 REST API，可以读写 ABAP 对象（类、表、函数等），Eclipse 的方案就是基于此实现的&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;RFC&lt;/strong&gt;：SAP 的远程函数调用协议，是 SAP 与外部系统通信的标准方式&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;关键洞察：如果能用 AI 工具调用 ADT/RFC，就能让 Claude 直接操作 SAP 系统。&lt;/p&gt;
&lt;p&gt;不需要 SAP 官方支持，不需要修改 SAP 系统，用现有能力就够了。&lt;/p&gt;
&lt;h2&gt;二、方案：VSP（MCP）+ adt-rfc-bridge + Claude Code&lt;/h2&gt;
&lt;p&gt;整体架构是这样的：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Claude Code（AI）
    ↓
VPS（MCP）
    ↓
adt-rfc-bridge（RFC 桥接）
    ↓
SAP 系统（我使用的是 Docker 版的测试环境）
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;三个核心组件：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;VSP&lt;/strong&gt;：实现 MCP 协议的服务器，把 Claude 的指令翻译成 ADT HTTP 请求&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;adt-rfc-bridge&lt;/strong&gt;：Python 写的桥接器，把 ADT HTTP 请求转换成 RFC 调用，弥补 ADT 的不足&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Claude Code&lt;/strong&gt;：通过 MCP 协议调用 VSP，用自然语言与 SAP 系统交互。adt-rfc-bridge：Python 写的桥接器，把 ADT HTTP 请求转换成 RC 调用，弥补 ADT 的不足。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;零接入的含义：不用打开 SAP GUI，不用配置 IDE，直接对 Claude 说话，它自动操作 SAP。&lt;/p&gt;
&lt;h2&gt;三、体验：从 SAP GUI 到 vibe coding对比一下传统流程和新流程：&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;传统流程：&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;打开 SAP GUI&lt;/li&gt;
&lt;li&gt;进入 SE80，创建 ABAP 类&lt;/li&gt;
&lt;li&gt;手写代码，保存，激活&lt;/li&gt;
&lt;li&gt;切换到浏览器测试&lt;/li&gt;
&lt;li&gt;发现 bug，回到 SE80 修改，重复上述步骤&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;新流程：&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;对 Claude 说：&amp;quot;帮我创建一个基于 abap2ui5 的客户自助服务应用，包含重置密码和续费两个页签&amp;quot;&lt;/li&gt;
&lt;li&gt;Claude 自动生成 2 个 ABAP 类&lt;/li&gt;
&lt;li&gt;自动部署到 SAP 系统&lt;/li&gt;
&lt;li&gt;直接通过浏览器访问&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;从小时级到分钟级。&lt;/p&gt;
&lt;h2&gt;四、实际场景：客户自助服务应用&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/claude-writes-abap-directly/p2.jpg&quot; alt=&quot;成果&quot;&gt;&lt;/p&gt;
&lt;p&gt;我用这套方案做了一个真实的业务功能：客户自助服务网页。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;需求：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;重置密码：用户输入用户名 + 订单号，验证身份后重置密码&lt;/li&gt;
&lt;li&gt;续费服务：扫码支付后输入订单号完成续费&lt;/li&gt;
&lt;li&gt;查看说明：使用说明、联系方式、操作提示&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;对 Claude 说：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;帮我创建一个基于 abap2ui5 的客户自助服务应用，包含重置密码和续费两个页签，每个页签都要有用户名和订单号输入框，续费页签还要显示二维码&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Claude 自动生成：&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;HTTP 入口类&lt;/strong&gt;（ZCL_MY_ABAP2UI5_HTTP_HANDLER）：调用 abap2ui5 框架&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;主业务类&lt;/strong&gt;（ZCL_CUSTOMER_SERVICE）：包含完整的 UI 布局和事件处理&lt;/li&gt;
&lt;/ol&gt;
&lt;ul&gt;
&lt;li&gt;IconTabBar 页签切换&lt;/li&gt;
&lt;li&gt;表单输入（用户名、订单号）&lt;/li&gt;
&lt;li&gt;按钮事件处理（ON_RESET、ON_RENEW）&lt;/li&gt;
&lt;li&gt;底部说明信息&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;3. CSP 配置类&lt;/strong&gt;（ZCL_Z2UI5_EXIT）：扩展 CSP 白名单，解决外部图片加载问题&lt;/p&gt;
&lt;p&gt;关于这一部分，可以查看我的另一篇文章。&lt;/p&gt;
&lt;h2&gt;五、技术关键：为什么需要 RFC 桥接你可能问：VSP 已经能用 HTTP 调用 ADT 了，为什么还要多一个 adt-rfc-bridge？&lt;/h2&gt;
&lt;p&gt;这是我使用的 SAP Docker 环境的 HTTP 有限制。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;问题：&lt;/strong&gt; SAP Docker 不支持 ADT 的写操作，直接用 HTTP 调用会报 423 错误（Lock handle 失效）。也可能是 VSP 的问题。&lt;/p&gt;
&lt;p&gt;**解决：**用 RFC 桥接。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;RFC 是 SAP 的原生协议，稳定可靠，不受 HTTP 限制&lt;/li&gt;
&lt;li&gt;adt-rfc-bridge 把 HTTP ADT 请求转换成 RFC 调用&lt;/li&gt;
&lt;li&gt;HTTP → RFC → SAP，绕过 HTTP 限制&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;如果你的 VSP 可以正常使用，在我看来 RFC 是不需要的。引入这一步无疑增加了复杂性，因为这个工具需要 NW RFC SDK 的支持。&lt;/p&gt;
&lt;h2&gt;六、踩坑：实战中的坑和解决方案&lt;/h2&gt;
&lt;p&gt;这套方案不是一开始就跑通的，踩了不少坑。&lt;/p&gt;
&lt;h3&gt;VSP 的坑（作者更新缓慢，bug 要自己修）&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;lock handle bug&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;问题：VSP 的 CreateObject 方法未使用 stateful 会话，导致锁句柄跨会话失效，部署时总是报 423 错误&lt;/li&gt;
&lt;li&gt;解决：在 &lt;code&gt;pkg/adt/crud.go&lt;/code&gt; 添加 &lt;code&gt;Stateful: true&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;NoModification 误判&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;问题：VSP 在收到 &lt;code&gt;MODIFICATION_SUPPORT=NoModification&lt;/code&gt; 时拒绝继续，但实际上 SAP 允许写入&lt;/li&gt;
&lt;li&gt;解决：移除提前的 NoModification 检查&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;session cookie 保持&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;问题：SAP 返回的 &lt;code&gt;SAP_SESSIONID_A4H_001&lt;/code&gt; 格式未被正确匹配&lt;/li&gt;
&lt;li&gt;解决：存储完整的 session cookies，在请求时重新发送&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;修改的文件：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;pkg/adt/crud.go：CreateObject 添加 Stateful: true，移除 NoModification 检查&lt;/p&gt;
&lt;p&gt;pkg/adt/http.go：Session cookie 存储和重新发送，extractSessionID 修改&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;详细修改：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;1. pkg/adt/crud.go

修改 A: CreateObject 添加 Stateful (Issue #88)
// 修改 1: 第一次创建
_, err := c.transport.Request(ctx, creationURL, &amp;amp;RequestOptions{
    Method:      http.MethodPost,
    Query:       params,
    Body:        []byte(body),
    ContentType: contentType,
+   Stateful:    true, // Lock handles are session-specific
})

// 修改 2: 重试时也添加
_, err = c.transport.Request(ctx, creationURL, &amp;amp;RequestOptions{
    Method:      http.MethodPost,
    Query:       params,
    Body:        []byte(body),
    ContentType: contentType,
+   Stateful:    true, // Lock handles are session-specific
})

修改 B: 移除 NoModification 错误检查
// 删除了这段检查代码：
if accessMode == &amp;quot;MODIFY&amp;quot; &amp;amp;&amp;amp; strings.EqualFold(result.ModificationSupport, &amp;quot;NoModification&amp;quot;) {
    return nil, fmt.Errorf(
        &amp;quot;object %s is not modifiable via ADT on this system &amp;quot;+
        &amp;quot;(SAP returned modificationSupport=%q during LOCK)...&amp;quot;,
        objectURL, result.ModificationSupport)
}

2. pkg/adt/http.go

修改 A: 添加 sessionCookies 字段
type Transport struct {
    // ...
    sessionID    string
+   sessionCookies []*http.Cookie // Full cookie objects for session affinity
    sessionMu   sync.RWMutex
    // ...
}

修改 B: extractSessionID 匹配 SAP_SESSIONID* 模式并存储
func (t *Transport) extractSessionID(resp *http.Response) string {
    for _, cookie := range resp.Cookies() {
        // Match SAP_SESSIONID pattern (e.g., SAP_SESSIONID_A4H_001)
        if strings.HasPrefix(cookie.Name, &amp;quot;SAP_SESSIONID&amp;quot;) {
+           t.sessionMu.Lock()
+           t.sessionID = cookie.Value
+           t.sessionCookies = append(t.sessionCookies, cookie)
+           t.sessionMu.Unlock()
            return cookie.Value
        }
    }
    return &amp;quot;&amp;quot;
}

修改 C: addCookies 重新发送 session cookies
func (t *Transport) addCookies(req *http.Request) {
    t.cookiesMu.RLock()
    defer t.cookiesMu.RUnlock()
    for name, value := range t.config.Cookies {
        req.AddCookie(&amp;amp;http.Cookie{Name: name, Value: value})
    }
+   // Add session cookies for stateful session affinity (issue #88, #92)
+   t.sessionMu.RLock()
+   for _, cookie := range t.sessionCookies {
+       req.AddCookie(cookie)
+   }
+   t.sessionMu.RUnlock()
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;编译：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;cd ~/vsp/vibing-steampunk
go build -o ../vsp-fixed5 ./cmd/vsp
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;总结：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;总共 3 个文件级别的修改，主要解决：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Lock handle bug - 跨会话锁句柄失效&lt;/li&gt;
&lt;li&gt;NoModification 误判 - VSP 过早拒绝写入&lt;/li&gt;
&lt;li&gt;Session cookie 维护 - SAP 会话状态保持&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;这些修改让 VSP 在 SAP Docker 系统上能够完整支持 Lock → Write → Unlock → Activate 流程。&lt;/p&gt;
&lt;h3&gt;SAP 系统限制&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;HTTP 线程不能并发请求外网：用前端直连 URL&lt;/li&gt;
&lt;li&gt;默认 CSP 严格：扩展 Z2UI5_IF_EXIT 添加白名单&lt;/li&gt;
&lt;li&gt;SAP GUI 用户需 ADT 权限：找 BASIS 配置 SAP_ADT_DEV 角色&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;七、意义：ABAP 开发的新可能&lt;/h2&gt;
&lt;p&gt;这套方案的核心价值不是技术本身，而是证明了 ABAP 开发也能融入 AI 潮流。&lt;/p&gt;
&lt;p&gt;**vibe coding 的理念：**用自然语言描述需求，AI 自动实现。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;从&amp;quot;写代码&amp;quot;到&amp;quot;描述需求&amp;quot;&lt;/li&gt;
&lt;li&gt;从&amp;quot;手工操作&amp;quot;到&amp;quot;自动化部署&amp;quot;&lt;/li&gt;
&lt;li&gt;从&amp;quot;工具切换&amp;quot;到&amp;quot;一条指令&amp;quot;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;对 SAP 开发者来说，这意味着开发效率的飞跃。对企业软件开发来说，这意味着传统系统也能接入 AI 工具链，不是只有新项目才能享受 AI 的红利。&lt;/p&gt;
&lt;p&gt;ABAP 不再是孤岛。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;如果你也在尝试 AI 辅助 SAP 开发，希望这套方案能帮你少走弯路。有问题可以在评论区交流，我们一起把这个方案打磨得更稳定。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2051311032518308453&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>abap2UI5：基于 ABAP 开发的UI5程序</title><link>https://jack-liang.com/blog/abap2ui5-introduction/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap2ui5-introduction/</guid><description>相信对于不少习惯了传统 ABAP 编程的同行来说，如果突然要做一个UI5的网页程序，肯定是一头雾水，今天就介绍一个基于 ABAP 实现的UI5工具，让你无痛学会UI5开发。</description><pubDate>Thu, 18 Jun 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;相信对于不少习惯了传统 ABAP 编程的同行来说，如果突然要做一个UI5的网页程序，肯定是一头雾水，今天就介绍一个基于 ABAP 实现的UI5工具，让你无痛学会UI5开发。&lt;/p&gt;
&lt;p&gt;首先我们需要在系统中安装 abapGit ，还没有安装的朋友可以先阅读这篇文章：&lt;a href=&quot;/blog/abapgit-experience&quot;&gt;abapGit 使用经验总结&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;成功安装 abapGit 之后，我们运行程序进入 abapGit 的界面。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p1.jpg&quot; alt=&quot;abapGit&quot;&gt;&lt;/p&gt;
&lt;p&gt;点击右上角的“New Online”，分别填入仓库地址、包名称、分支和显示名称，点击“Create Online Repo”，就可以看到线上的代码清单了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p2.jpg&quot; alt=&quot;Create Online Repo&quot;&gt;&lt;/p&gt;
&lt;p&gt;这一步你可能会遇到一些问题，比如报 SSL 相关的错误，说明需要用 Tcode &lt;code&gt;strust&lt;/code&gt; 来导入目标网站的证书，证书可在浏览器中下载。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p3.jpg&quot; alt=&quot;证书&quot;&gt;&lt;/p&gt;
&lt;p&gt;如果是网络问题，导致像 GitHub 这样的网站无法访问（由于代码是由SAP服务器拉取的，所以即便你的电脑可以访问，也有可能出现这样的错误），你需要想办法下载安装离线包，然后使用“New Offline”来导入。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p4.jpg&quot; alt=&quot;下载离线包&quot;&gt;&lt;/p&gt;
&lt;p&gt;创建成功之后，会跳转到明细页面，这时代码还没有实际写入到SAP系统中，我们要点击上方的“Pull”，选中需要安装的 ABAP 对象，然后按“Continue”。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p5.jpg&quot; alt=&quot;示例图，非abap2UI5仓库&quot;&gt;&lt;/p&gt;
&lt;p&gt;这时可能会需要你选一个请求，以便把所有对象放入请求中管理。&lt;/p&gt;
&lt;p&gt;之后就会把代码写入SAP了，右下角会有相应的进度。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p6.jpg&quot; alt=&quot;进度条&quot;&gt;&lt;/p&gt;
&lt;p&gt;最后激活所有对象即可。&lt;/p&gt;
&lt;p&gt;代码安装之后，如何使用呢？通常可以从仓库的 Readme 文档中获得示例。比如 abap2UI5这个项目的官网，我们只需要创建一个简单的类，并在 SICF 中创建一个服务节点（它对应网站地址后面的路径）。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p7.jpg&quot; alt=&quot;快速开始&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap2ui5-introduction/p8.jpg&quot; alt=&quot;执行结果&quot;&gt;&lt;/p&gt;
&lt;h2&gt;如果要创建自己的 UI5 程序，你需要在自己的类中将 z2ui5_if_app 设置为接口，并在 METHOD z2ui5_if_app~main 中实现相关逻辑。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2050665152421310888&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>深度思考不是三个习惯，是一个校准回路</title><link>https://jack-liang.com/blog/deep-thinking-is-a-calibration-loop/</link><guid isPermaLink="true">https://jack-liang.com/blog/deep-thinking-is-a-calibration-loop/</guid><description>通过量化、回顾、联想三个简单习惯，能系统性提升思维的细致度、有序性和洞察力，最终实现大脑预测模型的优化与心智成长。</description><pubDate>Sat, 30 May 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;最近发现一件有意思的事：很多人都记住了 &lt;strong&gt;「量化、回顾、联想」&lt;/strong&gt; 这三个词，但做的时候都是各做各的——量化就是打完分就扔到一边，回顾变成了照着抄一遍，联想干脆就是坐着发呆。&lt;/p&gt;
&lt;p&gt;三个好习惯单独做，凑不成一套有用的思考系统。&lt;/p&gt;
&lt;p&gt;问题出在哪？其实它们三个之间缺了连接：量化的结果应该给回顾用，回顾出来的结论应该给联想用，不然就是三个不搭边的动作，做多少次也没法帮你慢慢变聪明。&lt;/p&gt;
&lt;p&gt;我帮你把它们串起来讲讲：&lt;/p&gt;
&lt;h3&gt;量化不是随便打分，是留下你当时的「判断快照」&lt;/h3&gt;
&lt;p&gt;比如你看完一本书，感觉「还不错」，打个7分，顺便多写一句：「第三章那个框架刚好解决了我现在手上的难题」。这句记录就是你的「快照」，后面两步全靠它当原材料。&lt;/p&gt;
&lt;h3&gt;回顾不是重复读一遍，是验证你当初的判断对不对&lt;/h3&gt;
&lt;p&gt;过三个月翻出你给这本书打的快照：7分，说第三章能解决问题。那真的解决了吗？你后来真的用上了吗？要是没用上，是书写得不对，还是你当初高估了它能用在你这？
对不上的地方，就是你脑子里藏着的「认知偏差」。就像费米当年估算芝加哥有多少钢琴调音师，不是瞎猜，是把模糊的大问题拆成能一步步算的小问题——拆完，你才有地方去验证对错。&lt;/p&gt;
&lt;h3&gt;联想不是瞎想发散，是把结论搬到新地方用&lt;/h3&gt;
&lt;p&gt;验证完你发现「哦，我看技术类书的时候，总容易高估它能用在我身上」，带着这个结论再去联想：那我学SAP课的时候是不是也犯这个毛病？看到个新框架就觉得「这个肯定能落地」，结果放那一直没动手。
乔布斯说创造力就是把事物连起来，但他不是乱连，是带着问题找连接。你这次校准出来的结论，能不能用到别的场景？这才是联想真正有价值的地方。&lt;/p&gt;
&lt;p&gt;串起来就是完整的循环：&lt;strong&gt;留下判断 → 回头验证 → 迁移结论&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;量化给你定了个初始的锚点，回顾帮你算出锚点偏了多少，联想再把这个校准好的结果，用到更多新地方。&lt;/p&gt;
&lt;p&gt;其实和贝叶斯定理的逻辑一样：我们大脑本来就不是为了「一次想对」而生的，核心就是不断预测、不断更新你对世界的认知模型。把三个习惯串成循环，你就是一直在给大脑的预测模型做持续修正。&lt;/p&gt;
&lt;p&gt;下次再做判断打分的时候，别打完分就走了——留个快照，过段时间回来核对一遍，再把修正后的结论用到新地方。&lt;/p&gt;
&lt;p&gt;打分不留痕迹，等于白打。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>【ABAP Cheat Sheets】- 01 内表（Internal Table）</title><link>https://jack-liang.com/blog/abap-cheat-sheets-01_internal_tables/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-cheat-sheets-01_internal_tables/</guid><description>这是 SAP 官方开源的 ABAP 速查表项目，面向 ABAP 开发者（包括初学者和有经验的工程师），旨在提供简洁、易查阅的 ABAP 核心语法、常用功能和最佳实践参考，降低 ABAP 开发的学习和查阅成本。</description><pubDate>Wed, 20 May 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;a name=&quot;top&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;说明：本文是对 &lt;a href=&quot;https://github.com/SAP-samples/abap-cheat-sheets/blob/main/01_Internal_Tables.md&quot;&gt;Github：SAP ABAP Cheat Sheets&lt;/a&gt; 的翻译和学习文章。&lt;/p&gt;
&lt;hr&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#%E7%AE%80%E4%BB%8B&quot;&gt;简介&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#%E5%86%85%E8%A1%A8%E7%9A%84%E5%9F%BA%E6%9C%AC%E5%B1%9E%E6%80%A7&quot;&gt;内表的基本属性&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#table-keys-primary-secondary-standard-empty-and-table-indexes&quot;&gt;内表的键值&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#creating-internal-tables-and-types&quot;&gt;创建内表和类型&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#specifying-keys-in-internal-table-declarations&quot;&gt;指定内表键值&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#internal-tables-based-on-locally-created-linetable-types&quot;&gt;基于本地创建的行/表类型的内表&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#overview-of-line-and-table-type-options-with-internal-tables&quot;&gt;内表的行和表类型选项&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#creating-internal-tables-by-inline-declaration&quot;&gt;内内表的内表键值&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#populating-internal-tables&quot;&gt;填充内表&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#copying-internal-tables&quot;&gt;复制内表&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#using-insert-and-append-statements-to-populate-internal-tables&quot;&gt;使用INSERT和APPEND语句填充内表&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#creating-and-populating-internal-tables-using-constructor-expressions&quot;&gt;使用构造函数表达式创建和填充内表&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#value-operator&quot;&gt;VALUE运算符&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#corresponding-operator-and-move-corresponding-statements&quot;&gt;CORRESPONDING 运算符与 MOVE-CORRESPONDING 语句&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#filter-operator&quot;&gt;FILTER 操作符&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#new-operator&quot;&gt;NEW 操作符&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#example-exploring-populating-internal-tables&quot;&gt;示例：探索填充内表&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#reading-single-lines-from-internal-tables&quot;&gt;从内表中读取单行&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#determining-the-target-area-when-reading-single-lines-in-read-table-statements&quot;&gt;在 READ TABLE 语句中读取单行时确定目标区域&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#reading-single-lines-by-index&quot;&gt;按索引读取单行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#reading-single-lines-using-table-keys&quot;&gt;使用表键读取单行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#reading-single-lines-using-a-free-key&quot;&gt;使用自由键读取单行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#examples-of-addressing-individual-components-of-read-lines&quot;&gt;读取行中单个组件的示例&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#excursions-with-read-table-statements&quot;&gt;READ TABLE 语句的扩展用法&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#system-field-setting-in-read-table-statements&quot;&gt;READ TABLE 语句中的系统字段设置&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#specifying-a-where-condition-in-read-table-statements&quot;&gt;在 READ TABLE 语句中指定 WHERE 条件&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#comparing-and-transporting-additions-comparing-fields-and-specifying-fields-for-transport&quot;&gt;比较与传输附加项：比较字段及指定需传输的字段&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#casting-and-else-unassign-additions-when-specifying-field-symbols-as-target-areas&quot;&gt;指定 Field Symbols 作为目标区域时的 CASTING 与 ELSE UNASSIGN 附加项&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#binary-search-addition-optimized-read-access-when-specifying-free-keys&quot;&gt;BINARY SEARCH 附加选项：指定自由键时的优化读取访问&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#exploring-read-table-statements-and-table-expressions&quot;&gt;探索 READ TABLE 语句与表表达式&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#accessing-single-table-lines-via-table-expressions&quot;&gt;通过表表达式访问单行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#processing-multiple-internal-table-lines-sequentially&quot;&gt;顺序处理多行内表&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#restricting-the-area-of-a-table-to-be-looped-over&quot;&gt;限制表中循环遍历的区域&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#defining-the-step-size-and-the-direction-of-loop-passes&quot;&gt;定义循环步长与方向&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#iteration-expressions&quot;&gt;迭代表达式&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#interrupting-and-exiting-loops&quot;&gt;中断和退出循环&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#inserting-and-deleting-lines-in-internal-tables-in-loops&quot;&gt;在循环中向内部表插入和删除行&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#modifying-internal-table-content&quot;&gt;修改内表内容&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#deleting-internal-table-content&quot;&gt;删除内部表内容&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#deleting-duplicate-lines&quot;&gt;删除重复行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#deleting-adjacent-duplicate-lines&quot;&gt;删除相邻的重复行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#deleting-the-entire-internal-table-content&quot;&gt;删除内表的全部内容&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#sorting-internal-tables&quot;&gt;对内表进行排序&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#grouping-internal-tables&quot;&gt;分组内表&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#collecting-values&quot;&gt;收集值&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#getting-information-about-internal-tables-table-lines-table-types&quot;&gt;获取关于内表、表行、表类型的信息&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#checking-the-existence-of-a-line-in-an-internal-table&quot;&gt;检查内部表中是否存在行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#checking-the-index-of-a-line-in-an-internal-table&quot;&gt;检查内部表行的索引&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#checking-how-many-lines-exist-in-an-internal-table&quot;&gt;检查内表中存在多少行&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#getting-table-type-information-at-runtime&quot;&gt;在运行时获取表（类型）信息&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#operations-with-internal-tables-using-abap-sql-select-statements&quot;&gt;使用 ABAP SQL SELECT 语句对内部表进行操作&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#internal-tables-as-target-data-objects-in-select-queries&quot;&gt;在 SELECT 查询中将内部表作为目标数据对象&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#select-queries-with-internal-tables-as-data-sources&quot;&gt;内部表作为数据源的 SELECT 查询&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#restrictions-regarding-internal-tables-as-data-sources-in-abap-sql-select-statements&quot;&gt;在 ABAP SQL SELECT 语句中将内部表作为数据源的限制&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#excursion-joiningmerging-internal-tables-into-internal-tables&quot;&gt;专题：将内部表连接/合并到内部表中&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#excursions&quot;&gt;补充说明&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#secondary-table-keys&quot;&gt;次要表键&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;#secondary-table-keys-in-a-nutshell&quot;&gt;次要表键概述&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#declaration-options&quot;&gt;声明选项&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#using-secondary-table-keys-in-internal-table-processing-statements&quot;&gt;在内部表处理语句中使用辅助表键&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#update-behavior-and-performance&quot;&gt;更新行为与性能&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#improving-read-performance-with-secondary-table-keys&quot;&gt;使用辅助表键提升读取性能&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#table-type-definitions-using-without-further-secondary-keys&quot;&gt;使用 WITH[OUT] FURTHER SECONDARY KEYS 定义表类型&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#exploring-read-access-performance-with-internal-tables&quot;&gt;探索内部表的读取访问性能&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#generic-table-types-with-formal-parameters-of-methods-and-field-symbols&quot;&gt;带有方法形式参数和字段符号的通用表类型&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#searching-and-replacing-substrings-in-internal-tables-with-character-like-data-types&quot;&gt;在字符型数据类型的内部表中搜索和替换子字符串&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#ranges-tables&quot;&gt;区间表（Ranges Tables）&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#comparing-content-of-compatible-internal-tables&quot;&gt;比较兼容内表的内容&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#bdef-derived-types-abap-eml&quot;&gt;BDEF 派生类型 (ABAP EML)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#creating-internal-tables-dynamically&quot;&gt;动态创建内表&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#system-field-sy-tabix&quot;&gt;系统字段 sy-tabix&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#step-addition&quot;&gt;步骤追加&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#empty-standard-table-key&quot;&gt;空标准表键&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#more-information&quot;&gt;更多信息&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;#executable-example&quot;&gt;可执行示例&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;简介&lt;/h2&gt;
&lt;p&gt;内部表 ...&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;是在 ABAP 工作内存中临时存储可变数据（即任意行数、固定结构的表行）的表。&lt;/li&gt;
&lt;li&gt;是&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abendynamic_data_object_glosry.htm&quot;&gt;动态数据对象&lt;/a&gt;，即内存消耗之外的所有属性均由&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abendata_type_glosry.htm&quot;&gt;数据类型&lt;/a&gt;静态确定。&lt;/li&gt;
&lt;li&gt;由同一数据类型组成的可变行序列。&lt;/li&gt;
&lt;li&gt;其数据类型为&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abentable_type_glosry.htm&quot;&gt;表类型&lt;/a&gt;（一种&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abencomplex_data_type_glosry.htm&quot;&gt;复杂数据类型&lt;/a&gt;），该类型定义了以下属性：&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenrow_type_glosry.htm&quot;&gt;行类型&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abentable_category_glosry.htm&quot;&gt;表类别&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abentable_key_glosry.htm&quot;&gt;表键&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;当需要以结构化方式处理任意数据类型的可变数据集时使用，例如，在 &lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenabap_program_glosry.htm&quot;&gt;ABAP 程序&lt;/a&gt;中存储和处理&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abendatabase_table_glosry.htm&quot;&gt;数据库表&lt;/a&gt;内容。&lt;/li&gt;
&lt;li&gt;允许通过&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abentable_index_glosry.htm&quot;&gt;表索引&lt;/a&gt;或&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abentable_key_glosry.htm&quot;&gt;表键&lt;/a&gt;访问单个表行。&lt;/li&gt;
&lt;/ul&gt;
&lt;p align=&quot;right&quot;&gt;&lt;a href=&quot;#top&quot;&gt;⬆️ 回到顶部&lt;/a&gt;&lt;/p&gt;&lt;h3&gt;内表的基本属性&lt;/h3&gt;
&lt;details&gt;
  &lt;summary&gt;🟢 点击展开查看更多详情&lt;/summary&gt;
  &lt;!-- --&gt;&lt;p&gt;&lt;strong&gt;行类型&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;定义内部表中每一行的结构，即描述该表包含哪些列。&lt;/li&gt;
&lt;li&gt;可以是任意 ABAP 数据类型，例如&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenelementary_data_type_glosry.htm&quot;&gt;基础数据类型&lt;/a&gt;、复合数据类型，也可以是&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenreference_type_glosry.htm&quot;&gt;引用类型&lt;/a&gt;。&lt;/li&gt;
&lt;li&gt;多数情况下，行类型采用&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenstructured_type_glosry.htm&quot;&gt;结构化类型&lt;/a&gt;。此时，每行的独立组件也被称为内部表中的列。&lt;/li&gt;
&lt;li&gt;简单情况下，行由包含基础数据对象的&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenflat_structure_glosry.htm&quot;&gt;扁平结构&lt;/a&gt;组成；但也可以采用&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abendeep_structure_glosry.htm&quot;&gt;深度结构&lt;/a&gt;，其组件既可以是结构体，也可以是内部表。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;表类别&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;定义内部表的管理和存储方式，以及如何访问单个表条目。&lt;/li&gt;
&lt;li&gt;为何重要？选用合适的表类别应能满足您的需求，即当内部表数据量较大时，不同类别在访问表内容时可能存在显著的性能差异。&lt;/li&gt;
&lt;li&gt;注意：访问内部表有两种方式：&lt;ul&gt;
&lt;li&gt;通过表索引访问：通过行号访问内表的某一行。这种访问方式是访问表行的最快方式。&lt;/li&gt;
&lt;li&gt;通过表键访问：通过在特定列中搜索特定值来访问内表的某一行。注意：搜索的列可以是键列，也可以是非键列。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;类别&lt;/th&gt;
&lt;th&gt;由内部管理&lt;/th&gt;
&lt;th&gt;访问&lt;/th&gt;
&lt;th&gt;主表键&lt;/th&gt;
&lt;th&gt;使用时机&lt;/th&gt;
&lt;th&gt;提示&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;STANDARD&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;表索引（这也是这类表被称为&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenindex_table_glosry.htm&quot;&gt;索引表&lt;/a&gt;的原因）&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;表索引&lt;/li&gt;&lt;li&gt;表键&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;始终为非唯一键，即始终允许存在重复条目&lt;/li&gt;&lt;li&gt;若键不相关，可定义空键(&lt;code&gt;WITH EMPTY KEY&lt;/code&gt;)&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;主要场景：通过顺序处理或表索引访问表内容时。&lt;/li&gt;&lt;li&gt;使用主键访问表的响应时间：此类表访问仅针对排序表和哈希表进行了优化。对于标准表，主键访问会遍历所有表行进行线性搜索。这意味着当主要通过表键访问表时，包含超过 100 行的标准表并非理想选择。&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;无特定排序规则，但可使用 &lt;code&gt;SORT&lt;/code&gt; 对表进行排序&lt;/li&gt;&lt;li&gt;填充此类表格：行要么追加到表格末尾，要么插入到特定位置。&lt;/li&gt;&lt;li&gt;可以定义&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abensecondary_table_key_glosry.htm&quot;&gt;辅助表键&lt;/a&gt;，以提高对标准表进行键访问的效率。&lt;/li&gt;&lt;li&gt;标准表和排序表的&lt;a href=&quot;https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm?file=abenadmin_costs_dyn_mem_obj_guidl.htm&quot;&gt;管理开销最小（参见 ABAP 标准 F1 文档）&lt;/a&gt;。 &lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;SORTED&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;主表索引（这就是为什么这些表被称为&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenindex_table_glosry.htm&quot;&gt;索引表&lt;/a&gt;的原因）。&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;表索引&lt;/li&gt;&lt;li&gt;表键&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;非唯一&lt;/li&gt;&lt;li&gt;唯一&lt;/li&gt;&lt;br&gt;... 用于按升序对表进行排序。&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;通过表键和索引实现对表内容的优化访问。&lt;/li&gt;&lt;li&gt;如果通过表键访问是主要访问方式，但无法定义唯一键。&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;在插入或删除行时会自动进行排序。因此，表的索引通常需要进行重组。 &lt;/li&gt;&lt;li&gt;使用主键访问表的响应时间取决于表条目数的对数，因为采用了二分查找算法。&lt;/li&gt;&lt;li&gt;标准表和排序表的管理开销最低。&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;HASHED&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;哈希算法&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;表键&lt;/li&gt;&lt;li&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abensecondary_table_index_glosry.htm&quot;&gt;二级表索引&lt;/a&gt;&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;始终唯一&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;适用于大型内部表。&lt;/li&gt;&lt;li&gt;针对键访问进行了优化。通过表键访问表内容是主要的访问方式，可以定义唯一键。&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;td&gt;&lt;ul&gt;&lt;li&gt;主键访问的响应时间是恒定的，且与表中的条目数量无关。&lt;/li&gt;&lt;li&gt;哈希表的管理开销最高。&lt;/li&gt;&lt;/ul&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;关键属性&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;表键有两种类型：&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenprimary_table_key_glosry.htm&quot;&gt;主表键&lt;/a&gt; 和 &lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abensecondary_table_key_glosry.htm&quot;&gt;辅助表键&lt;/a&gt;。&lt;/li&gt;
&lt;li&gt;表键...&lt;ul&gt;
&lt;li&gt;旨在提供对内部表内容的优化访问。&lt;/li&gt;
&lt;li&gt;键可以是唯一或非唯一的，即内部表中可以存在或不存在具有相同键的多行（重复行）。对于主表键，其定义取决于表类别。对于辅表键，其定义取决于键类型。对于标准表，主表键也可以定义为空，即不包含任何键列。请注意，对于标准表，只有使用辅表键才能实现优化访问。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;键的类型：&lt;/li&gt;
&lt;li&gt;排序键：&lt;ul&gt;
&lt;li&gt;可以是排序表的主表键，也可以是任何表的次表键。&lt;/li&gt;
&lt;li&gt;在内部通过表索引进行管理。对于排序表，这是主表索引。对于次表键，则会额外添加一个次表索引。&lt;/li&gt;
&lt;li&gt;通过排序键进行访问意味着采用优化的二分查找。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;哈希键：&lt;ul&gt;
&lt;li&gt;可以是哈希表的主表键，也可以是任何表的辅助表键。&lt;/li&gt;
&lt;li&gt;内部通过哈希算法进行管理。&lt;/li&gt;
&lt;li&gt;哈希键没有表索引。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;更多信息&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_cp_index_htm/CLOUD/en-US/index.htm?file=abenitab_oview.htm&quot;&gt;内表 - 概述&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm?file=abenadmin_costs_dyn_mem_obj_guidl.htm&quot;&gt;内表 F1 文档（ ABAP 标准）&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/details&gt;&lt;p align=&quot;right&quot;&gt;&lt;a href=&quot;#top&quot;&gt;⬆️ 回到顶部&lt;/a&gt;&lt;/p&gt;&lt;h2&gt;持续更新中……&lt;/h2&gt;
</content:encoded><category>文章</category></item><item><title>00-ABAP Cheat Sheets 项目介绍</title><link>https://jack-liang.com/blog/abap-cheat-sheets-introduce/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-cheat-sheets-introduce/</guid><description>这是 SAP 官方开源的 ABAP 速查表项目，面向 ABAP 开发者（包括初学者和有经验的工程师），旨在提供简洁、易查阅的 ABAP 核心语法、常用功能和最佳实践参考，降低 ABAP 开发的学习和查阅成本。</description><pubDate>Tue, 19 May 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/SAP-samples/abap-cheat-sheets&quot;&gt;https://github.com/SAP-samples/abap-cheat-sheets&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;项目定位&lt;/h2&gt;
&lt;p&gt;本仓库收录了全面的 ABAP 速查表和可执行示例，聚焦于 ABAP 语法与编程概念，并特别强调 SAP BTP ABAP 环境中的云开发用 ABAP。这些资料可作为 ABAP 开发人员的快速参考，提供对 ABAP 语言特性的简明解释，并附带可执行的代码示例。&lt;/p&gt;
&lt;h2&gt;核心内容&lt;/h2&gt;
&lt;p&gt;项目以 “速查表（Cheat Sheet）” 为核心形式，覆盖 ABAP 开发的关键领域，主要包含：&lt;/p&gt;
&lt;h3&gt;基础语法类&lt;/h3&gt;
&lt;p&gt;ABAP 关键字、数据类型（基本类型 / 结构化类型 / 内表）、变量声明与赋值；
流程控制（条件语句 IF/CASE、循环语句 LOOP/DO/WHILE）；
字符串操作、数值计算、日期 / 时间处理等基础操作。&lt;/p&gt;
&lt;h3&gt;核心功能类&lt;/h3&gt;
&lt;p&gt;内表（Internal Table）操作（增删改查、排序、合并、筛选等）；
数据库交互（Open SQL 语法、SELECT/INSERT/UPDATE/DELETE、JOIN 查询、参数化查询）；
模块化编程（子程序 FORM、函数模块 FUNCTION MODULE、类与对象 OO ABAP）；
异常处理（TRY/CATCH、自定义异常）。&lt;/p&gt;
&lt;h3&gt;实用场景类&lt;/h3&gt;
&lt;p&gt;ABAP 报表开发（SELECTION-SCREEN、ALV 报表基础）；
批处理（Batch Input、BAPI 调用）；
常用系统函数 / 方法（如转换函数、消息输出 MESSAGE）；
性能优化小贴士（如内表使用、数据库查询优化）。&lt;/p&gt;
&lt;h3&gt;版本适配&lt;/h3&gt;
&lt;p&gt;覆盖不同 ABAP 版本（如 ABAP for HANA、ABAP Cloud）的特性差异，标注新语法 / 新功能的适用版本。&lt;/p&gt;
&lt;h2&gt;项目特点&lt;/h2&gt;
&lt;h3&gt;官方权威性&lt;/h3&gt;
&lt;p&gt;由 SAP 官方 Samples 团队维护，内容符合 SAP 官方的 ABAP 开发规范，避免非官方资料的错误或不规范表述。&lt;/p&gt;
&lt;h3&gt;轻量化与易读性&lt;/h3&gt;
&lt;p&gt;所有内容以 “速查表” 形式呈现，结构清晰（多为表格 / 分点总结），无冗余文字，开发者可快速定位所需知识点，而非长篇文档。&lt;/p&gt;
&lt;h3&gt;开源协作&lt;/h3&gt;
&lt;p&gt;基于 MIT 许可证开源，支持社区贡献 —— 开发者可通过 PR 补充内容、修正错误，持续完善速查表。&lt;/p&gt;
&lt;h3&gt;多格式支持&lt;/h3&gt;
&lt;p&gt;部分速查表提供 PDF/Markdown 等格式，方便本地下载、打印或集成到开发文档中。&lt;/p&gt;
&lt;h2&gt;适用人群&lt;/h2&gt;
&lt;p&gt;ABAP 初学者：快速掌握核心语法，避开入门常见坑；
资深 ABAP 开发者：日常开发中快速查阅语法细节、对比版本差异；
跨语言转岗开发者：快速了解 ABAP 核心逻辑与常用操作；
学习 SAP 生态的学生 / 技术爱好者：低成本入门 ABAP 开发。&lt;/p&gt;
&lt;h2&gt;如何使用&lt;/h2&gt;
&lt;p&gt;直接访问 GitHub 仓库，浏览 /cheat-sheets 目录下的文件（按主题分类）；
下载 PDF 版本到本地，作为开发手册离线查阅；
提交 Issue/PR 反馈错误或补充新的知识点。&lt;/p&gt;
&lt;h2&gt;补充说明&lt;/h2&gt;
&lt;p&gt;该项目并非完整的 ABAP 教程，而是 “速查工具”，适合搭配 SAP 官方文档、ABAP 培训课程使用；内容持续更新，适配最新的 ABAP Cloud 等技术趋势，是 ABAP 开发者的实用工具库。&lt;/p&gt;
&lt;p&gt;本站将于后续更新中，添加该项目的详细解读，敬请期待。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;参考内容&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://deepwiki.com/SAP-samples/abap-cheat-sheets&quot;&gt;SAP ABAP Cheat Sheets 项目介绍&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>SAP Fiori应用参考库及Fiori 激活任务列表</title><link>https://jack-liang.com/blog/sap-fiori-apps-and-task-list/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-fiori-apps-and-task-list/</guid><description>本次课程讲解SAP Fiori的生态工具与实施配置方法，介绍了应用库规模、参考库功能、应用推荐分析流程，演示了参考库操作、维护规划器用法与任务列表激活流程，帮助学习者掌握Fiori项目实施步骤。</description><pubDate>Tue, 19 May 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;本次课程讲解SAP Fiori的生态工具与实施配置方法，介绍了应用库规模、参考库功能、应用推荐分析流程，演示了参考库操作、维护规划器用法与任务列表激活流程，帮助学习者掌握Fiori项目实施步骤。&lt;/p&gt;
&lt;p&gt;【SAP Fiori应用参考库地址】&lt;a href=&quot;https://fioriappslibrary.hana.ondemand.com&quot;&gt;https://fioriappslibrary.hana.ondemand.com&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-fiori-apps-and-task-list/SAP-fiori-apps.png&quot; alt=&quot;SAP-fiori-apps&quot;&gt;&lt;/p&gt;
&lt;h2&gt;SAP Fiori应用生态核心优势&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;应用库规模增长&lt;/strong&gt;：Fiori刚发布时仅有约100个可用应用，很快增长到1200个，目前已有超过16000个应用，且会定期新增应用。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;应用覆盖范围&lt;/strong&gt;：现有应用覆盖企业财务、采购、销售、物流、人力等几乎所有企业业务领域，找不到匹配需求时可开发自定义应用。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;SAP Fiori应用参考库核心功能介绍&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;基础定位与作用&lt;/strong&gt;：该工具是帮助企业选择要实施的应用、查询不同应用的组件版本、安装和配置信息的核心工具。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;支持的搜索筛选方式&lt;/strong&gt;：可按业务线、行业等现有分类搜索，也可查看全部应用后创建多分类自定义筛选，还支持按角色搜索。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;提供的安装信息&lt;/strong&gt;：在应用详情页会列出对应产品版本、所需软件组件、所需后端业务应用类型、要求的数据库（如SAP HANA），还提供产品可用性矩阵截图和下载中心链接。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;SAP Fiori应用参考库实操演示&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;单应用查看流程&lt;/strong&gt;：选择适配SAP S/4 HANA的Fiori应用分类后，打开「盘点实物库存」应用，可查看该应用的灯塔属性、要求后端、覆盖业务线、应用类型、关键功能截图、应用文档、实施信息。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;多应用聚合功能&lt;/strong&gt;：选中「盘点实物库存」等5个应用后，点击聚合按钮，工具会汇总这5个应用的前后端所需组件、安装要求，可导出该信息用于后续实施规划。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Fiori应用推荐分析功能说明&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;推荐逻辑基础&lt;/strong&gt;：工具基于相关性和就绪性两个维度生成推荐，相关性匹配企业现有业务流程，就绪性评估当前系统是否满足使用要求。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;相关性评分规则&lt;/strong&gt;：3分代表应用和企业已使用的事务码高度匹配，2分代表应用和企业使用的业务领域相关但无直接匹配，1分代表相关性较低。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;注意事项说明&lt;/strong&gt;：高分相关性不代表Fiori应用可以完全覆盖替代原GUI事务，Fiori应用的功能通常比GUI事务更少，仍需进一步验证评估。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;使用推荐分析功能的操作步骤&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-fiori-apps-and-task-list/planing-your-project.png&quot; alt=&quot;计划您的项目&quot;&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;生成并准备使用配置文件&lt;/strong&gt;：在ABAP后端系统运行事务码STO3，选择最近一个完整月份的工作负载，输出事务配置文件导出为Excel，仅保留第一列事务/报表名称后另存为CSV文件。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;上传系统配置文件&lt;/strong&gt;：需要分别上传前端、后端以及HANA系统（若有）的已安装软件组件版本清单，若没有单独前端服务器，前后端可使用同一份配置文件。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;生成分析结果&lt;/strong&gt;：填写分析名称后生成推荐，可通过过滤器筛选结果，比如只展示当前系统已可直接使用的应用，选中目标应用后可再次聚合导出安装要求。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;维护规划器介绍&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;核心功能定位&lt;/strong&gt;：它是SAP支持门户的图形化工具，用于帮助规划系统运维，可检查现有插件、业务功能、行业解决方案的兼容性，生成的XML栈是使用SAP转换工具的强制前置条件。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;操作流程说明&lt;/strong&gt;：需要使用S用户凭据登录，可选择前后端系统，查看需要安装或升级的组件，标记组件变更类型，确认操作系统和数据库文件后，可下载XML栈、将所需安装包加入下载篮子，还可导出选择结果为Excel或PDF。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Fiori实施项目配套工具资源&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;免费分析报告&lt;/strong&gt;：SAP为所有处于维护期的客户免费提供Fiori应用推荐报告，基于企业现有SAP使用信息识别最适配的Fiori应用，报告链接放在演示幻灯片底部。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;灯塔场景支持&lt;/strong&gt;：SAP提供多款灯塔Fiori应用场景，覆盖现金经理、总账会计、成本会计等多个财务岗位，相比SAP Business Suite可为SAP S/4HANA用户带来更多业务收益。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;快速激活方案&lt;/strong&gt;：可通过SAP Fiori Foundation S4hana和SAP Fiori Content Activation两个任务列表实现快速激活，前者生成基础管理员和终端用户角色，后者为选中业务角色激活对应应用。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Fiori安装前准备事项&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;基础环境要求&lt;/strong&gt;：推荐使用Chrome或Firefox等现代浏览器，需要确认支持的客户端设备类型，确认是否使用反向代理服务器，明确前后端服务器配置，确认使用的数据库类型。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;移动与安全配置&lt;/strong&gt;：需要规划企业移动支持方案，确认是否支持平板、手机，是否允许员工使用自带设备，需要确认是否启用单点登录，以及单点登录使用的证书和认证机制。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;权限规划&lt;/strong&gt;：提前梳理规划实施后需要的不同用户角色和对应授权范围。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Fiori安装激活任务列表说明&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;任务列表核心价值&lt;/strong&gt;：预定义任务列表可自动化完成ABAP系统配置任务，将分散在不同事务中的多个步骤整合为一个列表，系统会引导完成配置，每个任务自带详细文档，执行后无需手动重复操作。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;不同部署的操作差异&lt;/strong&gt;：嵌入式部署仅需要在当前系统运行一次任务列表，集线器部署需要分别在网关和后端服务器运行任务列表。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Fiori内容激活任务实操演示&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;操作流程演示&lt;/strong&gt;：在嵌入式SAP S/4 HANA系统中，打开事务STCO1，选中SAP Fiori Content Activation任务列表，生成任务后选择SAP Buyer角色，配置传输选项和用户参数后启动任务。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;后续调整操作&lt;/strong&gt;：任务执行完成后存在部分警告，一般是因为部分节点或服务此前已激活，只需为新创建的用户分配对应角色即可。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;最终验证结果&lt;/strong&gt;：使用新建用户登录Fiori启动板后，该用户可看到对应角色的全部应用磁贴，任务列表确实简化了特定业务角色的Fiori内容激活流程。&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>从零开始学习 SAP Fiori 的实施与配置，轻松为 SAP S/4HANA 部署 Fiori 应用！</title><link>https://jack-liang.com/blog/sap-fiori-s4hana/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-fiori-s4hana/</guid><description>主要讲解SAP Fiori的实施和配置，从基础知识到如何顺利部署Fiori应用程序，涵盖了SAP S/4HANA的核心概念、设计原则、不同的部署选项、用户角色管理、安全机制等多方面内容。</description><pubDate>Mon, 18 May 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;课程连接：&lt;a href=&quot;https://www.udemy.com/course/sap-fiori-s4hana&quot;&gt;https://www.udemy.com/course/sap-fiori-s4hana&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;SAP S/4HANA 概述&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-fiori-s4hana/what-is-SAP-s4hana.png&quot; alt=&quot;SAP S/4HANA 概述&quot;&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;产品发展历程&lt;/strong&gt;：SAP ERP产品经历了R2、R3、ECC多个版本，S/4HANA是SAP最新的旗舰ERP产品，数年前推出，是SAP产品线的重大更新。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;产品核心特点&lt;/strong&gt;：S/4HANA原生适配云部署，同时支持本地部署、多租户SaaS等多种部署模式，搭载SAP自研的HANA数据库，相比原有的Oracle数据库，能降低容量压力、提升实时性能和数据可见性。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;适用场景与局限性&lt;/strong&gt;：S/4HANA更适合全球运营的大型复杂组织，原使用R3、ECC、Business One的legacy用户是迁移的核心候选对象，SAP设定的迁移截止时间为2030年，但并非所有企业都适合选择S/4HANA，企业可根据自身需求选择Oracle、Microsoft Dynamics等其他ERP方案。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;项目实施要点&lt;/strong&gt;：S/4HANA实施是大型复杂项目，技术只是其中一部分，真正的挑战来自组织内部的变革管理，需要清晰的项目方向和强有力的变革管理才能保证成功。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;SAP Fiori用户体验价值验证&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-fiori-s4hana/SAP-fiori.png&quot; alt=&quot;SAP Fiori用户体验价值验证&quot;&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;价值分类&lt;/strong&gt;：SAP将Fiori的用户体验价值分为两类，分别是可量化的货币价值和偏抽象的人文价值。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;货币价值具体表现&lt;/strong&gt;：货币价值体现为提升生产力、提升数据质量、节省培训成本、减少变更请求和降低用户操作错误。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;实操效率对比数据&lt;/strong&gt;：以应收账款会计手动清账任务为例，使用SAP Fiori完成任务仅需1分07秒，操作22次点击，切换1次屏幕，填写3个字段；使用SAP GUI完成相同任务需要超过2分钟，操作49次点击，切换26次屏幕，填写9个字段，Fiori将处理时间减少了53%。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;SAP Fiori核心定义与发展历程&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;产品定位&lt;/strong&gt;：SAP Fiori是SAP所有产品的统一设计语言，未来会成为所有SAP解决方案的默认用户体验，目前版本为SAP Fiori 3。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;发展历程&lt;/strong&gt;：SAP Fiori2013年以移动优先方案推出，2014年正式发布，2018年末开始引入对话式UI产品SAP Copilot，目前对所有SAP客户免费开放。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;技术基础&lt;/strong&gt;：SAP Fiori是基于浏览器的现代UI，使用HTML5开发，完全响应式，可适配桌面、笔记本、平板、手机等多种设备，支持Windows、iOS、Android等多个操作系统，支持几乎所有主流语言。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;SAP Fiori核心设计原则&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;基于角色设计&lt;/strong&gt;：Fiori的磁贴、目录、分组以及用户可操作内容都根据用户角色分配，例如管理角色比普通员工能访问更多应用和信息。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;适配性设计&lt;/strong&gt;：Fiori应用可以适配不同的屏幕尺寸，在手机端只会做小幅调整如放大磁贴方便点击，整体功能和流程保持一致。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;简洁一致性设计&lt;/strong&gt;：应用只保留必要信息，避免对用户造成混淆，所有SAP解决方案的Fiori应用体验保持一致，降低用户学习成本。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;体验友好设计&lt;/strong&gt;：设计目标是让用户愿意使用应用，至少不会让用户感受到压力或困惑，提升整体使用意愿和效率。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;SAP Fiori应用分类说明&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-fiori-s4hana/types-of-fiori-apps.png&quot; alt=&quot;SAP Fiori应用分类说明&quot;&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;事务型应用&lt;/strong&gt;：支持用户执行创建、修改、提交数据等操作，例如创建客户、提交发票都属于这类应用。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;分析型应用&lt;/strong&gt;：用于展示实时指标、绩效指标、KPI和其他分析数据，应用会自动更新数据，无需用户手动运行报表获取最新信息。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;事实型应用&lt;/strong&gt;：提供信息类内容，例如和当前业务对象相关的信息卡、上下文文档等，帮助用户快速获取参考信息。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;SAP Fiori前端服务器部署方案&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/sap-fiori-s4hana/technology-foundation.png&quot; alt=&quot;SAP Fiori技术基础&quot;&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;嵌入式部署推荐&lt;/strong&gt;：对于使用SAP S/4HANA的场景，官方推荐嵌入式部署，即前端服务器和S/4HANA后端服务器部署在同一系统中。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;嵌入式部署优势&lt;/strong&gt;：该方案不需要额外的SAP NetWeaver中心系统，不需要远程调用，运行开销更低，可直接访问元数据和业务数据，在同一个系统内完成授权管理，流程更简化。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;中心式部署特点&lt;/strong&gt;：中心式部署中，前端服务器部署在独立于S/4HANA后端的系统中，可以提供统一入口访问多个系统的业务应用，但如果接入多个S/4HANA系统，容易因为前端和后端的依赖关系产生问题。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;混合部署方案规则&lt;/strong&gt;：如果现有景观已经有了中心Fiori前端服务器，又新增了多个S/4HANA系统，推荐新增系统采用嵌入式部署，每个S/4HANA系统维护独立的Fiori启动板，通过中心启动板的URL磁贴访问，前端服务器版本严格依赖后端S/4HANA版本，且前端组件可以独立升级，无需升级整个S/4HANA就能使用最新的SAPUI技术。&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>知乎专栏 | SAP ABAP 开发历史文章</title><link>https://jack-liang.com/blog/zhihu-column-summary/</link><guid isPermaLink="true">https://jack-liang.com/blog/zhihu-column-summary/</guid><description>汇总我在知乎专栏发布的 SAP ABAP 开发技巧和技术交流文章</description><pubDate>Fri, 08 May 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;知乎有一个 &lt;strong&gt;&lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;&lt;/strong&gt;
专栏，专注于分享 SAP 开发技巧和翻译 SAP 技术文档。&lt;/p&gt;
&lt;p&gt;本文整理了一些历史文章，方便大家阅读和检索。&lt;/p&gt;
&lt;h2&gt;专栏简介&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;专栏主题&lt;/strong&gt;：SAP ABAP 开发技巧、技术文档翻译&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;主要内容&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;SAP ABAP 开发实战技巧&lt;/li&gt;
&lt;li&gt;SAP 技术文档中译&lt;/li&gt;
&lt;li&gt;开发最佳实践&lt;/li&gt;
&lt;li&gt;性能优化经验&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;文章列表&lt;/h2&gt;
&lt;p&gt;以下文章已全部迁入本博客（除特别标注外，链接指向站内文章）：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href=&quot;/blog/connect-sap-to-agent&quot;&gt;把SAP接入Agent，让Agent操作SAP&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/claude-writes-abap-directly&quot;&gt;让 Claude 直接写 ABAP 代码：我用这套方案实现了零接入的 SAP AI 开发&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap2ui5-introduction&quot;&gt;abap2UI5：基于 ABAP 开发的UI5程序&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/nocodb-sap-mysql&quot;&gt;使用Nocodb搭建SAP读写MySQL数据库功能&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sap-visualization-charts&quot;&gt;在SAP中开发可视化图表&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sap-custom-field-text&quot;&gt;SAP中通过标准Function无法获取到自定义字段的文本问题探究&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/garbled-text&quot;&gt;解决 SAP 使用 GUI_UPLOAD 上传 txt 文件乱码问题&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-performance-tools&quot;&gt;ABAP开发有哪些高效的优化工具&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-fm-json-in-depth-analysis&quot;&gt;abap_fm_json 深度剖析：如何通过 HTTP 调用 ABAP Function&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-string-type-notes&quot;&gt;ABAP 中使用类型 Sstring 的注意事项&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/beautify-sap-gui&quot;&gt;让你的 SAP GUI 更养眼一些&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sap-rest-login-language&quot;&gt;SAP REST 接口调用如何控制登录语言？&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/scc-password-reset&quot;&gt;abap-cloud-developer-trial 版本 SAP Cloud Connector 重置密码&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1887893267435193692&quot;&gt;在 Docker 中运行属于自己的 SAP 系统&lt;/a&gt;（知乎原文）&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abapgit-experience&quot;&gt;abapGit 使用经验总结&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-dynamic-nested-types&quot;&gt;在程序内动态创建ABAP嵌套数据类型&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sap-cross-client-data&quot;&gt;SAP 系统中跨 client 或服务器取数&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-number-get-next-lock&quot;&gt;ABAP使用NUMBER_GET_NEXT前需要加锁吗？&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/sap-752-sp04-install&quot;&gt;SAP NetWeaver AS ABAP Developer Edition 7.52 SP04 安装心得&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-json-int-space&quot;&gt;ABAP转JSON时int类型空格的问题探究&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-74-new-features&quot;&gt;ABAP 7.4 中的新功能&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-doc-correctness-quality&quot;&gt;ABAP文档：正确性和质量(Correctness and Quality)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-doc-kiss-principle&quot;&gt;ABAP文档：KISS原则（KISS Principle）&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/ooalv-dynamic-alv-header&quot;&gt;OOALV： 动态显示ALV表头&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/blog/abap-doc-separation-of-concerns&quot;&gt;ABAP文档：关注点分离（SoC）&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;相关链接&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;知乎专栏地址&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>当工作不再是答案，你是谁？当代人的迷茫</title><link>https://jack-liang.com/blog/the-end-of-the-working-society/</link><guid isPermaLink="true">https://jack-liang.com/blog/the-end-of-the-working-society/</guid><description>分享一个关于工作社会的思考，帮助你理解当前社会的趋势。工作社会的终结，是否意味着我们的未来？我们是否需要重新思考自己的价值和身份？</description><pubDate>Mon, 20 Apr 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;这是一本书的思考，最近总是在我的脑海中不断出现，迫使我不断追问————我们的工作形式是否可以改变？是否有更好的工作方式？我们是否需要重新思考自己的价值和身份？最初发布于小红书。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/The-End-of-the-Working-Society/image.png&quot; alt=&quot;alt text&quot;&gt;&lt;/p&gt;
&lt;p&gt;如今，“一份工作干到退休”的确定性逐渐消失，大厂裁员、AI抢岗、灵活就业主流化，“找好工作就稳了”的逻辑已不再成立，《工作社会的终结》一书便聚焦这些现象，探讨背后的本质与出路。&lt;/p&gt;
&lt;h2&gt;一、工作如何被神圣化？&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/The-End-of-the-Working-Society/image-1.png&quot; alt=&quot;alt text&quot;&gt;&lt;/p&gt;
&lt;p&gt;现代社会中，有偿工作成为社会运转的核心，不仅是谋生手段，更是个体融入社会、获得身份认同的关键。教育、人生阶段划分、时间规则乃至个人价值认知，都围绕工作展开，“工作等同于价值”深入人心，失业也因此从经济问题，变成了瓦解自我价值的“社会性断裂”。&lt;/p&gt;
&lt;h2&gt;二、工作社会为何走向终结？&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/The-End-of-the-Working-Society/image-2.png&quot; alt=&quot;alt text&quot;&gt;&lt;/p&gt;
&lt;p&gt;核心有两大原因：一是自反性现代化的反噬，二战后“第一现代性”实现充分就业，但全球化推动的“第二现代性”中，技术进步与资本流动减少了稳定工作总量，传统结构松动，风险转嫁给个体；二是内部悖论，社会要求人人就业，而商业本质是“减少劳动投入”，AI等技术替代人力，形成“工作自掘坟墓”的不可逆趋势。&lt;/p&gt;
&lt;h2&gt;三、工作社会终结后，人该怎么办？&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/The-End-of-the-Working-Society/image-3.png&quot; alt=&quot;alt text&quot;&gt;&lt;/p&gt;
&lt;p&gt;当下已呈现“巴西化”特征：全职工作减少，多数人靠流动商贩、自媒体等不稳定多元工作谋生，引发诸多连锁问题。作者贝克提出解决方案：一是重新定义工作权利，认可弹性就业、无偿劳动价值，缩短全职时长；二是推行“公民劳动+公民津贴”，以积分认可自愿服务劳动，给全民提供最低生活保障，让个体脱离全职工作也能获得保障与身份认同。&lt;/p&gt;
&lt;p&gt;未来，若AI满足人类物质需求，工作将从“生存必需品”变为“意义可选项”，核心价值转向创造、艺术等人际交互领域，而基础物质保障是这一切的前提。&lt;/p&gt;
&lt;p&gt;标签：#对工作的态度 #未来工作趋势 #工作的本质 #工作的意义 #未来工作方式&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>ABAP 开发者路线图</title><link>https://jack-liang.com/blog/abap-developer-road/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-developer-road/</guid><description>分享一个 ABAP 开发者的路线图，帮助你快速上手 ABAP 开发。</description><pubDate>Sun, 08 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;学习一门开发语言，如果可以在学习之前对整个技术路线有一定的了解，就能做到有计划的学习。&lt;/p&gt;
&lt;p&gt;今天分享一个技术路线图，帮你快速上手 ABAP 开发。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://roadmap.sh/r/sap-abap-developer&quot;&gt;路线图&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-developer-road/p1.png&quot; alt=&quot;&quot;&gt;&lt;/p&gt;
&lt;p&gt;点击每一项技术后，右侧会弹出该技术的详细说明。还有相关链接可以深入学习。
&lt;img src=&quot;https://img.jack-liang.com/abap-developer-road/p2.png&quot; alt=&quot;&quot;&gt;&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>前端开发的演进：穿越时空的旅程</title><link>https://jack-liang.com/blog/evolution-of-front-end-development/</link><guid isPermaLink="true">https://jack-liang.com/blog/evolution-of-front-end-development/</guid><description>为您的 Web 项目选择合适的框架是一个关键决策，它可能显著影响开发过程和项目的成功。面对众多可用选项，在做出选择之前考虑各种因素至关重要。</description><pubDate>Sun, 12 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;自万维网诞生以来，前端开发经历了漫长的发展历程。从静态 HTML 页面到动态交互式 Web 应用，前端开发的演变可谓令人惊叹。在本文中，我们将踏上一段穿越时空的奇妙旅程，探索前端开发多年来的演进历程。&lt;/p&gt;
&lt;h2&gt;静态 HTML 时代（1990年代 - 2000年代初）&lt;/h2&gt;
&lt;p&gt;在互联网早期，前端开发主要涉及创建静态 HTML 页面。这些页面简单、以文本为主，通常缺乏我们今天习以为常的视觉和交互元素。层叠样式表（CSS）在这一时期开始流行，使开发者能够为网页添加样式，使其更具视觉吸引力。&lt;/p&gt;
&lt;h2&gt;JavaScript 的崛起（1990年代末 - 2000年代初）&lt;/h2&gt;
&lt;p&gt;JavaScript 作为一种强大的工具应运而生，为网页增添了交互性。这一时期见证了 DHTML（动态 HTML）等技术的诞生，使开发者能够创建动态和动画化的网页内容。这标志着更具吸引力的 Web 体验的开端。&lt;/p&gt;
&lt;h2&gt;浏览器大战时代（1990年代末 - 2000年代初）&lt;/h2&gt;
&lt;p&gt;在这一时期，Web 开发者面临着 Internet Explorer 与 Netscape Navigator 之间&amp;quot;浏览器大战&amp;quot;带来的挑战。跨浏览器兼容性成为一个重大问题，催生了各种 JavaScript 库和框架的开发，以帮助解决这些问题。&lt;/p&gt;
&lt;h2&gt;Web 2.0 革命（2000年代中期）&lt;/h2&gt;
&lt;p&gt;Web 2.0 带来了前端开发的转变。网站开始变得更加交互化和以用户为中心。Ajax（异步 JavaScript 和 XML）成为一项关键技术，实现了无缝的数据检索和更新，无需完整刷新页面。&lt;/p&gt;
&lt;h2&gt;响应式 Web 设计（2010年代）&lt;/h2&gt;
&lt;p&gt;随着智能手机和平板电脑的普及，响应式 Web 设计变得至关重要。前端开发者必须适应构建能够优雅地调整大小和重组以适应各种屏幕尺寸的网站。这一时期见证了 Bootstrap 和 Foundation 等 CSS 框架的广泛使用。&lt;/p&gt;
&lt;h2&gt;JavaScript 框架时代（2010年代 - 至今）&lt;/h2&gt;
&lt;p&gt;Angular、React 和 Vue.js 等 JavaScript 框架彻底改变了前端开发。它们引入了组件化架构和虚拟 DOM 等概念，使构建复杂的动态 Web 应用变得更加容易。单页应用（SPA）越来越受欢迎，提供了更流畅的用户体验。&lt;/p&gt;
&lt;h2&gt;渐进式 Web 应用（PWA）运动（2010年代 - 至今）&lt;/h2&gt;
&lt;p&gt;PWA 结合了 Web 和移动应用的最佳体验。前端开发者开始专注于创建不仅在浏览器上运行良好，还能离线工作、提供推送通知，并为用户提供更类似应用体验的网站。&lt;/p&gt;
&lt;h2&gt;WebAssembly 及未来（现在 - 未来）&lt;/h2&gt;
&lt;p&gt;WebAssembly（Wasm）是一项新兴技术，允许在 Web 浏览器中以接近原生的速度运行编译后的代码。它为前端开发者构建高性能 Web 应用，甚至将其他语言的现有应用移植到 Web 平台开辟了可能性。&lt;/p&gt;
&lt;h2&gt;结语&lt;/h2&gt;
&lt;p&gt;前端开发已经发生了翻天覆地的变化，从静态 HTML 页面发展到动态、响应式且高度交互的 Web 应用。随着新兴技术和持续进步的出现，前端开发的旅程依然令人兴奋。作为前端开发者，保持更新、适应新趋势、拥抱不断变化的 Web 开发格局，以在互联网上创造引人入胜的用户体验，这一点至关重要。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>框架选择成功路线图</title><link>https://jack-liang.com/blog/your-roadmap-to-framework-selection-success/</link><guid isPermaLink="true">https://jack-liang.com/blog/your-roadmap-to-framework-selection-success/</guid><description>为您的 Web 项目选择合适的框架是一个关键决策，它会对开发过程和项目的成功产生重大影响。由于可选方案众多，在做出选择之前，必须考虑各种因素。</description><pubDate>Mon, 15 Sep 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;strong&gt;为您的 Web 项目选择合适的框架&lt;/strong&gt;是一个关键决策，它会对开发过程和项目的成功产生重大影响。由于可选方案众多，在做出选择之前，必须考虑各种因素。以下是为您的 Web 项目选择合适框架的逐步指南。&lt;/p&gt;
&lt;h2&gt;了解项目需求&lt;/h2&gt;
&lt;p&gt;首先，彻底了解 Web 项目的具体需求。考虑项目的范围、复杂程度以及所需功能等因素。可以问自己以下问题：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;项目的目的是什么？&lt;/li&gt;
&lt;li&gt;它应该具备哪些关键功能？&lt;/li&gt;
&lt;li&gt;是否有特定的技术或性能要求？&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;确定技术栈&lt;/h2&gt;
&lt;p&gt;确定您偏好的技术栈。这包括前端（HTML、CSS、JavaScript）、后端（编程语言、数据库）以及您计划使用的其他技术的选择。您选择的框架应与您选定的技术栈相匹配。&lt;/p&gt;
&lt;h2&gt;考虑团队的专业能力&lt;/h2&gt;
&lt;p&gt;评估开发团队的技能和专业能力。选择一个团队熟悉或愿意学习的框架。如果您的团队在某种特定语言或框架方面经验丰富，坚持使用他们熟悉的技术可能会更高效。&lt;/p&gt;
&lt;h2&gt;社区与生态系统&lt;/h2&gt;
&lt;p&gt;框架社区和生态系统的活力与实力是做出选择时的首要考虑因素。一个繁荣的社区意味着该框架正在被全球开发者积极使用和支持。以下是这之所以重要的原因。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/00-headImage/post-5-1.jpg&quot; alt=&quot;社区与生态系统&quot;&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;好的代码本身就是最好的文档。当你准备添加注释时，问问自己：&amp;quot;如何改进代码，使其不需要这个注释？&amp;quot; —— &lt;strong&gt;Steve McConnell&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;支持与问题解决：&lt;/strong&gt; 强大的社区确保您在开发过程中遇到问题时不会孤立无援。这是一个庞大的开发者网络，他们愿意帮助并分享知识。您可以求助于论坛、Stack Overflow、GitHub 讨论区以及各种在线社区寻求帮助。社区越活跃，您就越有可能快速获得问题的答案和解决方案。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第三方库与插件：&lt;/strong&gt; 活跃的生态系统通常意味着丰富的第三方库、插件和扩展，可以扩展您所选框架的功能。这可以通过为常见功能和特性提供预构建的解决方案，显著加快开发速度。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;持续改进：&lt;/strong&gt; 庞大且积极参与的社区通常意味着框架的持续改进。开发者更有可能贡献错误修复、增强功能和新特性，从而带来更快的更新和更稳定的平台。这些贡献使框架保持最新状态，并与行业标准保持一致。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;教程与学习资源：&lt;/strong&gt; 繁荣的社区通常会产生大量的教程、博客文章、视频课程和文档。这些丰富的学习资源对于希望掌握该框架的初学者和经验丰富的开发者来说都极具价值。它使学习曲线更加平缓，并促进最佳实践的采用。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;长期可行性：&lt;/strong&gt; 拥有强大社区的框架更有可能具有更长的生命周期。知道您今天选择的框架在未来几年仍会得到支持和更新，这令人安心，可以降低您的项目因缺乏维护而过时的风险。&lt;/p&gt;
&lt;h2&gt;文档与学习资源&lt;/h2&gt;
&lt;p&gt;检查框架文档和学习资源的质量和可用性。文档完善的框架更容易让开发者学习和使用。&lt;/p&gt;
&lt;h2&gt;可扩展性与性能&lt;/h2&gt;
&lt;p&gt;考虑框架是否能够扩展以满足项目的未来需求。它能否在不出现性能瓶颈的情况下处理增加的流量和数据？&lt;/p&gt;
&lt;h2&gt;安全性&lt;/h2&gt;
&lt;p&gt;安全性对任何 Web 项目都至关重要。确保框架内置了安全功能，并积极维护以及时解决安全漏洞。&lt;/p&gt;
&lt;p&gt;总之，为 Web 项目选择合适的框架需要仔细评估项目需求、团队专业能力、社区支持以及各种技术因素。在项目初期花时间做出明智的决策，可以随着项目进展为您节省时间、资源和避免麻烦。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>使用Nocodb搭建SAP读写MySQL数据库功能</title><link>https://jack-liang.com/blog/nocodb-sap-mysql/</link><guid isPermaLink="true">https://jack-liang.com/blog/nocodb-sap-mysql/</guid><description>MySQL是不少项目会用到的数据库，奈何SAP不支持直接连接。</description><pubDate>Wed, 10 Sep 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;MySQL是不少项目会用到的数据库，奈何SAP不支持直接连接。&lt;/p&gt;
&lt;p&gt;但如果你的SAP项目就是需要连接MySQL数据库呢？&lt;/p&gt;
&lt;p&gt;就是网上提供了一些思路，比如在hdbstudio中用SDA/SDI 技术虚拟映射MySQL数据库，但这种操作需要在hdb服务器上安装unixDBCO驱动，还要在HDB数据库上做一些操作，项目上未必会同意你这么做，还需要动用到basis。&lt;/p&gt;
&lt;p&gt;今天从ABAP的视角提供一种实现思路，供大家探讨。&lt;/p&gt;
&lt;p&gt;我们借助一款开源工具——Nocodb，它作为中间件以提供restful接口的形式，实现SAP和MySQL的对接。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p1.jpg&quot; alt=&quot;配图&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;NocoDB&lt;/strong&gt; 是一个开源的无代码（No-Code）数据库平台，它使得用户能够通过图形化界面创建、管理和操作数据库，而无需编写代码。NocoDB 旨在简化数据管理过程，提供一个可视化的用户界面来处理数据库中的数据，支持与各种数据库系统的集成。&lt;/p&gt;
&lt;p&gt;最重要的，它能自动生成 RESTful API 接口，使得用户能够通过 API 访问和操作数据库中的数据，这正是我们需要的。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p2.jpg&quot; alt=&quot;示意图&quot;&gt;&lt;/p&gt;
&lt;p&gt;准备工作：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;一台Linux虚拟机——本文以ubuntu为例&lt;/li&gt;
&lt;li&gt;Linux和Docker基础知识&lt;/li&gt;
&lt;li&gt;SAP调用reseful接口&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;p&gt;我们可以在现有的MySQL数据库服务器上安装Nocodb，也可以用一台新的服务器来安装Nocodb，只要保证网络能连接SAP和MySQL就行。&lt;/p&gt;
&lt;h3&gt;安装1Panel&lt;/h3&gt;
&lt;p&gt;这一步并非必须，熟悉Linux命令行的同学可以跳过这一步，不熟悉的话也可以安装一个管理面板，这里我以1Panel为例，它能提供丰富的图形界面，方便后续的Docker安装和Nocodb安装：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;bash -c &amp;quot;$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)&amp;quot;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p3.jpg&quot; alt=&quot;安装成功&quot;&gt;&lt;/p&gt;
&lt;p&gt;跟随引导一路安装下来的话，安装成功出现这样的界面，记住地址和账号密码等关键信息。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;如果Docker安装失败，可能是源的问题，可以跳过Docker安装重装一次。之后在1Panel面板中换源后用脚本安装。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;安装Nocodb&lt;/h3&gt;
&lt;p&gt;注意：如果你的网络环境无法访问Docker官方仓库，可能会出现镜像拉取失败的错误，你可以配置国内的镜像网站，比如我配置的是&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;a href=&quot;https://docker.1panel.live&quot;&gt;https://docker.1panel.live&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p4.jpg&quot; alt=&quot;配置镜像加速&quot;&gt;&lt;/p&gt;
&lt;p&gt;进入管理面板之后，在应用商店我们就可以直接搜索并安装Nocodb了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p5.jpg&quot; alt=&quot;应用商店的Nocodb&quot;&gt;&lt;/p&gt;
&lt;p&gt;安装时需要选择数据库，所以我们要在下方数据库菜单中提前配置，如果你的1Panel和MySQL在同一太机器上，应该可以省略一步。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p6.jpg&quot; alt=&quot;配置数据库连接&quot;&gt;&lt;/p&gt;
&lt;p&gt;回到应用商店，点击安装Nocodb，视情况勾选端口外部访问，如果不勾选，需要配置代理转发才能让SAP访问到Nocodb的服务。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p7.jpg&quot; alt=&quot;安装Nocodb&quot;&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;如果在安装过程中失败，遇到 /opt/1panel/apps/nocodb/nocodb/docker-compose.yml: no such file or directory 这样的报错，可能是由于系统自带的Docker导致他，它不允许在home之外的目录安装软件，可以删除Docker后，通过1Panel自带脚本安装&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p8.jpg&quot; alt=&quot;安装成功&quot;&gt;&lt;/p&gt;
&lt;p&gt;安装成功之后，在容器里我们就能看到Nocodb了，在端口出点击可以跳转Web界面，如果开了开放端口也可以通过IP:端口的方式直接访问。&lt;/p&gt;
&lt;h3&gt;操作Nocodb&lt;/h3&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p9.jpg&quot; alt=&quot;首次访问&quot;&gt;&lt;/p&gt;
&lt;p&gt;首次访问需要注册一个账号，然后来到集成菜单，在这里配置我们要访问的MySQL数据库。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p10.jpg&quot; alt=&quot;配置连接&quot;&gt;&lt;/p&gt;
&lt;p&gt;然后回到 Base 菜单，连接一个数据库，在这里就能操作表数据。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p11.jpg&quot; alt=&quot;连接外部数据库&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p12.jpg&quot; alt=&quot;添加数据源&quot;&gt;&lt;/p&gt;
&lt;p&gt;刚才添加的数据库就会出现在这里，假设它有一张名为&lt;code&gt;PA0001&lt;/code&gt;的表。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p13.jpg&quot; alt=&quot;表内容&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p14.jpg&quot; alt=&quot;API&quot;&gt;&lt;/p&gt;
&lt;p&gt;在详细信息里，我们就能看到，Nocodb已经自动为这张表创建了一个API，并给出了一些常见语言的调用示例。&lt;/p&gt;
&lt;p&gt;界面中我们只看到了GET方法，那么如果要写数怎么办呢？别慌，看这里，&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p15.jpg&quot; alt=&quot;Swagger是一个开源API开发工具&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p16.jpg&quot; alt=&quot;在这里你可以直接测试，注意在右上方维护token&quot;&gt;&lt;/p&gt;
&lt;p&gt;更多用法可以参考官方文档。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p17.jpg&quot; alt=&quot;API方法&quot;&gt;&lt;/p&gt;
&lt;h3&gt;ABAP调用&lt;/h3&gt;
&lt;p&gt;但对于ABAP，就需要自己写了。这里以GET方法为例。代码仅供参考，使用时注意替换url等信息，token不建议写在代码中。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Report ztest_call_http
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;
*&amp;amp;---------------------------------------------------------------------*
REPORT ztest_call_http.

DATA: lo_http_client TYPE REF TO if_http_client,
      lv_url         TYPE string,
      lv_response    TYPE string,
      lv_status      TYPE i.
DATA:   return_code TYPE i.


&amp;quot;根据情况替换
lv_url = &amp;#39;http://192.168.213.134:8080/api/v2/tables/mhvzjo4afz6ygyd/records?offset=0&amp;amp;limit=25&amp;amp;where=&amp;amp;viewId=vwalcqk4lj8c7i70&amp;#39;.

cl_http_client=&amp;gt;create_by_url(
   EXPORTING
      url = lv_url
   IMPORTING
      client = lo_http_client
   EXCEPTIONS
      argument_not_found = 1
      plugin_not_active = 2
      internal_error     = 3
      OTHERS             = 4 ).

&amp;quot;请求方法
lo_http_client-&amp;gt;request-&amp;gt;set_method( &amp;#39;GET&amp;#39; ).
lo_http_client-&amp;gt;request-&amp;gt;set_version( if_http_request=&amp;gt;co_protocol_version_1_1 ).

lo_http_client-&amp;gt;request-&amp;gt;set_content_type( &amp;#39;application/json&amp;#39; ).

&amp;quot;将token写入header中，token需要在nocodb中创建 /dashboard/#/account/tokens
lo_http_client-&amp;gt;request-&amp;gt;set_header_field( name = &amp;#39;xc-token&amp;#39;  value = &amp;#39;OGHNH8mNhSQBK6406w35qLTW3TFXQft3NbGmjZAN&amp;#39; ).

lo_http_client-&amp;gt;send(
  EXCEPTIONS
      http_communication_failure = 1
      http_invalid_state        = 2 ).

lo_http_client-&amp;gt;receive(
   EXCEPTIONS
      http_communication_failure = 1
      http_invalid_state        = 2
      http_processing_failed    = 3 ).

lv_response = lo_http_client-&amp;gt;response-&amp;gt;get_cdata( ).
lo_http_client-&amp;gt;response-&amp;gt;get_status( IMPORTING code   = return_code ).

CL_DEMO_OUTPUT=&amp;gt;write_data( return_code ).
CL_DEMO_OUTPUT=&amp;gt;write_json( lv_response ).

cl_demo_output=&amp;gt;display(  ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;运行结果。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/nocodb-sap-mysql/p18.jpg&quot; alt=&quot;运行结果&quot;&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;版权问题&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Nocodb在Github的版权设置是AGPLv3，如果你的项目不需要对外提供商业服务，你完全无需获得授权而自由的使用它。&lt;/p&gt;
&lt;p&gt;我们在官网看到的价格是针对于Nocodb提供的云服务的价格，开源版无需担心费用问题，但也相对应的没有那些花哨的高级功能。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;参考资料&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;安装应用显示找不到………/docker-compose.yml: no such file or directory - 1Panel - 社区论坛 - FIT2CLOUD 飞致云&lt;/li&gt;
&lt;li&gt;NocoDB API Documentation&lt;/li&gt;
&lt;li&gt;在线安装 - 1Panel 文档&lt;/li&gt;
&lt;li&gt;一键脚本使换源更简单 - LinuxMirrors&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1949071020410541922&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>在SAP中开发可视化图表</title><link>https://jack-liang.com/blog/sap-visualization-charts/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-visualization-charts/</guid><description>在 SAP Gui 中展示图表向来是其不擅长的，但使用 SAP HTML View 功能，借助 JS 语言的能力，我们不妨尝试一下。文末附代码。</description><pubDate>Sat, 06 Sep 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;在 SAP Gui 中展示图表向来是其不擅长的，但使用 SAP HTML View 功能，借助 JS 语言的能力，我们不妨尝试一下。文末附代码。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-visualization-charts/p1.jpg&quot; alt=&quot;EChart：一个基于 JavaScript 的开源可视化图表库&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-visualization-charts/p2.jpg&quot; alt=&quot;SAP中实现的效果图&quot;&gt;&lt;/p&gt;
&lt;p&gt;本文参考和使用了 CSDN 作者@伊登相关文章及代码，在此感谢。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://blog.csdn.net/x_aerbo/article/details/135857548&quot;&gt;SAP 使用abap开发包含点击事件的图表（CSDN，作者@伊登）&lt;/a&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h3&gt;实现&lt;/h3&gt;
&lt;p&gt;首先来看一段 JS 的 Demo，数据通过 option 变量传递。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;

var chartDom = document.getElementById(&amp;#39;main&amp;#39;);
var myChart = echarts.init(chartDom);
var option;

option = {
  xAxis: {
    type: &amp;#39;category&amp;#39;,
    data: [&amp;#39;Mon&amp;#39;, &amp;#39;Tue&amp;#39;, &amp;#39;Wed&amp;#39;, &amp;#39;Thu&amp;#39;, &amp;#39;Fri&amp;#39;, &amp;#39;Sat&amp;#39;, &amp;#39;Sun&amp;#39;]
  },
  yAxis: {
    type: &amp;#39;value&amp;#39;
  },
  series: [
    {
      data: [120, 200, 150, 80, 70, 110, 130],
      type: &amp;#39;bar&amp;#39;
    }
  ]
};

option &amp;amp;&amp;amp; myChart.setOption(option);
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-visualization-charts/p3.jpg&quot; alt=&quot;柱状图&quot;&gt;&lt;/p&gt;
&lt;p&gt;所以我们的 ABAP 程序也需要按这种方式把值传出去。在我们创建的类 &lt;code&gt;ZCL_GUI_HTML_CHARTJS4&lt;/code&gt; 中，设置一个 &lt;code&gt;SET_OPTIONS&lt;/code&gt; 方法做这件事 。&lt;/p&gt;
&lt;p&gt;拿到参数之后用 &lt;code&gt;INIT_DISPLAY&lt;/code&gt; 展示数据。&lt;/p&gt;
&lt;p&gt;这里提供一段 ABAP 代码：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Report ZTEST01
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;
*&amp;amp;---------------------------------------------------------------------*
REPORT ZTEST01 .
DATA GO_CHART TYPE REF TO ZCL_GUI_HTML_CHARTJS4.

CLASS CL_EVENT_RECEIVER DEFINITION DEFERRED.

DATA OB_EVENT_RECEIVER TYPE REF TO CL_EVENT_RECEIVER.

*----------------------------------------------------------------------*
*       CLASS cl_event_receiver DEFINITION
*----------------------------------------------------------------------*
*
*----------------------------------------------------------------------*
CLASS CL_EVENT_RECEIVER DEFINITION.
  PUBLIC SECTION .

    METHODS: SAPEVENT
      FOR EVENT SAPEVENT OF ZCL_GUI_HTML_CHARTJS4
      IMPORTING ACTION FRAME GETDATA POSTDATA QUERY_TABLE.

  PRIVATE SECTION .

ENDCLASS.                    &amp;quot;cl_event_receiver DEFINITION
*----------------------------------------------------------------------*
*       CLASS cl_event_receiver IMPLEMENTATION
*----------------------------------------------------------------------*
*
*----------------------------------------------------------------------*
CLASS CL_EVENT_RECEIVER IMPLEMENTATION.
  METHOD SAPEVENT.
    &amp;quot;单击事件
    CASE ACTION.
      WHEN &amp;#39;CLICK&amp;#39;.
        PERFORM FRM_PROCESS_CLICK USING GETDATA.
      WHEN OTHERS.

    ENDCASE.
  ENDMETHOD.                    &amp;quot;sapevent
ENDCLASS.                    &amp;quot;cl_event_receiver IMPLEMENTATION

START-OF-SELECTION.

  CREATE OBJECT GO_CHART
    EXPORTING
      IR_PARENT = CL_GUI_CONTAINER=&amp;gt;DEFAULT_SCREEN
      IV_CANUM  = 1                                         &amp;quot;最大支持4
      IV_HOR    = &amp;#39;&amp;#39;  &amp;quot;水平/垂直
      IV_ANT    = &amp;#39;&amp;#39;.

  GO_CHART-&amp;gt;NEW_CHART( &amp;#39;myChart1&amp;#39; ).
  PERFORM FRM_DRAW1.

  PERFORM FRM_REGISTER_EVENT.

  GO_CHART-&amp;gt;INIT_DISPLAY( ).

  WRITE: &amp;#39;ok&amp;#39;.

*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;      Form  frm_process_click
*&amp;amp;---------------------------------------------------------------------*
*       text
*----------------------------------------------------------------------*
*      --&amp;gt;P_DATA     text
*----------------------------------------------------------------------*
FORM FRM_PROCESS_CLICK  USING  P_DATA.

  DATA LT_CDATA TYPE TABLE OF STRING.
  DATA:XSTR TYPE XSTRING.
  DATA:L_CODEPAGE(4) TYPE N.
  DATA:L_ENCODING(20).
  DATA:L_DATA TYPE STRING.
  DATA: CONVOUT TYPE REF TO CL_ABAP_CONV_OUT_CE.
  DATA: CONVIN TYPE REF TO CL_ABAP_CONV_IN_CE.
  DATA STR TYPE STRING.

  L_DATA = P_DATA.
  CHECK L_DATA IS NOT INITIAL.

  &amp;quot;外部字符集转换内部编码
  CALL FUNCTION &amp;#39;SCP_CODEPAGE_BY_EXTERNAL_NAME&amp;#39;
    EXPORTING
      EXTERNAL_NAME = &amp;#39;utf-16be&amp;#39;
    IMPORTING
      SAP_CODEPAGE  = L_CODEPAGE
    EXCEPTIONS
      NOT_FOUND     = 1
      OTHERS        = 2.
  L_ENCODING = L_CODEPAGE.
  IF L_DATA IS NOT INITIAL.
    TRANSLATE L_DATA TO UPPER CASE.
    MOVE L_DATA TO XSTR.
  ENDIF.
  CONVIN = CL_ABAP_CONV_IN_CE=&amp;gt;CREATE( ENCODING = L_ENCODING
                                        INPUT = XSTR ).
  CALL METHOD CONVIN-&amp;gt;READ
    IMPORTING
      DATA = STR.
ENDFORM.                    &amp;quot; FRM_PROCESS_CLICK

*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;      Form  frm_register_event
*&amp;amp;---------------------------------------------------------------------*
*       text
*----------------------------------------------------------------------*
FORM FRM_REGISTER_EVENT .

  DATA: IT_MYEVENT TYPE CNTL_SIMPLE_EVENTS,
        ST_MYEVENT LIKE LINE OF IT_MYEVENT.

  IF OB_EVENT_RECEIVER IS NOT BOUND .
    CREATE OBJECT OB_EVENT_RECEIVER.
  ENDIF .

* Register event

  ST_MYEVENT-EVENTID = GO_CHART-&amp;gt;M_ID_SAPEVENT.
  ST_MYEVENT-APPL_EVENT = ABAP_TRUE .
  APPEND ST_MYEVENT TO IT_MYEVENT .

  CALL METHOD GO_CHART-&amp;gt;SET_REGISTERED_EVENTS
    EXPORTING
      EVENTS = IT_MYEVENT.

  SET HANDLER OB_EVENT_RECEIVER-&amp;gt;SAPEVENT
              FOR GO_CHART .

ENDFORM.                    &amp;quot; FRM_REGISTER_EVENT
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;      Form  frm_draw1
*&amp;amp;---------------------------------------------------------------------*
*       text
*----------------------------------------------------------------------*
FORM FRM_DRAW1 .
  DATA: LS_OPTION  TYPE ZCL_GUI_HTML_CHARTJS4=&amp;gt;TYPE_OPTIONS,
        LS_TOOLTIP TYPE ZCL_GUI_HTML_CHARTJS4=&amp;gt;TY_TOOLTIP,
        LS_DATA    TYPE ZCL_GUI_HTML_CHARTJS4=&amp;gt;TY_SDATA,
        LS_SERIES  TYPE ZCL_GUI_HTML_CHARTJS4=&amp;gt;TY_SERIES.
  LS_OPTION-TITLE-TEXT = &amp;#39;demo&amp;#39;.
  LS_OPTION-TITLE-SUBTEXT = &amp;#39;测试&amp;#39;.
  LS_OPTION-LEGEND-SHOW = &amp;#39;X&amp;#39;.
  LS_OPTION-X_AXIS-SHOW = &amp;#39;X&amp;#39;.
  LS_OPTION-Y_AXIS-SHOW = &amp;#39;X&amp;#39;.
  LS_OPTION-Y_AXIS-TYPE = &amp;#39;value&amp;#39;.
  LS_OPTION-TOOLTIP-SHOW = &amp;#39;X&amp;#39;.
  LS_OPTION-TOOLTIP-TRIGGER = &amp;#39;axis&amp;#39;.
  LS_OPTION-TOOLTIP-AXIS_POINTER-TYPE = &amp;#39;shadow&amp;#39;.
  LS_OPTION-X_AXIS-TYPE = &amp;#39;category&amp;#39;.
  APPEND &amp;#39;水果1&amp;#39; TO LS_OPTION-X_AXIS-DATA.
  APPEND &amp;#39;水果2&amp;#39; TO LS_OPTION-X_AXIS-DATA.
  APPEND &amp;#39;水果3&amp;#39; TO LS_OPTION-X_AXIS-DATA.
  CLEAR LS_SERIES.
  LS_SERIES-TYPE = &amp;#39;bar&amp;#39;.
  LS_SERIES-LABEL-SHOW = &amp;#39;X&amp;#39;.
  LS_SERIES-LABEL-POSITION = &amp;#39;inside&amp;#39;.
  LS_SERIES-LABEL-FORMATTER = &amp;#39;X&amp;#39;. &amp;quot;千分位

  LS_DATA-VALUE = &amp;#39;1500032&amp;#39;.
  LS_DATA-ITEM_STYLE-COLOR = &amp;#39;#5470c6&amp;#39;.
  APPEND LS_DATA TO LS_SERIES-DATA.
  LS_DATA-VALUE = &amp;#39;12009383&amp;#39;.
  LS_DATA-ITEM_STYLE-COLOR = &amp;#39;#91cc75&amp;#39;.
  APPEND LS_DATA TO LS_SERIES-DATA.
  LS_DATA-VALUE = &amp;#39;800093&amp;#39;.
  LS_DATA-ITEM_STYLE-COLOR = &amp;#39;#fac858&amp;#39;.
  APPEND LS_DATA TO LS_SERIES-DATA.
  APPEND LS_SERIES TO LS_OPTION-SERIES.

  GO_CHART-&amp;gt;SET_OPTIONS( LS_OPTION ).

ENDFORM.                    &amp;quot; FRM_DRAW
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;调试上面的代码，我们发现，程序使用上传的模板，把数据替换进了 script 代码里，这就是其实现原理了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-visualization-charts/p4.jpg&quot; alt=&quot;debug 界面&quot;&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;作者提供的代码安装包是 SAPLink 格式，由于个人偏好我在安装后整理了 abapGit 版本供大家交流学习：&lt;/p&gt;
&lt;p&gt;不熟悉 abapGit 的朋友可以移步我这篇文章：&lt;a href=&quot;/blog/abapgit-experience&quot;&gt;abapGit 使用经验总结&lt;/a&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h3&gt;注意：&lt;/h3&gt;
&lt;p&gt;本项目中包含&lt;code&gt;ZCL_JSON&lt;/code&gt;类，可能与你环境中的类有版本差异，注意排查。&lt;/p&gt;
&lt;p&gt;运行测试程序若出现下图错误，请检查 SMW0 是否包含相关文件。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-visualization-charts/p5.jpg&quot; alt=&quot;错误&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-visualization-charts/p6.jpg&quot; alt=&quot;SMW0&quot;&gt;&lt;/p&gt;
&lt;p&gt;若运行后窗口内出现空白页面，可能是本地浏览器兼容问题，请检查GUI设置，不要使用 IE。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-visualization-charts/p7.jpg&quot; alt=&quot;浏览器控件&quot;&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h3&gt;关于 Echarts：&lt;/h3&gt;
&lt;h2&gt;ECharts 是一款由百度团队开发并开源的&lt;strong&gt;数据可视化图表库&lt;/strong&gt;，目前由 Apache 软件基金会维护，它提供了丰富的图表类型和强大的交互功能，能够帮助开发者将数据以直观、美观的方式呈现出来。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1947603249529065810&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>驻厂日记 5</title><link>https://jack-liang.com/blog/factory-journal-5/</link><guid isPermaLink="true">https://jack-liang.com/blog/factory-journal-5/</guid><description>一场夏雨串起南方两年的四季雨景和日常，雨把南方泡成了水灵灵的碧玉，也泡出了南方人温软随性的活法。</description><pubDate>Thu, 31 Jul 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;早晨是被雨砸醒的。起初是零星的点子，“啪、啪” 打在窗玻璃上，像谁用指尖轻轻叩门。没等睁眼，雨势忽然翻了倍，哗啦啦一阵急响，倒像是有人往楼下泼豆子，密得不留一点空当。&lt;/p&gt;
&lt;p&gt;我住的厂区宿舍在七楼，猛地坐起来掀窗帘时，外头已白茫茫一片。雨不是落，是斜着扫，厂房的铁皮顶被浇得油亮，屋檐垂下来的水线连成帘子，砸在地面的积水里，溅起半尺高的白花花。楼下的榕树被抽打得直不起腰，气根在雨里乱舞，倒像是谁在半空甩着湿麻绳。&lt;/p&gt;
&lt;p&gt;洗罢脸，漱了口，雨还没有半分要停的意思。没法子，只好撑着伞下楼，一头扎进雨帘里，深一脚浅一脚往食堂赶。在蒸笼里捡了个花卷，又紧赶着往办公室去。雨点子噼里啪啦打在伞面上，顺着伞骨滑下来，在脚边溅起小小的水花。&lt;/p&gt;
&lt;p&gt;赶到办公室低头一瞧，膝盖以下的裤腿早被雨水浸得透透的，凉丝丝贴着腿，倒像是给小腿儿穿了层水做的 “套裤”。往周围看，狼狈的不止我一个，有同事正弯着腰拧裤腿，水在地上积了个小圈。&lt;/p&gt;
&lt;p&gt;忙活了一会手头上的事，一抬头，才惊觉外头早没了雨声。玻璃窗上的水痕还蜿蜒着，倒像是这场雨临走时留下的几行潦草诗。夏雨总是这般随性，风风火火地来，又悄没声儿地走。&lt;/p&gt;
&lt;p&gt;以前在南方诸国两年，把南方的雨认了个全。春时雨丝软得像新抽的柳芽，在天地间织一张朦胧的诗笺；盛夏的雨落得酣畅，裹着溽热把空气酿得黏腻；到了秋深，雨珠子就变得清冷，一滴一滴，将日子都浸得缠绵。至于这地方的冬雨，倒不似别处般凛冽，像被揉碎的月光，带着若有似无的清寒，把万物都笼进一层薄纱里，让南方的冬天也生出几分婉约的韵致。这雨，把南方泡成了块水灵灵的碧玉。&lt;/p&gt;
&lt;p&gt;雨一落，哪儿都活泛。青瓦上的雨珠子扑簌簌地，像是小孩子随手敲鼓，不成个调儿，倒也有趣。石板路叫雨水这么一冲，亮堂堂的，天光一照，碎银子似的铺满整条街。窗玻璃蒙着层薄雾，拿手指划拉两下，嘿，一串儿歪歪扭扭的小脚丫。&lt;/p&gt;
&lt;p&gt;南方的房子都藏着对付雨的心思。车间门口的雨棚是铁皮的，下雨时叮叮咚咚敲出细碎的响，倒成了流水线外的背景音乐；宿舍阳台支着伸缩架，晾衣杆上的衬衫总带着点潮，摸上去软软的，谁也不恼 —— 在南方，这是再平常不过的光景。&lt;/p&gt;
&lt;p&gt;过日子的人，家里总备着些 “防雨” 的物什。衣柜里搁着防潮剂，裹在花花绿绿的小袋子里，默默守着衣裳；也有挂着两袋除湿袋，透明袋子里积了小半袋水，像吊着两只冰棱；墙角立着除湿机，整日整夜呼噜呼噜吐气，抽走空气里黏糊糊的水汽；晾衣杆上的衣裳，总也晾不透，摸着潮乎乎的，却也不恼——在南方，这是再平常不过的光景了。&lt;/p&gt;
&lt;p&gt;南方人爱喝汤，汤里总离不得薏米、茯苓。薏米白白胖胖，像是养尊处优的小娃娃；茯苓则生得沉稳内敛，倒像个不爱说话的老先生。这两味一下锅，与其他食材慢慢煨着，咕嘟咕嘟，便熬出了祛湿的好汤。湖南人好辣，将自家的湘菜也带到了南方。本地的南方人若是大胆，尝上几口这热辣辣的菜，浑身发了汗，湿寒之气便都散得无影无踪了。&lt;/p&gt;
&lt;p&gt;清晨，早茶铺子就醒了。邀三两老友，寻片刻闲。不赶时辰，一盅两件，慢悠悠地抿茶，慢悠悠地嚼点心。话匣子一打开，东拉西扯，不知不觉就聊到日头偏西。&lt;/p&gt;
&lt;p&gt;待夜色深沉，街角砂锅粥摊亮起一盏暖黄。砂锅里咕嘟咕嘟地沸着，热气腾腾往上冒。盛出一碗浓稠的粥，海鲜的鲜味裹在米香里，入口熨帖，把雨夜里的寒气，都暖化了。&lt;/p&gt;
&lt;p&gt;南方人的骨子里也浸着水汽般的温软。遇了分歧，不似北方人爽朗直截，偏要将话头绕成九曲回廊，字字藏锋，句句留白，恰似春雨吻过镜面般的湖面。&lt;/p&gt;
&lt;p&gt;雨天于南方人，从不是被困住的枷锁，倒成了老天爷馈赠的闲趣。&lt;/p&gt;
&lt;p&gt;衣裳潮乎乎的，路面坑坑洼洼积着水，这些在北方人眼里的 “麻烦”，南方人却见怪不怪。办公室里，有人趿拉着拖鞋就来了，脸上还挂着笑：“下雨天，图个自在！”&lt;/p&gt;
&lt;p&gt;雨，是南方的钟表匠，把日子调得不疾不徐。它浸润着万物，也浸润着南方人的性子。就像雨后的青苔，在潮湿里生得愈发鲜活，南方人的生命力，也在这雨里，长成了独有的模样。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>驻厂日记 4</title><link>https://jack-liang.com/blog/factory-journal-4/</link><guid isPermaLink="true">https://jack-liang.com/blog/factory-journal-4/</guid><description>一段藏在老旧宿舍楼里的厂区爱情：两个年轻工人因变故被迫分开，女孩留下自制零件风车后离开，男孩守着这份回忆直到工厂迁走。</description><pubDate>Wed, 30 Jul 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;这几日，南方的天像是被人用竿子戳了无数个窟窿，雨总是淅淅沥沥地下个不停。空气里满是潮气，黏糊糊的，衣服晾在屋里，总也干不透。地板踩上去滑溜溜的，稍不留神就要摔个趔趄。这样的天，最宜躺在屋里，听着雨打窗棂的声响，慢悠悠说些旧事。&lt;/p&gt;
&lt;p&gt;最近的日子，上班、中饭、下班、晚饭，又回到了以前的轨道上，就像磨盘上的驴子，一圈圈地转，重复又无聊。虽然工作上的事儿，也能扯几句闲篇，可终究是些家长里短，鸡毛蒜皮，多说无益。&lt;/p&gt;
&lt;p&gt;想起刚来那日，拖着几十斤重的箱子爬楼梯，直喘得像风箱。今天闲下来倒让我对这宿舍楼来了兴致。原以为超过六层的楼总得有部电梯，这楼偏不，哪晓得这头一遭，就给我来了个下马威。&lt;/p&gt;
&lt;p&gt;后来听乐姑娘说，这楼是九十年代盖的，许是那会儿还没这规矩。九十年代，可不跟我差不多年纪？看它外墙的瓷砖，掉了好些块，露出里头青灰色的水泥，像老人脸上褪了色的斑，看来也是饱经风霜了。&lt;/p&gt;
&lt;p&gt;楼里住的人，像园子里的菜，一茬接一茬。来的时候，个个眼里有光，脚步轻快；走的时候，肩上像多了些什么，步子也沉了。多少年轻的日子，就耗在这楼里，耗在楼下的厂房里。日子久了，总该有些故事的。&lt;/p&gt;
&lt;p&gt;这不，还真让我听着一个。&lt;/p&gt;
&lt;p&gt;两个年轻人，一南一北，都在这楼里住，在同一条产线上干活。天天一块儿上班，一块儿下班。起初见了面，只是笑笑，后来熟了，会分着嗑一袋瓜子，说几句家乡的事。两人家里都不宽裕，说话投机，日子就这么不紧不慢地过着。歇班的时候，有时在楼下的树底下坐着，看蜘蛛结网；有时搭公交去市里，在公园的长椅上晒晒太阳，说些不着边际的话。&lt;/p&gt;
&lt;p&gt;变故是从一通电话开始的。女孩的父亲病危，临走前，念叨着女儿终身大事没定。他强撑着最后一口气，在邻村寻摸到一个做乡村教师的小伙子，家里条件不错，要她回去成亲。接了消息，女孩在楼梯间坐了半宿。楼梯间的灯忽明忽暗，把她的影子拉得老长，又缩成一团。&lt;/p&gt;
&lt;p&gt;男孩见她这几日总是发愣，问了好几回，才问出缘由。那天晚上，两人在楼顶的天台上站了会儿。风有点凉，吹得女孩的头发乱了，她也没理。女孩说：“我可能得回去了。” 男孩没说话，看着远处工厂的灯火，一片一片，亮一阵，又暗一阵。&lt;/p&gt;
&lt;p&gt;打那天后，俩人之间就像隔了层纱。走在宿舍楼的走廊里，原先并排的步子，变成一前一后。墙上那些斑驳的印记，还留着往日的笑声，这会儿却只剩下寂静。女孩开始默默收拾东西，每拿起一样，就像拾起一段回忆，拿在手里，又舍不得放下。&lt;/p&gt;
&lt;p&gt;临走前一天，女孩在男孩宿舍门口放了个小风车，是用厂里废弃零件做的，熬了好几个夜才做成。风车叶片上，还刻着几个小字，是俩人的名字。男孩瞧见，眼泪 “唰” 地就下来了，赶忙往厂子门口跑。等他出去，只瞅见女孩的背影上了车，消失在人群里，只留下他的影子，在路灯下拉得老长。&lt;/p&gt;
&lt;p&gt;女孩走后，男孩还住在这楼里，每天上下班都要路过女孩原先的宿舍。他把那小风车挂在窗边，风一吹，就骨碌碌地转，像是有说不完的话。宿舍楼的墙皮一块接一块地往下掉，楼梯扶手也越发斑驳，可那段藏在犄角旮旯的感情，倒像楼梯间那盏晃悠却总亮着的灯，在时光里暖烘烘的。&lt;/p&gt;
&lt;p&gt;后来听说，女孩到底退了亲，在家里一边照顾父亲，一边拼命攒钱给父亲做了手术，可终究人也没救回来，她也没再回这个厂子。男孩在这楼里住了五年，直到工厂迁走才离开。有人说，他走的时候，就带了那个小风车。&lt;/p&gt;
&lt;p&gt;如今我天天爬这楼梯，有时会想起这个事。说不定哪个楼梯的拐角，还留着他们坐过的痕迹；哪个窗台上，还沾着风车转过的影子。这楼就这么立着，和那些旧事一起，安安静静的。&lt;/p&gt;
&lt;p&gt;（故事纯属虚构，有雷同也说不定）&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>驻厂日记 3</title><link>https://jack-liang.com/blog/factory-journal-3/</link><guid isPermaLink="true">https://jack-liang.com/blog/factory-journal-3/</guid><description>在厂区食堂看着年轻工人木然的脸，忽然认出他们就是当年没来报名的同学——被考卷筛下来的普通孩子，最终在流水线上把名字活成工号，工业化把人的鲜活劲儿磨得干干净净。</description><pubDate>Tue, 29 Jul 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;午饭时去食堂，人已经满了。灯不亮，空气里混着汗味和饭菜的热气，潮乎乎的。&lt;/p&gt;
&lt;p&gt;厂里多是年轻人，瞧着他们木木的脸，没什么表情，忽然就愣了神 —— 这里会不会遇到我小时候的同学？&lt;/p&gt;
&lt;p&gt;每年开学那会儿，要是少了几个同学没来报名，问起，多半是往南方打工去了。&lt;/p&gt;
&lt;p&gt;我总羡慕，他们年纪轻轻就敢闯大城市，在亮晃晃的城里做喜欢的事，日子定是活色生香的。可现在细想，小小年纪，文化不高，到了外面能做什么呢？眼前这些脸，怎么也和记忆里他们那股鲜活劲儿对不上，怕是见了也不一定认得出来了。&lt;/p&gt;
&lt;p&gt;老话说 “万般皆下品，惟有读书高”，书读得不好，好像就落了下乘。普通人家的孩子，倘若没有应付考试的天分，升学之路就会被考卷上的红叉封将死，那些没被墨水浸透的手，终究要去握住冰冷的扳手，往后余生多半也只能在反复的重复中咀嚼着人生的酸涩。&lt;/p&gt;
&lt;p&gt;以前读黄灯老师的《我的二本学生》，说全国三千多所高校，除了百十来所 985、211，剩下的大多是二本往下。这些人啊，在人堆里就像没印清楚的字，模糊得很。在我看来，能上二本已经不算差了。再往下呢？专科的孩子又有多少？十几年的求学生涯，总不时有人被层层筛选下来，他们最终都去了哪儿呢？&lt;/p&gt;
&lt;p&gt;大抵是散落进了这些厂房里吧。有的在流水线上给零件贴标签，有的在仓库里搬箱子，有的守着机床日复一日地打磨 —— 就像眼前这些年轻人，穿着统一的工装，在机器声里消磨着日子，名字慢慢被工号代替，连笑起来的样子都带着几分相似的疲惫。&lt;/p&gt;
&lt;p&gt;有时候，这样一天天上班下班，会觉得生活从来就该是这样。但回头想想，工业化也不过一两百年的光景。以前的人，更多同大自然打交道，日出而作，日落而息。那时候的社会，就算有封建地主那样的剥削，劳动里总还留着点自主性，带着点人情味儿。到了资本主义工厂，马克思说的 “异化” 就来了 —— 人反倒被资本和机器支使着，劳动不再是舒心的事，倒成了压在身上的分量。日子里的一厘一毫，都被裹进了资本增殖的圈圈里。&lt;/p&gt;
&lt;p&gt;《资本论》里说，工业催着社会往前跑，却也把人磨得变了样。有时会瞎想，要是没有这些机器轰鸣，这些年轻人会过什么样的日子？&lt;/p&gt;
&lt;p&gt;或许自小在乡间的私塾里学个“人之初，性本善”，放学的路上在田埂间追蝴蝶、捉蜻蜓，蹲在水渠边看蝌蚪；稍年长些，背着粗布行囊去镇上，学个木匠、铁匠的手艺，做得好，十里八乡都能叫出名字；待到二十来岁，家里托媒人说门亲，一家人和和睦睦过日子，也有温度。无论怎样，有人守着祖传手艺走街串巷，有人在自家小院侍弄菜园，脸上总该有几分活人气。&lt;/p&gt;
&lt;p&gt;可现在，社会看着是进步了，生活条件也好了，可一家人却都七零八落的散落各处，有些人父母在乡里，有些人老婆孩子在老家，一年到头见不着几回面。日常生活被车间墙上的时钟秒针切得碎碎的，每天都像机器上的螺丝钉，拧在这儿，拧在那儿。以前的调皮劲儿、藏在眼睛里的光，慢慢都磨没了。人成了流水线上的零件，谁也说不清你是谁。没人问你晚上睡得香不香，没人管你心里装着什么念想，吃着最廉价的饭菜，挤着集体宿舍，日子就这么对付着过。&lt;/p&gt;
&lt;p&gt;说到底，是 “人” 站的位置不一样了。从前是人拿着主意管劳动、过日子，现在倒像是劳动攥着人走。这变化说不上好与坏，只是看着这些年轻人，心里头有些空落落的。&lt;/p&gt;
&lt;p&gt;食堂角落里，一个小伙子扒拉着饭，眼神直勾勾盯着手机，嘴里慢慢嚼着，像台设定好程序的机器。窗外的太阳正毒，照在树顶上亮得晃眼，可照不进这些年轻人眼里的暗影。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>驻厂日记 2</title><link>https://jack-liang.com/blog/factory-journal-2/</link><guid isPermaLink="true">https://jack-liang.com/blog/factory-journal-2/</guid><description>驻厂第二天，从晨散步、入职安顿到冒雨聚餐，在异乡的细碎日常里摸到了烟火人情的温度，也品出了聚散寻常、把他乡过成片刻故乡的况味。</description><pubDate>Mon, 28 Jul 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;天还蒙蒙亮，窗户透着点青白，闹钟没响，我先醒了。夜里睡得沉，浑身骨头都松快。也不用急着起身 —— 办公室就在路对面大楼里，住园区这点好，省了赶早班的慌，日子能过得匀净些。&lt;/p&gt;
&lt;p&gt;若是起了兴，套件速干衣到园区边上跑跑步，也自在。其他人大都还没起，园区里静悄悄的，道旁的榕树叶子上还挂着露水，风一吹，簌簌落几滴在颈窝里，一股清凉。路上没几个人，偶见两个穿工装的并肩走着，说话声被风揉碎了，听不真切，只觉得安稳。&lt;/p&gt;
&lt;p&gt;厂子八点半上班。约莫八点十分，踱到楼下食堂。笼屉里的热饼子冒着白气，芝麻香混着葱花味飘过来。本想拿一张揣在手里，边走边啃，刚咬两口，饼渣卡得喉咙发紧，便折回去盛了碗米汤，里面没几粒米，一口饼子一口汤就着刚好。&lt;/p&gt;
&lt;p&gt;头天上班，满眼都是生面孔，工位在哪，该认谁，全摸不着头脑，只在门口候着那位姓乐的女生来领。没等多久，她从楼里走出来，浅浅握了手。女生一口一个 “老师”，叫得恳切，倒让我有些不好意思。这 “乐” 字，是读 “le” 还是 “yue”？没好意思问，只随着她往里走。&lt;/p&gt;
&lt;p&gt;进了大楼，正面是个公司前台，靠边上摆着几张沙发，奶白色的皮子磨得发亮，该是接待人的地方。&lt;/p&gt;
&lt;p&gt;二楼是办公区，IT开发都在这层，往上几层，听说是财务、人事这些部门。&lt;/p&gt;
&lt;p&gt;楼里光线偏暗，像是蒙着层薄纱，人却稠，各守着一张办公桌，有的正捏着茶叶梗往玻璃杯里放，热水一冲，叶片打着旋儿舒展开；有的早盯着电脑屏，眉头微蹙，手指在键盘上敲得笃笃响，像檐下的雨点儿打在青石板上，急一阵，缓一阵，倒也有个节奏。&lt;/p&gt;
&lt;p&gt;乐姑娘引我到个空工位，说句 “您就先在这儿落脚”，便去忙了。我打开背包，一样样往外拾掇：笔记本电脑、键盘、鼠标，还有个支电脑的小架子，充电器线绕了两圈，最后是只陶瓷水杯。零零碎碎摆开来，不大的桌面，霎时间满满当当，像在这陌生地方，安了个临时的家。&lt;/p&gt;
&lt;p&gt;一上午也简单，连个网，跟着乐姑娘认人。张三李四，王姐小赵，名字听了一耳朵，脸却一张没记住。心里不免发虚：回头在楼道撞见，怕是要闹 “相逢不相识” 的笑话。转念又想，谁不是打生面孔过来的？日子长了，自然就熟了，不急。&lt;/p&gt;
&lt;p&gt;午饭是几个人凑在一块儿吃的。我向来怕生，能躲就躲，可初来乍到，总得应个景。食堂的菜是家常味，青椒炒肉，番茄蛋汤，大家有一搭没一搭地说着话，说各自的籍贯，说食堂的菜价，倒也不局促。原来人和人走近，有时就靠这一碗一碟的热乎气。&lt;/p&gt;
&lt;p&gt;下午偷摸开了个远程会，是另一个项目的事。领导特意嘱咐要瞒着甲方，听着听着就有些发困 —— 一来是不打紧的琐事，二来是骨子里那点惰性在作祟，总想着 “明日复明日”。罢了，船到桥头自然直，先搁搁吧。&lt;/p&gt;
&lt;p&gt;一下午时间过的说快也慢，无所事事时便这看看那瞧瞧，还抽空在楼下的园区里逛了一圈。厂房里的机器轰鸣，像一群不知疲倦的壮汉在哼哧哼哧干活；外面几辆大车运出运进，忙得脚不沾地。&lt;/p&gt;
&lt;p&gt;我呢，水接了一杯又一杯，卫生间去了一趟又一趟，这一天下来的运动步数，竟全靠这来来回回的踱跶积累着。&lt;/p&gt;
&lt;p&gt;这边下班倒准时，五点半一到，楼道里便热闹起来。乐姑娘说请吃饭，偏巧下了雨，几个人撑着伞沿着厂外的街慢慢走。路灯还没亮，街边的小炒店飘出蒜香，一行人便进了家湘菜馆。馆子不大，方桌圆桌加一起五六张，一张桌下还躺着条浑身健壮的白狗，人来了也不搭理，只顾蜷着身子打盹。&lt;/p&gt;
&lt;p&gt;拣了张靠里的桌子坐下，乐姑娘要了菜单，挨个儿问忌口。我摆摆手，说随便，辣点无妨。她便笑着点了剁椒鱼头、小炒黄牛肉，又加了盘拍黄瓜，说解辣。&lt;/p&gt;
&lt;p&gt;菜上得快。鱼头端上来，红亮亮的剁椒堆得像座小山，热气裹着辣香扑过来，鼻尖先冒汗了。黄牛肉切得细碎，青蒜炒得翠绿，油星子溅在盘边，看着就下饭。&lt;/p&gt;
&lt;p&gt;几个人边吃边聊，无非找几句话说，了解一下彼此。办公室里闲聊影响不好，饭桌上却不同，有些该说的不该说的，聊着聊着就说了出来，琐碎得很，却听得入耳。&lt;/p&gt;
&lt;p&gt;走了许多地方，做了许多项目，日子原是这些碎片拼的：一碗热米汤，一声怯生生的 “老师”，几句闲话。寻常，却带着烟火气，熨帖得很。&lt;/p&gt;
&lt;p&gt;这些年为项目奔忙，天南海北，来去匆匆。结识些人，共事时总有话说，项目一了，挥手作别，山高水远，再难相逢。&lt;/p&gt;
&lt;p&gt;就像今早那碗米汤，热乎气儿转眼就散了。&lt;/p&gt;
&lt;p&gt;人这一生，不就是在陌生处识些陌生人，做些寻常事，慢慢把他乡过成片刻故乡么？&lt;/p&gt;
&lt;p&gt;人生聚散原是寻常，如园区的花，开了谢了，谢了或许再开，或许不再。但那份芬芳，总淡淡的留在心头，难忘。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>驻厂日记 1</title><link>https://jack-liang.com/blog/factory-journal-1/</link><guid isPermaLink="true">https://jack-liang.com/blog/factory-journal-1/</guid><description>上一个项目收工才一周，这边的活儿就接上了。骨头还没歇舒坦，脑子也昏沉沉的，今天又拖着这一身乏，飞到了深圳。</description><pubDate>Sun, 27 Jul 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;上一个项目收工才一周，这边的活儿就接上了。骨头还没歇舒坦，脑子也昏沉沉的，今天又拖着这一身乏，到了深圳。&lt;/p&gt;
&lt;p&gt;听说是家造电子器件的厂子，计算机、通信设备都做。办公的地方偏得很，从魔都飞过来，落地后，地铁倒了三回，又坐了段公交，末了还得拖着箱子走两里地，才到厂区。一早出门，到地方已是下午，这路程，倒和回趟老家差不离了。&lt;/p&gt;
&lt;p&gt;刚进厂区门，见个身量不高、瞧着还年轻的小伙子从里头走出来，手里捏着什么单子递给门卫。门卫二十出头，比他壮实些，站在一块儿，倒显得有几分伟岸了。那门卫说话不怎么客气，板着脸，像是在教训自家小兄弟。&lt;/p&gt;
&lt;p&gt;这时候日头正毒，空气烘得人发黏。我急着找宿管拿钥匙，没心思细听他们嚼什么舌根，只心里犯嘀咕：这地方管人，倒像是学校里老师管学生？&lt;/p&gt;
&lt;p&gt;宿管办公室报了姓名，钥匙顺顺当当拿到手。瞅着门牌是七楼，心说该有电梯吧？转了半圈，只看见楼梯森森然，却没电梯的影子。折回去问，果然没有。没奈何，拖着十几公斤的箱子，背上还压着个鼓鼓囊囊的包，一步一挪往上爬。爬个三两层，就得停下来喘口气，后背的衣裳早湿透了，黏在身上，像块浸了水的棉絮。&lt;/p&gt;
&lt;p&gt;宿舍倒还齐整，桌椅床铺都有，就是跟家里比，总归是局促些。不过不要钱的住处，还能挑拣什么？进门先摸空调开关，凉风一出来，浑身的毛孔才算松快些。赶紧把汗湿的衣裳扒下来，冲了个澡，勉强活过来了。&lt;/p&gt;
&lt;p&gt;休息一会儿，看看天色，该吃晚饭了。正好出去走走，认认路。&lt;/p&gt;
&lt;p&gt;宿舍隔壁就是食堂，一进门，热浪混着饭菜香扑面而来。灯不算亮，稀稀拉拉坐着些人，多半是年轻人，也有几个看着年纪稍长的，都低着头，一只手扒拉着碗里的饭，另一只手在手机上划来划去，指尖飞快。&lt;/p&gt;
&lt;p&gt;食堂一角是自助选菜的，盛在不到十来个盘子里，菜色看着倒清爽。我学着旁人的样子，拿个碟子夹了几样，称下来不到十块，着实便宜。付了钱，拿了双不锈钢筷子，见角落里立着个大柜子，跟冰柜似的，上面挂着几把饭铲，原来是盛米饭的。盛了一勺，长粒米，嚼着有股子韧劲，还行，就着寡淡的紫菜蛋花汤吃完了事。&lt;/p&gt;
&lt;p&gt;饭罢出来，看地图才知这地方原是个村镇，离市中心隔着几十里地。南方的厂子真多，一眼望过去，厂房连着厂房，没个尽头。只是怪，这么些人住着，手机信号倒时断时续，像个被遗忘的角落。&lt;/p&gt;
&lt;p&gt;食堂旁边有片空场，十几张石凳摆成一圈，上面三三两两坐着人。七八月份的南方，太阳落了山，空气还是热烘烘的，像口烧红的锅。他们也不嫌热，有的低头刷手机，有的叼着烟，烟头明灭不定。地上扔着些饮料瓶子，横七竖八的。&lt;/p&gt;
&lt;p&gt;往常在街上见着这光景，我总要绕着走，总觉得不定什么时候就惹上麻烦。但此刻瞧着，都是厂哥厂妹，我和他们也没什么两样。&lt;/p&gt;
&lt;p&gt;在园区里晃了晃，便利店买了点东西，就回宿舍了。刚到楼门口，迎面的牌子上写着什么女生宿舍、男生莫入的话，倒让我吃了一惊，莫不是走错了地方？再往外走几步细看入口，是没错呀，既没人拦着，也有男生出入，我便跟随别人的脚步走吧，总不能不上去。&lt;/p&gt;
&lt;p&gt;洗漱罢，把汗湿的衣裳搓了搓，晾在阳台上。明天要见客户，得拾掇拾掇。老一辈做顾问的，讲究穿西装打领带，说这是体面。可在这地方，真要是西装笔挺地走出去，怕是倜傥不起来哟？&lt;/p&gt;
&lt;p&gt;夜风从阳台钻进来，带着楼下樟树的气味。晾着的T恤平整垂落，衣角偶尔被风掀起一角。其实人生哪有那么多体面不体面的讲究，不过是到什么山头唱什么歌。这厂区的路灯亮了，昏黄的光铺在路面，和我走过的无数异乡街道并无不同。人这一生，不就是从一个陌生的门口走进另一个陌生的门口，把箱子放下，把汗擦干，然后慢慢认出门口的树、窗边的风，和那些擦肩而过的人么？明天太阳升起，这新地方的日子，也就开始了。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>SAP中通过标准Function无法获取到自定义字段的文本问题探究</title><link>https://jack-liang.com/blog/sap-custom-field-text/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-custom-field-text/</guid><description>官方在 Note 491403 - Identifying text in SAP Query 有一些说明。</description><pubDate>Thu, 17 Jul 2025 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;在SAP系统中，通过预定义数据字典实现自动文本获取，但对于自定义字段，标准Function RH_TEXT_GET有时会失败。本文将探讨如何解决这一问题，确保自定义字段也能顺利获取文本。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;官方在 Note 491403 - Identifying text in SAP Query 有一些说明。&lt;/p&gt;
&lt;p&gt;系统预留了几个配置表，以处理特殊的数据元素（TEXC_DE）、域（TEXC_DOM ）和表（TEXC_FLD）的取值。&lt;/p&gt;
&lt;p&gt;比如我做的是HR模块，需要处理 P0001-ZHR_FRZZ 字段，使用 Note 中给出的程序（SE38：RS_TEST_IDENTIFY_TEXT）检查一下，PERNR 字段是可以正常取出文本的，但 ZHR_FRZZ 是通过 VALUETABLE 也就是值表取值，没能匹配到。因为值表是一张的是系统表，不能贸然增加文本字段或者维护数据。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-custom-field-text/p1.jpg&quot; alt=&quot;检查结果&quot;&gt;&lt;/p&gt;
&lt;p&gt;所以我们考虑其他方法，首先给表中维护一条对应的记录。&lt;/p&gt;
&lt;p&gt;如果是简单的文本表取数，直接维护上文本表和文本字段就大功告成了。&lt;/p&gt;
&lt;p&gt;但复杂一些的就需要通过代码完成。&lt;/p&gt;
&lt;p&gt;这里我需要指定实现取文本逻辑的 Function，然后配置特定类——HR 模块需要配的类是 CL_HR_TEXT_IDENTIFIER ，其他模块参考官方文档，可能是 CL_TEXT_IDENTIFIER。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-custom-field-text/p2.jpg&quot; alt=&quot;SM30: TEXC_FLD&quot;&gt;&lt;/p&gt;
&lt;p&gt;至于 Function 应该怎么写，有哪些参数呢？Note 中给了一个例子，可以参考 Function TXID_TEXT_IDENTIFIER_TEMPLATE，也可以参考上图中的 PERNR 的 Function HR_TXID_PERNR。&lt;/p&gt;
&lt;p&gt;翻译其中的一段。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-custom-field-text/p3.jpg&quot; alt=&quot;TXID_TEXT_IDENTIFIER_TEMPLATE&quot;&gt;&lt;/p&gt;
&lt;p&gt;参考其中的说明，代码可以这样写：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;* 匹配域为S_BUSPANUM的字段
IF domainname = &amp;#39;S_BUSPANUM&amp;#39;.
  IF mode = &amp;#39;IDENTIFY_TEXT&amp;#39;.
    &amp;quot; 仅需FIELDVALUE即可获取文本（如从STRAVELAG表读取）
    text_exists_type = cl_text_identifier=&amp;gt;co_tetype_readable.
    like_tabname = &amp;#39;STRAVELAG&amp;#39;.  &amp;quot; 文本参考表
    like_fieldname = &amp;#39;NAME&amp;#39;.     &amp;quot; 文本参考字段
  ELSEIF mode = &amp;#39;READ_TEXT&amp;#39;.
    &amp;quot; 读取STRAVELAG表中对应编号的名称
    SELECT SINGLE name INTO text FROM stravelag WHERE agencynum = fieldvalue.
    text_for_value_read = &amp;#39;X&amp;#39;.  &amp;quot; 标记读取成功
  ENDIF.
ENDIF.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;另外，对于函数的运行逻辑，也可以通过打断点来了解。在取文本的时候，我们自定义的函数被调用了两次，IDENTIFY_TEXT 和 READ_TEXT，第一次指定文本要参考的数据类型，第二次获取文本。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-custom-field-text/p4.jpg&quot; alt=&quot;第一次调用&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-custom-field-text/p5.jpg&quot; alt=&quot;第二次调用&quot;&gt;&lt;/p&gt;
&lt;p&gt;完成这些之后，我们再次执行检查程序。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-custom-field-text/p6.jpg&quot; alt=&quot;检查结果&quot;&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-custom-field-text/p7.jpg&quot; alt=&quot;IF_TEXT_IDENTIFIER&quot;&gt;&lt;/p&gt;
&lt;p&gt;系统接口 IF_TEXT_IDENTIFIER 的文档中还给我们提供了更多信息，感兴趣可以看一下。&lt;/p&gt;
&lt;p&gt;大致归纳如下：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;概述&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;接口IF_TEXT_IDENTIFIER用于实现数据字典中的文本自动识别，核心功能是通过字典信息在指定字段中查找对应文本，主要应用于SAP Query，支持两类实现类：跨应用的&lt;code&gt;CL_TEXT_IDENTIFIER&lt;/code&gt;和HR专用的&lt;code&gt;CL_HR_TEXT_IDENTIFIER&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;核心内容&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;核心方法&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;IDENTIFY_TEXT&lt;/code&gt;：识别文本的获取方式（如关联的文本表、字段等）。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;READ_TEXT&lt;/code&gt;：根据识别结果读取具体文本内容。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;2. 文本识别逻辑与测试&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;逻辑：通过数据字典信息（表、字段、数据元素、域等）自动匹配文本。&lt;/li&gt;
&lt;li&gt;测试：可使用报表&lt;code&gt;RS_TEST_IDENTIFY_TEXT&lt;/code&gt;验证文本识别结果，分析文本缺失原因。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;3. 例外规则定义（当字典定义无法满足需求时）&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：字典定义无法匹配目标文本且不可修改时，通过例外规则扩展逻辑。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;例外类型与存储表&lt;/strong&gt;（分SAP标准和客户自定义）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;单表字段例外：&lt;code&gt;TEXC_FLD&lt;/code&gt;/&lt;code&gt;TEXC_FLD_C&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;特定数据元素例外：&lt;code&gt;TEXC_DE&lt;/code&gt;/&lt;code&gt;TEXC_DE_C&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;特定域例外：&lt;code&gt;TEXC_DOM&lt;/code&gt;/&lt;code&gt;TEXC_DOM_C&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;定义方式：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;关联文本表+文本字段；&lt;/li&gt;
&lt;li&gt;实现指定接口的函数模块（参考模板&lt;code&gt;TXID_TEXT_IDENTIFIER_TEMPLATE&lt;/code&gt;）。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;约束条件：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;文本表+文本字段与函数模块二选一，不可同时指定；&lt;/li&gt;
&lt;li&gt;需指定优先级（通常设为“始终适用”）；&lt;/li&gt;
&lt;li&gt;可通过“专用类”字段限制适用范围（如仅HR类&lt;code&gt;CL_HR_TEXT_IDENTIFIER&lt;/code&gt;）。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;总结&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;IF_TEXT_IDENTIFIER通过标准化接口实现文本自动识别，支持灵活的例外规则扩展，平衡了系统默认逻辑与业务特殊需求，广泛应用于报表开发中的文本解析场景。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;参考内容：&lt;/strong&gt;&lt;/p&gt;
&lt;h2&gt;&lt;a href=&quot;https://me.sap.com/notes/491403/E&quot;&gt;https://me.sap.com/notes/491403/E&lt;/a&gt;&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1929191043686962727&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>ABAP开发有哪些高效的优化工具</title><link>https://jack-liang.com/blog/abap-performance-tools/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-performance-tools/</guid><description>在ABAP开发过程中，有许多工具可以帮助开发者优化程序的性能。今天来讲一下：</description><pubDate>Tue, 10 Jun 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;在ABAP开发过程中，有许多工具可以帮助开发者优化程序的性能。今天来讲一下：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;ABAP运行时间分析 (SE30)&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：SE30是一个性能分析工具，用于跟踪ABAP程序的执行时间。它能够提供详细的运行时间信息，帮助你找出程序中存在性能瓶颈的部分。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：适用于分析长时间运行的程序，通过查看函数或方法的执行时间来判断哪些地方需要优化。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p1.jpg&quot; alt=&quot;SE30 界面&quot;&gt;&lt;/p&gt;
&lt;p&gt;这个工具和后面的SAT比较相似，下文会讲到。&lt;/p&gt;
&lt;ol start=&quot;2&quot;&gt;
&lt;li&gt;&lt;strong&gt;SQL Trace (ST05)&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：ST05是一个强大的SQL追踪工具，它可以记录所有数据库操作的详细信息，包括&lt;code&gt;SELECT&lt;/code&gt;、&lt;code&gt;INSERT&lt;/code&gt;、&lt;code&gt;UPDATE&lt;/code&gt;和&lt;code&gt;DELETE&lt;/code&gt;语句。你可以查看这些语句的执行计划、执行时间和数据库的响应。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：当程序涉及到大量数据库操作时，使用ST05可以帮助你找到慢查询、表扫描和缺乏索引的情况，从而对SQL语句进行优化。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p2.jpg&quot; alt=&quot;ST05&quot;&gt;&lt;/p&gt;
&lt;p&gt;图中核心操作区&lt;code&gt;Activate Trace&lt;/code&gt;（激活跟踪）、&lt;code&gt;Deactive Trace&lt;/code&gt;（停止跟踪）、&lt;code&gt;Display Trace&lt;/code&gt;（显示结果）是比较常用的几个功能，在下方根据需要勾选需要跟踪的类型即可。&lt;/p&gt;
&lt;p&gt;跟踪类型：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;SQL Trace&lt;/code&gt;：追踪 SQL 语句执行（如执行时间、执行频率，排查数据库操作性能问题 ）；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Buffer Trace&lt;/code&gt;：分析缓冲（如 SAP 系统缓冲）使用情况，看是否有频繁缓冲读取 / 失效影响性能；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Enqueue Trace&lt;/code&gt;：追踪锁（Enqueue）操作，排查因锁竞争导致的性能或业务阻塞；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;RFC Trace&lt;/code&gt;：追踪 RFC（远程函数调用），用于跨系统调用的性能、逻辑排查；&lt;/li&gt;
&lt;li&gt;其他（&lt;code&gt;HTTP Trace&lt;/code&gt;/&lt;code&gt;APC trace&lt;/code&gt;/&lt;code&gt;AMC Trace&lt;/code&gt; 等 ）：依场景用于 HTTP 通信、特定应用性能追踪等。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code&gt;Stack Trace&lt;/code&gt;（栈追踪）选&lt;code&gt;Off&lt;/code&gt;，若开启（&lt;code&gt;On&lt;/code&gt;），可记录代码调用栈信息，辅助定位性能问题根源（但会增加追踪数据量 ）。&lt;/p&gt;
&lt;p&gt;点Activate Trace之后我们在另一个窗口执行需要跟踪的程序，完成后回到本跟踪窗口，点击Deactive Trace、Display Trace，即可查看跟踪结果。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p3.jpg&quot; alt=&quot;跟踪结果&quot;&gt;&lt;/p&gt;
&lt;p&gt;图中给出了详细的内容，我们可以看到对应的程序、表名，双击对应位置就能跳转过去。&lt;/p&gt;
&lt;h3&gt;3. &lt;strong&gt;ABAP性能监控 (SAT)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：SAT（ABAP Runtime Analysis）是SAP的一个新工具，可以用来检测和分析ABAP程序的性能。它提供了对内存使用、数据库访问、CPU时间、内表大小等详细的性能指标。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：适用于对程序进行全方位性能监控，帮助开发者从各个角度发现性能问题，并提供优化建议。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p4.jpg&quot; alt=&quot;SAT/SE30&quot;&gt;&lt;/p&gt;
&lt;p&gt;SAT与SE30的功能大同小异，进入后我们会在左上角看到&lt;code&gt;Tips &amp;amp; Tricks&lt;/code&gt;的按钮，这是一些开发技巧提示，其中对ABAP常用的一些功能，如SQL、内表操作、分支判断等做了讲解，还有对应的运行时间对比，建议有时间认真学习一下。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p5.jpg&quot; alt=&quot;Tips &amp;amp; Tricks&quot;&gt;&lt;/p&gt;
&lt;p&gt;回到SAT来，我们可以看到SAT提供了针对，事务码、程序和函数模块的分析，勾选并填入对应对象，点击下方&lt;code&gt;Execute&lt;/code&gt;即可正常执行程序，执行完毕后回返回分析结果。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p6.jpg&quot; alt=&quot;Hit List&quot;&gt;&lt;/p&gt;
&lt;p&gt;我通常会看着重看Hit List，聚焦耗时高的代码段（如数据库查询、循环逻辑 ），进行代码优化、简化流程 。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Gross [microsec]（总耗时，微秒）&lt;/strong&gt;：指该语句或事件在整个程序运行期间所花费的总时间，包括其调用其他子程序的时间。通过总耗时可以直观地看出哪些语句或事件消耗了较多的时间。&lt;/p&gt;
&lt;p&gt;同时，通过查看程序之间的调用关系，可以发现是否存在不合理的嵌套调用或者过度依赖的情况，从而进行相应的改进。&lt;/p&gt;
&lt;h3&gt;4. &lt;strong&gt;Code Inspector (SCI)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：Code Inspector 是一种静态代码分析工具，可以扫描ABAP代码，识别潜在的性能问题、错误、重复代码、潜在的内存泄漏等问题。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：当代码逻辑复杂或存在潜在的性能问题时，SCI可以帮助提前发现问题，并提供优化建议。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p7.jpg&quot; alt=&quot;SCI&quot;&gt;&lt;/p&gt;
&lt;p&gt;SCI主要用于代码合规的检查，也能检查出一些语法方面的错误，所以在一些项目上回设置一个规则，用来规范项目代码。&lt;/p&gt;
&lt;p&gt;上图的界面中从下网上看：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;检查变式：是代码检查规则的集合（内置或自定义，决定检查 &amp;quot;语法严谨性&amp;quot;&amp;quot;性能&amp;quot;&amp;quot;安全&amp;quot; 等维度 ），以DEFAULT为例；&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p8.jpg&quot; alt=&quot;DEFAULT变式&quot;&gt;&lt;/p&gt;
&lt;p&gt;用户也可以根据自己的需要定制检查变式，例如对变量命名进行检查。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p9.jpg&quot; alt=&quot;命名规则&quot;&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;对象集：定义要检查的 ABAP 对象范围（如特定程序、函数组、类 ）；&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p10.jpg&quot; alt=&quot;对象集&quot;&gt;&lt;/p&gt;
&lt;p&gt;也就是说这里要配你需要检查的对象集合，我这里创建的对象集，只包含一个程序。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;检验：可理解为 &amp;quot;检查方案&amp;quot;，决定要执行哪些对象集、检查变式等， 也可以指定请求或单个对象；&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p11.jpg&quot; alt=&quot;检验&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p12.jpg&quot; alt=&quot;检验结果&quot;&gt;&lt;/p&gt;
&lt;p&gt;运行检验之后，会有一个检验结果，展开即可看到每一项内容，有针对性的调整即可。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p13.jpg&quot; alt=&quot;检验结果&quot;&gt;&lt;/p&gt;
&lt;p&gt;还有一个简单的方法，我们在代码编辑器中的菜单也可直接使用这个工具。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p14.jpg&quot; alt=&quot;代码分析器&quot;&gt;&lt;/p&gt;
&lt;h3&gt;5. &lt;strong&gt;ABAP Runtime Error Analysis (ST22)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：ST22用于分析ABAP程序的运行时错误（dump），帮助开发人员分析程序崩溃或运行时出错的原因。通过ST22，开发人员可以看到程序崩溃时的调用堆栈、内存情况等。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：适用于排查程序在运行时出现异常或崩溃的原因，特别是在程序执行效率低下时。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p15.jpg&quot; alt=&quot;ST22&quot;&gt;&lt;/p&gt;
&lt;p&gt;上图的例子中说到&amp;quot;An attempt was made to access a field symbol that has not been assigned yet (data segment number &amp;quot;-1&amp;quot;).&amp;quot;可知是 field symbol 访问出错了。&lt;/p&gt;
&lt;p&gt;一般在左侧点&lt;code&gt;源代码提取&lt;/code&gt;即可看到程序出问题的位置，如果肉眼看不出问题，也可以在此打断点再次运行程序看看。&lt;/p&gt;
&lt;p&gt;如果是代码执行过程中产生的dump，你还可以在左上角&lt;code&gt;调试器&lt;/code&gt;直达&amp;quot;案发现场&amp;quot;。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p16.jpg&quot; alt=&quot;只出现一次的调试器&quot;&gt;&lt;/p&gt;
&lt;p&gt;下方还有&amp;quot;所选变量&amp;quot;、&amp;#39;活动调用/事件&amp;#39;等功能，能给你还原当时的场景提供帮助。&lt;/p&gt;
&lt;h3&gt;6. &lt;strong&gt;Database Performance Monitoring (DB02)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：DB02提供了关于数据库的性能监控功能，帮助用户查看表的增长情况、索引的使用情况、表的碎片化程度等。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：当程序频繁进行数据库操作时，DB02可以帮助开发者分析数据库性能瓶颈，并为数据库优化提供依据。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;DB02 也是一个很有用的工具，顾名知意这是数据库相关的工具，他能帮助你在程序运行时查看数据库的负载，快速通过原生SQL查询数据库输出报表等。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p17.jpg&quot; alt=&quot;配图&quot;&gt;&lt;/p&gt;
&lt;p&gt;上图呈现的是数据库检查结果界面，显示有 8 个表缺失，这意味着管理员可以通过点击这些图标对缺失表进行相关操作，比如尝试重新创建表、查找表丢失的原因等。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;不一致对象（Inconsistent objects）&lt;/strong&gt;、&lt;strong&gt;其他检查（Other checks）&lt;/strong&gt; 和 &lt;strong&gt;可选索引（Optional indexes）&lt;/strong&gt;：这三项显示为一致，右侧的信息图标可能用于提供关于这些检查项的详细说明或相关文档链接，方便管理员进一步了解检查的具体情况。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-performance-tools/p18.jpg&quot; alt=&quot;大表&quot;&gt;&lt;/p&gt;
&lt;p&gt;大表功能可以监控表数据量的增长情况，帮助发现潜在问题。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;此外，还有一些从全局角度帮助进行系统监控和优化的工具，简单列举。&lt;/p&gt;
&lt;h3&gt;7. &lt;strong&gt;Transaction ST03N (Workload Monitor)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：ST03N是SAP提供的工作负载监控工具，可以查看系统在一段时间内的负载情况。它提供了程序、事务的响应时间、CPU消耗、数据库操作等信息。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：ST03N可以帮助你从全局的角度了解系统性能，找出哪些事务或操作占用了过多的资源，从而进行优化。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;8. &lt;strong&gt;Transaction SM50 / SM66 (Work Process Monitor)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：SM50用于监控SAP系统中工作进程的状态，查看各个工作进程的当前状态和资源占用情况。SM66提供了跨客户端的工作进程监控。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：适用于分析系统的资源使用情况，找出工作进程瓶颈并及时采取措施。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;9. &lt;strong&gt;Extended Check (SCON)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：Extended Check（扩展检查）是SAP的一种代码质量工具，它提供了更多关于ABAP代码潜在问题的检查功能，包括性能优化方面的检查。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：在代码开发过程中，可以使用Extended Check提前发现潜在的性能瓶颈或问题。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;10. &lt;strong&gt;ABAP Test Cockpit (ATC)&lt;/strong&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;功能&lt;/strong&gt;：ABAP Test Cockpit是一种自动化的代码质量检查工具，可以对代码进行静态分析，包括性能、可维护性、安全性等方面的检查。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用场景&lt;/strong&gt;：在开发过程中，ATC可以帮助团队保持代码质量，提前识别性能问题并进行优化。&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2&gt;以上就是我在工作中积累的一些工具，这些工具可以帮助开发人员在多个层次上分析和优化ABAP程序的性能，确保系统在高负载情况下能够高效运行。合理利用这些工具，能够显著提高程序执行效率，减少响应时间，提升用户体验。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1915801947103031858&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>构建一个印象深刻的前端开发人员组合集</title><link>https://jack-liang.com/blog/building-an-impressive-front-end-developer-portfolio/</link><guid isPermaLink="true">https://jack-liang.com/blog/building-an-impressive-front-end-developer-portfolio/</guid><description>前端开发人员组合集是展示您的技能、留下持久印象并推进您的职业生涯的门票。您的组合集是您的数字商务名片，它应该反映您的才华、创造力和专业知识。</description><pubDate>Tue, 10 Jun 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;在前端开发竞争激烈的世界中，一份出色的作品集是您展示技能、给潜在雇主或客户留下深刻印象并推进职业生涯的通行证。您的作品集是您的数字名片，它应该反映您的才华、创造力和专业知识。在本文中，我们将带您了解创建一个令人印象深刻的前端开发人员作品集的步骤，帮助您在人群中脱颖而出。&lt;/p&gt;
&lt;h2&gt;1. 展示多样化的项目&lt;/h2&gt;
&lt;p&gt;您的作品集应该证明您的多才多艺。包含各种项目，展示您在前端开发不同领域的技能。考虑包含以下类型的项目：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;响应式网站：&lt;/strong&gt; 展示您创建能够无缝适应各种屏幕尺寸和设备的网站的能力。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;交互式 Web 应用程序：&lt;/strong&gt; 展示具有动态功能和特性的 Web 应用程序，以吸引用户。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;电子商务网站：&lt;/strong&gt; 如果您从事过电子商务网站的工作，请将其包含在内，以展示您处理复杂 Web 开发任务的专业知识。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;开源贡献：&lt;/strong&gt; 突出您在开源项目中的参与或对在线编码社区的贡献。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;2. 突出您的编码技能&lt;/h2&gt;
&lt;p&gt;您的作品集应该清晰地展示您的编码能力。考虑以下几点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;整洁有序的代码：&lt;/strong&gt; 以整洁有序的方式展示您的代码。使用正确的缩进、注释和编码标准。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;版本控制的使用：&lt;/strong&gt; 展示您对 Git 和 GitHub 等版本控制系统的使用，以证明您的协作和代码管理技能。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;代码示例：&lt;/strong&gt; 包含您项目中的代码片段，让访问者深入了解您的编码风格和解决问题的能力。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;3. 强调响应式设计&lt;/h2&gt;
&lt;p&gt;作为前端开发人员，响应式设计至关重要。确保您的作品集本身就是响应式设计的典范。它应该在各种设备（包括台式机、平板电脑和智能手机）上看起来和运行都完美无缺。&lt;/p&gt;
&lt;h2&gt;4. 用户体验（UX）很重要&lt;/h2&gt;
&lt;p&gt;前端开发不仅仅是编写代码；它还关乎创造出色的用户体验。解释您在项目中做出的用户界面（UI）和 UX 决策背后的思考过程。讨论您如何优化性能和可访问性。&lt;/p&gt;
&lt;h2&gt;5. 记录您的项目&lt;/h2&gt;
&lt;p&gt;为每个项目附上详细的描述。解释项目的目标、您在其中的角色、使用的技术和工具，以及您克服的任何挑战。这些文档为您的工作提供了背景和深度。&lt;/p&gt;
&lt;h2&gt;6. 定期更新您的作品集&lt;/h2&gt;
&lt;p&gt;停滞不前的作品集会给人留下不活跃或缺乏进步的印象。定期用您最新的工作和项目更新您的作品集。删除过时或不太出色的作品，以保持您的作品集的相关性和影响力。&lt;/p&gt;
&lt;h2&gt;7. 测试和优化加载时间&lt;/h2&gt;
&lt;p&gt;加载缓慢的网站可能会让访问者望而却步。通过优化图像和使用适当的技术来最小化加载时间，确保您的作品集快速加载。&lt;/p&gt;
&lt;h2&gt;8. 寻求反馈&lt;/h2&gt;
&lt;p&gt;在最终确定您的作品集之前，向同行、导师或在线社区寻求反馈。建设性的批评可以帮助您完善作品集，使其更加令人印象深刻。&lt;/p&gt;
&lt;h2&gt;9. 个性化您的作品集&lt;/h2&gt;
&lt;p&gt;您的作品集不仅仅是关于您的工作；它也是关于您自己的。通过添加一个 &lt;strong&gt;&amp;quot;关于我&amp;quot;&lt;/strong&gt; 部分来添加个人风格，讲述您的故事、您的热情，以及作为前端开发人员让您与众不同的地方。&lt;/p&gt;
&lt;p&gt;请记住，您的前端开发人员作品集是一个持续进行的项目。不断完善它，紧跟最新趋势，让它随着您的技能和经验的增长而发展。一个令人印象深刻的作品集不仅证明了您的能力，还为您打开了前端开发世界中令人兴奋的机会之门。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>ABAP 中使用类型 Sstring 的注意事项</title><link>https://jack-liang.com/blog/abap-string-type-notes/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-string-type-notes/</guid><description>本文介绍了在使用 Sstring 类型时遇到 DBSQLDBSLLENGTHERROR 报错的原因及处理方法，文末有代码。</description><pubDate>Fri, 09 May 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;strong&gt;前言&lt;/strong&gt;：&lt;/p&gt;
&lt;p&gt;本文介绍了在使用 Sstring 类型时遇到 DBSQL_DBSL_LENGTH_ERROR 报错的原因及处理方法，文末有代码。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;在业务场景中，需创建包含数百个字段的大表，然而字段总体长度总和超出了系统限制。&lt;/p&gt;
&lt;p&gt;具体而言，SAP 系统规定单表字段总长度不得超过 16000 字节（由于 SAP 系统中每个长度单位占 2 字节，实际限制为 8000 个单位长度）。&lt;/p&gt;
&lt;p&gt;TIPS：每个 String 类型长度占 2000 字节，每个 Sstring 占 8 字节。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-string-type-notes/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;一张表中的字段总长度不能超过 16000 字节&lt;/p&gt;
&lt;p&gt;为解决该问题，我们评估了多种方案：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;簇表方案&lt;/strong&gt;：存在数据存取效率低下的问题，并且字段调整操作极为繁琐；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;分表方案&lt;/strong&gt;：虽然拆分后的单表数据更易查看，但数据存取需操作多张表，导致流程复杂化；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;STRING 类型方案&lt;/strong&gt;：STRING 字段数量存在上限，单表最多仅允许 16 个 STRING 字段，且忽略类型转换问题的同时，仍无法突破字段数量限制。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-string-type-notes/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;一张表只允许最多16个 STRING 字段&lt;/p&gt;
&lt;p&gt;最终，我们将目光聚焦于 SSTRING 类型字段。SSTRING 类型在表中每个字段仅占用 8 字节，理论上可支持单表容纳 2000 个字段。&lt;/p&gt;
&lt;p&gt;需要注意的是，使用 SSTRING 类型需定义字段长度，系统最大支持 1333。&lt;/p&gt;
&lt;p&gt;起初，该方案看似完美，即便定义字段长度为 100，传入 300 个字符也不会触发报错。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-string-type-notes/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;F1 定义长度 100&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-string-type-notes/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;实际传入 300&lt;/p&gt;
&lt;p&gt;然而，当我 MODIFY 数据到表的时候，出现了 &lt;strong&gt;DBSQL_DBSL_LENGTH_ERROR&lt;/strong&gt; 报错。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-string-type-notes/p5.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;DBSQL_DBSL_LENGTH_ERROR&lt;/p&gt;
&lt;p&gt;经查阅官方 &lt;a href=&quot;https://me.sap.com/notes/2667193/E&quot;&gt;Note 2667193&lt;/a&gt; 中提到——系统虽不会在定义阶段阻止 SSTRING 字段长度增加，但在数据写入数据库时会进行严格校验并报错。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-string-type-notes/p6.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;Note 2667193&lt;/p&gt;
&lt;p&gt;开发文档中给出了一点线索：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-string-type-notes/p7.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;内置函数 dbmaxlen 可以返回定义长度&lt;/p&gt;
&lt;h3&gt;解决方案&lt;/h3&gt;
&lt;p&gt;我们发现可通过内置函数 dbmaxlen 获取字段定义长度，进而对输入数据进行长度校验：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA: ls_data TYPE zttest.

ls_data-f1 = repeat( val = &amp;#39;A&amp;#39; occ = 125 ). &amp;quot;假设字段定义为SSTRING(100)

DATA(lv_max_len) = dbmaxlen( ls_data-f1 ).

IF strlen( ls_data-f1 ) &amp;gt; dbmaxlen( ls_data-f1 ).
  ls_data-f1 = ls_data-f1(lv_max_len).
ENDIF.

MODIFY zttest FROM ls_data.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;尽管数据截断并非最优解，但在字段长度需求超出 1333 的情况下，我们只能在各种方案中权衡利弊，寻求相对合理的解决方案。&lt;/p&gt;
&lt;h2&gt;如果你还有更好的方案，欢迎在下方评论交流。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1904131953621448610&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>解决 SAP 使用 GUI_UPLOAD 上传 txt 文件乱码问题</title><link>https://jack-liang.com/blog/garbled-text/</link><guid isPermaLink="true">https://jack-liang.com/blog/garbled-text/</guid><description>在使用 SAP 的标准 Function GUI_UPLOAD 上传包含中文的 txt 文档时，遇到了乱码问题，解决的关键在于正确设置编码参数。</description><pubDate>Sun, 30 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;在使用 SAP 的标准 Function GUI_UPLOAD 上传包含中文的 txt 文档时，遇到了乱码问题，解决的关键在于正确设置编码参数。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p1.jpg&quot; alt=&quot;乱码&quot;&gt;&lt;/p&gt;
&lt;p&gt;原代码如下：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;REPORT ztest.

DATA: lv_file_name   TYPE string VALUE &amp;#39;C:\temp.txt&amp;#39;,
      lv_file_length TYPE i,
      lt_content     TYPE string_table,
      lv_content     TYPE string.

CALL FUNCTION &amp;#39;GUI_UPLOAD&amp;#39;
  EXPORTING
    filename   = lv_file_name
  IMPORTING
    filelength = lv_file_length
  TABLES
    data_tab   = lt_content.

LOOP AT lt_content INTO lv_content.
  WRITE:/ lv_content.
ENDLOOP.
&lt;/code&gt;&lt;/pre&gt;
&lt;hr&gt;
&lt;p&gt;这其实是接口没有识别出文档的编码方式所致，需要增加一个 codepage 传参来声明文档的编码格式。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CALL FUNCTION &amp;#39;GUI_UPLOAD&amp;#39;
  EXPORTING
    filename   = lv_file_name
    codepage   = &amp;#39;4110&amp;#39;
  IMPORTING
    filelength = lv_file_length
  TABLES
    data_tab   = lt_content.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;为什么是 4110 呢？&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p2.jpg&quot; alt=&quot;函数文档&quot;&gt;&lt;/p&gt;
&lt;p&gt;来到函数的说明文档中，文中说 SCP_CODEPAGE_BY_EXTERNAL_NAME 可以提供外部编码对应的 SAP 编码号，由于我的 txt 文档是 UTF-8 格式。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p3.jpg&quot; alt=&quot;外部记事本：编码格式&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p4.jpg&quot; alt=&quot;UFT-8 对应的 code 4110&quot;&gt;&lt;/p&gt;
&lt;p&gt;执行函数查询，可知 UTF-8 在 SAP 系统内的编码就是 4110。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;修改代码后执行，结果就正常了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p5.jpg&quot; alt=&quot;成功解码&quot;&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;深入探究&lt;/h2&gt;
&lt;p&gt;SAP 中有一个功能模块：SCP_CODEPAGE_INFO，他能返回每一种编码对应的具体含义。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p6.jpg&quot; alt=&quot;4110&quot;&gt;&lt;/p&gt;
&lt;p&gt;而当我们入参 codepage 不传值的时候，系统会自动根据 GUI 端的环境计算。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p7.jpg&quot; alt=&quot;CALL FUNCTION &quot;&gt;&lt;/p&gt;
&lt;p&gt;参数 prcLoginLanguage = 1，代表中文ZH，FETYPE = &amp;#39;MS&amp;#39;，是操作系统的缩写，允许值有 MS（Windows ）、MAC（苹果）、UNX（类 Unix 系统 ）、OS2 。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p8.jpg&quot; alt=&quot;CALL FUNCTION NES_GET_FRONTEND_CP&quot;&gt;&lt;/p&gt;
&lt;p&gt;这种系统内部调用的方式，已经到了普通 debug 难以抵达的地步了，只能通过猜测来分析。返回值与我们的操作系统和语言相关。从选项中我们能看到我的字符集是 GB2312，结合表 TCP00A 能给我们更多信息。&lt;/p&gt;
&lt;p&gt;Note 中给了一种解决方案，能让用户在不改动代码的情况下暂时解决问题。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/garbled-text/p9.jpg&quot; alt=&quot;Note 3233121&quot;&gt;&lt;/p&gt;
&lt;p&gt;用户需要手动在logon界面将连接配置中的编码改为目标文件的编码
但是研究了这么多，我想问：究竟有没有一种方式，能在上传文件时自动识别文件编码，而不是古板的指定编码？&lt;/p&gt;
&lt;p&gt;要识别文件的编码，需要从一个叫 BOM 的东西下手，Byte Order Mark（字节顺序标记），它是一个特殊的 Unicode 字符（编码为U+FEFF），主要用于标识文本文件的编码格式和字节序（在多字节编码中，字节的排列顺序）。&lt;/p&gt;
&lt;p&gt;但问题在于，有些系统生成的文件并不含 BOM，换句话说——有没有 BOM，不一定。&lt;/p&gt;
&lt;p&gt;我目前还没找到，欢迎知道的朋友指点。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;参考：&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://me.sap.com/notes/3233121/E&quot;&gt;notes 3233121&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://help.sap.com/docs/SAP_COMMERCE/d0224eca81e249cb821f2cdf45a82ace/8b76856086691014a125e8e6d7d36f59.html&quot;&gt;本地化文件字符编码要求 | SAP 帮助门户 --- Character Encoding Requirements for Localization Files | SAP Help Portal&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://blog.csdn.net/i042416/article/details/126237539&quot;&gt;ABAP 报表中如何以二进制方式上传本地文件_abap报表中如何以二进制上传文件-CSDN博客&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content:encoded><category>文章</category></item><item><title>SAP REST 接口调用如何控制登录语言？</title><link>https://jack-liang.com/blog/sap-rest-login-language/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-rest-login-language/</guid><description>通过 SICF 创建的 SAP REST 接口，在调用时返回消息有点异常，不是我预期的中文，而是消息类和消息编号。</description><pubDate>Sun, 30 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;通过 SICF 创建的 SAP REST 接口，在调用时返回消息有点异常，不是我预期的中文，而是消息类和消息编号。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-rest-login-language/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;消息&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;      es_message-msgty = &amp;#39;E&amp;#39;.
      MESSAGE e002(zmsg_01) INTO es_message-msgtx.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;有经验的开发应该会意识到，这是语言的原因，我的消息类没有配置英文。&lt;/p&gt;
&lt;p&gt;但如果暂时还不想做英文适配呢，毕竟我的业务现在只面向国内的业务。&lt;/p&gt;
&lt;p&gt;如果这样，只需要在 SU01 更改登录账号的默认语言即可。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-rest-login-language/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;登录账号的默认语言&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;但如果想适配多语言，这种方式就行不通了，总不能每种语言开一个账号吧，应该还有其他方法。&lt;/p&gt;
&lt;p&gt;我在浏览器中尝试访问接口，通过 F12 查看网络请求来确认，有没有什么参数可以传，果然——&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-rest-login-language/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;Header 的参数&lt;/p&gt;
&lt;p&gt;Header 中赫然有一个 Language ，显然是它了，在 API 工具中加入试试：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-rest-login-language/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;加上 Accept-Language&lt;/p&gt;
&lt;h2&gt;如果 Accept-Language 传 EN 就是英语，传 zh-CN 就是中文，测试正常。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1889613443474114438&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>能跑在笔记本中的 SAP 系统</title><link>https://jack-liang.com/blog/abap-cloud-developer-trial/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-cloud-developer-trial/</guid><description>SAP 官方推出了 Docker 版本的系统，提供给 ABAP 开发者使用，硬件要求也不高，本文讲解使用方法和注意事项。</description><pubDate>Tue, 25 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;本文首发于 &lt;a href=&quot;https://zhuanlan.zhihu.com/p/1887893267435193692&quot;&gt;Jack-L的知乎专栏&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;2026.10.20更新：官方正式发布了 2025 版本，镜像已重新上架 Docker
Hub，本文的安装步骤依然适用，但默认密码有变化，详见第 4 节。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://community.sap.com/t5/technology-blog-posts-by-sap/abap-cloud-developer-trial-2025-available-now/ba-p/14376009&quot;&gt;ABAP Cloud Developer Trial 2025 Available Now - SAP Community&lt;/a&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;2026.3.7更新：官方在 Docker
仓库中暂时下架了镜像，他们给出的理由是正在准备2025版本，这很令人费解。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://community.sap.com/t5/technology-blog-posts-by-sap/abap-cloud-developer-trial-2023-available-now/ba-p/14057183&quot;&gt;ABAP Cloud Developer Trial 2023 Available Now - SAP Community&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p1.jpg&quot; alt=&quot;ABAP Cloud Developer Trial 2023 Available Now&quot;&gt;&lt;/p&gt;
&lt;p&gt;期间可以访问国内的镜像试试：&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://1ms.run/r/sapse/abap-cloud-developer-trial&quot;&gt;sapse/abap-cloud-developer-trial - Docker镜像 - 毫秒镜像&lt;/a&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;没有 ABAPer 开发者能抗拒拥有一台专属 SAP 服务器的诱惑。​&lt;/p&gt;
&lt;p&gt;拥有属于自己的 SAP
系统，这样就能做一些尝试性的开发，看到好玩的代码——拉下来跑一个，而不用在客户的服务器上折腾。&lt;/p&gt;
&lt;p&gt;但由于 SAP 服务器的硬件要求实在太高，即便不考虑 Lisence，HANA 动辄要求 256 G
内存也需要花费不少。&lt;/p&gt;
&lt;p&gt;我在之前的文章中介绍过在物理机上安装的经验——&lt;a href=&quot;https://zhuanlan.zhihu.com/p/449222222&quot;&gt;Jack-L：SAP NetWeaver AS ABAP Developer Edition 7.52 SP04 安装心得&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;好消息是，SAP 官方还推出了 Docker 版本的系统，硬件要求也不高。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://hub.docker.com/r/sapse/abap-cloud-developer-trial&quot;&gt;sapse/abap-cloud-developer-trial - Docker Image | Docker Hub&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;需要说明的是，这是一个精简版，不包含 SAP
的业务模块，也没有中文语言包，所以只适合用作开发人员学习。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p2.jpg&quot; alt=&quot;系统组件版本&quot;&gt;&lt;/p&gt;
&lt;h2&gt;1. 安装要求&lt;/h2&gt;
&lt;p&gt;由于是基于 Docker 运行，所以你的电脑系统首先要能跑 Docker。&lt;/p&gt;
&lt;p&gt;其次，文档中对电脑配置的最低要求是：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;4 CPUs&lt;/li&gt;
&lt;li&gt;16 GB RAM&lt;/li&gt;
&lt;li&gt;150 GB Disk&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Windows 系统推荐 32 G 内存，可能是因为同时要跑 Linux 的缘故。&lt;/p&gt;
&lt;h2&gt;2. 拉取镜像&lt;/h2&gt;
&lt;p&gt;SAP 镜像即便精简了也不小，压缩后 23 GB，解压后＞53
GB，所以要提前准备好磁盘空间。&lt;/p&gt;
&lt;p&gt;这里跳过 Dokcer 的下载和安装过程。&lt;/p&gt;
&lt;p&gt;直接在上方搜索&lt;code&gt;sapse/abap-cloud-developer-trial&lt;/code&gt;，然后点击 Pull
就可以下载镜像了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p3.jpg&quot; alt=&quot;Pull&quot;&gt;&lt;/p&gt;
&lt;p&gt;也可以通过命令行拉取，以 Windows 系统为例，运行 Docker 之后，点击右下角的
Terminal，命令行，会在程序里出现 CMD 窗口。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p4.jpg&quot; alt=&quot;Docker 中的 Terminal&quot;&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;docker pull sapse/abap-cloud-developer-trial:&amp;lt;TAGNAME&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;输入命令并回车，注意需要将&lt;TAGNAME&gt;替换成对应的版本，也可以在 Docker Hub 中查看
Tags 确定。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p5.jpg&quot; alt=&quot;Tags&quot;&gt;&lt;/p&gt;
&lt;p&gt;下载时间可能比较长，好在有进度条可以查看。&lt;/p&gt;
&lt;h2&gt;3. 运行容器&lt;/h2&gt;
&lt;p&gt;下载的东西叫 image（镜像），让它运行起来叫 container（容器）。&lt;/p&gt;
&lt;p&gt;下载完成后，不要着急点Run，因为启动容器需要设置一些参数，最好是通过命令行来键入。&lt;/p&gt;
&lt;p&gt;这里根据你的系统来选择，注意替换命令中的&lt;TAGNAME&gt;。&lt;/p&gt;
&lt;p&gt;GNU/Linux&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;docker run --stop-timeout 3600 -it --name a4h -h vhcala4hci sapse/abap-cloud-developer-trial:&amp;lt;TAGNAME&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;其他系统&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;docker run --stop-timeout 3600 -i --name a4h -h vhcala4hci -p 3200:3200 -p 3300:3300 -p 8443:8443 -p 30213:30213 -p 50000:50000 -p 50001:50001 sapse/abap-cloud-developer-trial:&amp;lt;TAGNAME&amp;gt; -skip-limits-check
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果遇到一些报错，可以查看官方文档中的 Troubleshooting 一节。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p6.jpg&quot; alt=&quot;成功启动&quot;&gt;&lt;/p&gt;
&lt;p&gt;当你看到 Have fun! 出现的时候，就表明服务器已经成功跑起来了。&lt;/p&gt;
&lt;h2&gt;4. 配置连接&lt;/h2&gt;
&lt;p&gt;跑起来的服务需要通过 SAP GUI 连接，配置如下：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p7.jpg&quot; alt=&quot;新建连接&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p8.jpg&quot; alt=&quot;服务器可以填 localhost 或者 127.0.0.1&quot;&gt;&lt;/p&gt;
&lt;p&gt;系统提供了两个 client，默认使用 001，用户名&lt;code&gt;DEVELOPER&lt;/code&gt;，密码根据版本不同：2025
版本为&lt;code&gt;ABAPtr2025#SP00&lt;/code&gt;，旧版可能是&lt;code&gt;ABAPtr2022#01&lt;/code&gt;，如果不对请参见官方 User and
Passwords 一节。&lt;/p&gt;
&lt;h2&gt;5. 配置 licenses&lt;/h2&gt;
&lt;p&gt;如果登录提示 licenses 相关的错误，你需要到官方网站申请。官方提供了三个月的
licenses，过期后可再次申请。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://go.support.sap.com/minisap/#/minisap&quot;&gt;SAP License Keys for Preview, Evaluation and Developer Versions&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p9.jpg&quot; alt=&quot;登录 000&quot;&gt;&lt;/p&gt;
&lt;p&gt;用&lt;code&gt;SAP*&lt;/code&gt; 账号登录 000 客户端，密码同 &lt;code&gt;DEVELOPR&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;运行事务码 &lt;code&gt;SLICENSE&lt;/code&gt; 。在左上角可以看到系统的相关信息，申请 licenses 需要填入。&lt;/p&gt;
&lt;p&gt;系统选择
&lt;code&gt;A4H - SAP NetWeaver AS ABAP 7.4 and above (Linux / SAP HANA)&lt;/code&gt;，下方填入一些个人信息。&lt;/p&gt;
&lt;p&gt;下载生成后的文件，回到 GUI 中，安装 licenses。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p10.jpg&quot; alt=&quot;Install Licenses&quot;&gt;&lt;/p&gt;
&lt;p&gt;提示 successfully installed.
就代表安装成功了，你会在详情中看到到期日是三个月后。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p11.jpg&quot; alt=&quot;安装成功&quot;&gt;&lt;/p&gt;
&lt;h2&gt;6. 开关机命令&lt;/h2&gt;
&lt;p&gt;除去首次开机命令不同，后面每次开关机命令都比较简单。&lt;/p&gt;
&lt;p&gt;开机&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;docker start -ai a4h
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;关机&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;docker stop --time 3600 a4h
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;a4h 是容器的名称。&lt;/p&gt;
&lt;h2&gt;7. 一些问题处理&lt;/h2&gt;
&lt;h3&gt;端口占用&lt;/h3&gt;
&lt;p&gt;假如在启动时提示：Error response from daemon: Ports are not available: exposing
port TCP 0.0.0.0:3200 -&amp;gt; 127.0.0.1:0: listen tcp 0.0.0.0:3200: bind: An attempt
was made to access a socket in a way forbidden by its access permissions.&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;# 查看hyper-v启动后的保留端口范围
netsh interface ipv4 show excludedportrange protocol=tcp

1.停止Windows NAT 驱动程序
net stop winnat

2.启动容器
docker start ...

3.开启Windows NAT 驱动程序
net start winnat
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;运行缓慢&lt;/h3&gt;
&lt;p&gt;如果进入某些界面是显示类似如下的文字，说明程序初次运行，正在编译，稍等即可。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/abap-cloud-developer-trial/p12.jpg&quot; alt=&quot;编译中&quot;&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;参考内容：&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://community.sap.com/t5/technology-blog-posts-by-sap/abap-cloud-developer-trial-2025-available-now/ba-p/14376009&quot;&gt;ABAP Cloud Developer Trial 2025 Available Now - SAP Community&lt;/a&gt;
&lt;a href=&quot;https://community.sap.com/t5/technology-blogs-by-sap/abap-cloud-developer-trial-2022-available-now/ba-p/13598069&quot;&gt;ABAP 云开发者试用 2022 现已开放 - SAP 社区 --- ABAP Cloud Developer Trial 2022 Available Now - SAP Community&lt;/a&gt;
&lt;a href=&quot;https://hub.docker.com/r/sapse/abap-cloud-developer-trial&quot;&gt;Docker Hub | sapse/abap-cloud-developer-trial&lt;/a&gt;
[Youtube] | 在2025年安装ABAP试用系统- ABAP云开发人员试用2022
SP01[英文]](&lt;a href=&quot;https://youtu.be/98Sc3356O9k&quot;&gt;https://youtu.be/98Sc3356O9k&lt;/a&gt;) 支持本地部署，完全免费的 ABAP 来了 -
ABAP Platform Trial 1909 发布
&lt;a href=&quot;https://www.sap.com/products/try-sap/trials-downloads.html?search=SAP%20GUI&quot;&gt;SAP GUI开放下载地址 Developer Trials and Downloads | SAP Developer&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;推荐文章：&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://blog.csdn.net/DeveloperMrMeng/article/details/144568135&quot;&gt;ABAP Cloud Developer Trial 2022 SP01 Docker安装教程_docker abap trial-CSDN博客&lt;/a&gt;&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>abap-cloud-developer-trial 版本 SAP Cloud Connector 重置密码</title><link>https://jack-liang.com/blog/scc-password-reset/</link><guid isPermaLink="true">https://jack-liang.com/blog/scc-password-reset/</guid><description>我的上篇文章 在 Docker 中运行属于自己的 SAP 系统 中，讲解了在 Docker 中运行 SAP。</description><pubDate>Tue, 25 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;我的上篇文章 &lt;a href=&quot;https://zhuanlan.zhihu.com/p/1887893267435193692&quot;&gt;在 Docker 中运行属于自己的 SAP 系统&lt;/a&gt; 中，讲解了在 Docker 中运行 SAP。&lt;/p&gt;
&lt;p&gt;官方的说明中提到了这个系统支持 SAP Cloud Connector，然而在我初次登录后并修改密码后，就再也登不上去了，总是提示用户授权错误。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/scc-password-reset/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;登录不上去了&lt;/p&gt;
&lt;p&gt;只好想办法重置密码，故此有了这篇文章。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;本文的操作参考官方 note。&lt;/p&gt;
&lt;p&gt;文中指出，需要下载对应版本的安装文件，将 users.xml 解压并替换。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/scc-password-reset/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;Note&lt;/p&gt;
&lt;p&gt;进入下载链接：&lt;a href=&quot;https://tools.hana.ondemand.com/#cloud&quot;&gt;SAP Development Tools&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/scc-password-reset/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;选择图中版本下载，我第一次就下错了，解压后才发现是安装包。&lt;/p&gt;
&lt;p&gt;解压出的文件中果然有一个叫 users.xml 的文件。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/scc-password-reset/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;读者自己复制下面的代码，新建一个想必效果也一样。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-xml&quot;&gt;&amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;UTF-8&amp;quot;?&amp;gt;
&amp;lt;tomcat-users&amp;gt;
  &amp;lt;role rolename=&amp;quot;admin&amp;quot;/&amp;gt;
  &amp;lt;user username=&amp;quot;Administrator&amp;quot; password=&amp;quot;181229424893BB65D94A74C2132B8B9E5ADFE851464FDB5CB9F49E8A8204BE7B&amp;quot; roles=&amp;quot;admin&amp;quot; groups=&amp;quot;initial&amp;quot;/&amp;gt;
&amp;lt;/tomcat-users&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;我把文件存在本地桌面，接下来就是要传入 Docker 中。&lt;/p&gt;
&lt;p&gt;如何找到 所谓&lt;code&gt;the config directory of used SAP Cloud Connector installation&lt;/code&gt; ，也就是 Connector 的安装路径。在容器的 Exec 中使用下面的命令：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;sudo find / -name &amp;quot;users.xml&amp;quot;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/scc-password-reset/p5.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;Exec&lt;/p&gt;
&lt;p&gt;显示安装位置在 /opt/sap/scc/config/users.xml，那么就把文件复制过去吧。&lt;/p&gt;
&lt;p&gt;打开一个 CMD 窗口，切换到 Desktop目录，也就是存放 users.xml 的桌面目录，运行命令：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-bash&quot;&gt;docker cp users.xml a4h:/opt/sap/scc/config/
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;执行成功会返回 &lt;code&gt;Successfully copied 2.05kB to a4h:/opt/sap/scc/config/&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;至此大功告成。尝试一下能不能用默认账号重新登录吧。&lt;/p&gt;
&lt;p&gt;&lt;em&gt;&amp;lt;用户名&amp;gt;&lt;/em&gt;/*&amp;lt;密码&amp;gt;*输入Administrator/manage（区分大小写）&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;SAP Cloud Connector，您以下命令启动服务：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;docker exec -it a4h bash
/usr/local/sbin/rcscc_daemon start
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;检查 SAP Cloud Connector 的状态：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;docker exec -it a4h bash
/usr/local/sbin/rcscc_daemon status
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;离开容器之前必须停止它:&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;/usr/local/sbin/rcscc_daemon stop
exit
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Connector 的实例，地址如下：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;https://&amp;lt;the container&amp;#39;s IP&amp;gt;:8443
&lt;/code&gt;&lt;/pre&gt;
&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;参考链接：&lt;/strong&gt;&lt;/p&gt;
&lt;h2&gt;&lt;a href=&quot;https://help.sap.com/docs/connectivity/sap-btp-connectivity-cf/cloud-connector-initial-configuration&quot;&gt;初始配置 | SAP Help Portal&lt;/a&gt;&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/1887957750799112191&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>在程序内动态创建ABAP嵌套数据类型</title><link>https://jack-liang.com/blog/abap-dynamic-nested-types/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-dynamic-nested-types/</guid><description>在一些业务场景中，我们需要将 json 转为 ABAP 数据类型，或者根据配置表创建 ABAP 数据类型。</description><pubDate>Sat, 25 Jan 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;strong&gt;项目地址：&lt;/strong&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;在一些业务场景中，我们需要将 json 转为 ABAP 数据类型，或者根据配置表创建 ABAP 数据类型。&lt;/p&gt;
&lt;p&gt;SAP 标准提供的 json 解析工具需要首先定义对应的数据类型才能使用，但对于动态数据，甚至嵌套数据的构造往往需要花费开发不少时间。官方提供了 CL_ABAP_TABLEDESCR 和 CL_ABAP_STRUCTDESCR 等类能创建一些基础类型，但如果要创建&lt;strong&gt;嵌套&lt;/strong&gt;的数据结构，就不能直接实现了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-dynamic-nested-types/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;官方类&lt;/p&gt;
&lt;p&gt;原理上，如果通过先创建最下层的数据类型，再层层向上，是可以实现嵌套的，说干就干。&lt;/p&gt;
&lt;p&gt;本文提供了一种解决方案和实现代码。&lt;/p&gt;
&lt;h3&gt;1. 创建类&lt;/h3&gt;
&lt;p&gt;先创建一个类 zcl_dynamic_object，为其创建 create_main 的公共方法。具体实现代码见 &lt;a href=&quot;https://github.com/Jack-Liang/DYNAMIC_DATA&quot;&gt;GitHub&lt;/a&gt;。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-dynamic-nested-types/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;类 ZCL_DYNAMIC_OBJECT&lt;/p&gt;
&lt;h3&gt;2. 通过 json 生成嵌套类型&lt;/h3&gt;
&lt;p&gt;传入 json 数据，返回对应的数据类型，然后调用 json 解析类即可得到数据。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;  DATA: lr_type TYPE REF TO cl_abap_datadescr.
  DATA dyn_data TYPE REF TO data.
  DATA json_data TYPE string.

  FIELD-SYMBOLS: &amp;lt;fs_wa&amp;gt; TYPE any.

  json_data = &amp;#39;{  &amp;quot;tenantId&amp;quot;: &amp;quot;949043908&amp;quot;, &amp;quot;sensorId&amp;quot;: &amp;quot;feef4fff-0731-462e-9972-ee92923de3fd&amp;quot;, &amp;quot;timestamp&amp;quot;: 1600244897484,&amp;#39; &amp;amp;&amp;amp;
               &amp;#39;&amp;quot;measures&amp;quot;: [  {  &amp;quot;tagId&amp;quot;: &amp;quot;A32F&amp;quot;, &amp;quot;zC&amp;quot;: 1000.132, &amp;quot;yC&amp;quot;: 1000.132, &amp;quot;xC&amp;quot;: 324.12, &amp;quot;quality&amp;quot;: 92 } ] }&amp;#39;.

  lr_type = zcl_dynamic_object=&amp;gt;create_main( jsondata = jsondata ).

  TRY.
      CREATE DATA dyn_data TYPE HANDLE lr_type.
      IF dyn_data IS NOT INITIAL.
        ASSIGN dyn_data-&amp;gt;*  TO &amp;lt;fs_wa&amp;gt;.
        /ui2/cl_json=&amp;gt;deserialize( EXPORTING json = json_data  CHANGING data = &amp;lt;fs_wa&amp;gt; ).
      ENDIF.
    CATCH cx_root INTO DATA(lr_exc).
      DATA(lv_message) = lr_exc-&amp;gt;get_text( ).
      WRITE:/ lv_message.
  ENDTRY.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3. 通过配置表生成嵌套类型&lt;/h3&gt;
&lt;p&gt;示例代码中：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;  DATA: lr_type TYPE REF TO cl_abap_datadescr.
  DATA: lt_field_tab TYPE TABLE OF zdos_datadescr.
  DATA dyn_data TYPE REF TO data.
  FIELD-SYMBOLS: &amp;lt;fs_wa&amp;gt; TYPE any.

  INSERT VALUE #( fldname = &amp;#39;data_Id&amp;#39; fldtype = &amp;#39;F&amp;#39; )        INTO lt_field_tab INDEX 1.
  INSERT VALUE #( fldname = &amp;#39;process_Name&amp;#39; fldtype = &amp;#39;F&amp;#39; )   INTO lt_field_tab INDEX 2.
  INSERT VALUE #( fldname = &amp;#39;KCFJ&amp;#39; fldtype = &amp;#39;T&amp;#39; )           INTO lt_field_tab INDEX 3.
  INSERT VALUE #( fldname = &amp;#39;KCFJ-file_Name&amp;#39; fldtype = &amp;#39;F&amp;#39; ) INTO lt_field_tab INDEX 4.  &amp;quot;上下级用-连接
  INSERT VALUE #( fldname = &amp;#39;KCFJ-file_Path&amp;#39; fldtype = &amp;#39;F&amp;#39; ) INTO lt_field_tab INDEX 5.

  lr_type = zcl_dynamic_object=&amp;gt;create_main( field_tab = lt_field_tab  type = &amp;#39;S&amp;#39; ).

  TRY.
      CREATE DATA dyn_data TYPE HANDLE lr_type.
      IF dyn_data IS NOT INITIAL.
        ASSIGN dyn_data-&amp;gt;*  TO &amp;lt;fs_wa&amp;gt;.
      ENDIF.
    CATCH cx_root INTO DATA(lr_exc).
      DATA(lv_message) = lr_exc-&amp;gt;get_text( ).
      WRITE:/ lv_message.
  ENDTRY.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;输入只需要一个内表，包含两个字段 &lt;strong&gt;fldname&lt;/strong&gt;（字段名称），用符号“-”表示数据层级，&lt;strong&gt;fldtype&lt;/strong&gt;（对象类型），有字段(F)、结构(S)和表(T)，三种可选，这样就实现了数据结构的描述。目前创建的字段只默认 String 类型，后续可以增加更多类型支持。&lt;/p&gt;
&lt;p&gt;在实现类动态嵌套之后，我们可以把数据通过官方类 /ui2/cl_json 转换成 json。&lt;/p&gt;
&lt;p&gt;更多使用方式，欢迎大家在GitHub提交代码。&lt;/p&gt;
&lt;p&gt;本项目通过 abapgit 维护，使用前请熟悉其使用方法。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;参考项目：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/fidley/JSON2ABAPType&quot;&gt;fidley/JSON2ABAPType: Creator of ABAP types on a base of JSON structur&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://community.sap.com/t5/application-development-discussions/dynamically-create-internal-table-from-json-using-ui2-cl-json-and-more/td-p/12147345&quot;&gt;Solved: Dynamically create internal table from JSON using ... - SAP Community&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/19400730868&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>ABAP使用NUMBER_GET_NEXT前需要加锁吗？</title><link>https://jack-liang.com/blog/abap-number-get-next-lock/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-number-get-next-lock/</guid><description>SAP 项目中使用 Function 生成流程水号的时候，有些开发会加锁，那么到底有没有必要呢？</description><pubDate>Fri, 24 Jan 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;SAP 项目中使用 Function 生成流程水号的时候，有些开发会加锁，那么到底有没有必要呢？&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;结论&lt;/strong&gt;：不用加，没必要。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;bad code 示例&lt;/p&gt;
&lt;p&gt;我们不妨做一个试验：&lt;/p&gt;
&lt;p&gt;写一段测试程序，设置后台作业让程序连续取号，最好持续一定时间，此时我们再手动执行同样的程序取号，如果系统没有做控制，我们取到的数自然会与作业中的重复。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Report  GET_NEXT
*&amp;amp;
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;  取号测试程序
*&amp;amp;  by Jack
*&amp;amp;---------------------------------------------------------------------*

REPORT  GET_NEXT.
DATA: number TYPE char20.
DATA: begin TYPE char20.
DATA: end TYPE char20.

PARAMETERS time TYPE char20.

DO .
  CLEAR: number.
  CALL FUNCTION &amp;#39;NUMBER_GET_NEXT&amp;#39;
    EXPORTING
      nr_range_nr                   = &amp;#39;01&amp;#39;
      object                        = &amp;#39;ZTEST1&amp;#39;
   IMPORTING
      number                        = number
   EXCEPTIONS
      INTERVAL_NOT_FOUND            = 1
      NUMBER_RANGE_NOT_INTERN       = 2
      OBJECT_NOT_FOUND              = 3
      QUANTITY_IS_0                 = 4
      QUANTITY_IS_NOT_1             = 5
      INTERVAL_OVERFLOW             = 6
      BUFFER_OVERFLOW               = 7
      OTHERS                        = 8
            .
  IF sy-subrc &amp;lt;&amp;gt; 0.
* MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO
*         WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4.
  ELSE.
    IF sy-index = 1.
      begin = number.
      WRITE: / &amp;#39;begin = &amp;#39; , begin.
    ENDIF.
    IF sy-index = time .
      end = number.
      WRITE: / &amp;#39;end = &amp;#39; , end.
      EXIT.
    ENDIF.
  ENDIF.

ENDDO.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;下图的作业分两批，前两条是同时执行的，我们发现第一个比第二个持续时间多了一半，所以我尝试了上述的测试，也就是第三条。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;SM37 作业总览&lt;/p&gt;
&lt;p&gt;在第三条日志的状态为进行中的时候，我们手动执行程序，会发现程序进入了等待状态。在作业结束之后，我们的程序才输出结果，如下：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;手动执行结果&lt;/p&gt;
&lt;p&gt;我们看作业的日志：结束的号码是...3020001，而我们手动执行的取得的号码是在其后的。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;作业日志&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p5.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;SNUM / SNRO&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;让我们尝试用 SAT 分析一下程序，看看 NUMBER_GET_NEXT 内部实现这一功能的方式。&lt;/p&gt;
&lt;p&gt;这里似乎用时很长让我们进去看看。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p6.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;用时&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p7.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;FOR UPDATE 语法&lt;/p&gt;
&lt;p&gt;这里有一条不常见的语法，通过开发文档的解读，发现原来是一种锁。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Effect&lt;/strong&gt;&lt;br&gt;When reading an individual row using &lt;strong&gt;SINGLE&lt;/strong&gt;, the addition &lt;strong&gt;FOR UPDATE&lt;/strong&gt; sets a database lock as an exclusive lock for this row on the database. With this addition, the &lt;strong&gt;SELECT&lt;/strong&gt; statement is only executed if, in the &lt;strong&gt;ef=&amp;quot;javascript:call_link(&amp;#39;abapwhere.htm&amp;#39;)&amp;quot;&amp;gt;WHERE condition, all primary key fields in logical expression that are joined using AND are checked for equivalence. Otherwise the result set is empty and sy-subrc is set to 8.&lt;/strong&gt;&lt;br&gt;&lt;strong&gt;The addition FOR UPDATE can only be used when accessing data sources where writes are allowed. This addition cannot be used when accessing views where only reads are allowed.&lt;/strong&gt;&lt;br&gt;&lt;strong&gt;The addition FOR UPDATE NOWAIT works in the same way as the addition FOR UPDATE and must be specified at the end of a SELECT SINGLE statement. Using the addition NOWAIT, an attempt is made to set the lock without waiting. If no lock can be set, sy-subrc is set to 6. In this case, no data is read.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-number-get-next-lock/p8.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;ABAP Keyword Documentation&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;相关链接：&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;a href=&quot;https://mp.weixin.qq.com/s/SUbK5dTbY4aKj3M43g15uw&quot;&gt;ABAP开发中的画蛇添足现象&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_latest_index_htm/latest/en-US/index.htm?file=abapselect_single.htm&quot;&gt;ABAP Keyword Documentation (sap.com)&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/713127117&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>abapGit 使用经验总结</title><link>https://jack-liang.com/blog/abapgit-experience/</link><guid isPermaLink="true">https://jack-liang.com/blog/abapgit-experience/</guid><description>abapGit是一款专为ABAP环境打造的Git客户端，它能像传统git一样完成代码管理，不同的是它完全由ABAP语言实现并在SAP中运行。</description><pubDate>Thu, 23 Jan 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;abapGit是一款专为ABAP环境打造的Git客户端，它能像传统git一样完成代码管理，不同的是它完全由ABAP语言实现并在SAP中运行。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;官网网址：&lt;/p&gt;
&lt;h3&gt;安装&lt;/h3&gt;
&lt;p&gt;官方提供了两个版本的代码，独立版（Standalone Version）和开发版（Developer Version）。前者是一个庞大的文件，截止25年初的0.16.6版已经超过13万行代码，有时在浏览器中加载甚至会超时，但好在安装起来并不难，只需要下载之后在SE38上传即可，安装起来很方便。&lt;/p&gt;
&lt;p&gt;独立版链接：&lt;a href=&quot;https://raw.githubusercontent.com/abapGit/build/main/zabapgit_standalone.prog.abap&quot;&gt;https://raw.githubusercontent.com/abapGit/build/main/zabapgit_standalone.prog.abap&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;通过浏览器访问链接，将文件另存为一个文件，打开SAPGUI的SE38，新建一个程序：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;安装独立版&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;程序属性&lt;/p&gt;
&lt;p&gt;接着再上传之前下载的文件，激活后按F8即可运行程序。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;代码上传&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p5.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;运行后界面&lt;/p&gt;
&lt;p&gt;开发者版本则可以通过独立版导入的方式安装，主要是提供给abapGit的开发者使用，通常我们没必要安装。&lt;/p&gt;
&lt;p&gt;在程序运行界面有两个按钮“&lt;a href=&quot;https://docs.abapgit.org/user-guide/projects/online/install.html&quot;&gt;New Online&lt;/a&gt;”和“&lt;a href=&quot;https://docs.abapgit.org/user-guide/projects/offline/install.html&quot;&gt;New Offline&lt;/a&gt;”，也就是线上导入和线下导入（适用于SAP无法连接外网的情况下），具体使用方法可以看官方文档，比较详细。&lt;/p&gt;
&lt;h3&gt;线下线上转换&lt;/h3&gt;
&lt;p&gt;官网文档 &lt;a href=&quot;https://docs.abapgit.org/user-guide/repo-settings/remote.html&quot;&gt;Remote | abapGit Docs&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;有些情况下我们需要把线下项目变为线上，或者相反。这时就可以在项目的设置里完成，进入项目（包），点击“Repo Settings”，然后点击“Remote”，在弹出的窗口中点“Switch to Online”，填入创建好的git仓库连接保存即可。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p6.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;切换&lt;/p&gt;
&lt;p&gt;某些情况下可能会报错，多数是由于网络不通，或者git仓库的权限设置导致的。根据具体情况可以可能需要使用程序 ZABAPGIT_TEST_SSL 测试网络，或者在事务 STRUST 中安装必要的证书。&lt;/p&gt;
&lt;h3&gt;配置后台自动提交&lt;/h3&gt;
&lt;p&gt;abapGit 提供了好用的后台功能，完成一定的设置选项，并在SM36设置定时作业，就可以自动同步代码，非常方便。比如我的项目上就同步到自建git仓库中，一方面可以备份代码，另一方面能清晰的看到每天的编码内容。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p7.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;Backgound&lt;/p&gt;
&lt;h3&gt;好用的项目&lt;/h3&gt;
&lt;p&gt;在这个网站收录了一部分由abapgit制作的仓库，其中一些可能对你有用。&lt;/p&gt;
&lt;p&gt;比如，&lt;a href=&quot;https://github.com/Kaszub09/abapEasyALV&quot;&gt;abapEasyALV&lt;/a&gt; 能方便快捷的展示ALV数据，再也不用每次写报表都要写一遍表头参数之类的。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abapgit-experience/p8.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;abapEasyALV&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/abap2xlsx/abap2xlsx&quot;&gt;abap2xlsx&lt;/a&gt; 关于Excel操作的工具&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/SAP/abap-to-json&quot;&gt;abap-to-json&lt;/a&gt; ABAP转json工具，方便SAP版本较低没有 /UI2/CL_JSON 的同学&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/Jack-Liang/DYNAMIC_DATA&quot;&gt;DYNAMIC_DATA&lt;/a&gt; 再推荐一个本人的小工具，能根据配置在代码运行时生成可用的ABAP对象类型（支持嵌套），也许对你有用&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;更多好用的功能欢迎评论交流补充。&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;strong&gt;参考文献：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://blog.csdn.net/Wang_Deji/article/details/132466484?utm_medium=distribute.pc_relevant.none-task-blog-2~default~baidujs_baidulandingword~default-0-132466484-blog-138838247.235%5Ev43%5Econtrol&amp;amp;spm=1001.2101.3001.4242.1&amp;amp;utm_relevant_index=2&quot;&gt;SAP从放弃到入门系列之abapGit安装_abapgit 导入-CSDN博客&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://docs.abapgit.org/user-guide/&quot;&gt;User Guide | abapGit Docs&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/20034587426&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>前端网站性能优化技术</title><link>https://jack-liang.com/blog/front-end-techniques-for-optimizing-website-performance/</link><guid isPermaLink="true">https://jack-liang.com/blog/front-end-techniques-for-optimizing-website-performance/</guid><description>在当今即时满足成为常态的时代，网站性能至关重要。加载缓慢的网站会让用户感到沮丧，影响搜索引擎排名，并最终导致流量和收入损失。前端优化是确保网站快速、响应迅速且用户友好的关键。</description><pubDate>Sat, 10 Aug 2024 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;在当今即时满足成为常态的时代，网站性能至关重要。加载缓慢的网站会让用户感到沮丧，影响搜索引擎排名，并最终导致流量和收入损失。前端优化是确保网站快速、响应迅速且用户友好的关键。在本文中，我们将探讨一些优化网站性能的基本前端技术。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;图片优化：&lt;/strong&gt;
图片通常是网页上最大的资源。优化它们至关重要。使用现代图片格式如 WebP，它提供更好的压缩率和质量。压缩图片以减小文件大小，同时保持质量。考虑使用懒加载技术，仅在图片进入用户视口时才加载它们。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;代码压缩与压缩传输：&lt;/strong&gt;
压缩 HTML、CSS 和 JavaScript 文件，删除不必要的空白字符以减小文件大小。此外，启用服务器端压缩如 Gzip 或 Brotli，以进一步减少数据传输。更小的文件意味着更快的加载速度。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;CDN（内容分发网络）：&lt;/strong&gt;
实施 CDN，将网站资源分发到位于不同地理区域的多个服务器上。这可以减少延迟，并加速向用户交付内容，无论他们身在何处。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;减少 HTTP 请求：&lt;/strong&gt;
浏览器发出的每个 HTTP 请求都会增加延迟。通过合并 CSS 和 JavaScript 文件，并使用图片精灵来减少图片请求数量，从而最小化请求数。此外，考虑异步加载非必要脚本。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;缓存：&lt;/strong&gt;
通过为资源设置适当的缓存头来利用浏览器缓存。这使回访用户能够更快地加载您的网站，因为他们的浏览器已经缓存了一些资源。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;关键 CSS 和字体加载：&lt;/strong&gt;
实施关键 CSS，仅加载首屏内容所需的基本样式。对于字体，使用 &amp;quot;font-display&amp;quot; 属性来指定字体的加载方式，确保在获取字体时文本内容保持可见。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;响应式设计：&lt;/strong&gt;
以移动设备为优先进行设计，并使用响应式设计技术。这包括使用媒体查询调整布局，以及为不同屏幕尺寸优化图片。移动用户期望快速的加载时间。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;预获取和预加载：&lt;/strong&gt;
利用 HTML 标签如 &lt;code&gt;&amp;lt;link rel=&amp;quot;preload&amp;quot;&amp;gt;&lt;/code&gt; 和 &lt;code&gt;&amp;lt;link rel=&amp;quot;prefetch&amp;quot;&amp;gt;&lt;/code&gt; 给浏览器提示，告诉它提前获取哪些资源。这可以改善网站的感知性能。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;减少第三方脚本：&lt;/strong&gt;
限制网站上第三方脚本的数量，因为它们会显著降低加载速度。评估每个脚本的必要性，并考虑异步加载以防止阻塞页面渲染。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;渐进式 Web 应用（PWA）：&lt;/strong&gt;
实施 PWA 可以大幅提升网站性能和用户体验。PWA 允许离线访问、快速加载，并在 Web 上提供类似应用的体验。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;监控与测试：&lt;/strong&gt;
使用 Google PageSpeed Insights、GTmetrix 或 WebPageTest 等工具持续监控网站性能。定期运行性能测试，识别并解决瓶颈问题。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;减少动画和特效：&lt;/strong&gt;
虽然动画和特效可以增强用户体验，但过度使用会降低网站速度。谨慎使用它们，并考虑降低其复杂度。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;总之，优化前端性能是一个永无止境的旅程。在美观和功能与速度需求之间取得平衡至关重要。定期评估网站性能，并实施最合适的前端技术，以确保为访问者提供快速、响应迅速且用户友好的体验。遵循这些技巧，您不仅会取悦用户，还会提升搜索引擎排名，并带来更好的业务成果。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>SAP 系统中跨 client 或服务器取数</title><link>https://jack-liang.com/blog/sap-cross-client-data/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-cross-client-data/</guid><description>SAP 项目实施中，某些情况下我们需要跨 client 或者服务器取数，前者比较容易，后者则可以依靠 RFC 实现。</description><pubDate>Fri, 09 Aug 2024 00:00:00 GMT</pubDate><content:encoded>&lt;h3&gt;前言&lt;/h3&gt;
&lt;p&gt;SAP 项目实施中，某些情况下我们需要跨 client 或者服务器取数，前者比较容易，后者则可以依靠 RFC 实现。&lt;/p&gt;
&lt;hr&gt;
&lt;h3&gt;跨 client 取数&lt;/h3&gt;
&lt;p&gt;对于存在于同一个服务器上但不跨客户端的表，也就是表中第一个字段是 MANDT 的，只需要使用&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA: ITAB TYPE TABLE OF T000.

SELECT *
  FROM T000
  CLIENT SPECIFIED INTO TABLE ITAB
      WHERE mandt  = &amp;#39;120&amp;#39;
        AND MWAER= &amp;#39;CNY&amp;#39;.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-cross-client-data/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;h3&gt;跨服务器取数&lt;/h3&gt;
&lt;p&gt;系统中有一个 Function：RFC_READ_TABLE，提供了这一功能，我们尝试取一下 T582S 表的数据：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA  l_rfcdest TYPE crmrfcpar-rfcdest.
DATA: lt_options TYPE STANDARD TABLE OF rfc_db_opt,
      ls_options TYPE rfc_db_opt,
      ls_fields  TYPE rfc_db_fld,
      lt_fields  TYPE STANDARD TABLE OF rfc_db_fld,
      lt_data    TYPE STANDARD TABLE OF tab512,
      ls_data    LIKE LINE OF lt_data.

l_rfcdest = &amp;#39;xxxx&amp;#39;.

ls_fields-fieldname = &amp;#39;INFTY&amp;#39;.
ls_fields-offset = &amp;#39; &amp;#39;.
ls_fields-length = &amp;#39;4&amp;#39;.
ls_fields-type = &amp;#39;c&amp;#39;.
ls_fields-fieldtext = &amp;#39;Infotyp&amp;#39;.                            &amp;quot;#EC NOTEXT
APPEND ls_fields TO lt_fields.

ls_fields-fieldname = &amp;#39;ITBLD&amp;#39;.
ls_fields-offset = &amp;#39; &amp;#39;.
ls_fields-length = &amp;#39;     2&amp;#39;.
ls_fields-type = &amp;#39;c&amp;#39;.
ls_fields-fieldtext = &amp;#39;信息类型屏幕控制&amp;#39;.                           &amp;quot;#EC NOTEXT
APPEND ls_fields TO lt_fields.

ls_fields-fieldname = &amp;#39;ITEXT&amp;#39;.
ls_fields-offset = &amp;#39; &amp;#39;.
ls_fields-length = &amp;#39;    35&amp;#39;.
ls_fields-type = &amp;#39;c&amp;#39;.
ls_fields-fieldtext = &amp;#39;信息类型文本&amp;#39;.                             &amp;quot;#EC NOTEXT
APPEND ls_fields TO lt_fields.

DATA: msg_txt(64) TYPE c.

CALL FUNCTION &amp;#39;RFC_READ_TABLE&amp;#39; DESTINATION l_rfcdest
  EXPORTING
    query_table           = &amp;#39;T582S&amp;#39;
    delimiter             = &amp;#39;,&amp;#39;
  TABLES
    OPTIONS               = lt_options
    fields                = lt_fields
    data                  = lt_data
  EXCEPTIONS
    system_failure        = 1  MESSAGE msg_txt
    communication_failure = 2  MESSAGE msg_txt.
WRITE: / msg_txt.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;上面的代码中有一个点，l_rfcdest 需要填什么呢？其实是在 SM59 中的 RFC 连接配置，通常由于需要传输请求，已经由 basis 配好，如果没有可以自己尝试在“ABAP连接”下添加。&lt;/p&gt;
&lt;p&gt;或许我们会问，这样跨客户端取岂不是很容易发生数据泄露，其实不会，SM59 中不需要配置目标系统的登录数据，执行程序的时候需要手动输入。&lt;/p&gt;
&lt;p&gt;参考上面的思路，要跨系统更新程序、配置等均不在话下，只需自己开发 Function 调用即可。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;如果需要调用的数据不是来自 SAP 服务器，ABAP 也支持直接连接数据库，具体可尝试搜索关键字：&lt;strong&gt;EXEC SQL&lt;/strong&gt;。&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/713131935&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>ABAP转JSON时int类型空格的问题探究</title><link>https://jack-liang.com/blog/abap-json-int-space/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-json-int-space/</guid><description>在SAP开发中，ABAP对象转JSON时使用了系统的CLFDTJSON=DATATOJSON方法，但发现在对数值类型I和P的输出值后面总带有空格。</description><pubDate>Wed, 07 Aug 2024 00:00:00 GMT</pubDate><content:encoded>&lt;h3&gt;&lt;strong&gt;概述&lt;/strong&gt;&lt;/h3&gt;
&lt;blockquote&gt;
&lt;p&gt;问题：在SAP ABAP中，将数值类型I和P转换为JSON时，正数后常带空格。&lt;br&gt;解决方法：使用CONDENSE语法或更新系统类或者使用开源类。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;正文&lt;/h3&gt;
&lt;p&gt;在SAP开发中，ABAP对象转JSON时使用了系统的CL_FDT_JSON=&amp;gt;DATA_TO_JSON方法，但发现在对数值类型I和P的输出值后面总带有空格。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-json-int-space/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;返回的JSON数值后带有空格&lt;/p&gt;
&lt;p&gt;但对于负数却没有发生这种现象。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-json-int-space/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;负数后没有空格&lt;/p&gt;
&lt;p&gt;联想到ABAP对于代符号的数值显示时，总是把最后一位用于表示正负号，推测可能是这一原因导致的。&lt;/p&gt;
&lt;p&gt;进一步的debug证实了这一想法。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-json-int-space/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;处理负数&lt;/p&gt;
&lt;p&gt;DATA_TO_JSON_INTERNAL 方法只对对负数做了处理，将负号前移，但对正数没做处理，这样在数值赋值到string类型的rv_json时，尾部就多了一个空格（也就是符号位）。&lt;/p&gt;
&lt;p&gt;解决的方法其实也很简单，就是用CONDENSE语法把空格去掉就行。&lt;/p&gt;
&lt;p&gt;在安装了更新的类 /UI2/CL_JSON 的系统中，这一问题得到了解决，也确实是这么处理的。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-json-int-space/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;/UI2/CL_JSON 的处理方式&lt;/p&gt;
&lt;p&gt;如果系统版本不够新，没有这个类（我的项目上就没有），又要如何处理呢，除开直接改标准代码外。还推荐一个开源类，只需要用abapGit安装即可。&lt;/p&gt;
&lt;p&gt;项目地址：&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/SAP/abap-to-json&quot;&gt;SAP/abap-to-json: ABAP to JSON serializer and deserializer (github.com)&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-json-int-space/p5.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;h2&gt;项目截图&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/709496059&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>SAP NetWeaver AS ABAP Developer Edition 7.52 SP04 安装心得</title><link>https://jack-liang.com/blog/sap-752-sp04-install/</link><guid isPermaLink="true">https://jack-liang.com/blog/sap-752-sp04-install/</guid><description>最近尝试在虚拟机和物理机上安装SAP官方的给开发者的免费试用系统，想就自己的心得做一些分享。</description><pubDate>Sat, 03 Aug 2024 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;最近尝试在虚拟机和物理机上安装SAP官方的给开发者的免费试用系统，想就自己的心得做一些分享。&lt;/p&gt;
&lt;p&gt;官方下载地址：&lt;a href=&quot;https://developers.sap.com/trials-downloads.html?search=7.52+SP04&quot;&gt;Developer Trials and Downloads | SAP Developer&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-752-sp04-install/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;这个版本的上线时间是2018年，数据库是SYBASE，系统版本如下：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-752-sp04-install/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-752-sp04-install/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;由于是开发者试用系统，里面只提供了ABAP开发相关的组件，并没有业务模块，可能有些基于业务的实施无法实现。&lt;/p&gt;
&lt;p&gt;参考的博客：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://community.sap.com/t5/technology-blogs-by-members/adjusting-installer-script-for-sap-netweaver-dev-edition-for-distros-with/ba-p/13492318&quot;&gt;Adjusting installer script for SAP NetWeaver Dev E... - SAP Community&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://www.youtube.com/watch?v=SMSStxU4BHU&quot;&gt;&lt;em&gt;NEU&lt;/em&gt; 2022 | SAP Demo System installieren | SAP NetWeaver ABAP Developer Edition | SAP Übungssystem ...&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://community.sap.com/t5/application-development-blog-posts/as-abap-7-52-sp04-developer-edition-concise-installation-guide/ba-p/13389514&quot;&gt;AS ABAP 7.52 SP04, Developer Edition: Concise Inst... - SAP Community&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;操作系统：opensuse 15.3、15.4、15.5&lt;/p&gt;
&lt;p&gt;内存：官方推荐的是4G，加上8G交换空间（4 GB RAM plus about 8 GB swap space）&lt;/p&gt;
&lt;p&gt;磁盘空间：100 GB&lt;/p&gt;
&lt;h3&gt;遇到的问题：&lt;/h3&gt;
&lt;p&gt;Assertion failed: This tool does not support the database server version 15.7.0.000&lt;/p&gt;
&lt;p&gt;原文如下：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;ERROR 2024-08-01 22:44:21.226 (root/sapinst) (startInstallation) [CSiStepExecute.cpp:1104] id=controller.stepExecuted errno=FCO-00011 CSiStepExecute::execute() The step syb_step_get_ase_version with step key |offlineadjustment_dialogs|ind|ind|ind|ind|0|0|offlineadjustment_db_post|ind|ind|ind|ind|db_post|0|syb_rename_db_post_dia|ind|ind|ind|ind|syb|0|NW_SYB_DB_REN|ind|ind|ind|ind|syb2|0|syb_step_get_ase_version was executed with status ERROR (Last error reported by the step: Assertion failed: This tool does not support the database server version 15.7.0.000).&lt;/p&gt;
&lt;/blockquote&gt;
&lt;ol start=&quot;2&quot;&gt;
&lt;li&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;=&amp;gt;sapparam: SAPSYSTEMNAME neither in Profile nor in Commandline&lt;br&gt;################################################&lt;br&gt;Abort execution because of&lt;br&gt;Step returns modlib.jslib.caughtException&lt;br&gt;################################################&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;由于我是在2024年安装，官方推荐在opensuse上安装，并没有要求系统版本，我便想当然的下载了最新的15.6版本，内核是6.4，但是SAP系统的数据库似乎不支持这一版本。&lt;/p&gt;
&lt;p&gt;通过这篇文章：&lt;a href=&quot;https://community.sap.com/t5/technology-blogs-by-members/adjusting-installer-script-for-sap-netweaver-dev-edition-for-distros-with/ba-p/13492318&quot;&gt;Adjusting installer script for SAP NetWeaver Dev E... - SAP Community&lt;/a&gt; 我更换了15.3系统解决了这一问题。文中替换了一段官方的安装脚本，请参考上述连接的 Appendix - bash script code 段落。&lt;br&gt;如果成功安装，登录GUI可能会出现ST22报错：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/sap-752-sp04-install/p4.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;可以看到是UUID相关的错误，有文章提到是uuid没有正常启动的原因，可以参考这篇文章处理：&lt;a href=&quot;https://www.itsfullofstars.de/2017/10/uuidd-problem-when-running-sap-nw-abap-inside-docker/&quot;&gt;UUIDD problem when running SAP NW ABAP inside Docker | It&amp;#39;s full of stars! (itsfullofstars.de)&lt;/a&gt;&lt;br&gt;系统管理&lt;br&gt;在Terminal里可使用命令行进行系统管理：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;su - npladm
sapcontrol
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;sapcontrol 命令可以得到相关的 help，常用的命令还有两个：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-tcshcon&quot;&gt;startsap
stopsap
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;后记&lt;/h3&gt;
&lt;p&gt;接下来我想尝试借助abapGit把自己在系统里实施的代码同步到GitHub，欢迎交流。&lt;/p&gt;
&lt;p&gt;相比之下我更推荐大家尝试Docker的版本，&lt;a href=&quot;https://hub.docker.com/r/sapse/abap-cloud-developer-trial&quot;&gt;sapse/abap-cloud-developer-trial - Docker Image | Docker Hub&lt;/a&gt; ，这个版本更新一些，而且安装的是hana数据库，由于docker的特性可以说是开箱即用。&lt;/p&gt;
&lt;h2&gt;文章封面由豆包AI生成&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/712532389&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>居家办公的利与弊</title><link>https://jack-liang.com/blog/advantages-disadvantages-of-working-from-home/</link><guid isPermaLink="true">https://jack-liang.com/blog/advantages-disadvantages-of-working-from-home/</guid><description>近年来，我们的工作方式发生了重大转变，这主要得益于技术的进步以及人们对工作与生活平衡态度的转变。其中最显著的变化之一就是远程工作的兴起，让员工能够在家中舒适地工作。</description><pubDate>Mon, 05 Feb 2024 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;近年来，我们的工作方式发生了重大转变，这主要得益于技术的进步以及人们对工作与生活平衡态度的转变。其中最显著的变化之一就是远程工作的兴起，让员工能够在家中舒适地工作。虽然这种转变带来了许多好处，但也带来了不少挑战。让我们来探讨一下在家工作的优缺点。&lt;/p&gt;
&lt;h2&gt;在家工作的优点&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;灵活性：&lt;/strong&gt; 远程工作最大的优点之一就是它提供的灵活性。员工通常可以自主安排工作时间，这对那些需要承担家庭责任或有其他事务的人来说尤其有益。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;减少通勤：&lt;/strong&gt; 取消日常通勤不仅节省时间，还能减少与交通相关的压力和经济支出。这有助于改善心理健康，提高工作满意度。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;节省开支：&lt;/strong&gt; 在家工作可以带来可观的节省。员工可以在交通、工作服装和日常用餐方面省钱，这对他们的整体财务状况有积极影响。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;提高生产力：&lt;/strong&gt; 许多人发现他们在家工作时效率更高。没有办公室的干扰，并且能够打造个性化的工作环境，有助于提高专注力和工作效率。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;工作与生活平衡：&lt;/strong&gt; 远程工作有助于实现更好的工作与生活平衡。员工能够更好地管理个人生活和职业生活，从而减少职业倦怠，提高工作满意度。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;你自律地设定明确目标并每天为之努力的能力，将比其他任何单一因素更能保证你的成功。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2&gt;在家工作的缺点&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;孤独感：&lt;/strong&gt; 远程工作可能会让人感到孤独。缺少同事和面对面交流可能导致孤立和孤独感，这可能对心理健康产生负面影响。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;沟通困难：&lt;/strong&gt; 远程工作时，有效沟通可能是一个挑战。误解、缺乏清晰沟通以及回复延迟都可能阻碍团队协作。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;工作生活界限模糊：&lt;/strong&gt; 虽然远程工作可以改善工作与生活平衡，但也可能模糊工作与个人生活之间的界限。建立清晰的界限可能很困难，导致过度工作和倦怠。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;技术问题：&lt;/strong&gt; 技术问题，如网络连接故障或软件故障，可能会中断工作并造成困扰。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;干扰因素：&lt;/strong&gt; 在家工作可能充满各种干扰，从家务琐事到吵闹的邻居。对某些人来说，保持专注可能是一场持续的挑战。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;职业发展：&lt;/strong&gt; 一些员工可能觉得远程工作限制了他们的职业发展机会，因为他们在组织内的可见度可能较低。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;虽然远程工作提供了灵活性、节省开支和改善工作与生活平衡，但也可能导致孤独感、沟通挑战和干扰因素。成功远程工作的关键在于找到适合个人偏好的平衡点，并通过有效沟通、时间管理和自律来解决潜在的弊端。随着远程工作的不断发展，理解和适应这些优缺点对雇员和雇主来说都将至关重要。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>前端开发者的沟通与协作</title><link>https://jack-liang.com/blog/communication-and-collaboration-for-front-end-developers/</link><guid isPermaLink="true">https://jack-liang.com/blog/communication-and-collaboration-for-front-end-developers/</guid><description>前端开发不仅仅是编写代码，更是与他人无缝合作，创造卓越用户体验的过程。在当今动态且相互依存的科技行业中，有效的沟通与协作是前端开发者取得成功的必备技能。</description><pubDate>Sat, 23 Dec 2023 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;前端开发不仅仅是编写代码，更是与他人无缝合作，创造卓越用户体验的过程。在当今动态且相互依存的科技行业中，有效的沟通与协作是前端开发者取得成功的必备技能。在本文中，我们将探讨这些技能的重要性，并为希望在这些领域脱颖而出的前端开发者提供实用建议。&lt;/p&gt;
&lt;h2&gt;沟通与协作的重要性&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;跨职能团队：&lt;/strong&gt; 前端开发很少是孤军奋战。你经常需要与设计师、后端开发者、项目经理以及其他利益相关者合作。有效的沟通能够确保所有人目标一致，朝着共同的方向努力。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;以用户为中心：&lt;/strong&gt; 前端开发者在塑造用户体验方面扮演着关键角色。与设计师和用户研究员进行清晰的沟通，对于理解用户需求并交付直观的界面至关重要。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;持续学习：&lt;/strong&gt; 在快速发展的Web开发领域保持更新，需要积极参与社区、阅读文档以及与他人分享知识。有效的沟通能够促进这一进程。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;有效沟通的技巧&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;积极倾听：&lt;/strong&gt; 认真倾听他人的发言。理解他们的观点和顾虑是有效沟通的第一步。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;善于提问：&lt;/strong&gt; 遇到不清楚的地方，不要犹豫，及时寻求澄清。这有助于避免误解，确保你走在正确的道路上。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;使用清晰简洁的语言：&lt;/strong&gt; 与非技术人员沟通时，避免使用行话和技术术语。用简单易懂的方式解释复杂的概念。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;文档记录：&lt;/strong&gt; 详细记录项目决策和讨论内容。这在出现争议时很有帮助，也能提供有价值的参考。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;定期更新：&lt;/strong&gt; 让团队了解你的工作进展。分享你已完成的任务以及遇到的任何挑战。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;接受反馈：&lt;/strong&gt; 对他人的反馈保持开放态度，无论是关于你的代码、设计选择还是沟通方式。建设性的批评是成长的宝贵工具。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;有效协作的技巧&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;建立工作流程：&lt;/strong&gt; 在团队内明确工作流程和职责。项目管理软件和版本控制系统等工具可以帮助简化协作。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;设计评审：&lt;/strong&gt; 定期与设计师和其他团队成员会面，评审设计方案并讨论如何有效实现。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;代码审查：&lt;/strong&gt; 通过代码审查与其他开发者协作。这能确保代码质量、及早发现问题，并促进知识共享。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;换位思考：&lt;/strong&gt; 设身处地为其他团队成员着想。理解他们的限制、优先事项和挑战。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;冲突解决：&lt;/strong&gt; 冲突在所难免，但要以解决问题的态度去面对。寻求有利于项目的妥协和解决方案。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;庆祝成就：&lt;/strong&gt; 与团队一起认可并庆祝大大小小的成就。这能够鼓舞士气，营造积极的协作环境。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;构建协作文化&lt;/h2&gt;
&lt;p&gt;归根结底，有效的沟通与协作不仅仅是个人技能，也是开发团队的文化特质。鼓励开放、透明和持续改进的文化。作为前端开发者，你可以通过以身作则、积极参与团队讨论和倡议，在培养这种文化方面发挥关键作用。&lt;/p&gt;
&lt;p&gt;在前端开发领域，创新和用户体验至关重要，有效沟通与协作的能力能够带来根本性的改变。通过磨练这些技能，你不仅能提升工作质量，还能为项目的成功以及你作为前端开发者的职业生涯做出贡献。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>探索 Astro.js 前端开发的未来</title><link>https://jack-liang.com/blog/exploring-the-future-of-front-end-development/</link><guid isPermaLink="true">https://jack-liang.com/blog/exploring-the-future-of-front-end-development/</guid><description>前端开发是一个不断发展的动态领域，持续演进以满足现代 Web 开发的需求。近年来，我们见证了各种工具和框架的兴起，它们彻底改变了我们构建 Web 应用程序的方式。Astro.js 就是这样一个令人兴奋的新成员，它为前端开发领域带来了新的活力。</description><pubDate>Sat, 15 Jul 2023 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;前端开发是一个不断发展的动态领域，持续演进以满足现代 Web 开发的需求。近年来，我们见证了各种工具和框架的兴起，它们彻底改变了我们构建 Web 应用程序的方式。Astro.js 就是这样一个令人兴奋的新成员，它为前端开发领域带来了新的活力。在本文中，我们将探讨 Astro.js 是什么，以及它如何有望塑造前端开发的未来。&lt;/p&gt;
&lt;h2&gt;什么是 Astro.js？&lt;/h2&gt;
&lt;p&gt;Astro.js 是一个新兴的静态站点生成器和前端框架，正在 Web 开发社区中获得越来越多的关注。它由 Vercel 团队创建，Vercel 是 Next.js 和 Vercel 托管等流行工具背后的公司。Astro.js 旨在提供一种全新的前端开发方法，将静态站点生成（SSG）和服务器端渲染框架的优势完美结合。&lt;/p&gt;
&lt;h2&gt;Astro.js 的核心特性&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;更快的加载速度：&lt;/strong&gt; Astro.js 采用独特的方法，仅发送特定页面所需的 JavaScript，从而减少初始加载时间并提升性能。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;部分水合：&lt;/strong&gt; 它允许对组件进行选择性水合，在保持快速加载速度的同时优化网页的交互性。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;通用渲染：&lt;/strong&gt; Astro.js 使你能够使用单一代码库同时支持服务器端渲染和静态站点，简化开发和维护工作。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;框架无关：&lt;/strong&gt; 它的设计可以与任何 JavaScript 框架或库配合使用，让开发者能够自由选择自己喜欢的工具。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;渐进式采用：&lt;/strong&gt; Astro.js 具有灵活性，可以逐步集成到现有项目中，方便从其他框架过渡的开发者使用。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;Astro.js 与前端开发的未来&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;性能提升：&lt;/strong&gt; Astro.js 对性能优化的关注将成为前端开发未来的重要推动力。加载速度更快的 Web 应用对于用户留存和 SEO 排名至关重要。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;无缝集成：&lt;/strong&gt; 随着 Astro.js 越来越受欢迎，我们可以期待它与更多流行的 JavaScript 库和框架实现集成，使其在各种项目中更易于使用。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;简化的开发流程：&lt;/strong&gt; Astro.js 的通用渲染和框架无关方法将简化开发流程，降低维护 Web 应用的复杂性。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;SEO 优化：&lt;/strong&gt; 凭借更快的加载速度和服务器端渲染内容，Astro.js 可以显著提升 SEO 表现，使其成为希望在搜索引擎结果中获得更高排名的网站的首选。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;社区成长：&lt;/strong&gt; 随着越来越多的开发者和公司采用 Astro.js，我们可以预见一个不断壮大的社区将为它的发展做出贡献，并创建一个丰富的扩展和插件生态系统。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;总结&lt;/h2&gt;
&lt;p&gt;Astro.js 是前端开发领域中一个充满希望的新成员，它提供了一种优先考虑性能、开发者体验和未来可扩展性的新方法。随着 Web 开发社区的不断发展，Astro.js 已做好准备在前端开发的未来中发挥重要作用。无论你是经验丰富的开发者还是刚刚起步，关注 Astro.js 并探索其功能都将是对你的 Web 开发工具箱的宝贵投资。&lt;/p&gt;
</content:encoded><category>文章</category></item><item><title>ABAP 7.4 中的新功能</title><link>https://jack-liang.com/blog/abap-74-new-features/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-74-new-features/</guid><description>ABAP 7.4 版本是一次比较大的更新，提供了许多让人眼前一亮的语法和功能，这次我尝试来做一个整理。</description><pubDate>Wed, 28 Sep 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;目录&lt;/p&gt;
&lt;p&gt;ABAP 7.4 版本是一次比较大的更新，提供了许多让人眼前一亮的语法和功能，这次我尝试来做一个整理。&lt;/p&gt;
&lt;h2&gt;ABAP 7.4 的 OpenSQL 新命令&lt;/h2&gt;
&lt;h3&gt;CASE 语句&lt;/h3&gt;
&lt;p&gt;在Open SQL查询中可以使用CASE语法。&lt;/p&gt;
&lt;p&gt;在下方的代码中&lt;code&gt;CASE char1&lt;/code&gt;针对不同的值将不同的结果写入&lt;code&gt;text&lt;/code&gt;，如果是本地变量需要在前方加&lt;code&gt;@&lt;/code&gt;来转意。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CLASS demo DEFINITION.
  PUBLIC SECTION.
    CLASS-METHODS main.
ENDCLASS.

CLASS demo IMPLEMENTATION.
  METHOD main.

    DELETE FROM demo_expressions.
    INSERT demo_expressions FROM TABLE @( VALUE #(
      ( id = &amp;#39;x&amp;#39; char1 = &amp;#39;aaaaa&amp;#39; char2 = &amp;#39;bbbbb&amp;#39; )
      ( id = &amp;#39;y&amp;#39; char1 = &amp;#39;xxxxx&amp;#39; char2 = &amp;#39;yyyyy&amp;#39; )
      ( id = &amp;#39;z&amp;#39; char1 = &amp;#39;mmmmm&amp;#39; char2 = &amp;#39;nnnnn&amp;#39; ) ) ).

    DATA: char1 VALUE &amp;#39;111&amp;#39;.
    DATA(else) = &amp;#39;fffff&amp;#39;.

    SELECT id, char1, char2,
           CASE char1
             WHEN &amp;#39;aaaaa&amp;#39; THEN @char1
             WHEN &amp;#39;xxxxx&amp;#39; THEN char2
             ELSE @else
           END AS text
           FROM demo_expressions
           INTO TABLE @DATA(results).

    cl_demo_output=&amp;gt;display( results ).
  ENDMETHOD.
ENDCLASS.

START-OF-SELECTION.
  demo=&amp;gt;main( ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;运行结果：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-74-new-features/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;h3&gt;在查询中计算&lt;/h3&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;    CONSTANTS: lc_carrid TYPE s_carr_id VALUE &amp;#39;UA&amp;#39;,
               lc_connid TYPE s_conn_id VALUE &amp;#39;941&amp;#39;.
    SELECT carrid, connid, price, seatsocc_b, seatsocc_f,
      ( ( seatsocc_b + seatsocc_f ) ) * price AS paymentsum
      FROM sflight
      WHERE carrid = @lc_carrid
        AND connid = @lc_connid
      INTO TABLE @DATA(lt_sight).

    cl_demo_output=&amp;gt;display( lt_sight ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;运行结果：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-74-new-features/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;h2&gt;声明和创建变量&lt;/h2&gt;
&lt;h3&gt;内联声明（inline declaration ）&lt;/h3&gt;
&lt;p&gt;在上面的例子中还有一个&lt;code&gt;INTO TABLE @DATA(lt_sight)&lt;/code&gt; 的语法，这就是内联声明，能根据查询的内容来创建本地变量。我们再来多看几个内联声明的例子。&lt;/p&gt;
&lt;p&gt;ABAP 7.4 以前：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA: lv_vehicle TYPE string.
lv_vehicle = &amp;#39;Mercedes&amp;#39;.

FIELD-SYMBOLS &amp;lt;ft_tab&amp;gt;.
ASSIGN lt_tab TO FIELD-SYMBOL(&amp;lt;ft_tab&amp;gt;).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;ABAP 7.4：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA(lv_vehicle) = &amp;#39;Mercedes&amp;#39;.

&amp;quot;对 field symbols 的使用
&amp;quot;1
ASSIGN lt_tab TO FIELD-SYMBOL(&amp;lt;ft_tab&amp;gt;).
&amp;quot;2
LOOP AT itab ASSIGNING FIELD-SYMBOL(&amp;lt;fs_tab&amp;gt;).
ENDLOOP.
&amp;quot;3
READ TABLE itab ASSIGNING FIELD-SYMBOL(&amp;lt;fs_tab&amp;gt;).
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;ABAP OO 创建实例&lt;/h2&gt;
&lt;p&gt;ABAP 7.4 以前：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA lo_human TYPE REF TO class_human.
CREATE OBJECT lo_human EXPORTING name = &amp;#39;TONY&amp;#39;.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;ABAP 7.4：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;lo_human = NEW class_human( name = &amp;#39;tony&amp;#39; ).
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;VALUE 的使用&lt;/h2&gt;
&lt;p&gt;ABAP 7.4 以前：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA: itab_o TYPE t_itab.
APPEND: 10 TO itab_o,
        20 TO itab_o,
        20 TO itab_o.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;ABAP 7.4：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA(itab_o) = VALUE #( ( 10 ) ( 20 )  ( 30 ) ).
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;迭代表达式&lt;/h2&gt;
&lt;p&gt;ABAP 7.4 以前：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;LOOP AT gt_ships INTO gs_ship.
  gs_city = gs_ship-city.
  APPEND gs_city TO gt_citys.
ENDLOOP.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;ABAP 7.4：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA(gt_citys) = VALUE ty_citys( FOR ls_ship IN gt_ships ( ls_ship-city ) ).
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;使用CONDS代替IF/ELSE&lt;/h2&gt;
&lt;p&gt;使用IF/ELSE：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA: lv_text(30).
IF lv_vehicle = &amp;#39;01&amp;#39; AND lv_type = &amp;#39;C&amp;#39;.
  lv_text = &amp;#39;Toyota&amp;#39;.
ELSE.
  IF lv_vehicle =&amp;#39;02&amp;#39; AND lv_type = &amp;#39;C&amp;#39;.
    lv_text = &amp;#39;Chevy&amp;#39;.
  ELSE.
    IF lv_vehicle =&amp;#39;03&amp;#39; AND lv_type = &amp;#39;C&amp;#39;.
      lv_text = &amp;#39;Range Rover&amp;#39;.
      ..
    ENDIF.
  ENDIF.
ENDIF.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;ABAP 7.4：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA(lv_text) = COND text30(
                WHEN lv_vehicle =&amp;#39;01&amp;#39; AND lv_type = &amp;#39;C&amp;#39; THEN &amp;#39;Toyota&amp;#39;
                WHEN lv_vehicle =&amp;#39;02&amp;#39; AND lv_type = &amp;#39;C&amp;#39; THEN &amp;#39;Chevy&amp;#39;
                WHEN lv_vehicle =&amp;#39;03&amp;#39; AND lv_type = &amp;#39;C&amp;#39; THEN &amp;#39;Range Rover&amp;#39; ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;适当使用COND语法能使代码结构变得更清晰。&lt;/p&gt;
&lt;h2&gt;使用SWITCH代替CASE&lt;/h2&gt;
&lt;p&gt;CASE:&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;CASE l_indicator.
  WHEN 1.
    l_day = &amp;#39;Monday&amp;#39;.
  WHEN 2.
    l_day = &amp;#39;Tuesday&amp;#39;.
  WHEN 3.
    l_day = &amp;#39;Wednesday&amp;#39;.
  WHEN 4.
    l_day = &amp;#39;Thursday&amp;#39;.
  WHEN 5.
    l_day = &amp;#39;Friday&amp;#39;.
  WHEN 6.
    l_day = &amp;#39;Saturday&amp;#39;.
  WHEN 7.
    l_day = &amp;#39;Sunday&amp;#39;.
  ELSE.
    RAISE EXCEPTION TYPE zcx_day_problem.
ENDCASE.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;SWITCH:&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;DATA(l_day) = SWITCH char10( l_indicator
       WHEN 1 THEN &amp;#39;Monday&amp;#39;
       WHEN 2 THEN &amp;#39;Tuesday&amp;#39;
       WHEN 3 THEN &amp;#39;Wednesday&amp;#39;
       WHEN 4 THEN &amp;#39;Thursday&amp;#39;
       WHEN 5 THEN &amp;#39;Friday&amp;#39;
       WHEN 6 THEN &amp;#39;Saturday&amp;#39;
       WHEN 7 THEN &amp;#39;Sunday&amp;#39;
       ELSE THROW zcx_day_problem( ) ).
&lt;/code&gt;&lt;/pre&gt;
&lt;hr&gt;
&lt;p&gt;参考文件&lt;/p&gt;
&lt;h2&gt;&lt;a href=&quot;https://itpfed.com/wp-content/uploads/2021/09/new-features-in-abap-7-4_614cccdc-1.pdf&quot;&gt;https://itpfed.com/wp-content/uploads/2021/09/new-features-in-abap-7-4_614cccdc-1.pdf&lt;/a&gt;&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/569000151&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>ABAP文档：正确性和质量(Correctness and Quality)</title><link>https://jack-liang.com/blog/abap-doc-correctness-quality/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-doc-correctness-quality/</guid><description>原文路径：ABAP关键字文档→ABAP编程指南→通用规则→</description><pubDate>Wed, 21 Sep 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;&lt;strong&gt;分类&lt;/strong&gt;：翻译&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键字&lt;/strong&gt;：ABAP；编程指南&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;原文路径&lt;/strong&gt;：&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencorrectness_quality_guidl.htm&quot;&gt;ABAP关键字文档→ABAP编程指南→通用规则→&lt;/a&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;背景&lt;/h2&gt;
&lt;p&gt;大多数开发专业软件的组织都有必须遵守的产品标准。这些产品标准定义了程序的正确性和质量。SAP有许多这样的标准，开发部门必须遵守这些标准。目前对开发人员最重要的产品标准如下:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;**可访问性&lt;br&gt;**在信息技术环境中，“可访问性”一词涉及到要求任何人，包括特别是有缺陷的人，都可以访问和使用信息技术产品。为了使软件或网站等产品对所有消费者开放，它们的设计和开发必须保证，如果用户有特定的障碍(例如视力障碍、色盲)，它们仍然可以使用，并且必须与屏幕阅读器和屏幕放大镜等技术兼容。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;文档&lt;/strong&gt;&lt;br&gt;作为一项规则，文档的产品标准定义了哪些文档必须与产品一起交付给消费者，并确保提供的文档在所有产品领域是一致的、正确的和最新的。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;功能正确性&lt;/strong&gt;&lt;br&gt;软件的功能正确性通常被视为其最重要的品质。功能不正确的软件通常是不可用的。作为一项规则，功能正确性的产品标准要求软件没有错误，并定义了升级过程中接口和程序行为的稳定性。为了达到这些目标，对软件的彻底测试可能是强制性的。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;全球化&lt;br&gt;如果软件要在世界范围内使用，通常需要一个全球化的产品标准。这包括国际化和本地化两个方面。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;国际化&lt;/strong&gt;&lt;br&gt;国际化包括全球化的技术方面，如Unicode兼容性、文本处理、屏幕显示、打印、数据交换、时区、可译性等，因此为本地化设定了技术先决条件。当然，用户界面和其他文本的翻译也是国际化的一个重要方面。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;**本地化&lt;br&gt;**如果全球使用的软件必须适应当地(通常是国家特定的)条件，如法律要求或特定的业务程序，本地化是必要的。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;性能&lt;/strong&gt;&lt;br&gt;即使一个程序在功能上是正确的，如果它不能在合理的时间内执行，它对用户来说也没有什么用处。性能产品标准确保这方面不会被忽视。例如，它可以包括用于高效数据库访问和应用程序逻辑可伸缩性的规则。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;安全&lt;/strong&gt;&lt;br&gt;当安全性对软件至关重要时(这通常适用于任何类型的业务软件)，安全性产品标准通过指出任何潜在的安全漏洞或法律要求，列出产品的所有与安全性相关的方面，并包含满足标准的说明。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;可用性&lt;/strong&gt;&lt;br&gt;术语可用性指的是用户界面适应人类最终用户及其任务的需求。可用性产品标准应该确保最终用户能够高效地执行他们的任务。可用性的关键方面包括用户界面的一致性、易用性、直观的任务友好型和角色友好型界面、个体适应性、容错性等等。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;尽管这些标准在某种程度上是法律要求，但它们本质上来自于保证交付给消费者的软件的正确性和质量的基本目标。编程指南在这方面非常重要。这里列出的许多指导方针直接或间接地支持所提到的标准之一，或者是从它们派生出来的。他们支持并确保符合这些标准，从而产生正确的、高质量的项目。编程指导方针本身甚至可以说与具有约束力的产品标准不相上下。&lt;/p&gt;
&lt;p&gt;然而，由于编程指南不能涵盖所有可能的产品标准，例如性能或安全标准的所有规则，因此我们列出了以下基本规则。&lt;/p&gt;
&lt;h2&gt;规则&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;遵守或检查现有产品标准的符合性&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;坚持您的组织中存在的产品标准，并通过在开发期间和完成后使用您所掌握的所有测试工具对程序进行测试，以确保程序的正确性和质量。&lt;/p&gt;
&lt;h2&gt;详情&lt;/h2&gt;
&lt;p&gt;很明显，你必须遵守产品标准;这一点无需进一步解释。然而，人们常常忘记，ABAP环境中可用的静态和动态分析工具可以为遵从重要的产品标准提供无价的帮助，特别是功能正确性和性能标准。因此，作为这个基本规则的一部分，我们建议您使用所有可用的工具来帮助确保ABAP程序的正确性和质量。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;定期执行&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenextended_program_check_guidl.htm&quot;&gt;扩展程序检查&lt;/a&gt;(事务SLIN)并纠正所有消息。&lt;/li&gt;
&lt;li&gt;使用标准检查变量定期使用&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencode_inspector_guidl.htm&quot;&gt;代码检查器&lt;/a&gt;工具(事务SCI)，并纠正所有消息。&lt;/li&gt;
&lt;li&gt;通过使用适当的工具(集成到工作台工具和&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenabap-testcockpit_guidl.htm&quot;&gt;ABAP Test Cockpit&lt;/a&gt;中)检查界面元素的可用性和可访问性。&lt;/li&gt;
&lt;li&gt;通过使用ABAP单元的单元测试(集成到ABAP工作台、代码检查器和ABAP测试座舱中)，覆盖过程单元的所有功能。&lt;/li&gt;
&lt;li&gt;通过使用带有eCATT(事务SECATT)的场景测试，覆盖应用程序的所有功能。&lt;/li&gt;
&lt;li&gt;使用ABAP内存检查器(事务S_MEMORY_INSPECTOR和ABAP调试器集成的内存分析功能)检查程序的内存消耗。&lt;/li&gt;
&lt;li&gt;检查运行时行为和性能。在SAP GUI中使用ABAP运行时分析(事务SAT)，在&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenadt_glosry.htm&quot;&gt;ABAP开发工具(ADT)&lt;/a&gt;中使用ABAP分析器。&lt;/li&gt;
&lt;li&gt;通过使用覆盖分析器(事务SCOV并集成到ABAP工作台的ABAP单元浏览器中)检查测试覆盖率。&lt;/li&gt;
&lt;li&gt;遵循&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenabap_security.htm&quot;&gt;ABAP -安全说明&lt;/a&gt;保护您的程序和数据免受来自外部的攻击。&lt;/li&gt;
&lt;li&gt;使用所有可用的方法记录程序和服务:从&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencomments_guidl.htm&quot;&gt;注释&lt;/a&gt;开始，从用于上下文敏感的输入帮助的简单数据元素文档，到用于记录API的类和方法文档，再到其他存储库(如SAP Knowledge Warehouse)或Internet(例如SAP Developer Community (SCN, &lt;a href=&quot;http://scn.sap.com&quot;&gt;http://scn.sap.com&lt;/a&gt;))中的概念解释和教程。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencts_glosry.htm&quot;&gt;ABAP测试座舱&lt;/a&gt;(ATC)集成到ABAP工作台和&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencts_glosry.htm&quot;&gt;变更和运输系统(CTS)&lt;/a&gt;中，支持最重要测试的执行和评估。其中一些测试还检查是否符合后面讨论的ABAP编程指南的一些规则。&lt;/p&gt;
&lt;h3&gt;说明&lt;/h3&gt;
&lt;p&gt;如果有疑问，产品标准优先于本文档的指导方针和建议。例如，如果性能或安全方面禁止这里介绍的任何编程实践，那么遵从标准将是优先考虑的。&lt;/p&gt;
&lt;h3&gt;好例子&lt;/h3&gt;
&lt;p&gt;为包 SABAP_DEMOS_CAR_RENTAL_APPL 的类执行单元测试，并在对象导航器的ABAP单元浏览器中显示结果，可以获得100%的测试覆盖率。此包作为一个小型示例应用程序的应用程序部分的子包提供，该示例应用程序除了单元测试之外，还展示了对&lt;a href=&quot;https://zhuanlan.zhihu.com/p/564396505&quot;&gt;关注点分离&lt;/a&gt;的严格遵守。&lt;/p&gt;
&lt;hr&gt;
&lt;hr&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/566399359&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>ABAP文档：KISS原则（KISS Principle）</title><link>https://jack-liang.com/blog/abap-doc-kiss-principle/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-doc-kiss-principle/</guid><description>关键字：ABAP；编程指南；KISS</description><pubDate>Thu, 15 Sep 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;目录&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;分类&lt;/strong&gt;：翻译&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键字&lt;/strong&gt;：ABAP；编程指南；KISS&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;原文路径&lt;/strong&gt;：&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenkiss_principle_guidl.htm&quot;&gt;ABAP关键字文档→ABAP编程指南→通用规则→&lt;/a&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;背景&lt;/h2&gt;
&lt;p&gt;KISS原则说的是，您应该始终为一个问题选择最简单的解决方案。KISS是首字母缩略词，可以有以下任何一种含义(这些含义并不详尽)：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Keep it simple, stupid.（保持简单直白。）&lt;/li&gt;
&lt;li&gt;Keep it small and simple.（保持小而简单。）&lt;/li&gt;
&lt;li&gt;Keep it sweet and simple.（保持清新和简单。）&lt;/li&gt;
&lt;li&gt;Keep it simple and straightforward.（保持简单直接。）&lt;/li&gt;
&lt;li&gt;Keep it short and simple.（保持短小精简）&lt;/li&gt;
&lt;li&gt;Keep it simple and smart.（保持简单和聪明。）&lt;/li&gt;
&lt;li&gt;Keep it strictly simple.（尽量保持简单。）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;KISS原理的基本陈述类似于奥卡姆剃刀（Occam&amp;#39;s razor），即在科学中首选的理论是用最少的假设来解释观察结果的理论(参见维基百科关于KISS原理的条目)。&lt;/p&gt;
&lt;h2&gt;规则&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;遵循KISS原则&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;遵循KISS原则，尽可能限制程序的复杂性。&lt;/p&gt;
&lt;h2&gt;详情&lt;/h2&gt;
&lt;p&gt;问题的最佳解决方案通常是尽可能简单、最低限度和易于理解的解决方案，同时确保稳定性、可理解性和可维护性，以及功能正确性。&lt;/p&gt;
&lt;p&gt;KISS原则有很多不好的例子。这是为什么呢?&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;程序从一开始就太复杂了。这可能是由于糟糕的设计或仅仅是草率、无纪律的编程风格。&lt;/li&gt;
&lt;li&gt;程序的维护时间很长。无需为新旧函数同时创建新实现，只需将新函数(通常使用IF控制结构)添加到旧函数中。最初简单的程序因此变得越来越复杂，尽管这并不是因为手头任务的复杂性。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;要根据KISS原则进行开发，您应该从一开始就确保程序的复杂性是可管理的。支持这种方法的规则与程序的&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenstructure_style_guidl.htm&quot;&gt;结构和风格&lt;/a&gt;有关，特别是&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencomments_guidl.htm&quot;&gt;注释&lt;/a&gt;和&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencomplexity_guidl.htm&quot;&gt;复杂性&lt;/a&gt;。&lt;/p&gt;
&lt;h3&gt;说明&lt;/h3&gt;
&lt;p&gt;如果现有的项目不遵循KISS原则，这些程序需要进一步开发，我们建议适当地进行重构。重构是指在保留可观察程序行为的同时，手动或自动改进程序结构的行为。它提高了易读性、可理解性、可维护性和可扩展性，同时大大减少了故障排除和功能增强的相关工作(参见维基百科关于重构的条目)。现有程序的(增量)重构不仅对遵循上述规则有用，而且对以下所有规则都有用。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencorrectness_quality_guidl.htm&quot;&gt;单元测试&lt;/a&gt;所要求的覆盖率支持现有代码的重构。全面的单元测试可以确保程序在重构过程后以相同的方式运行。&lt;/p&gt;
&lt;h3&gt;例子&lt;/h3&gt;
&lt;p&gt;下图显示了不遵循KISS原则的方法的结构。该方法由大约160条语句组成，&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abennesting_depth_guidl.htm&quot;&gt;嵌套深度&lt;/a&gt;达到12级。该方法仅以示意图的方式说明，它是一个实时ABAP程序的真实示例，经过不断的进一步开发，该程序达到了左图所示的状态。该方法变得如此复杂，以至于实际上不可能再进行必要的更改，开发人员被迫按照KISS原则进行重构。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-doc-kiss-principle/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;结果显示在图的右边。通过将方法M拆分为三个方法，每个方法的语句少于100条，最大嵌套深度为5层，创建了可管理的模块化单元，遵循&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencomplexity_guidl.htm&quot;&gt;复杂性&lt;/a&gt;规则，并允许进行所需的修改。理想情况下，不应该出现图左侧所示的状态。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;参考文献：&lt;/h2&gt;
&lt;p&gt;&lt;a href=&quot;https://zh.wikipedia.org/wiki/KISS%E5%8E%9F%E5%88%99&quot;&gt;KISS原则 - 维基百科，自由的百科全书 (wikipedia.org)&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;&lt;a href=&quot;https://zh.wikipedia.org/zh-cn/%E4%BB%A3%E7%A0%81%E9%87%8D%E6%9E%84&quot;&gt;代码重构 - 维基百科，自由的百科全书 (wikipedia.org)&lt;/a&gt;&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/564677985&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>ABAP文档：关注点分离（SoC）</title><link>https://jack-liang.com/blog/abap-doc-separation-of-concerns/</link><guid isPermaLink="true">https://jack-liang.com/blog/abap-doc-separation-of-concerns/</guid><description>关键字：ABAP；编程规则；SoC</description><pubDate>Thu, 15 Sep 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;目录&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;分类&lt;/strong&gt;：翻译&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;关键字&lt;/strong&gt;：ABAP；编程规则；SoC&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;原文路径&lt;/strong&gt;：&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenseperation_concerns_guidl.htm&quot;&gt;ABAP关键字文档→ABAP编程指南→通用规则→&lt;/a&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;背景&lt;/h2&gt;
&lt;p&gt;术语“关注点分离”(SoC)是Edsger W. Dijkstra于1974年的文章《关于科学思想的作用》中创造的:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“…但是什么也没有得到——恰恰相反!——同时处理这些不同的方面。这就是我有时所说的“分离关注点”。据我所知，这即使不是完全可行的，也是唯一有效地安排一个人的思想的方法。这就是我所说的‘把注意力集中在某一方面’，并不是说要忽略其他方面，而是要正确对待从这个方面来看，另一方面是无关紧要的。”(斯普林格出版社,1982年版)&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;关注点分离是编程中使用的一个原则，它将应用程序分离为多个单元，使各个单元的功能之间的重叠最小化。关注点的分离是通过在软件层中使用模块化、封装和排列来实现的。&lt;/p&gt;
&lt;p&gt;尽管应用服务器ABAP (AS ABAP)的经典三层体系结构对于基于SoC原理的ABAP编程来说是理想的，但这种可能性从未被探索过。应用程序(换句话说，模块池中的对话程序或可执行程序中的报告)通常以整体块的形式显示，在这些块中，系统同时响应表示层的用户操作，完成应用程序逻辑并执行对持久性层数据的访问。在当今的编程世界中，这种类型的编程已不再相关，而面向服务的体系结构(SOA)等概念将成为趋势。&lt;/p&gt;
&lt;h2&gt;规则&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;遵循SoC原则&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;遵循关注点分离原则。将应用程序严格建模为面向服务的应用程序。特别重要的是要将应用程序的逻辑与表示逻辑、持久性和与外部系统通信的逻辑分开。将各个关注点的存储库对象封装在单独的包中。&lt;/p&gt;
&lt;h2&gt;详情&lt;/h2&gt;
&lt;p&gt;SoC原理识别具有特定用途的应用程序的各个部分，并将这些部分封装在封闭的单元中。这些单元之间只使用指定的接口进行通信。由于这一原理，软件——否则会过于复杂——被分成易于管理的组件。因此，该软件是:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;更稳定&lt;/li&gt;
&lt;li&gt;更容易理解&lt;/li&gt;
&lt;li&gt;更容易重用&lt;/li&gt;
&lt;li&gt;更容易运输&lt;/li&gt;
&lt;li&gt;更容易维护&lt;/li&gt;
&lt;li&gt;更容易测试&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;关于最后一点，甚至可以说遵循SoC原则是执行孤立的、&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abencorrectness_quality_guidl.htm&quot;&gt;自动化的单元测试&lt;/a&gt;的先决条件。&lt;/p&gt;
&lt;h3&gt;糟糕的例子&lt;/h3&gt;
&lt;p&gt;下图显示了两个不遵循SoC原则的ABAP应用程序示例。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-doc-separation-of-concerns/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;事实上，这里的两个坏例子是SAP传播了相当长一段时间的报表和会话编程的程序员模型！更准确地说，该示例并不糟糕，因为事务本身的报告或编程，而是由于这些应用程序通常的实现方式。下面源代码是如何在单个程序单元中混合不同关注点的典型示例。数据声明和函数实现混合在一起。对持久数据的访问、数据处理、数据表示和相关声明都发生在一个单元中。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;REPORT z_non_soc_report.
PARAMETERS p_carrid TYPE spfli-carrid.
DATA: spfli_tab TYPE STANDARD TABLE OF spfli,
      alv       TYPE REF TO cl_salv_table,
      alv_exc   TYPE REF TO cx_salv_msg.
SELECT *
       FROM spfli
       WHERE carrid = @p_carrid
       INTO TABLE @spfli_tab.
IF sy-subrc = 0.
  SORT spfli_tab BY cityfrom cityto.
  TRY.
      cl_salv_table=&amp;gt;factory(
        IMPORTING r_salv_table = alv
        CHANGING t_table = spfli_tab ).
      alv-&amp;gt;display( ).
    CATCH cx_salv_msg INTO alv_exc.
      MESSAGE alv_exc TYPE &amp;#39;I&amp;#39; DISPLAY LIKE &amp;#39;E&amp;#39;.
  ENDTRY.
ENDIF.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;当然，即使在上面的源代码这样的短程序中，坚持将关注点完全分离也太过分了。然而，真正的应用程序通常是非常长的ABAP程序(可执行程序、模块池)，在这些程序中，所有的关注点都是同时处理的。如果执行模块化，它通常局限于重用功能单元，很少关注实际可用的层。此外，通常会创建在不同过程和层中使用的大量全局数据。结果，程序的所有部分本质上是相互依赖的，不能单独测试。我们确信，这些程序的质量不仅可以通过遵循命名约定来提高，还可以通过改变用于编程任务的过程的范式来提高。&lt;/p&gt;
&lt;p&gt;下面的源代码证明了您可以使用经典的ABAP过程方法(在本例中是子例程)实现SoC原理。此源代码的工作方式与上面的源代码相同。然而，所有的关注点都是在分配给层的独立过程中实现的。正如我们已经提到的，对于一个简单的程序来说，这种类型的实现太多了。但是，如果您需要通过使用单元测试单独地、独立地测试上述源代码中的关注点，那么惟一的可能是调整如下所示的源代码。下面源代码的程序现在可以很容易地在ABAP单元测试类中分配测试方法，测试各个过程。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;REPORT z_soc_report.
SELECTION-SCREEN BEGIN OF SCREEN 100.
PARAMETERS p_carrid TYPE spfli-carrid.
SELECTION-SCREEN END OF SCREEN 100.
TYPES spfli_tab TYPE STANDARD TABLE OF spfli.
DATA: carrid TYPE spfli-carrid,
      table  TYPE spfli_tab,
      arc     TYPE sy-subrc.
START-OF-SELECTION.
  PERFORM get_carrid CHANGING carrid.
  PERFORM get_table  USING    carrid
                     CHANGING table
                              arc.
IF arc = 0.
  PERFORM sort_table    CHANGING table.
  PERFORM display_table USING    table.
ENDIF.
* Presentation layer
FORM get_carrid
     CHANGING value(carrid) TYPE spfli-carrid.
  CALL SELECTION-SCREEN 100.
  IF sy-subrc = 0.
    carrid = p_carrid.
  ENDIF.
ENDFORM.
FORM display_table
     USING table TYPE spfli_tab.
  DATA: alv TYPE      REF TO cl_salv_table,
        alv_exc TYPE REF TO cx_salv_msg.
  TRY.
     cl_salv_table=&amp;gt;factory(
       IMPORTING r_salv_table = alv
       CHANGING t_table = table ).
     alv-&amp;gt;display( ).
   CATCH cx_salv_msg INTO alv_exc.
     MESSAGE alv_exc TYPE &amp;#39;I&amp;#39; DISPLAY LIKE &amp;#39;E&amp;#39;.
  ENDTRY.
ENDFORM.
* Application layer
FORM sort_table
     CHANGING table TYPE spfli_tab.
     SORT table BY cityfrom cityto.
ENDFORM.
* Persistency layer
FORM get_table
     USING     carrid TYPE spfli-carrid
     CHANGING table   TYPE spfli_tab
              arc     TYPE sy-subrc.
  SELECT *
         FROM spfli
         WHERE carrid = @carrid
         INTO TABLE @table.
  arc = sy-subrc.
ENDFORM.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;然而，这种使用上面所示的子例程的关注点分离并不能给人留下好印象。下面的源代码展示了应该如何实现关注点分离，而不是使用特定于关注点的类中的方法。&lt;/p&gt;
&lt;h3&gt;好的例子&lt;/h3&gt;
&lt;p&gt;下图显示了在分离关注点之后ABAP应用程序应该是什么样子。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/abap-doc-separation-of-concerns/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;在确定关注点之后，它们将在ABAP对象类中实现。图中所示的关注点是ABAP应用程序编程中通常执行的主要任务:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;使用UI服务与用户界面(UI)通信&lt;/li&gt;
&lt;li&gt;实际应用程序逻辑&lt;/li&gt;
&lt;li&gt;使用持久性服务访问持久性数据&lt;/li&gt;
&lt;li&gt;使用代理服务与外部系统通信&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这些主要规则可以进一步细分，这通常是必要的。&lt;/p&gt;
&lt;p&gt;图中各个关注点的方框表示包。属于一个关注点的所有存储库对象(类、数据类型)都应该位于相应的包中。包概念(封装包)支持这种关注点分离。在封装的包中，一个包中的存储库对象只能通过包接口访问另一个包的对象，这将通过语法检查进行检查。通过使用访问控制列表，包可以进一步限制其存储库对象的可用性。对包中的关注点分离进行细分是子包支持的一个概念。&lt;/p&gt;
&lt;p&gt;例如，将应用程序的所有数据库表封装在一个用于持久化服务的包中，可以防止不属于这个包的任何程序访问这些数据库表。反之亦然。例如，持久层中的程序不能直接与表示层中的组件通信，例如Web Dynpro ABAP应用程序。您应该在包属性中准备包封装(通过选择&lt;em&gt;Package Check as Server&lt;/em&gt;)。包检查是在扩展程序检查过程中执行的。&lt;/p&gt;
&lt;p&gt;下面的源代码展示了如何将关注点与上面的源代码分离，用于程序本地类。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-abap&quot;&gt;REPORT z_soc_class_report.
SELECTION-SCREEN BEGIN OF SCREEN 100.
PARAMETERS p_carrid TYPE spfli-carrid.
SELECTION-SCREEN END OF SCREEN 100.
TYPES spfli_tab TYPE STANDARD TABLE OF spfli.
CLASS presentation_server DEFINITION.
  PUBLIC SECTION.
    CLASS-METHODS:
      get_carrid RETURNING VALUE(carrid) TYPE spfli-carrid,
      display_table IMPORTING VALUE(table) TYPE spfli_tab.
ENDCLASS.
CLASS presentation_server IMPLEMENTATION.
  METHOD get_carrid.
    CALL SELECTION-SCREEN 100.
    IF sy-subrc = 0.
      carrid = p_carrid.
    ENDIF.
  ENDMETHOD.
  METHOD display_table.
    DATA: alv     TYPE REF TO cl_salv_table,
          alv_exc TYPE REF TO cx_salv_msg.
    TRY.
        cl_salv_table=&amp;gt;factory(
          IMPORTING r_salv_table = alv
          CHANGING t_table = table ).
        alv-&amp;gt;display( ).
      CATCH cx_salv_msg INTO alv_exc.
        MESSAGE alv_exc TYPE &amp;#39;I&amp;#39; DISPLAY LIKE &amp;#39;E&amp;#39;.
    ENDTRY.
  ENDMETHOD.
ENDCLASS.
CLASS application_server DEFINITION.
  PUBLIC SECTION.
    CLASS-METHODS
      sort_table CHANGING table TYPE spfli_tab.
ENDCLASS.
CLASS application_server IMPLEMENTATION.
  METHOD sort_table.
    SORT table BY cityfrom cityto.
  ENDMETHOD.
ENDCLASS.
CLASS persistency_server DEFINITION.
  PUBLIC SECTION.
    CLASS-METHODS
      get_table IMPORTING carrid TYPE spfli-carrid
                EXPORTING table  TYPE spfli_tab
                          arc    TYPE sy-subrc.
ENDCLASS.
CLASS persistency_server IMPLEMENTATION.
  METHOD get_table.
    SELECT *
           FROM spfli
           WHERE carrid = @carrid
           INTO TABLE @table.
    arc = sy-subrc.
  ENDMETHOD.
ENDCLASS.
CLASS report DEFINITION.
  PUBLIC SECTION.
    CLASS-METHODS main.
ENDCLASS.
CLASS report IMPLEMENTATION.
  METHOD main.
    DATA: carrid TYPE spfli-carrid,
          table  TYPE spfli_tab,
          arc    TYPE sy-subrc.
    carrid = presentation_server=&amp;gt;get_carrid( ).
    persistency_server=&amp;gt;get_table( EXPORTING carrid = carrid
                                   IMPORTING table  = table
                                             arc     = arc ).
    IF arc = 0.
      application_server=&amp;gt;sort_table(
        CHANGING table = table ).
      presentation_server=&amp;gt;display_table( table ).
    ENDIF.
  ENDMETHOD.
ENDCLASS.

START-OF-SELECTION.
  report=&amp;gt;main( ).
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;乍一看，上面的源代码与第一个源代码相比显得非常多。但只是第一眼。一个真正的应用程序通常只有25行。应用程序越大、越真实，将关注点包装到类中所产生的开销比例就越小。如果适当地使用&lt;a href=&quot;https://help.sap.com/doc/abapdocu_753_index_htm/7.53/en-US/index.htm?file=abenabap_obj_progr_model_guidl.htm&quot;&gt;ABAP对象&lt;/a&gt;的重用选项，甚至可以减少源代码的数量。&lt;/p&gt;
&lt;p&gt;此外，单个步骤现在被包装在类中，换句话说，是真正的程序单元(与第二个源代码不同)。实际上，包装不是在单个程序中执行的，而是在根据层分配给不同包的全局类中执行的。这些包使用包接口相互连接。只有通过使用这些接口，您才能实现分离关注点的其他好处(除了在第二个源代码中实现的测试功能之外)。&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;参考文献：&lt;/h2&gt;
&lt;h2&gt;&lt;a href=&quot;https://www.cs.utexas.edu/users/EWD/transcriptions/EWD04xx/EWD447.html&quot;&gt;E.W. Dijkstra Archive: On the role of scientific thought (EWD447) (utexas.edu)&lt;/a&gt;&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/564396505&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item><item><title>OOALV： 动态显示ALV表头</title><link>https://jack-liang.com/blog/ooalv-dynamic-alv-header/</link><guid isPermaLink="true">https://jack-liang.com/blog/ooalv-dynamic-alv-header/</guid><description>根据左边ALV选中的字段，动态生成ALV显示在右侧</description><pubDate>Thu, 15 Sep 2022 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;目录&lt;/p&gt;
&lt;h2&gt;1. 需求&lt;/h2&gt;
&lt;p&gt;根据左边ALV选中的字段，动态生成ALV显示在右侧&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/ooalv-dynamic-alv-header/p1.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;效果图&lt;/p&gt;
&lt;h2&gt;2. 分析&lt;/h2&gt;
&lt;p&gt;普通 Function ALV 只能实现一个屏幕上显示一个ALV，所以上图的效果需要使用OOALV（GRID ALV）技术。&lt;/p&gt;
&lt;p&gt;将屏幕分作三部分：取数条件、标题勾选、结果展示分别实现。&lt;/p&gt;
&lt;h2&gt;3. 实现&lt;/h2&gt;
&lt;p&gt;本程序以SAP系统中的Sflight数据为例，若系统尚未生成数据，请执行相应程序，方法自行搜索。&lt;/p&gt;
&lt;h3&gt;3.1 画屏幕&lt;/h3&gt;
&lt;p&gt;SE38创建程序后，首先新建一个屏幕9000，分三块：子屏幕SC_9001，定制控制CON1和CON2。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/ooalv-dynamic-alv-header/p2.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;画屏幕&lt;/p&gt;
&lt;p&gt;逻辑流如下：&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;PROCESS BEFORE OUTPUT.
  MODULE status_9000.
  MODULE display_alv_9000.
  &amp;quot;调用子屏幕
  CALL SUBSCREEN sc_9001 INCLUDING sy-repid dynn.

PROCESS AFTER INPUT.
  CALL SUBSCREEN sc_9001.
  MODULE user_command_9000.
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3.2 状态栏&lt;/h3&gt;
&lt;p&gt;在SE41复制程序SAPLKKBL的APPEND状态到本程序。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://img.jack-liang.com/zhihu/ooalv-dynamic-alv-header/p3.jpg&quot; alt=&quot;图片&quot;&gt;&lt;/p&gt;
&lt;p&gt;复制状态栏&lt;/p&gt;
&lt;h2&gt;4 完整实现代码&lt;/h2&gt;
&lt;p&gt;为方便起见，本程序没有创建INCLUDE程序，实践中可以按程序功能将之分块，便于管理。&lt;/p&gt;
&lt;pre&gt;&lt;code class=&quot;language-text&quot;&gt;REPORT zdyn_out_alv_tab.
TABLES: sflight.
*&amp;amp;----------------------------------------------------------------------------
*&amp;amp;    DATA &amp;amp; ALV
*&amp;amp;----------------------------------------------------------------------------
DATA: BEGIN OF gs_confg,
        box       TYPE abap_bool,
        num       TYPE numc04,
        name      TYPE char20,
        fieldname TYPE char20,
      END OF gs_confg,
      gt_alv1 LIKE TABLE OF gs_confg.
DATA: con_ref1 TYPE REF TO cl_gui_custom_container,
      con_ref2 TYPE REF TO cl_gui_custom_container.
DATA: g_grid1 TYPE REF TO cl_gui_alv_grid,
      g_grid2 TYPE REF TO cl_gui_alv_grid.
DATA: gs_layout TYPE lvc_s_layo.
DATA: gt_fieldcat1 TYPE lvc_t_fcat WITH HEADER LINE,
      gt_fieldcat2 TYPE lvc_t_fcat WITH HEADER LINE.
DATA: dfies_tab TYPE TABLE OF dfies.
FIELD-SYMBOLS: &amp;lt;dyn_table&amp;gt; TYPE STANDARD TABLE,
               &amp;lt;dyn_wa&amp;gt;    TYPE any.
*&amp;amp;----------------------------------------------------------------------------
*&amp;amp;    CLASS
*&amp;amp;----------------------------------------------------------------------------
CLASS cla_event_receiver DEFINITION.
  PUBLIC SECTION.
    METHODS:
      handler_toolbar FOR EVENT toolbar OF cl_gui_alv_grid
        IMPORTING e_object
                    e_interactive,

      handler_user_command FOR EVENT user_command OF cl_gui_alv_grid
        IMPORTING e_ucomm.

ENDCLASS.

CLASS cla_event_receiver IMPLEMENTATION.
  METHOD handler_toolbar.
    PERFORM frm_handle_toolbar_9000 USING e_object e_interactive.
  ENDMETHOD.

  METHOD handler_user_command.
    PERFORM frm_handle_user_command_9000 USING e_ucomm.
  ENDMETHOD.
ENDCLASS.

*&amp;amp;----------------------------------------------------------------------------
*&amp;amp;    SCREEN
*&amp;amp;----------------------------------------------------------------------------
DATA: ref_event_receiver TYPE REF TO cla_event_receiver.
DATA: dynn(4) VALUE &amp;#39;9001&amp;#39;.
&amp;quot;子屏幕
SELECTION-SCREEN: BEGIN OF SCREEN 9001 AS SUBSCREEN  .
SELECTION-SCREEN: BEGIN OF BLOCK bl0 WITH FRAME TITLE TEXT-t01  .&amp;quot;选择
SELECT-OPTIONS: s_fldate FOR sflight-fldate.
SELECTION-SCREEN: END OF BLOCK bl0.
SELECTION-SCREEN: END OF SCREEN 9001.

*&amp;amp;----------------------------------------------------------------------------
*&amp;amp;  INITIALIZATION
*&amp;amp;----------------------------------------------------------------------------
INITIALIZATION.

*&amp;amp;----------------------------------------------------------------------------
*&amp;amp;    START-OF-SELECTION
*&amp;amp;----------------------------------------------------------------------------
START-OF-SELECTION.

  &amp;quot;获取表头字段
  PERFORM frm_get_data.

  CALL SCREEN 9000.

*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Module STATUS_9000 OUTPUT
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;
*&amp;amp;---------------------------------------------------------------------*
MODULE status_9000 OUTPUT.
  SET PF-STATUS &amp;#39;APPEND&amp;#39;. &amp;quot;Copy STATUS APPEND from Program SAPLKKBL using TCODE SE41
* SET TITLEBAR &amp;#39;xxx&amp;#39;.
ENDMODULE.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Module DISPLAY_ALV_9000 OUTPUT
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;
*&amp;amp;---------------------------------------------------------------------*
MODULE display_alv_9000 OUTPUT.
  IF con_ref1 IS INITIAL AND con_ref2 IS INITIAL.
    &amp;quot;初始化ALV控件
    PERFORM frm_set_container.
    &amp;quot;设置输出格式
    PERFORM frm_init_layout_9000.
    &amp;quot;设置输出字段
    PERFORM frm_init_fieldcat_9000.
    &amp;quot;事件
    PERFORM frm_set_events.
    &amp;quot;显示ALV
    PERFORM frm_alv_display.
  ELSE.
    &amp;quot;刷新ALV
    PERFORM frm_refresh_alv_9000.
  ENDIF.
ENDMODULE.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;      Module  USER_COMMAND_9000  INPUT
*&amp;amp;---------------------------------------------------------------------*
*       text
*----------------------------------------------------------------------*
MODULE user_command_9000 INPUT.
  CASE sy-ucomm.
    WHEN &amp;#39;&amp;amp;F03&amp;#39; OR &amp;#39;&amp;amp;F15&amp;#39; OR &amp;#39;&amp;amp;F12&amp;#39;
      OR &amp;#39;ENDE&amp;#39; OR &amp;#39;E&amp;#39; OR &amp;#39;ECAN&amp;#39;.
      &amp;quot;退出
      LEAVE TO SCREEN 0.
    WHEN OTHERS.
  ENDCASE.
ENDMODULE.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_SET_CONTAINER
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; text
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_set_container .
  CREATE OBJECT con_ref1
    EXPORTING
      container_name = &amp;#39;CON1&amp;#39;.

  CREATE OBJECT con_ref2
    EXPORTING
      container_name = &amp;#39;CON2&amp;#39;.

  CREATE OBJECT g_grid1
    EXPORTING
      i_parent = con_ref1.

  CREATE OBJECT g_grid2
    EXPORTING
      i_parent = con_ref2.

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_INIT_LAYOUT_9000
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; text
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_init_layout_9000 .

  gs_layout-zebra = abap_true.
  gs_layout-detailinit = abap_true.
  gs_layout-detailtitl = &amp;#39;详细内容&amp;#39;.
  gs_layout-sel_mode = &amp;#39;A&amp;#39;.
  gs_layout-cwidth_opt = abap_true.&amp;quot;自适应列宽

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_INIT_FIELDCAT_9000
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; text
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_init_fieldcat_9000 .
  DATA: lv_colpos TYPE lvc_s_fcat-col_pos VALUE 0.

  &amp;quot;宏
  DEFINE macro_fill_fcat1.
    ADD 1 TO lv_colpos.
    gt_fieldcat1-col_pos = lv_colpos. &amp;quot;位置
    gt_fieldcat1-fieldname = &amp;amp;1.      &amp;quot;字段名称
    gt_fieldcat1-scrtext_m  = &amp;amp;2.     &amp;quot;字段描述
    gt_fieldcat1-checkbox   = &amp;amp;3.     &amp;quot;复选框
    gt_fieldcat1-edit   = &amp;amp;4.         &amp;quot;可编辑
    gt_fieldcat1-just    = &amp;amp;5.
    APPEND gt_fieldcat1.
    CLEAR gt_fieldcat1.
  END-OF-DEFINITION.

  macro_fill_fcat1:
      &amp;#39;BOX&amp;#39; &amp;#39;选择&amp;#39; &amp;#39;X&amp;#39; &amp;#39;X&amp;#39; &amp;#39;&amp;#39;,
      &amp;#39;NUM&amp;#39; &amp;#39;序号&amp;#39; &amp;#39;&amp;#39; &amp;#39;&amp;#39; &amp;#39;C&amp;#39;,
      &amp;#39;NAME&amp;#39; &amp;#39;字段描述&amp;#39; &amp;#39;&amp;#39; &amp;#39;&amp;#39; &amp;#39;&amp;#39;.

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_SET_EVENTS
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; text
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_set_events .

  &amp;quot;注册事件句柄
  CREATE OBJECT ref_event_receiver.
  SET HANDLER ref_event_receiver-&amp;gt;handler_toolbar FOR g_grid1.
  SET HANDLER ref_event_receiver-&amp;gt;handler_user_command FOR g_grid1.

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_GET_DATA
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; 获取表头配置字段，此处以表SFLIGHT为例
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_get_data .

  CLEAR: dfies_tab, gt_alv1.

  &amp;quot;取表字段信息
  CALL FUNCTION &amp;#39;DDIF_FIELDINFO_GET&amp;#39;
    EXPORTING
      tabname        = &amp;#39;SFLIGHT&amp;#39;
    TABLES
      dfies_tab      = dfies_tab
    EXCEPTIONS
      not_found      = 1
      internal_error = 2
      OTHERS         = 3.
  IF sy-subrc = 0.
    DELETE dfies_tab WHERE fieldname = &amp;#39;MANDT&amp;#39;.
    &amp;quot;放入左侧ALV表
    LOOP AT dfies_tab ASSIGNING FIELD-SYMBOL(&amp;lt;fs_dfies&amp;gt;).
      gt_alv1[] = VALUE #( BASE gt_alv1[]
        ( num = sy-tabix name = &amp;lt;fs_dfies&amp;gt;-fieldtext fieldname = &amp;lt;fs_dfies&amp;gt;-fieldname )
       ).
    ENDLOOP.
  ENDIF.

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_ALV_DISPLAY
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; text
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_alv_display .
  CALL METHOD g_grid1-&amp;gt;set_table_for_first_display
    EXPORTING
      i_save                        = &amp;#39;A&amp;#39;
      is_layout                     = gs_layout
    CHANGING
      it_outtab                     = gt_alv1
      it_fieldcatalog               = gt_fieldcat1[]
    EXCEPTIONS
      invalid_parameter_combination = 1
      program_error                 = 2
      too_many_lines                = 3
      OTHERS                        = 4.
ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_REFRESH_ALV_9000
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; 刷新右侧表
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_refresh_alv_9000 .
  DATA: gs_stable TYPE lvc_s_stbl.

  IF &amp;lt;dyn_table&amp;gt; IS ASSIGNED.
    gs_stable-row = &amp;#39;X&amp;#39;.
    gs_stable-col = &amp;#39;X&amp;#39;.
    CALL METHOD g_grid2-&amp;gt;refresh_table_display
      EXPORTING
        is_stable = gs_stable.
  ENDIF.
ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_HANDLE_TOOLBAR_9000
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; 工具栏增加“生成”按钮
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;      --&amp;gt; E_OBJECT
*&amp;amp;      --&amp;gt; E_INTERACTIVE
*&amp;amp;---------------------------------------------------------------------*
FORM frm_handle_toolbar_9000  USING    p_e_object TYPE REF TO cl_alv_event_toolbar_set
                                       p_e_interactive.
  DATA: ls_toolbar TYPE stb_button.

  CLEAR: ls_toolbar.
  MOVE 3 TO ls_toolbar-butn_type.
  APPEND ls_toolbar TO p_e_object-&amp;gt;mt_toolbar.

  CLEAR: ls_toolbar.
  MOVE icon_system_shortcut TO ls_toolbar-icon.
  MOVE &amp;#39;CREATE&amp;#39; TO ls_toolbar-function.
  MOVE &amp;#39;生成&amp;#39; TO ls_toolbar-quickinfo.
  MOVE &amp;#39;生成&amp;#39; TO ls_toolbar-text.
  APPEND ls_toolbar TO p_e_object-&amp;gt;mt_toolbar.

  CLEAR: ls_toolbar.
  MOVE 3 TO ls_toolbar-butn_type.
  APPEND ls_toolbar TO p_e_object-&amp;gt;mt_toolbar.

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_HANDLE_USER_COMMAND_9000
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; 相应生成操作
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp;      --&amp;gt; E_UCOMM
*&amp;amp;---------------------------------------------------------------------*
FORM frm_handle_user_command_9000  USING    p_e_ucomm.
  CASE p_e_ucomm.
    WHEN &amp;#39;CREATE&amp;#39;.
      &amp;quot;创建动态内表
      PERFORM frm_create_table.

      PERFORM frm_get_result.
      &amp;quot;显示结果
      PERFORM frm_display_alv2.
  ENDCASE.

  PERFORM frm_refresh_alv_9000.

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_CREATE_TABLE
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; 动态生成右侧ALV内表
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_create_table .
  DATA lr_struc TYPE REF TO cl_abap_structdescr.
  DATA lr_table TYPE REF TO cl_abap_tabledescr.
  DATA lt_comp TYPE abap_component_tab.
  DATA ls_table TYPE dfies.
  DATA l_string TYPE string.
  DATA ls_comp LIKE LINE OF lt_comp.
  DATA lr_type TYPE REF TO cl_abap_typedescr.
  DATA dyn_wa TYPE REF TO data.
  DATA dyn_table TYPE REF TO data.

  LOOP AT gt_alv1 INTO DATA(gs_alv1)
    WHERE box = abap_true .
    READ TABLE dfies_tab INTO ls_table WITH KEY fieldname = gs_alv1-fieldname.
    IF sy-subrc = 0.
      CONCATENATE ls_table-tabname &amp;#39;-&amp;#39; ls_table-fieldname INTO l_string.
      ls_comp-name = ls_table-fieldname.
*读取字段类型
      CALL METHOD cl_abap_datadescr=&amp;gt;describe_by_name
        EXPORTING
          p_name         = l_string
        RECEIVING
          p_descr_ref    = lr_type
        EXCEPTIONS
          type_not_found = 1
          OTHERS         = 2.
      IF sy-subrc &amp;lt;&amp;gt; 0.
        MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno
        WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.
      ENDIF.
      ls_comp-type ?= lr_type.
      APPEND ls_comp TO lt_comp.
      CLEAR ls_comp.
    ENDIF.
  ENDLOOP.

  IF lt_comp IS NOT INITIAL.
    CALL METHOD cl_abap_structdescr=&amp;gt;create
      EXPORTING
        p_components = lt_comp
      RECEIVING
        p_result     = lr_struc.
*根据动态结构创建动态内表类型
    CALL METHOD cl_abap_tabledescr=&amp;gt;create
      EXPORTING
        p_line_type = lr_struc
      RECEIVING
        p_result    = lr_table.

*参照动态结构类型和动态内表类型创建内表与工作区
    CREATE DATA dyn_wa TYPE HANDLE lr_struc.
    CREATE DATA dyn_table TYPE HANDLE lr_table.
*指定内表与工作区到字段符号
    ASSIGN dyn_wa-&amp;gt;* TO &amp;lt;dyn_wa&amp;gt;.
    ASSIGN dyn_table-&amp;gt;* TO &amp;lt;dyn_table&amp;gt;.
  ELSE.
    MESSAGE &amp;#39;请勾选表头字段&amp;#39; TYPE &amp;#39;S&amp;#39; DISPLAY LIKE &amp;#39;W&amp;#39;.
  ENDIF.

ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_DISPLAY_ALV2
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; text
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_display_alv2 .
  DATA: lv_colpos TYPE lvc_s_fcat-col_pos VALUE 0.

  CHECK &amp;lt;dyn_table&amp;gt; IS ASSIGNED.

  CLEAR: gt_fieldcat2[].
  DEFINE macro_fill_fcat2.
    ADD 1 TO lv_colpos.
    gt_fieldcat2-col_pos = lv_colpos.
    gt_fieldcat2-fieldname = &amp;amp;1.
    gt_fieldcat2-scrtext_m  = &amp;amp;2.
    gt_fieldcat2-edit_mask  = &amp;amp;3.
    APPEND gt_fieldcat2.
    CLEAR: gt_fieldcat2.
  END-OF-DEFINITION.

  CLEAR: gt_fieldcat2.
  LOOP AT gt_alv1 INTO DATA(gs_alv1)
    WHERE box = abap_true .
    macro_fill_fcat2 gs_alv1-fieldname gs_alv1-name &amp;#39;&amp;#39;.
  ENDLOOP.

  CALL METHOD g_grid2-&amp;gt;set_table_for_first_display
    EXPORTING
      i_save                        = &amp;#39;A&amp;#39;
      is_layout                     = gs_layout
    CHANGING
      it_outtab                     = &amp;lt;dyn_table&amp;gt;
      it_fieldcatalog               = gt_fieldcat2[]
    EXCEPTIONS
      invalid_parameter_combination = 1
      program_error                 = 2
      too_many_lines                = 3
      OTHERS                        = 4.
ENDFORM.
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; Form FRM_GET_RESULT
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; text
*&amp;amp;---------------------------------------------------------------------*
*&amp;amp; --&amp;gt;  p1        text
*&amp;amp; &amp;lt;--  p2        text
*&amp;amp;---------------------------------------------------------------------*
FORM frm_get_result .

  IF &amp;lt;dyn_table&amp;gt; IS ASSIGNED.

    DATA dynpfields TYPE TABLE OF dynpread WITH HEADER LINE.
* 获取屏幕上字段输入的值：此字段还没有更新到对应的内表或工作区中
    dynpfields-fieldname = &amp;#39;S_FLDATE-LOW&amp;#39;.
    APPEND dynpfields.
    dynpfields-fieldname = &amp;#39;S_FLDATE-HIGH&amp;#39;.
    APPEND dynpfields.
    CALL FUNCTION &amp;#39;DYNP_VALUES_READ&amp;#39;
      EXPORTING
        dyname               = sy-cprog
        dynumb               = &amp;#39;9001&amp;#39;
      TABLES
        dynpfields           = dynpfields
      EXCEPTIONS
        invalid_abapworkarea = 1
        invalid_dynprofield  = 2
        invalid_dynproname   = 3
        invalid_dynpronummer = 4
        invalid_request      = 5
        no_fielddescription  = 6
        invalid_parameter    = 7
        undefind_error       = 8
        double_conversion    = 9
        stepl_not_found      = 10
        OTHERS               = 11.
    IF sy-subrc EQ 0.
      READ TABLE dynpfields WITH KEY &amp;#39;S_FLDATE-LOW&amp;#39;.
      IF sy-subrc = 0 AND dynpfields-fieldvalue IS NOT INITIAL .
        &amp;quot;日期格式化
        CALL FUNCTION &amp;#39;CONVERT_DATE_TO_INTERNAL&amp;#39;
          EXPORTING
            date_external            = dynpfields-fieldvalue
            accept_initial_date      = &amp;#39; &amp;#39;
          IMPORTING
            date_internal            = s_fldate-low
          EXCEPTIONS
            date_external_is_invalid = 1
            OTHERS                   = 2.
      ELSE.
        CLEAR: s_fldate-low.
      ENDIF.
      READ TABLE dynpfields WITH KEY &amp;#39;S_FLDATE-HIGH&amp;#39;.
      IF sy-subrc = 0 AND dynpfields-fieldvalue IS NOT INITIAL .
        CALL FUNCTION &amp;#39;CONVERT_DATE_TO_INTERNAL&amp;#39;
          EXPORTING
            date_external            = dynpfields-fieldvalue
            accept_initial_date      = &amp;#39; &amp;#39;
          IMPORTING
            date_internal            = s_fldate-high
          EXCEPTIONS
            date_external_is_invalid = 1
            OTHERS                   = 2.
      ELSE.
        CLEAR: s_fldate-high.
      ENDIF.

      IF s_fldate-low IS NOT INITIAL OR s_fldate-high IS NOT INITIAL.
        IF s_fldate-low IS NOT INITIAL AND s_fldate-high IS INITIAL.
          s_fldate-sign = &amp;#39;I&amp;#39;.
          s_fldate-option = &amp;#39;EQ&amp;#39;.
        ELSEIF s_fldate-low IS NOT INITIAL AND s_fldate-high IS NOT INITIAL.
          s_fldate-sign = &amp;#39;I&amp;#39;.
          s_fldate-option = &amp;#39;BT&amp;#39;.
        ENDIF.
        CLEAR: s_fldate[].
        APPEND s_fldate.
      ELSE.
        CLEAR: s_fldate,s_fldate[].
      ENDIF.
    ENDIF.

    &amp;quot;取数，若表中无数据，请执行数据生成程序，方法自行搜索
    SELECT *
        FROM sflight
        INTO CORRESPONDING FIELDS OF TABLE &amp;lt;dyn_table&amp;gt;
        WHERE fldate IN s_fldate.
    IF sy-subrc &amp;lt;&amp;gt; 0.
      MESSAGE &amp;#39;没有找到符合条件的数据&amp;#39; TYPE &amp;#39;S&amp;#39; DISPLAY LIKE &amp;#39;W&amp;#39;.
    ENDIF.
  ENDIF.

ENDFORM.
&lt;/code&gt;&lt;/pre&gt;
&lt;hr&gt;
&lt;p&gt;参考：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/520522128&quot;&gt;OOALV 的一个demo之动态生成ALV - 知乎 (zhihu.com)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://blue-eyeds.net/notes/view/80&quot;&gt;ZSD063 - 销售订单库存移转（更新 WM 版） - ※蓝色眼睛※ (blue-eyeds.net)&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;blockquote&gt;
&lt;p&gt;本文最初发布于知乎专栏 &lt;a href=&quot;https://www.zhihu.com/column/c_1553466158648614912&quot;&gt;SAP ABAP&lt;/a&gt;，&lt;a href=&quot;https://zhuanlan.zhihu.com/p/562886624&quot;&gt;查看知乎原文&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded><category>文章</category></item></channel></rss>