tap

Class TAPSyncJob.SyncThread

java.lang.Object

java.lang.Thread

tap.TAPSyncJob.SyncThread

All Implemented Interfaces:

java.lang.Runnable

Enclosing class:

TAPSyncJob

protected class TAPSyncJob.SyncThread
extends java.lang.Thread

Thread which will process the job execution.

Actually, it will basically just call ADQLExecutor.start(Thread, String, TAPParameters, HttpServletResponse) with the given ADQLExecutor and TAP parameters (containing the ADQL query to execute).

Version:

2.1 (03/2017)

Author:

Grégory Mantelet (CDS;ARI)

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Throwable	exception Exception that occurs while executing this thread.
protected ADQLExecutor	executor Object knowing how to execute an ADQL query and which will execute it by calling ADQLExecutor.start(Thread, String, TAPParameters, HttpServletResponse).
protected java.lang.String	ID ID of this thread.
protected TAPExecutionReport	report Query execution report.
protected javax.servlet.http.HttpServletResponse	response Response in which the query result must be written.
protected TAPParameters	tapParams Parameters containing the ADQL query to execute and other execution parameters/options.

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
SyncThread(ADQLExecutor executor, java.lang.String ID, TAPParameters tapParams, javax.servlet.http.HttpServletResponse response) Create a thread that will run the given executor with the given parameters.

Method Summary

Modifier and Type	Method and Description
java.lang.Throwable	getError() Get the error that has interrupted/stopped this thread.
TAPExecutionReport	getExecutionReport() Get the report of the query execution.
void	interrupt()
boolean	isSuccess() Tell whether the execution has ended with success.
void	run()

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

executor

protected final ADQLExecutor executor

Object knowing how to execute an ADQL query and which will execute it by calling ADQLExecutor.start(Thread, String, TAPParameters, HttpServletResponse).

response

protected final javax.servlet.http.HttpServletResponse response

Response in which the query result must be written. No error should be written in it directly at this level ; the error must be propagated and it will be written in this HTTP response later on a top level.

ID

protected final java.lang.String ID

ID of this thread. It is also the ID of the synchronous job owning this thread.

tapParams

protected final TAPParameters tapParams

Parameters containing the ADQL query to execute and other execution parameters/options.

exception

protected java.lang.Throwable exception

Exception that occurs while executing this thread. NULL if the execution was a success.

report

protected TAPExecutionReport report

Query execution report. NULL if the execution has not yet started.

Constructor Detail

SyncThread

public SyncThread(ADQLExecutor executor,
                  java.lang.String ID,
                  TAPParameters tapParams,
                  javax.servlet.http.HttpServletResponse response)

Create a thread that will run the given executor with the given parameters.

Parameters:

executor - Object to execute and which knows how to execute an ADQL query.

ID - ID of the synchronous job owning this thread.

tapParams - TAP parameters to use to get the query to execute and the execution parameters.

response - HTTP response in which the ADQL query result must be written.

Method Detail

isSuccess

public final boolean isSuccess()

Tell whether the execution has ended with success.

Returns:

true if the query has been successfully executed, false otherwise (or if this thread is still executed).

getError

public final java.lang.Throwable getError()

Get the error that has interrupted/stopped this thread. This function returns NULL if the query has been successfully executed.

Returns:

Error that occurs while executing the query or NULL if the execution was a success.

getExecutionReport

public final TAPExecutionReport getExecutionReport()

Get the report of the query execution.

Returns:

Query execution report.

interrupt

public void interrupt()

Overrides:

interrupt in class java.lang.Thread

run

public void run()

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread