Inheritance diagram for ilCtrlArrayClassPath:

Collaboration diagram for ilCtrlArrayClassPath:

Public Member Functions
	__construct (ilCtrlStructureInterface $structure, ilCtrlContextInterface $context, array $target_classes)
	ilCtrlArrayClassPath Constructor More...

Public Member Functions inherited from ilCtrlAbstractPath
	__construct (ilCtrlStructureInterface $structure)
	ilCtrlAbstractPath Constructor More...

	getCidPath ()

	getCurrentCid ()

	getNextCid (string $current_class)

	getCidPaths (int $order=SORT_DESC)

	getCidArray (int $order=SORT_DESC)

	getBaseClass ()

	getException ()

Private Member Functions
	getCidPathByArray (array $target_classes)
	Generates a cid path from the given class array. More...

Private Attributes
ilCtrlContextInterface	$context

Additional Inherited Members
Data Fields inherited from ilCtrlPathInterface
const	CID_PATH_SEPARATOR = ':'

Protected Member Functions inherited from ilCtrlAbstractPath
	getPathToRelatedClassInContext (ilCtrlContextInterface $context, string $target_class)
	Returns the path to a class within the given contexts current path that has a relation to the given target. More...

	isClassChildOf (string $child_class, string $parent_class)
	Returns whether the given target class is a child of the other given class. More...

	isClassParentOf (string $parent_class, string $child_class)
	Returns whether the given target class is a parent of the other given class. More...

	appendCid (string $cid, string $path=null)
	Helper function to add CIDs to a given path. More...

Protected Attributes inherited from ilCtrlAbstractPath
ilCtrlStructureInterface	$structure

ilCtrlException	$exception = null

string	$cid_path = null

Detailed Description

Class ilCtrlArrayClassPath.

Author: Thibeau Fuhrer thf@s.nosp@m.tude.nosp@m.r-rai.nosp@m.mann.nosp@m..ch

Definition at line 12 of file class.ilCtrlArrayClassPath.php.

Constructor & Destructor Documentation

◆ __construct()

ilCtrlArrayClassPath::__construct	(	ilCtrlStructureInterface	$structure,
		ilCtrlContextInterface	$context,
		array	$target_classes
	)

ilCtrlArrayClassPath Constructor

Parameters

ilCtrlStructureInterface	$structure
ilCtrlContextInterface	$context
	string[]	$target_classes

Definition at line 26 of file class.ilCtrlArrayClassPath.php.

References $context, ilCtrlAbstractPath\$exception, ILIAS\GlobalScreen\Provider\__construct(), and getCidPathByArray().

     {
         parent::__construct($structure);
 
         $this->context = $context;
 
         try {
             $this->cid_path = $this->getCidPathByArray($target_classes);
         } catch (ilCtrlException $exception) {
             $this->exception = $exception;
         }
     }

Here is the call graph for this function:

Member Function Documentation

◆ getCidPathByArray()

ilCtrlArrayClassPath::getCidPathByArray ( array $target_classes )

private

Generates a cid path from the given class array.

If the given class array does not contain a valid path an according exception will be thrown.

Parameters

string[] $target_classes

Returns: string

Exceptions

ilCtrlException if classes within the classes array are not related.

Definition at line 50 of file class.ilCtrlArrayClassPath.php.

References ilCtrlAbstractPath\$cid_path, ilCtrlAbstractPath\appendCid(), ilCtrlAbstractPath\getPathToRelatedClassInContext(), and ilCtrlAbstractPath\isClassParentOf().

Referenced by __construct().

                                                              : string
     {
         // abort if the provided targets are empty.
         if (empty($target_classes)) {
             throw new ilCtrlException(__METHOD__ . " must be provided with a list of classes.");
         }
 
         // loop through each provided class in descending order
         // and check if they are all related to one another and
         // convert them to a cid path.
         $cid_path = $previous_class = null;
         foreach ($target_classes as $current_class) {
             $current_cid = $this->structure->getClassCidByName($current_class);
 
             // abort if the current class cannot be found.
             if (null === $current_cid) {
                 throw new ilCtrlException("Class '$current_class' was not found in the control structure, try `composer du` to read artifacts.");
             }
 
             // abort if the current and previous classes are
             // not related.
             if (null !== $previous_class && !$this->isClassParentOf($previous_class, $current_class)) {
                 throw new ilCtrlException("Class '$current_class' is not a child of '$previous_class'.");
             }
 
             $cid_path = $this->appendCid($current_cid, $cid_path);
             $previous_class = $current_class;
         }
 
         // if the first provided class is a baseclass the
         // created cid path can be returned.
         $first_array_class = $target_classes[array_key_first($target_classes)];
         if ($this->structure->isBaseClass($first_array_class)) {
             return $cid_path;
         }
 
         // check if the first command class is related to one
         // of the current context.
         $related_class_path = $this->getPathToRelatedClassInContext($this->context, $first_array_class);
         if (null === $related_class_path) {
             throw new ilCtrlException("Class '$first_array_class' is not a baseclass and the current context doesn't have one either.");
         }
 
         return $this->appendCid($cid_path, $related_class_path);
     }