Inheritance diagram for ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI:

Collaboration diagram for ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI:

Public Member Functions
	executeCommand ()

	getUnsafeGetCommands ()
	This method must return a list of unsafe GET commands. More...

	getSafePostCommands ()
	This method must return a list of safe POST commands. More...

	getUnsafeGetCommands ()
	This method must return a list of unsafe GET commands. More...

	getSafePostCommands ()
	This method must return a list of safe POST commands. More...

Static Public Member Functions
static	hash (string $url)

static	unhash (string $url)

Data Fields
const	FROM_URL = 'from_url'

const	OBSERVER_ID = 'observer_id'

const	SELECTED_OPTION = 'selected_option'

const	CMD_ABORT = 'abortBucket'

const	CMD_REMOVE = 'abortBucket'

const	CMD_USER_INTERACTION = 'userInteraction'

const	IS_ASYNC = 'bt_task_is_async'

const	CMD_GET_REPLACEMENT_ITEM = "getAsyncReplacementItem"

Protected Member Functions
	userInteraction ()

	abortBucket ()

	getAsyncReplacementItem ()
	Loads one single aggregate notification item representing a button async to replace an existing one. More...

Private Member Functions
	getFromURL ()

	enforceBucketBelongsToCurrentUser (Bucket $bucket)

	defaultReturnUrl ()

	sendSuccessResponse (Stream $stream)

	redirectToCallerOrClose ()

	respondWithError (int $error_status_code, string $message)

	retrieveSelectedInteractionOption ()

	wasInvokedAsynchronously ()

	retrieveObserverIdFromRequest ()

	retrieveFromUrlFromRequest ()

Detailed Description

Author: Oskar Truffer ot@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch; Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Definition at line 38 of file ControllerGUI.php.

Member Function Documentation

◆ abortBucket()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::abortBucket ( )

protected

Definition at line 104 of file ControllerGUI.php.

                                    : void
    {
        $observer_id = $this->retrieveObserverIdFromRequest();
        if ($observer_id === null) {
            $this->respondWithError(StatusCode::HTTP_BAD_REQUEST, 'Bad Request');
        }
 
        $bucket = $this->dic()->backgroundTasks()->persistence()->loadBucket($observer_id);
 
        $this->enforceBucketBelongsToCurrentUser($bucket);
 
        $this->dic()->backgroundTasks()->taskManager()->quitBucket($bucket);
 
        $this->redirectToCallerOrClose();
    }

References ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\enforceBucketBelongsToCurrentUser(), ILIAS\HTTP\StatusCode\HTTP_BAD_REQUEST, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\redirectToCallerOrClose(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\respondWithError(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\retrieveObserverIdFromRequest().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ defaultReturnUrl()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::defaultReturnUrl ( )

private

Definition at line 202 of file ControllerGUI.php.

                                       : string
    {
        return ilUtil::_getHttpPath();
    }

References ilUtil\_getHttpPath().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getFromURL(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\respondWithError().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ enforceBucketBelongsToCurrentUser()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::enforceBucketBelongsToCurrentUser ( Bucket $bucket )

private

Definition at line 195 of file ControllerGUI.php.

                                                                      : void
    {
        if ($bucket->getUserId() !== $this->user()->getId()) {
            $this->respondWithError(StatusCode::HTTP_FORBIDDEN, 'Forbidden');
        }
    }

References ILIAS\BackgroundTasks\Bucket\getUserId(), ILIAS\HTTP\StatusCode\HTTP_FORBIDDEN, and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\respondWithError().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\abortBucket(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getAsyncReplacementItem(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\userInteraction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::executeCommand ( )

Definition at line 50 of file ControllerGUI.php.

                                    : void
    {
        $cmd = $this->ctrl()->getCmd();
        switch ($cmd) {
            case self::CMD_GET_REPLACEMENT_ITEM:
                $this->getAsyncReplacementItem();
                break;
            case self::CMD_USER_INTERACTION:
                $this->userInteraction();
                break;
            case self::CMD_ABORT:
            case self::CMD_REMOVE:
                $this->abortBucket();
                break;
            default:
                break;
        }
    }

References ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\abortBucket(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_ABORT, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_GET_REPLACEMENT_ITEM, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_REMOVE, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_USER_INTERACTION, ILIAS\Repository\ctrl(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getAsyncReplacementItem(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\userInteraction().

Here is the call graph for this function:

◆ getAsyncReplacementItem()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::getAsyncReplacementItem ( )

protected

Loads one single aggregate notification item representing a button async to replace an existing one.

Definition at line 125 of file ControllerGUI.php.

                                                : void
    {
        $observer_id = $this->retrieveObserverIdFromRequest();
        if ($observer_id === null) {
            $this->respondWithError(StatusCode::HTTP_BAD_REQUEST, 'Bad Request');
        }
 
        $bucket = $this->dic()->backgroundTasks()->persistence()->loadBucket($observer_id);
 
        $this->enforceBucketBelongsToCurrentUser($bucket);
 
        $item_source = new PopOverGUI($this->dic());
        $this->dic()->language()->loadLanguageModule('background_tasks');
        $item = $item_source->getItemForObserver($bucket);
 
        $this->sendSuccessResponse(
            Streams::ofString(
                $this->dic()->ui()->renderer()->renderAsync($item)
            )
        );
    }

References ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\enforceBucketBelongsToCurrentUser(), ILIAS\HTTP\StatusCode\HTTP_BAD_REQUEST, ILIAS\Filesystem\Stream\Streams\ofString(), renderer(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\respondWithError(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\retrieveObserverIdFromRequest(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\sendSuccessResponse(), and ILIAS\Repository\ui().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFromURL()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::getFromURL ( )

private

Definition at line 148 of file ControllerGUI.php.

                                 : URI
    {
        $uri = (new Factory())->uri($this->defaultReturnUrl());
 
        $decoded_from_url = $this->retrieveFromUrlFromRequest();
        if ($decoded_from_url === null || $decoded_from_url === '') {
            return $uri;
        }
 
        $from_url = self::unhash($decoded_from_url);
        if ($from_url === false) {
            return $uri;
        }
 
        $from_url_parts = parse_url($from_url);
        if (!is_array($from_url_parts)) {
            return $uri;
        }
 
        $uri = $uri->withPath(null)->withQuery(null)->withFragment(null);
 
        $mutators = [
            'path' => static fn(URI $u, string $v): URI => $u->withPath($v),
            'query' => static fn(URI $u, string $v): URI => $u->withQuery($v),
            'fragment' => static fn(URI $u, string $v): URI => $u->withFragment($v),
        ];
 
        foreach ($mutators as $key => $apply) {
            $value = $from_url_parts[$key] ?? null;
            if (is_string($value) && $value !== '') {
                $uri = $apply($uri, $value);
            }
        }
 
        return $uri;
    }

References ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\defaultReturnUrl(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\retrieveFromUrlFromRequest(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\unhash(), ILIAS\Data\URI\withFragment(), ILIAS\Data\URI\withPath(), and ILIAS\Data\URI\withQuery().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\redirectToCallerOrClose().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSafePostCommands()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::getSafePostCommands ( )

This method must return a list of safe POST commands.

Safe post commands returned by this method will no longer be CSRF protected and will NOT be appended by an ilCtrlToken.

Returns: string[]

Implements ilCtrlSecurityInterface.

Definition at line 78 of file ControllerGUI.php.

                                         : array
    {
        return [];
    }

◆ getUnsafeGetCommands()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::getUnsafeGetCommands ( )

This method must return a list of unsafe GET commands.

Unsafe get commands returned by this method will now be CSRF protected, which means an ilCtrlToken is appended each time a link-target is generated to the class implementing this interface with a command from that list.

Tokens will be validated in

See also: ilCtrlInterface::getCmd(), whereas the fallback command will be used if the CSRF validation fails.

Returns: string[]

Implements ilCtrlSecurityInterface.

Definition at line 69 of file ControllerGUI.php.

                                          : array
    {
        return array_unique([
            self::CMD_ABORT,
            self::CMD_REMOVE,
            self::CMD_USER_INTERACTION,
        ]);
    }

◆ hash()

static ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::hash ( string $url )

static

Definition at line 185 of file ControllerGUI.php.

                                            : string
    {
        return base64_encode((string) $url);
    }

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\addFromUrlToNextRequest().

Here is the caller graph for this function:

◆ redirectToCallerOrClose()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::redirectToCallerOrClose ( )

private

Definition at line 220 of file ControllerGUI.php.

                                              : never
    {
        if (!$this->wasInvokedAsynchronously()) {
            $this->ctrl()->redirectToURL((string) $this->getFromURL());
        }
 
        $this->http()->close();
    }

References ILIAS\Repository\ctrl(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getFromURL(), ILIAS\FileDelivery\http(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\wasInvokedAsynchronously().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\abortBucket(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\userInteraction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ respondWithError()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::respondWithError	(	int	$error_status_code,
		string	$message
	)

private

Definition at line 229 of file ControllerGUI.php.

                                                                              : never
    {
        $response = $this->http()->response()->withStatus($error_status_code, $message);
        if ($error_status_code === StatusCode::HTTP_FORBIDDEN && !$this->wasInvokedAsynchronously()) {
            $this->tpl()->setOnScreenMessage(
                $this->tpl()::MESSAGE_TYPE_FAILURE,
                $this->lng()->txt('permission_denied'),
                true
            );
            $response = $response
                ->withStatus(StatusCode::HTTP_FOUND, 'Found')
                ->withHeader(ResponseHeader::LOCATION, $this->defaultReturnUrl());
        }
 
        $this->http()->saveResponse($response);
        $this->http()->sendResponse();
        $this->http()->close();
    }

References $message, $response, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\defaultReturnUrl(), ILIAS\FileDelivery\http(), ILIAS\HTTP\StatusCode\HTTP_FORBIDDEN, ILIAS\HTTP\StatusCode\HTTP_FOUND, ILIAS\Repository\lng(), ILIAS\HTTP\Response\ResponseHeader\LOCATION, and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\wasInvokedAsynchronously().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\abortBucket(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\enforceBucketBelongsToCurrentUser(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getAsyncReplacementItem(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\userInteraction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ retrieveFromUrlFromRequest()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::retrieveFromUrlFromRequest ( )

private

Definition at line 281 of file ControllerGUI.php.

                                                 : ?string
    {
        return $this->http()->wrapper()->query()->retrieve(
            self::FROM_URL,
            $this->dic()->refinery()->byTrying([
                $this->dic()->refinery()->kindlyTo()->string(),
                $this->dic()->refinery()->always(null)
            ])
        );
    }

References ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getFromURL().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ retrieveObserverIdFromRequest()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::retrieveObserverIdFromRequest ( )

private

Definition at line 270 of file ControllerGUI.php.

                                                    : ?int
    {
        return $this->http()->wrapper()->query()->retrieve(
            self::OBSERVER_ID,
            $this->dic()->refinery()->byTrying([
                $this->dic()->refinery()->kindlyTo()->int(),
                $this->dic()->refinery()->always(null)
            ])
        );
    }

References ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\abortBucket(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getAsyncReplacementItem(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\userInteraction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ retrieveSelectedInteractionOption()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::retrieveSelectedInteractionOption ( )

private

Definition at line 248 of file ControllerGUI.php.

                                                        : ?string
    {
        return $this->http()->wrapper()->query()->retrieve(
            self::SELECTED_OPTION,
            $this->dic()->refinery()->byTrying([
                $this->dic()->refinery()->kindlyTo()->string(),
                $this->dic()->refinery()->always(null)
            ])
        );
    }

References ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\userInteraction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sendSuccessResponse()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::sendSuccessResponse ( Stream $stream )

private

Definition at line 207 of file ControllerGUI.php.

                                                        : void
    {
        $response = $this->http()->response()
                                 ->withStatus(StatusCode::HTTP_OK, 'OK')
                                 ->withBody($stream);
        $this->http()->saveResponse($response);
 
        if ($this->wasInvokedAsynchronously()) {
            $this->http()->sendResponse();
            $this->http()->close();
        }
    }

References $response, ILIAS\FileDelivery\http(), ILIAS\HTTP\StatusCode\HTTP_OK, and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\wasInvokedAsynchronously().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getAsyncReplacementItem().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ unhash()

static ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::unhash ( string $url )

static

Definition at line 190 of file ControllerGUI.php.

                                              : string|false
    {
        return base64_decode((string) $url);
    }

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\getFromURL().

Here is the caller graph for this function:

◆ userInteraction()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::userInteraction ( )

protected

Definition at line 83 of file ControllerGUI.php.

                                        : void
    {
        $observer_id = $this->retrieveObserverIdFromRequest();
        $selected_option = $this->retrieveSelectedInteractionOption();
        if ($observer_id === null || $selected_option === null) {
            $this->respondWithError(StatusCode::HTTP_BAD_REQUEST, 'Bad Request');
        }
 
        $bucket = $this->dic()->backgroundTasks()->persistence()->loadBucket($observer_id);
 
        $this->enforceBucketBelongsToCurrentUser($bucket);
 
        $this->dic()->backgroundTasks()->taskManager()->continueTask(
            $bucket,
            new UserInteractionOption('', $selected_option)
        );
 
        $this->redirectToCallerOrClose();
    }

References ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\enforceBucketBelongsToCurrentUser(), ILIAS\HTTP\StatusCode\HTTP_BAD_REQUEST, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\redirectToCallerOrClose(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\respondWithError(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\retrieveObserverIdFromRequest(), and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\retrieveSelectedInteractionOption().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ wasInvokedAsynchronously()

ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI::wasInvokedAsynchronously ( )

private

Definition at line 259 of file ControllerGUI.php.

                                               : bool
    {
        return $this->http()->wrapper()->query()->retrieve(
            self::IS_ASYNC,
            $this->dic()->refinery()->byTrying([
                $this->dic()->refinery()->kindlyTo()->bool(),
                $this->dic()->refinery()->always(false)
            ])
        );
    }