ilBiblFileReaderBase Class Reference

Class ilBiblFileReaderBase. More...

Inheritance diagram for ilBiblFileReaderBase:

Collaboration diagram for ilBiblFileReaderBase:

Public Member Functions
	__construct (ilBiblEntryFactoryInterface $entry_factory, ilBiblFieldFactoryInterface $field_factory, ilBiblAttributeFactoryInterface $attribute_factory)
	ilBiblFileReaderBase constructor. More...
	readContent (ResourceIdentification $identification)
	getFileContent ()
	setFileContent (string $file_content)
	parseContent ()
	parseContentToEntries (ilObjBibliographic $bib)
	@inheritDoc More...
	getEntryFactory ()
	getFieldFactory ()
	getAttributeFactory ()
	@inheritDoc More...
	readContent (ResourceIdentification $identification)
	parseContentToEntries (ilObjBibliographic $bib)
	getEntryFactory ()
	getFieldFactory ()
	getAttributeFactory ()

Data Fields
const	ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH = 4000
const	ENCODING_UTF_8 = 'UTF-8'
const	ENCODING_ASCII = 'ASCII'
const	ENCODING_ISO_8859_1 = 'ISO-8859-1'

Protected Member Functions
	convertStringToUTF8 (string $string)

Protected Attributes
string	$file_content = ''
string	$path_to_file = ''
ilBiblEntryFactoryInterface	$entry_factory
ilBiblFieldFactoryInterface	$field_factory
ilBiblAttributeFactoryInterface	$attribute_factory
ILIAS ResourceStorage Services	$storage

Detailed Description

Class ilBiblFileReaderBase.

Author

Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Definition at line 25 of file class.ilBiblFileReaderBase.php.

Constructor & Destructor Documentation

__construct()

ilBiblFileReaderBase::__construct	(	ilBiblEntryFactoryInterface	$entry_factory,
		ilBiblFieldFactoryInterface	$field_factory,
		ilBiblAttributeFactoryInterface	$attribute_factory
	)

ilBiblFileReaderBase constructor.

Reimplemented in ilBiblRisFileReader.

Definition at line 48 of file class.ilBiblFileReaderBase.php.

      {
        global $DIC;
 
        $this->entry_factory = $entry_factory;
        $this->field_factory = $field_factory;
        $this->attribute_factory = $attribute_factory;
        $this->storage = $DIC["resource_storage"];
    }

References $attribute_factory, $DIC, $entry_factory, and $field_factory.

Member Function Documentation

convertStringToUTF8()

ilBiblFileReaderBase::convertStringToUTF8 ( string  $string )

protected

Definition at line 70 of file class.ilBiblFileReaderBase.php.

                                                          : string
    {
        if (!function_exists('mb_detect_encoding') || !function_exists('mb_detect_order')
            || !function_exists("mb_convert_encoding")
        ) {
            return $string;
        }
 
        ob_end_clean();
 
        $mb_detect_encoding = mb_detect_encoding($string);
        mb_detect_order(array(self::ENCODING_UTF_8, self::ENCODING_ISO_8859_1));
        switch ($mb_detect_encoding) {
            case self::ENCODING_UTF_8:
                break;
            case self::ENCODING_ASCII:
                $string = utf8_encode(iconv(self::ENCODING_ASCII, 'UTF-8//IGNORE', $string));
                break;
            default:
                $string = mb_convert_encoding($string, self::ENCODING_UTF_8, $mb_detect_encoding);
                break;
        }
 
        return $string;
    }

References ENCODING_ASCII, and ENCODING_UTF_8.

getAttributeFactory()

ilBiblFileReaderBase::getAttributeFactory

(

)

@inheritDoc

Implements ilBiblFileReaderInterface.

Definition at line 190 of file class.ilBiblFileReaderBase.php.

                                         : ilBiblAttributeFactoryInterface
    {
        return $this->attribute_factory;
    }

References $attribute_factory.

Referenced by parseContentToEntries().

Here is the caller graph for this function:

getEntryFactory()

ilBiblFileReaderBase::getEntryFactory

(

)

Implements ilBiblFileReaderInterface.

Definition at line 174 of file class.ilBiblFileReaderBase.php.

                                     : ilBiblEntryFactoryInterface
    {
        return $this->entry_factory;
    }

References $entry_factory.

Referenced by parseContentToEntries().

Here is the caller graph for this function:

getFieldFactory()

ilBiblFileReaderBase::getFieldFactory

(

)

Implements ilBiblFileReaderInterface.

Definition at line 182 of file class.ilBiblFileReaderBase.php.

                                     : ilBiblFieldFactoryInterface
    {
        return $this->field_factory;
    }

References $field_factory.

getFileContent()

ilBiblFileReaderBase::getFileContent

(

)

Definition at line 96 of file class.ilBiblFileReaderBase.php.

                                    : string
    {
        return $this->file_content;
    }

References $file_content.

Referenced by ilBiblTexFileReader\convertBibSpecialChars(), ilBiblTexFileReader\normalizeContent(), and ilBiblTexFileReader\parseContent().

Here is the caller graph for this function:

parseContent()

ilBiblFileReaderBase::parseContent ( )

abstract

Reimplemented in ilBiblTexFileReader, and ilBiblRisFileReader.

Referenced by parseContentToEntries().

Here is the caller graph for this function:

parseContentToEntries()

ilBiblFileReaderBase::parseContentToEntries

(

ilObjBibliographic

$bib

)

@inheritDoc

Implements ilBiblFileReaderInterface.

Definition at line 111 of file class.ilBiblFileReaderBase.php.

                                                                  : 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 = array();
            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(function (string $a): string {
                        return $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;
    }

References Vendor\Package\$a, $entry_factory, ILIAS\LTI\ToolProvider\$key, $type, getAttributeFactory(), ilBiblEntryFactoryInterface\getEmptyInstance(), getEntryFactory(), ilObject\getId(), parseContent(), ilStr\strLen(), and ilStr\subStr().

Here is the call graph for this function:

readContent()

ilBiblFileReaderBase::readContent

(

ResourceIdentification

$identification

)

Implements ilBiblFileReaderInterface.

Definition at line 62 of file class.ilBiblFileReaderBase.php.

                                                                       : bool
    {
        $stream = $this->storage->consume()->stream($identification)->getStream();
        $this->setFileContent($stream->getContents());
 
        return true;
    }

References setFileContent().

Here is the call graph for this function:

setFileContent()

ilBiblFileReaderBase::setFileContent

(

string

$file_content

)

Definition at line 101 of file class.ilBiblFileReaderBase.php.

                                                        : void
    {
        $this->file_content = $file_content;
    }

References $file_content.

Referenced by ilBiblTexFileReader\convertBibSpecialChars(), ilBiblTexFileReader\normalizeContent(), and readContent().

Here is the caller graph for this function:

Field Documentation

$attribute_factory

ilBiblAttributeFactoryInterface ilBiblFileReaderBase::$attribute_factory

protected

Definition at line 40 of file class.ilBiblFileReaderBase.php.

Referenced by __construct(), ilBiblRisFileReader\__construct(), and getAttributeFactory().

$entry_factory

ilBiblEntryFactoryInterface ilBiblFileReaderBase::$entry_factory

protected

Definition at line 38 of file class.ilBiblFileReaderBase.php.

Referenced by __construct(), ilBiblRisFileReader\__construct(), getEntryFactory(), and parseContentToEntries().

$field_factory

ilBiblFieldFactoryInterface ilBiblFileReaderBase::$field_factory

protected

Definition at line 39 of file class.ilBiblFileReaderBase.php.

Referenced by __construct(), ilBiblRisFileReader\__construct(), and getFieldFactory().

$file_content

string ilBiblFileReaderBase::$file_content = ''

protected

Definition at line 36 of file class.ilBiblFileReaderBase.php.

Referenced by getFileContent(), and setFileContent().

$path_to_file

string ilBiblFileReaderBase::$path_to_file = ''

protected

Definition at line 37 of file class.ilBiblFileReaderBase.php.

$storage

ILIAS ResourceStorage Services ilBiblFileReaderBase::$storage

protected

Definition at line 42 of file class.ilBiblFileReaderBase.php.

ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH

const ilBiblFileReaderBase::ATTRIBUTE_VALUE_MAXIMAL_TEXT_LENGTH = 4000

Definition at line 32 of file class.ilBiblFileReaderBase.php.

ENCODING_ASCII

const ilBiblFileReaderBase::ENCODING_ASCII = 'ASCII'

Definition at line 34 of file class.ilBiblFileReaderBase.php.

Referenced by convertStringToUTF8().

ENCODING_ISO_8859_1

const ilBiblFileReaderBase::ENCODING_ISO_8859_1 = 'ISO-8859-1'

Definition at line 35 of file class.ilBiblFileReaderBase.php.

ENCODING_UTF_8

const ilBiblFileReaderBase::ENCODING_UTF_8 = 'UTF-8'

Definition at line 33 of file class.ilBiblFileReaderBase.php.

Referenced by convertStringToUTF8().

---

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

• Modules/Bibliographic/classes/FileReader/class.ilBiblFileReaderBase.php