Exercise XML Parser which completes/updates a given file by an xml string. More...

Inheritance diagram for ilFileXMLParser:

Collaboration diagram for ilFileXMLParser:

Public Member Functions
	ilFileXMLParser (& $file, $a_xml_data, $obj_id=-1, $mode=0)
	Constructor. More...

	setImportDirectory ($a_val)
	Set import directory. More...

	getImportDirectory ()
	Get import directory. More...

	setHandlers ($a_xml_parser)
	set event handlers More...

	handlerBeginTag ($a_xml_parser, $a_name, $a_attribs)
	handler for begin of element More...

	handlerEndTag ($a_xml_parser, $a_name)
	handler for end of element More...

	handlerCharacterData ($a_xml_parser, $a_data)
	handler for character data More...

	setFileContents ()
	update file according to filename and version, does not update history has to be called after (!) file save for new objects, since file storage will be initialised with obj id. More...

	updateFileContents ()
	update file according to filename and version and create history entry has to be called after (!) file save for new objects, since file storage will be initialised with obj id. More...

	start ()
	starts parsing an changes object by side effect. More...

Public Member Functions inherited from ilSaxParser
	ilSaxParser ($a_xml_file='', $throwException=false)
	Constructor setup ILIAS global object @access public. More...

	setXMLContent ($a_xml_content)

	getXMLContent ()

	getInputType ()

	startParsing ()
	stores xml data in array More...

	createParser ()
	create parser More...

	setOptions ($a_xml_parser)
	set parser options More...

	setHandlers ($a_xml_parser)
	set event handler should be overwritten by inherited class @access private More...

	openXMLFile ()
	open xml file More...

	parse ($a_xml_parser, $a_fp=null)
	parse xml file More...

	freeParser ($a_xml_parser)
	free xml parser handle More...

	setThrowException ($throwException)
	set error handling More...

Public Member Functions inherited from PEAR
	PEAR ($error_class=null)
	Constructor. More...

	_PEAR ()
	Destructor (the emulated type of...). More...

&	getStaticProperty ($class, $var)
	If you have a class that's mostly/entirely static, and you need static properties, you can use this method to simulate them. More...

	registerShutdownFunc ($func, $args=array())
	Use this function to register a shutdown method for static classes. More...

	isError ($data, $code=null)
	Tell whether a value is a PEAR error. More...

	setErrorHandling ($mode=null, $options=null)
	Sets how errors generated by this object should be handled. More...

	expectError ($code=' *')
	This method is used to tell which errors you expect to get. More...

	popExpect ()
	This method pops one element off the expected error codes stack. More...

	_checkDelExpect ($error_code)
	This method checks unsets an error code if available. More...

	delExpect ($error_code)
	This method deletes all occurences of the specified element from the expected error codes stack. More...

&	raiseError ($message=null, $code=null, $mode=null, $options=null, $userinfo=null, $error_class=null, $skipmsg=false)
	This method is a wrapper that returns an instance of the configured error class with this object's default error handling applied. More...

&	throwError ($message=null, $code=null, $userinfo=null)
	Simpler form of raiseError with fewer options. More...

	staticPushErrorHandling ($mode, $options=null)

	staticPopErrorHandling ()

	pushErrorHandling ($mode, $options=null)
	Push a new error handler on top of the error handler options stack. More...

	popErrorHandling ()
	Pop the last error handler used. More...

	loadExtension ($ext)
	OS independant PHP extension load. More...

Static Public Member Functions
static	normalizeRelativePath ($path)
	Normalize relative directories in a path. More...

Data Fields
	$file

	$obj_id

	$result

	$mode

	$tmpFilename

Data Fields inherited from ilSaxParser
	$input_type = null

	$xml_content = ''

	$ilias

	$lng

	$xml_file

	$throwException = false

Data Fields inherited from PEAR
	$_debug = false

	$_default_error_mode = null

	$_default_error_options = null

	$_default_error_handler = ''

	$_error_class = 'PEAR_Error'

	$_expected_errors = array()

Static Public Attributes
static	$CONTENT_NOT_COMPRESSED = 0

static	$CONTENT_GZ_COMPRESSED = 1

static	$CONTENT_ZLIB_COMPRESSED = 2

static	$CONTENT_COPY = 4

static	$CONTENT_REST = 5

Additional Inherited Members
Protected Member Functions inherited from ilSaxParser
	handleError ($message, $code)
	use given error handler to handle error message or internal ilias error message handle More...

Detailed Description

Exercise XML Parser which completes/updates a given file by an xml string.

Author: Roland Küstermann rolan.nosp@m.d@ku.nosp@m.ester.nosp@m.mann.nosp@m..com

Version

Id: class.ilObjectXMLParser.php 12811 2006-12-08 18:37:44Z akill

Definition at line 22 of file class.ilFileXMLParser.php.

Member Function Documentation

◆ getImportDirectory()

ilFileXMLParser::getImportDirectory ( )

Get import directory.

Returns: string import directory

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

        {
                return $this->importDirectory;
        }

Referenced by handlerEndTag().

Here is the caller graph for this function:

◆ handlerBeginTag()

ilFileXMLParser::handlerBeginTag	(	$a_xml_parser,
		$a_name,
		$a_attribs
	)

handler for begin of element

Parameters

resource	$a_xml_parser	xml parser
string	$a_name	element name
array	$a_attribs	element attributes array

Exceptions

ilFileException when obj id != - 1 and if it it does not match the id in the xml or deflation mode is not supported

Definition at line 137 of file class.ilFileXMLParser.php.

        {
                global $ilErr;
 
                global $ilLog;
                
                switch($a_name)
                {
                        case 'File':
                            if (isset($a_attribs["obj_id"]))
                            {
                   $read_obj_id = ilUtil::__extractId($a_attribs["obj_id"], IL_INST_ID);
                               if ($this->obj_id != -1 && (int) $read_obj_id != -1 && (int) $this->obj_id != (int) $read_obj_id)
                               {
                       throw new ilFileException ("Object IDs (xml $read_obj_id and argument ".$this->obj_id.") do not match!", ilFileException::$ID_MISMATCH);
                   }
                            }
                if (isset($a_attribs["type"]))
                {
                                        $this->file->setFileType($a_attribs["type"]);
                }
                                break;
                        case 'Content':
                                $this->tmpFilename = ilUtil::ilTempnam();
                            $this->mode = ilFileXMLParser::$CONTENT_NOT_COMPRESSED;
                            $this->isReadingFile = true;
#echo $a_attribs["mode"];
                            if (isset($a_attribs["mode"]))
                                {
                                if($a_attribs["mode"] == "GZIP")
                                {
                        if (!function_exists("gzread"))
                            throw new ilFileException ("Deflating with gzip is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
 
                                    $this->mode = ilFileXMLParser::$CONTENT_GZ_COMPRESSED;
                                }
                                        elseif ($a_attribs["mode"] == "ZLIB")
                                {
                        if (!function_exists("gzuncompress"))
                             throw new ilFileException ("Deflating with zlib (compress/uncompress) is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
 
                                    $this->mode = ilFileXMLParser::$CONTENT_ZLIB_COMPRESSED;
                                }
                                        elseif ($a_attribs["mode"] == "COPY")
                                {
                                    $this->mode = ilFileXMLParser::$CONTENT_COPY;
                                }
                                        // begin-patch fm
                                        elseif($a_attribs['mode'] == 'REST')
                                        {
                                                $this->mode = ilFileXMLParser::$CONTENT_REST;
                                        }
                                        // end-patch fm
                            }
                }
        }

References $CONTENT_COPY, $CONTENT_GZ_COMPRESSED, $CONTENT_NOT_COMPRESSED, $CONTENT_REST, $CONTENT_ZLIB_COMPRESSED, ilFileException\$ID_DEFLATE_METHOD_MISMATCH, ilFileException\$ID_MISMATCH, $ilErr, $ilLog, ilUtil\__extractId(), and ilUtil\ilTempnam().

Here is the call graph for this function:

◆ handlerCharacterData()

ilFileXMLParser::handlerCharacterData	(	$a_xml_parser,
		$a_data
	)

handler for character data

Parameters

resource	$a_xml_parser	xml parser
string	$a_data	character data

Definition at line 309 of file class.ilFileXMLParser.php.

        {
                if($a_data != "\n")
                {
                        // begin-patch fm
                        if ($this->isReadingFile && $this->mode != ilFileXMLParser::$CONTENT_COPY && $this->mode != ilFileXMLParser::$CONTENT_REST)
                        // begin-patch fm
                        {
                        $handle = fopen($this->tmpFilename, "a");
                                fwrite ($handle, $a_data);
                                fclose ($handle);
                        } else
                                $this->cdata .= $a_data;
                }
        }

References $CONTENT_COPY, and $CONTENT_REST.

◆ handlerEndTag()

ilFileXMLParser::handlerEndTag	(	$a_xml_parser,
		$a_name
	)

handler for end of element

Parameters

resource	$a_xml_parser	xml parser
string	$a_name	element name

Definition at line 202 of file class.ilFileXMLParser.php.

        {
            $this->cdata = trim($this->cdata);
 
                $GLOBALS['ilLog']->write(__METHOD__.': '.$this->cdata);
 
                switch($a_name)
                {
                        case 'File':
                              $this->result = true;    
                                break;
                        case 'Filename':                            
                            if (strlen($this->cdata) == 0)
                                  throw new ilFileException("Filename ist missing!");
                            
                            $this->file->setFilename(basename(self::normalizeRelativePath($this->cdata)));
                            $this->file->setTitle($this->cdata);
                            
                                break;
                        case 'Title':
                            $this->file->setTitle(trim($this->cdata));
                            break;
                        case 'Description':
                            $this->file->setDescription(trim($this->cdata));
                                break;
                        case 'Rating':
                            $this->file->setRating((bool)$this->cdata);
                                break;
                        case 'Content':
                                $GLOBALS['ilLog']->write($this->mode);
                                $this->isReadingFile = false;
                                $baseDecodedFilename = ilUtil::ilTempnam();
                                if ($this->mode == ilFileXMLParser::$CONTENT_COPY)
                                {
                                        $this->tmpFilename = $this->getImportDirectory()."/".self::normalizeRelativePath($this->cdata);
                                }
                                // begin-patch fm
                                elseif($this->mode == ilFileXMLParser::$CONTENT_REST)
                                {
                                        include_once './Services/WebServices/Rest/classes/class.ilRestFileStorage.php';
                                        $storage = new ilRestFileStorage();
                                        $this->tmpFilename = $storage->getStoredFilePath(self::normalizeRelativePath($this->cdata));
                                        if(!ilFileUtils::fastBase64Decode($this->tmpFilename, $baseDecodedFilename))
                                        {
                                                throw new ilFileException("Base64-Decoding failed", ilFileException::$DECOMPRESSION_FAILED);
                                        }
                                        $this->tmpFilename = $baseDecodedFilename;
                                }
                                // end-patch fm
                                else
                                {
                                        if (!ilFileUtils::fastBase64Decode($this->tmpFilename, $baseDecodedFilename))
                                        {
                                                        throw new ilFileException ("Base64-Decoding failed", ilFileException::$DECOMPRESSION_FAILED);
                                        }
                                        if ($this->mode == ilFileXMLParser::$CONTENT_GZ_COMPRESSED)
                                        {
                                                if (!ilFileUtils::fastGunzip ($baseDecodedFilename, $this->tmpFilename))
                                                {
                                                        throw new ilFileException ("Deflating with fastzunzip failed", ilFileException::$DECOMPRESSION_FAILED);
                                                }
                                                unlink ($baseDecodedFilename);
                                        }
                                        elseif ($this->mode == ilFileXMLParser::$CONTENT_ZLIB_COMPRESSED)
                                        {
                                                if (!ilFileUtils::fastGunzip ($baseDecodedFilename, $this->tmpFilename))
                                                {
                                                        throw new ilFileException ("Deflating with fastDecompress failed", ilFileException::$DECOMPRESSION_FAILED);
                                                }
                                                unlink ($baseDecodedFilename);
                                        }
                                        else
                                        {
                                                $this->tmpFilename = $baseDecodedFilename;
                                        }
                                }
                                //$this->content = $content;
                                // see #17211
                                if (is_file($this->tmpFilename))
                                {
                                        $this->file->setFileSize(filesize($this->tmpFilename)); // strlen($this->content));
                                }
                                
                                // if no file type is given => lookup mime type
                                if(!$this->file->getFileType())
                                {
                                        global $ilLog;
                                        
                                        #$ilLog->write(__METHOD__.': Trying to detect mime type...');
                                        include_once('./Services/Utilities/classes/class.ilFileUtils.php');
                                        $this->file->setFileType(ilFileUtils::_lookupMimeType($this->tmpFilename));
                                }
                                
                                break;
                }
 
                $this->cdata = '';
 
                return;
        }

References $CONTENT_COPY, $CONTENT_GZ_COMPRESSED, $CONTENT_REST, $CONTENT_ZLIB_COMPRESSED, ilFileException\$DECOMPRESSION_FAILED, $GLOBALS, $ilLog, ilFileUtils\_lookupMimeType(), ilFileUtils\fastBase64Decode(), ilFileUtils\fastGunzip(), getImportDirectory(), ilUtil\ilTempnam(), and normalizeRelativePath().

Here is the call graph for this function:

◆ ilFileXMLParser()

ilFileXMLParser::ilFileXMLParser	(	&	$file,
			$a_xml_data,
			$obj_id = `-1`,
			$mode = `0`
	)

Constructor.

Parameters

ilObjFile	$file	existing file object
string	$a_xml_file	xml data
int	$obj_id	obj id of exercise which is to be updated @access public

Definition at line 86 of file class.ilFileXMLParser.php.

        {
                parent::ilSaxParser();
                $this->file = $file;
                $this->setXMLContent($a_xml_data);
                $this->obj_id = $obj_id;
                $this->result = false;
                $this->mode = $mode;
        }

References $file, $mode, $obj_id, and ilSaxParser\setXMLContent().

Here is the call graph for this function:

◆ normalizeRelativePath()

static ilFileXMLParser::normalizeRelativePath ( $path )

static

Normalize relative directories in a path.

Source: https://github.com/thephpleague/flysystem/blob/master/src/Util.php#L96 Workaround until we have

Parameters

string $path

Exceptions

LogicException

Returns: string

Definition at line 399 of file class.ilFileXMLParser.php.

                                                            {
                $path = str_replace('\\', '/', $path);
 
                while (preg_match('#\p{C}+|^\./#u', $path)) {
                        $path = preg_replace('#\p{C}+|^\./#u', '', $path);
                }
 
                $parts = array();
                foreach (explode('/', $path) as $part) {
                        switch ($part) {
                                case '':
                                case '.':
                                        break;
                                case '..':
                                        array_pop($parts);
                                        break;
                                default:
                                        $parts[] = $part;
                                        break;
                        }
                }
 
                return implode('/', $parts);
        }

References $path.

Referenced by handlerEndTag().

Here is the caller graph for this function:

◆ setFileContents()

ilFileXMLParser::setFileContents ( )

update file according to filename and version, does not update history has to be called after (!) file save for new objects, since file storage will be initialised with obj id.

Definition at line 330 of file class.ilFileXMLParser.php.

        {
                if(!file_exists($this->tmpFilename))
                {
                        ilLoggerFactory::getLogger('file')->error(__METHOD__.' "'.$this->tmpFilename. '" file not found.');
                        return;
                }
 
                if (filesize ($this->tmpFilename) == 0) {
                        return;
                }
 
                $filedir = $this->file->getDirectory($this->file->getVersion());
                
                if (!is_dir($filedir))
                {
                        $this->file->createDirectory();
                        ilUtil::makeDir($filedir);
                }
                   
                $filename = $filedir."/".$this->file->getFileName();
 
                if (file_exists($filename))
                        unlink($filename);
                require_once('./Services/Utilities/classes/class.ilFileUtils.php');
                return ilFileUtils::rename($this->tmpFilename, $filename);
        }

References $filename, ilLoggerFactory\getLogger(), ilUtil\makeDir(), and ilFileUtils\rename().

Referenced by updateFileContents().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setHandlers()

ilFileXMLParser::setHandlers ( $a_xml_parser )

set event handlers

Parameters

resource reference to the xml parser @access private

Reimplemented from ilSaxParser.

Definition at line 121 of file class.ilFileXMLParser.php.

        {
                xml_set_object($a_xml_parser,$this);
                xml_set_element_handler($a_xml_parser,'handlerBeginTag','handlerEndTag');
                xml_set_character_data_handler($a_xml_parser,'handlerCharacterData');
        }

◆ setImportDirectory()

ilFileXMLParser::setImportDirectory ( $a_val )

Set import directory.

Parameters

string import directory

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

        {
                $this->importDirectory = $a_val;
        }

◆ start()

ilFileXMLParser::start ( )

starts parsing an changes object by side effect.

Exceptions

ilFileException when obj id != - 1 and if it it does not match the id in the xml

Returns: boolean true, if no errors happend.

Definition at line 381 of file class.ilFileXMLParser.php.

                                 {
            $this->startParsing();
            return $this->result > 0;
        }

References ilSaxParser\startParsing().

Here is the call graph for this function:

◆ updateFileContents()

ilFileXMLParser::updateFileContents ( )

update file according to filename and version and create history entry has to be called after (!) file save for new objects, since file storage will be initialised with obj id.

Definition at line 364 of file class.ilFileXMLParser.php.

        {
      if ($this->setFileContents()) 
      {
                require_once("./Services/History/classes/class.ilHistory.php");
                                ilHistory::_createEntry($this->file->getId(), "replace", $this->file->getFilename().",".$this->file->getVersion());
                                $this->file->addNewsNotification("file_updated");       
                        }
        }

References ilHistory\_createEntry(), and setFileContents().

Here is the call graph for this function:

Field Documentation

◆ $CONTENT_COPY

ilFileXMLParser::$CONTENT_COPY = 4

static

Definition at line 27 of file class.ilFileXMLParser.php.

Referenced by handlerBeginTag(), handlerCharacterData(), and handlerEndTag().

◆ $CONTENT_GZ_COMPRESSED

ilFileXMLParser::$CONTENT_GZ_COMPRESSED = 1

static

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

Referenced by handlerBeginTag(), and handlerEndTag().

◆ $CONTENT_NOT_COMPRESSED

ilFileXMLParser::$CONTENT_NOT_COMPRESSED = 0

static

Definition at line 24 of file class.ilFileXMLParser.php.

Referenced by handlerBeginTag().

◆ $CONTENT_REST

ilFileXMLParser::$CONTENT_REST = 5

static

Definition at line 29 of file class.ilFileXMLParser.php.

Referenced by handlerBeginTag(), handlerCharacterData(), and handlerEndTag().

◆ $CONTENT_ZLIB_COMPRESSED

ilFileXMLParser::$CONTENT_ZLIB_COMPRESSED = 2

static

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

Referenced by handlerBeginTag(), and handlerEndTag().

◆ $file

ilFileXMLParser::$file

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

Referenced by ilFileXMLParser().

◆ $mode

ilFileXMLParser::$mode

Definition at line 60 of file class.ilFileXMLParser.php.

Referenced by ilFileXMLParser().

◆ $obj_id

ilFileXMLParser::$obj_id

Definition at line 45 of file class.ilFileXMLParser.php.

Referenced by ilFileXMLParser().

◆ $result

ilFileXMLParser::$result

Definition at line 53 of file class.ilFileXMLParser.php.

◆ $tmpFilename

ilFileXMLParser::$tmpFilename

Definition at line 75 of file class.ilFileXMLParser.php.

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

Modules/File/classes/class.ilFileXMLParser.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ getImportDirectory()

◆ handlerBeginTag()

◆ handlerCharacterData()

◆ handlerEndTag()

◆ ilFileXMLParser()

◆ normalizeRelativePath()

◆ setFileContents()

◆ setHandlers()

◆ setImportDirectory()

◆ start()

◆ updateFileContents()

Field Documentation

◆ $CONTENT_COPY

◆ $CONTENT_GZ_COMPRESSED

◆ $CONTENT_NOT_COMPRESSED

◆ $CONTENT_REST

◆ $CONTENT_ZLIB_COMPRESSED

◆ $file

◆ $mode

◆ $obj_id

◆ $result

◆ $tmpFilename