Module page.codeberg.friedolyn.Friedolyn

Package page.codeberg.friedolyn.client

Class Client.FetchPersonalData

java.lang.Object

page.codeberg.friedolyn.util.Task<String>

page.codeberg.friedolyn.client.Client.FetchPersonalData

All Implemented Interfaces:

Runnable

Enclosing class:

Client

private class Client.FetchPersonalData
extends Task<String>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	Client.FetchPersonalData.Kind	The possible kinds of personal data that can be fetched from Friedolin.

Nested classes/interfaces inherited from class page.codeberg.friedolyn.util.Task

Task.CancelListener, Task.FailureListener<ResultType>, Task.ProgressListener, Task.SuccessListener<ResultType>, Task.TaskListener<ResultType>

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_TOTAL_WORK	The expected number of individial steps to complete this task, assuming that we're already logged in.
private boolean	isCancelled	Whether the task has been prematurely terminated by outside intervention.
private final @NonNull Client.FetchPersonalData.Kind	KIND	What personal data to retrieve from Friedolin.
private final @NonNull HashSet<Task.TaskListener<String>>	LISTENERS	The subscribers that will be notified about any status changes and progress updates of this task.
private String	result	The personal data fetched from Friedolin.
private Boolean	success	Whether the task has been executed successfully.

Constructor Summary

Constructors

Constructor	Description
FetchPersonalData(@NonNull Client.FetchPersonalData.Kind kind)	Creates a new task to fetch the student's personal data from Friedolin.

Method Summary

Modifier and Type	Method	Description
void	cancel()	Prematurely terminates the action.
private void	cancelled()	Notifies all subscribers that the fetching process was terminated prematurely by outside intervention.
private void	failed()	Notifies all subscribers that the fetching process finished unsuccessfully.
@NonNull Optional<Result<String>>	getResult()
void	registerListener(@NonNull Task.TaskListener<String> listener)	Adds a subscriber that is interested in status updates of the action's progress.
boolean	removeListener(@NonNull Task.TaskListener<String> listener)	Removes a subscriber that was previously added to receive status updates of the action's progress.
void	run()	Begins the execution of the action.
private void	started()	Notifies all subscribers that the fetching process has begun.
private void	succeeded()	Notifies all subscribers that the fetching process finished successfully.
private void	updateProgress(int current, int total)	Notifies all subscribers about the amount of work that has already been done and the total amount of work that needs to be done to finish fetching the student's personal data.

Methods inherited from class page.codeberg.friedolyn.util.Task

setOnCancelled, setOnFailed, setOnProgressUpdate, setOnSucceeded

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_TOTAL_WORK

public static final int DEFAULT_TOTAL_WORK

The expected number of individial steps to complete this task, assuming that we're already logged in.

See Also:

• Constant Field Values

KIND

@NonNull
private final @NonNull Client.FetchPersonalData.Kind KIND

What personal data to retrieve from Friedolin.

LISTENERS

@NonNull
private final @NonNull HashSet<Task.TaskListener<String>> LISTENERS

The subscribers that will be notified about any status changes and progress updates of this task.

result

@Nullable
private String result

The personal data fetched from Friedolin. null until the task has finished.

success

@Nullable
private Boolean success

Whether the task has been executed successfully. null until the task has finished.

isCancelled

private boolean isCancelled

Whether the task has been prematurely terminated by outside intervention.

Constructor Details

FetchPersonalData

FetchPersonalData(@NonNull
 @NonNull Client.FetchPersonalData.Kind kind)

Creates a new task to fetch the student's personal data from Friedolin.

Parameters:

kind - What personal data to retrieve from Friedolin.

Method Details

registerListener

public void registerListener(@NonNull
 @NonNull Task.TaskListener<String> listener)

Adds a subscriber that is interested in status updates of the action's progress. Does NOT remove or replace any existing listeners.

Specified by:

registerListener in class Task<String>

Parameters:

listener - The subscriber that wants to be informed about the progress of the action.

See Also:

• Task.removeListener(TaskListener)

removeListener

public boolean removeListener(@NonNull
 @NonNull Task.TaskListener<String> listener)

Removes a subscriber that was previously added to receive status updates of the action's progress.

Specified by:

removeListener in class Task<String>

Parameters:

listener - The subscriber that no longer wants to be informed about the progress of the action. Must be the exact same reference that was previously registered.

Returns:

true if the subscriber was removed, false if it hadn't been registered in the first place.

See Also:

• Task.registerListener(TaskListener)

updateProgress

private void updateProgress(int current,
 int total)

Notifies all subscribers about the amount of work that has already been done and the total amount of work that needs to be done to finish fetching the student's personal data.

started

private void started()

Notifies all subscribers that the fetching process has begun.

failed

private void failed()

Notifies all subscribers that the fetching process finished unsuccessfully.

succeeded

private void succeeded()

Notifies all subscribers that the fetching process finished successfully. Does nothing if result is null.

cancelled

private void cancelled()

Notifies all subscribers that the fetching process was terminated prematurely by outside intervention.

cancel

public void cancel()

Prematurely terminates the action. The action will be stopped as soon as possible, but it may not be immediate, depending on the implementation.

Specified by:

cancel in class Task<String>

getResult

@NonNull
public @NonNull Optional<Result<String>> getResult()

Specified by:

getResult in class Task<String>

Returns:

The end product generated by the action. Empty if the action has not finished yet. The presence of Result.getResult() does NOT indicate success. Only Result.getSuccess() can be used to determine success or failure.

run

public void run()
         throws IllegalStateException

Begins the execution of the action. The action will run in the same thread that it was envoked from. Use Task.cancel() to prematurely terminate the action. The end product of the action can be retrieved using Task.getResult().

Specified by:

run in interface Runnable

Specified by:

run in class Task<String>

Throws:

IllegalStateException - If the action had been started before (each task can only be run once).