Class HttpEffectTarget

java.lang.Object

com.kingsrook.qqq.backend.core.jobs.effects.targets.HttpEffectTarget

All Implemented Interfaces:

EffectTarget

public abstract class HttpEffectTarget
extends Object
implements EffectTarget

HTTP delivery with a stable provider idempotency key and conservative outcome reporting.

Constructor Summary

Constructors

Constructor	Description
HttpEffectTarget()

Method Summary

Modifier and Type	Method	Description
protected abstract HttpRequest.Builder	buildRequest(EffectRequest request)	Subclasses supply the URL, method, body and any provider-specific authentication.
EffectResult	deliver(EffectRequest request)	Only explicit rejections or a failed connection are safe to retry as undelivered.
protected ReconcileResult	lookup(EffectRequest request)	Providers without a lookup must leave ambiguous deliveries for review.
protected String	providerRef(HttpResponse<String> response)	Subclasses can extract the provider's delivery identifier.
ReconcileResult	reconcile(EffectRequest request)	Delegate reconciliation to the provider-specific lookup.
protected Duration	timeout()	Maximum duration of a delivery request.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

HttpEffectTarget

public HttpEffectTarget()

Method Details

buildRequest

protected abstract HttpRequest.Builder buildRequest(EffectRequest request)

Subclasses supply the URL, method, body and any provider-specific authentication.

timeout

protected Duration timeout()

Maximum duration of a delivery request.

providerRef

protected String providerRef(HttpResponse<String> response)

Subclasses can extract the provider's delivery identifier.

deliver

public EffectResult deliver(EffectRequest request)

Only explicit rejections or a failed connection are safe to retry as undelivered.

Specified by:

deliver in interface EffectTarget

reconcile

public ReconcileResult reconcile(EffectRequest request)
                          throws Exception

Delegate reconciliation to the provider-specific lookup.

Specified by:

reconcile in interface EffectTarget

Throws:

Exception

lookup

protected ReconcileResult lookup(EffectRequest request)
                          throws Exception

Providers without a lookup must leave ambiguous deliveries for review.

Throws:

Exception