class.ilBiblFileReaderBase.php

Go to the documentation of this file.

<?php
 
use ILIAS\Refinery\Factory;
use ILIAS\ResourceStorage\Services;
use ILIAS\ResourceStorage\Identification\ResourceIdentification;
 
abstract class ilBiblFileReaderBase implements ilBiblFileReaderInterface
{
    use ilBibliographicSecureString;
    public const ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH = 4000;
    public const ENCODING_UTF_8 = 'UTF-8';
    public const ENCODING_ASCII = 'ASCII';
    public const ENCODING_ISO_8859_1 = 'ISO-8859-1';
    protected string $file_content = '';
    protected string $path_to_file = '';
    private Factory $refinery;
 
    protected Services $storage;
 
 
    public function __construct(
        protected \ilBiblEntryFactoryInterface $entry_factory,
        protected \ilBiblFieldFactoryInterface $field_factory,
        protected \ilBiblAttributeFactoryInterface $attribute_factory
    ) {
        global $DIC;
        $this->refinery = $DIC->refinery();
        $this->storage = $DIC["resource_storage"];
    }
 
 
    public function readContent(ResourceIdentification $identification): bool
    {
        $stream = $this->storage->consume()->stream($identification)->getStream();
        $this->setFileContent($stream->getContents());
 
        return true;
    }
 
    protected function convertStringToUTF8(string $string): string
    {
        return $this->refinery->string()
                              ->encoding()
                              ->latin1ToUtf8()
                              ->transform($string);
    }
 
    public function getFileContent(): string
    {
        return $this->file_content;
    }
 
    public function setFileContent(string $file_content): void
    {
        $this->file_content = $file_content;
    }
 
    abstract public function parseContent(): array;
 
    public function parseContentToEntries(ilObjBibliographic $bib): array
    {
        $this->entry_factory->deleteEntriesById($bib->getId());
 
        $entries_from_file = $this->parseContent();
        $entry_instances = [];
        //fill each entry into a ilBibliographicEntry object and then write it to DB by executing doCreate()
 
        foreach ($entries_from_file as $file_entry) {
            $type = null;
            $x = 0;
            $parsed_entry = [];
            foreach ($file_entry as $key => $attribute) {
                $key = $this->secure($key);
                if (is_string($attribute)) {
                    $attribute = $this->secure($attribute);
                }
                // if the attribute is an array, make a comma separated string out of it
                if (is_array($attribute)) {
                    $attribute = array_map(fn(string $a): string => $this->secure($a), $attribute);
                    $attribute = implode(", ", $attribute);
                }
                // reduce the attribute strings to a maximum of 4000 (ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH) characters, in order to fit in the database
                //if (mb_strlen($attribute, 'UTF-8') > self::ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH) {
                if (ilStr::strLen($attribute) > self::ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH) {
                    // $attribute = mb_substr($attribute, 0, self::ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH - 3, 'UTF-8') . '...';
                    $attribute = ilStr::subStr($attribute, 0, self::ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH - 3) . '...';
                }
                // ty (RIS) or entryType (BIB) is the type and is treated seperately
                if (strtolower($key) === 'ty' || strtolower($key) === 'entrytype') {
                    $type = $attribute;
                    continue;
                }
                //TODO - Refactoring for ILIAS 4.5 - get rid off array restructuring
                //change array structure (name not as the key, but under the key "name")
                $parsed_entry[$x]['name'] = $key;
                $parsed_entry[$x]['value'] = $attribute;
                $x++;
            }
 
            if ($type === null) {
                continue;
            }
            //create the entry and fill data into database by executing doCreate()
            $entry_factory = $this->getEntryFactory();
            $entry_model = $entry_factory->getEmptyInstance();
            $entry_model->setType($type);
            $entry_model->setDataId($bib->getId());
            $entry_model->store();
            foreach ($parsed_entry as $entry) {
                $this->getAttributeFactory()->createAttribute($entry['name'], $entry['value'], $entry_model->getId());
            }
            $entry_instances[] = $entry_model;
        }
 
        return $entry_instances;
    }
 
    public function getEntryFactory(): ilBiblEntryFactoryInterface
    {
        return $this->entry_factory;
    }
 
    public function getFieldFactory(): ilBiblFieldFactoryInterface
    {
        return $this->field_factory;
    }
 
    public function getAttributeFactory(): ilBiblAttributeFactoryInterface
    {
        return $this->attribute_factory;
    }
}