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