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.
30 lines
1.1 KiB
30 lines
1.1 KiB
|
2 weeks ago
|
package common.ecommerce.shared.audit;
|
||
|
2 weeks ago
|
|
||
|
|
/**
|
||
|
|
* 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);
|
||
|
|
}
|