【功能定位】导出接口接收用户导出请求,将内存中临时报表数据组装为CSV字节流,通过HTTP Response下发。【输入来源】HttpRequest.getQueryString()、ThreadLocal.get()获取当前租户ID、配置中心拉取的timeout_ms。【核心逻辑分步】解析查询参数→校验租户权限→查Redis缓存→拼接SQL→执行JDBC→封装List→写入Response输出流。【异常分支】QueryTimeoutException:DB响应超时且enable_retry=false时直接抛出;NullPointerException:ThreadLocal中租户ID为空时抛出。【已知限制】仅支持UTF-8编码;最大导出行数锁定为50万,超出截断无提示;CSV字段分隔符硬编码为英文逗号。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让通义千问把一段旧代码自动转成清晰、可读、带上下文的说明文档,但直接扔代码过去它往往只做表面注释,漏掉设计意图、调用链路和边界条件。关键不是“解释代码”,而是“还原当初写它的人想说却没写进注释里的话”。
明确告诉AI你想要的文档结构
在提示词开头就定义输出骨架,强制它按框架填充内容,避免自由发挥跑偏。
输入:“请按以下结构生成说明文档:①【功能定位】一句话说清这段代码在系统中承担什么角色(不是‘实现了XX功能’,而是‘当用户点击导出按钮后,它负责把内存中的临时报表数据组装成CSV字节流,交由Response流下发’);②【输入来源】列出所有实际入参或隐式依赖(如:HttpRequest.getQueryString()、ThreadLocal.get()、配置中心拉取的timeout_ms);③【核心逻辑分步】用‘→’串联3~5个不可再拆的原子动作,每步附10字内动词短语标题(例:『校验租户权限→查Redis缓存→拼接SQL→执行JDBC→封装List
提供一段参考风格文本
给AI一个它要模仿的“语气+粒度+信息密度”样本,比抽象描述更有效。
输入:“请严格参照以下示例风格输出,尤其注意:不用‘该函数’‘此模块’等指代词,直接命名;动词用现在时;每个分号后换行;技术名词不加引号;不出现‘可能’‘一般’‘通常’等模糊表述:
【功能定位】
订单创建接口接收前端提交的购物车快照,生成待支付订单记录,同时向MQ推送order_created事件供库存服务扣减。
【输入来源】
HTTP POST body(JSON)、X-User-ID Header、spring.cloud.config.label(用于区分灰度环境)。
【核心逻辑分步】
解析JSON→校验SKU库存→计算满减优惠→生成订单号→写MySQL主库→发MQ消息→返回订单ID。
【异常分支】
IllegalStateException:SKU库存不足时立即抛出,不进入事务;
OptimisticLockException:更新库存CAS失败时抛出,由全局处理器转为BUSY_RETRY状态码。
【已知限制】
不校验用户地址格式,仅存储原始字符串;
优惠券叠加逻辑未实现,当前仅支持单张券;
订单号长度固定18位,高位时间戳精度到秒。
绑定具体代码片段并禁用幻觉
把你要处理的真实代码粘贴在提示词末尾,并加一句硬性约束。
输入:“以上结构与风格必须应用于以下Java代码,【禁止补充任何代码中未出现的类名、方法名、配置项或业务规则】,所有结论必须能在代码字面或其紧邻的注释/日志/配置文件中找到依据。”
(此处粘贴你的旧代码)


















