|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IRunEventListener
This interface describes the set of methods that any Run Listener must implement.
These methods are invoked when a run has been added, removed (marked as deleted), judged, or updated in the contest. A client utilizing the PC2 API can implement this interface and add itself to the contest as a Listener, and therefore arrange to be notified when any runs are added to, modified, or removed from the contest.
There is no guarantee that these events will appear in the order described below. The system is a asynchronous system (Threads) and many factors can affect the order which these events occur.
Run Flow - if Admin selects "Send Additional Run Status Information" to OFF
runSubmitted(IRun)
runCheckedOut(IRun, boolean)
runJudged(IRun, boolean)
typically, but also can be: runJudgingCanceled(IRun, boolean)
or runDeleted(IRun)
or runUpdated(IRun, boolean)
.
runSubmitted(IRun)
runCheckedOut(IRun, boolean)
runCompiling(IRun, boolean)
runExecuting(IRun, boolean)
runValidating(IRun, boolean)
runJudged(IRun, boolean)
typically, but also can be: runJudgingCanceled(IRun, boolean)
or runDeleted(IRun)
or runUpdated(IRun, boolean)
.
runCompiling(IRun, boolean)
, runExecuting(IRun, boolean)
and runValidating(IRun, boolean)
can
appear in any order
runExecuting(IRun, boolean)
and runValidating(IRun, boolean)
are optional, if the preceeding
step fails or does not create output then these states may never be reached.
This documentation describes the current draft of the PC2 API, which is subject to change.
Method Summary | |
---|---|
void |
runCheckedOut(IRun run,
boolean isFinal)
Invoked when a run has been checked by a judge. |
void |
runCompiling(IRun run,
boolean isFinal)
Invoked when an existing run is being compiled. |
void |
runDeleted(IRun run)
Invoked when an existing run has been deleted from the contest (marked as deleted by the Contest Administrator). |
void |
runExecuting(IRun run,
boolean isFinal)
Invoked when an existing run is being executed. |
void |
runJudged(IRun run,
boolean isFinal)
Invoked when an existing run has been judged; that is, has had a Judgement applied to it. |
void |
runJudgingCanceled(IRun run,
boolean isFinal)
Invoked if the run is re-queued for judgement. |
void |
runSubmitted(IRun run)
Invoked when a new run has been added to the contest. |
void |
runUpdated(IRun run,
boolean isFinal)
Invoked when an existing run has been updated (modified) in some way. |
void |
runValidating(IRun run,
boolean isFinal)
Invoked when an existing run is being validated. |
Method Detail |
---|
void runSubmitted(IRun run)
Typically this means that a run has been submitted by a team; it may also may be caused by a remote server in a multi-site contest sending its run(s) to the local server.
The added run may have been originally entered into the contest on either the local server (the server to which this client is connected) or on a remote server.
run
- the IRun
that has been added to the contestvoid runDeleted(IRun run)
run
- the deleted IRun
void runCheckedOut(IRun run, boolean isFinal)
run
- isFinal
- true if this is a action for a final Judgement.runJudgingCanceled(edu.csus.ecs.pc2.api.IRun, boolean)
void runJudged(IRun run, boolean isFinal)
run
- the judged IRun
isFinal
- true if this is a action for a final Judgement.void runUpdated(IRun run, boolean isFinal)
Typically a runUpdated()
invocation occurs when either
IJudgement
) in the run.
run
- the IRun
which has been changedisFinal
- true if this is a action for a final Judgement.void runCompiling(IRun run, boolean isFinal)
run
- the IRun
which is being compiled.isFinal
- true if this is a action for a final Judgement.void runExecuting(IRun run, boolean isFinal)
run
- the IRun
which is being executed.isFinal
- true if this is a action for a final Judgement.void runValidating(IRun run, boolean isFinal)
run
- the IRun
which is being validated.isFinal
- true if this is a action for a final Judgement.void runJudgingCanceled(IRun run, boolean isFinal)
run
- the IRun
which has been returned to the judging queue.isFinal
- true if this is a action for a final Judgement.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |