Ver Fonte

docs(进件): 修正 fileBytes 的 try 定位 - 指向真实那一处(postForRawEntity)

G-2:@param fileBytes 原文说那个 IAE 在「postForRawMultipart 的 try 之外」,
但 postForRawMultipart 里**没有 try** —— 本文件唯一一处 try(连同四段 catch)在
发送腿 postForRawEntity:422。结论不变(不会被包成 LeshouyingApiException:守卫在
postMultipart 入口,比 postForRawMultipart 还早,压根不经过那个 try),坏的只是
指向的方法名:上一版只写光秃秃的「在 try 之外」(含糊但不假),这一版加的方法名
反把它指到一处不存在的 try 上。改成指向真实那一处,并点明「本文件唯一一处」。

纯 javadoc(4 行 → 6 行);提交前跑过全量 451 绿。
alphaH há 3 semanas atrás
pai
commit
2a30ecf544

+ 5 - 3
java/src/main/java/com/payment/platform/module/payment/leshouying/client/LeshouyingClient.java

@@ -213,9 +213,11 @@ public class LeshouyingClient {
      * @param fileName      文件部件的文件名(multipart 的 filename),不是表单字段;
      *                      不得为 null、不得含 ISO 控制字符
      * @param fileBytes     文件内容,**不得为 null**:由本方法**入口**的守卫拒绝(消息点名
-     *                      {@code fileBytes}),抛的 {@link IllegalArgumentException} 在
-     *                      {@code postForRawMultipart} 的 {@code try} **之外**,**不会**被包成
-     *                      {@link LeshouyingApiException} —— 调用方若只 catch 后者,
+     *                      {@code fileBytes})。守卫在入口,比 {@code postForRawMultipart} 还早;
+     *                      而本文件唯一一处 {@code try}(连同把异常包成
+     *                      {@link LeshouyingApiException} 的那几段 {@code catch})在发送腿
+     *                      {@code postForRawEntity} 里 —— 所以这个 {@link IllegalArgumentException}
+     *                      **不会**被包成 {@link LeshouyingApiException}:调用方若只 catch 后者,
      *                      这个错误会逃出它的错误通道(生产表现为 500)。
      *                      这条守卫是**消息清晰度与对称性**的改动,**不是**补泄漏:
      *                      它一个字节都不出海(理由写在方法体那条注释里)