ILIAS\ResourceStorage\Collection\Collections Class Reference

Class Collections. More...

Collaboration diagram for ILIAS\ResourceStorage\Collection\Collections:

Public Member Functions
	__construct (ResourceBuilder $resource_builder, CollectionBuilder $collection_builder, 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 = []
ResourceBuilder	$resource_builder
CollectionBuilder	$collection_builder
RepositoryPreloader	$preloader

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	(	ResourceBuilder	$resource_builder,
		CollectionBuilder	$collection_builder,
		RepositoryPreloader	$preloader,
		private Subject	$events
	)

Consumers constructor.

Definition at line 48 of file Collections.php.

References ILIAS\ResourceStorage\Collection\Collections\$collection_builder, ILIAS\ResourceStorage\Collection\Collections\$preloader, and ILIAS\ResourceStorage\Collection\Collections\$resource_builder.

      {
        $this->resource_builder = $resource_builder;
        $this->collection_builder = $collection_builder;
        $this->preloader = $preloader;
    }

Member Function Documentation

clone()

ILIAS\ResourceStorage\Collection\Collections::clone

(

ResourceCollectionIdentification

$source_collection_id

)

Definition at line 136 of file Collections.php.

References ILIAS\ResourceStorage\Collection\Collections\id(), and ILIAS\ResourceStorage\Collection\Collections\store().

                                                                                 : 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;
    }

Here is the call graph for this function:

exists()

ILIAS\ResourceStorage\Collection\Collections::exists

(

string

$collection_identification

)

Definition at line 81 of file Collections.php.

Referenced by ILIAS\ResourceStorage\Collection\Collections\idOrNull().

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

Here is the caller graph for this function:

get()

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

Definition at line 96 of file Collections.php.

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

     : 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;
    }

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 63 of file Collections.php.

Referenced by ILIAS\ResourceStorage\Collection\Collections\clone(), and ILIAS\ResourceStorage\Collection\Collections\idOrNull().

     : 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);
    }

Here is the caller graph for this function:

idOrNull()

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

Definition at line 86 of file Collections.php.

References ILIAS\ResourceStorage\Collection\Collections\exists(), and ILIAS\ResourceStorage\Collection\Collections\id().

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

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 172 of file Collections.php.

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

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

Here is the call graph for this function:

rangeAsGenerator()

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

Returns

|ResourceIdentification[]

Definition at line 186 of file Collections.php.

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

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

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 152 of file Collections.php.

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

     : 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);
    }

Here is the call graph for this function:

sort()

ILIAS\ResourceStorage\Collection\Collections::sort

(

ResourceCollection

$collection

)

Definition at line 195 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 129 of file Collections.php.

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

Referenced by ILIAS\ResourceStorage\Collection\Collections\clone().

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

        return $this->collection_builder->store($collection);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$cache

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

private

Definition at line 39 of file Collections.php.

$collection_builder

CollectionBuilder ILIAS\ResourceStorage\Collection\Collections::$collection_builder

private

Definition at line 42 of file Collections.php.

Referenced by ILIAS\ResourceStorage\Collection\Collections\__construct().

$preloader

RepositoryPreloader ILIAS\ResourceStorage\Collection\Collections::$preloader

private

Definition at line 43 of file Collections.php.

Referenced by ILIAS\ResourceStorage\Collection\Collections\__construct().

$resource_builder

ResourceBuilder ILIAS\ResourceStorage\Collection\Collections::$resource_builder

private

Definition at line 41 of file Collections.php.

Referenced by ILIAS\ResourceStorage\Collection\Collections\__construct().

$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:

• src/ResourceStorage/Collection/Collections.php