Package com.qtsurfer.api.sdk

Class Backtest

java.lang.Object

com.qtsurfer.api.sdk.Backtest

public final class Backtest
extends Object

Handle for a running backtest execution. Returned by Strategy.backtest(com.qtsurfer.api.sdk.BacktestRequest, com.qtsurfer.api.sdk.BacktestOptions) once the execute request has been accepted by the backend.

• await() resolves with the final ResultMap when polling completes.
• progress() streams BacktestProgress events through a Flow.Publisher.
• cancel() triggers a best-effort server-side cancelExecution.
• state() returns a local snapshot of the lifecycle.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	Backtest.State	Execution lifecycle as observed by the SDK.

Constructor Summary

Constructors

Constructor	Description
Backtest(String id, Strategy strategy, CompletableFuture<com.qtsurfer.api.client.model.ResultMap> result, Flow.Publisher<BacktestProgress> progress, AtomicReference<Backtest.State> state, Runnable cancelHook)	Internal constructor used by the SDK workflow; not part of the public contract.

Method Summary

Modifier and Type	Method	Description
CompletableFuture<com.qtsurfer.api.client.model.ResultMap>	await()	Resolves with the final ResultMap.
boolean	cancel()	Request cancellation.
String	id()	Server-side execute jobId.
Flow.Publisher<BacktestProgress>	progress()	Reactive-streams feed of progress events; terminates when the job reaches a terminal state.
Backtest.State	state()	Local snapshot of the execution lifecycle; does not itself contact the server.
Strategy	strategy()	The Strategy this backtest was run against.
String	toString()	Compact debug representation including the job id and current state.

Methods inherited from class java.lang.Object

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

Constructor Details

Backtest

public Backtest(String id,
 Strategy strategy,
 CompletableFuture<com.qtsurfer.api.client.model.ResultMap> result,
 Flow.Publisher<BacktestProgress> progress,
 AtomicReference<Backtest.State> state,
 Runnable cancelHook)

Internal constructor used by the SDK workflow; not part of the public contract.

Method Details

id

public String id()

Server-side execute jobId.

strategy

public Strategy strategy()

The Strategy this backtest was run against.

state

public Backtest.State state()

Local snapshot of the execution lifecycle; does not itself contact the server.

progress

public Flow.Publisher<BacktestProgress> progress()

Reactive-streams feed of progress events; terminates when the job reaches a terminal state.

await

public CompletableFuture<com.qtsurfer.api.client.model.ResultMap> await()

Resolves with the final ResultMap. Completes exceptionally on failure or cancellation.

cancel

public boolean cancel()

Request cancellation. Cancels the underlying polling future and best-effort calls cancelExecution server-side.

Returns:

true if the call caused a transition from Backtest.State.EXECUTING

toString

public String toString()

Compact debug representation including the job id and current state.

Overrides:

toString in class Object