ILIAS\ResourceStorage\Collection\Collections Class Reference

Class Collections. More...

Collaboration diagram for ILIAS\ResourceStorage\Collection\Collections:

Public Member Functions
	__construct (private ResourceBuilder $resource_builder, private CollectionBuilder $collection_builder, private RepositoryPreloader $preloader, private Subject $events)
	Consumers constructor. More...
	id (?string $collection_identification=null, ?int $owner=null)
	exists (string $collection_identification)
	idOrNull (?string $collection_identification=null, ?int $owner=null)
	get (ResourceCollectionIdentification $identification, ?int $owner=null)
	store (ResourceCollection $collection)
	clone (ResourceCollectionIdentification $source_collection_id)
	remove (ResourceCollectionIdentification $collection_id, ResourceStakeholder $stakeholder, bool $delete_resources_as_well=false)
	rangeAsArray (ResourceCollection $collection, int $from, int $amout)
	rangeAsGenerator (ResourceCollection $collection, int $from, int $to)
	sort (ResourceCollection $collection)

Private Attributes
array	$cache = []
array	$rid_cache = []

Detailed Description

Class Collections.

Author

Fabian Schmid fabia.nosp@m.n@sr.nosp@m..solu.nosp@m.tion.nosp@m.s

Definition at line 37 of file Collections.php.

Constructor & Destructor Documentation

__construct()

ILIAS\ResourceStorage\Collection\Collections::__construct	(	private ResourceBuilder	$resource_builder,
		private CollectionBuilder	$collection_builder,
		private RepositoryPreloader	$preloader,
		private Subject	$events
	)

Consumers constructor.

Definition at line 45 of file Collections.php.

    {
    }

Member Function Documentation

clone()

ILIAS\ResourceStorage\Collection\Collections::clone

(

ResourceCollectionIdentification

$source_collection_id

)

Definition at line 126 of file Collections.php.

                                                                                 : ResourceCollectionIdentification
    {
        $target_collection_id = $this->id();
        $target_collection = $this->get($target_collection_id);
        $source_collection = $this->get($source_collection_id);
 
        foreach ($source_collection->getResourceIdentifications() as $identification) {
            $resource = $this->resource_builder->get($identification);
            $cloned_resource = $this->resource_builder->clone($resource);
            $target_collection->add($cloned_resource->getIdentification());
        }
        $this->store($target_collection);
 
        return $target_collection_id;
    }

References ILIAS\GlobalScreen\Provider\id().

Here is the call graph for this function:

exists()

ILIAS\ResourceStorage\Collection\Collections::exists

(

string

$collection_identification

)

Definition at line 71 of file Collections.php.

                                                             : bool
    {
        return $this->collection_builder->has(new ResourceCollectionIdentification($collection_identification));
    }

get()

ILIAS\ResourceStorage\Collection\Collections::get	(	ResourceCollectionIdentification	$identification,
		?int	$owner = null
	)

Definition at line 86 of file Collections.php.

     : ResourceCollection {
        $rcid = $identification->serialize();
 
        $collection = $this->cache[$rcid] ?? $this->collection_builder->get(
            $identification,
            $owner
        );
 
        $preload = [];
 
        $rids = isset($this->cache[$rcid])
            ? $this->cache[$rcid]->getResourceIdentifications()
            : $this->rid_cache[$rcid]
            ?? iterator_to_array($this->collection_builder->getResourceIds($identification));
 
        $this->rid_cache[$rcid] = []; // reset cache for identification, rebuild it now
        $collection->clear();
 
        foreach ($rids as $resource_identification) {
            if ($this->resource_builder->has($resource_identification)) {
                $collection->add($resource_identification);
                $preload[] = $resource_identification;
            }
            $this->rid_cache[$rcid][] = $resource_identification;
        }
        $this->preloader->preload($preload);
 
        return $this->cache[$rcid] = $collection;
    }

References ILIAS\ResourceStorage\Identification\AbstractIdentification\serialize().

Here is the call graph for this function:

id()

ILIAS\ResourceStorage\Collection\Collections::id	(	?string	$collection_identification = null,
		?int	$owner = null
	)

Parameters

string | null	$collection_identification	an existing collection identification or null for a new
int | null	$owner	if this colletion is owned by a users, you must prvide it's owner ID

Definition at line 53 of file Collections.php.

     : ResourceCollectionIdentification {
        if ($collection_identification === null
            || $collection_identification === ''
            || !$this->collection_builder->has(new ResourceCollectionIdentification($collection_identification))
        ) {
            $collection = $this->collection_builder->new($owner);
            $identification = $collection->getIdentification();
            $this->cache[$identification->serialize()] = $collection;
 
            return $identification;
        }
 
        return new ResourceCollectionIdentification($collection_identification);
    }

idOrNull()

ILIAS\ResourceStorage\Collection\Collections::idOrNull	(	?string	$collection_identification = null,
		?int	$owner = null
	)

Definition at line 76 of file Collections.php.

     : ?ResourceCollectionIdentification {
        if ($this->exists($collection_identification)) {
            return $this->id($collection_identification, $owner);
        }
        return null;
    }

References ILIAS\GlobalScreen\Provider\id().

Here is the call graph for this function:

rangeAsArray()

ILIAS\ResourceStorage\Collection\Collections::rangeAsArray	(	ResourceCollection	$collection,
		int	$from,
		int	$amout
	)

Returns

ResourceIdentification[]

Definition at line 162 of file Collections.php.

                                                                                       : array
    {
        $return = [];
        foreach ($collection->getResourceIdentifications() as $position => $identification) {
            if ($position >= $from && $position < $from + $amout) {
                $return[] = $identification;
            }
        }
        return $return;
    }

References ILIAS\ResourceStorage\Collection\ResourceCollection\getResourceIdentifications().

Here is the call graph for this function:

rangeAsGenerator()

ILIAS\ResourceStorage\Collection\Collections::rangeAsGenerator	(	ResourceCollection	$collection,
		int	$from,
		int	$to
	)

Returns

\Generator|ResourceIdentification[]

Definition at line 176 of file Collections.php.

                                                                                        : \Generator
    {
        foreach ($collection->getResourceIdentifications() as $position => $identification) {
            if ($position >= $from && $position <= $to) {
                yield $identification;
            }
        }
    }

References ILIAS\ResourceStorage\Collection\ResourceCollection\getResourceIdentifications().

Here is the call graph for this function:

remove()

ILIAS\ResourceStorage\Collection\Collections::remove	(	ResourceCollectionIdentification	$collection_id,
		ResourceStakeholder	$stakeholder,
		bool	$delete_resources_as_well = false
	)

Definition at line 142 of file Collections.php.

     : bool {
        $collection = $this->get($collection_id);
        if ($delete_resources_as_well) {
            foreach ($collection->getResourceIdentifications() as $resource_identification) {
                $resource = $this->resource_builder->get($resource_identification);
                $this->resource_builder->remove($resource, $stakeholder);
            }
        }
        unset($this->cache[$collection_id->serialize()]);
 
        return $this->collection_builder->delete($collection_id);
    }

References ILIAS\ResourceStorage\Identification\AbstractIdentification\serialize().

Here is the call graph for this function:

sort()

ILIAS\ResourceStorage\Collection\Collections::sort

(

ResourceCollection

$collection

)

Definition at line 185 of file Collections.php.

                                                        : Sorter
    {
        return new Sorter(
            $this->resource_builder,
            $this->collection_builder,
            $collection
        );
    }

store()

ILIAS\ResourceStorage\Collection\Collections::store

(

ResourceCollection

$collection

)

Definition at line 119 of file Collections.php.

                                                         : bool
    {
        $this->cache[$collection->getIdentification()->serialize()] = $collection;
 
        return $this->collection_builder->store($collection);
    }

References ILIAS\ResourceStorage\Collection\ResourceCollection\getIdentification().

Here is the call graph for this function:

Field Documentation

$cache

array ILIAS\ResourceStorage\Collection\Collections::$cache = []

private

Definition at line 39 of file Collections.php.

$rid_cache

array ILIAS\ResourceStorage\Collection\Collections::$rid_cache = []

private

Definition at line 40 of file Collections.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/ResourceStorage/src/Collection/Collections.php