You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

29 lines
1.1 KiB

package common.ecommerce.shared.audit;
/**
* SDK 调用观察者:操作日志 / 审计日志的宿主扩展点。
*
* <p>SDK 是纯库,不写数据库、不写文件、不起线程。需要把调用记录落库、发 MQ 或接监控时,
* 由宿主实现本接口并注入 {@code ChannelSdk.Builder.callObserver(...)}。</p>
*
* <p>实现约束:</p>
* <ul>
* <li><b>不要抛异常</b>。SDK 会兜底捕获,但吞掉异常会掩盖实现问题;</li>
* <li>回调发生在业务线程上,方法应尽快返回。慢操作请自行投递到宿主的异步通道;</li>
* <li>{@link CallRecord#params()} 只放摘要,不要补写密钥、买家姓名、收货地址等敏感信息。</li>
* </ul>
*/
public interface CallObserver {
/** 空实现:不记录任何内容,也是默认值。 */
CallObserver NOOP = record -> {
// 默认不做任何事
};
/**
* 每次门面调用结束后回调一次;成功与失败都会回调。
*
* @param record 不可变的调用记录
*/
void onCall(CallRecord record);
}