com.tencent.mm.opensdk.report

Interface IWXPayReporter

All Known Implementing Classes:

WXPayHttpReporter

public interface IWXPayReporter

Transport-level reporter. Core SDK classes only emit events; the actual batching / network / retry is done by an implementation of this interface. Hosts may inject a custom implementation (e.g. route through their own pipeline) or disable reporting.

传输层上报器接口。核心类只负责产生事件，真正的攒批/网络/重试由本接口的实现完成。 宿主可注入自定义实现（改走自有通道）或直接关闭上报。

实现方必须保证 report(java.util.List<com.tencent.mm.opensdk.report.WXPayReportEvent>, boolean) 不抛异常、不阻塞调用线程（异步执行）。

Method Summary

Modifier and Type	Method and Description
void	flush() 主动把攒批队列中的 pending 事件立即发出（用于拉起前、拉起结果和回包等阶段边界， 使正常成功路径的 HTTP 调用保持在最多 4 次）。 队列为空时应为 no-op；实现必须异步执行、失败静默、绝不抛出、不阻塞调用线程。
void	report(java.util.List<WXPayReportEvent> events, boolean immediate) 提交一批待上报事件。

Method Detail

report

void report(java.util.List<WXPayReportEvent> events,
            boolean immediate)

提交一批待上报事件。

Parameters:

events - 待上报事件（非空、至少 1 条）。

immediate - true 表示尽快单独发送（用于 pay_start 发起立即单发）； false 表示进入攒批队列，等待阶段边界主动 flush。

flush

void flush()

主动把攒批队列中的 pending 事件立即发出（用于拉起前、拉起结果和回包等阶段边界， 使正常成功路径的 HTTP 调用保持在最多 4 次）。 队列为空时应为 no-op；实现必须异步执行、失败静默、绝不抛出、不阻塞调用线程。