|
|
@@ -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)。
|
|
|
* 这条守卫是**消息清晰度与对称性**的改动,**不是**补泄漏:
|
|
|
* 它一个字节都不出海(理由写在方法体那条注释里)
|