Base class for sax-based expat parsing extended classes need to overwrite the method setHandlers and implement their own handler methods. More...

Inheritance diagram for ilSaxParser:

Collaboration diagram for ilSaxParser:

Public Member Functions
	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...

Data Fields
	$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()

Protected Member Functions
	handleError ($message, $code)
	use given error handler to handle error message or internal ilias error message handle More...

Detailed Description

Base class for sax-based expat parsing extended classes need to overwrite the method setHandlers and implement their own handler methods.

Author: Stefan Meyer <smeyer@databay>

Version: $Id$

Definition at line 17 of file class.ilSaxParser.php.

Member Function Documentation

◆ createParser()

ilSaxParser::createParser ( )

create parser

@access private

Exceptions

ilSaxParserException or ILIAS Error

Definition at line 135 of file class.ilSaxParser.php.

        {
                $xml_parser = xml_parser_create("UTF-8");
 
                if($xml_parser == false)
                {
                        $this->handleError("Cannot create an XML parser handle",$this->ilias->error_obj->FATAL);
                }
                return $xml_parser;
        }

References handleError().

Referenced by startParsing().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ freeParser()

ilSaxParser::freeParser ( $a_xml_parser )

free xml parser handle

@access private

Definition at line 239 of file class.ilSaxParser.php.

        {
                if(!xml_parser_free($a_xml_parser))
                {
                        $this->ilias->raiseError("Error freeing xml parser handle ",$this->ilias->error_obj->FATAL);
                }
        }

Referenced by startParsing().

Here is the caller graph for this function:

◆ getInputType()

ilSaxParser::getInputType ( )

Definition at line 94 of file class.ilSaxParser.php.

        {
                return $this->input_type;
        }

References $input_type.

Referenced by ilXMLChecker\parse(), SurveyImportParser\parse(), SurveyImportParserPre38\parse(), parse(), and startParsing().

Here is the caller graph for this function:

◆ getXMLContent()

ilSaxParser::getXMLContent ( )

Definition at line 89 of file class.ilSaxParser.php.

        {
                return $this->xml_content;
        }

References $xml_content.

Referenced by ilXMLChecker\parse(), SurveyImportParser\parse(), SurveyImportParserPre38\parse(), and parse().

Here is the caller graph for this function:

◆ handleError()

ilSaxParser::handleError	(	$message,
		$code
	)

protected

use given error handler to handle error message or internal ilias error message handle

Parameters

string	$message
string	$code

Exceptions

ilSaxParserException or ILIAS Error

Definition at line 218 of file class.ilSaxParser.php.

                                                        {
                if ($this->throwException) {
                        require_once ('./Services/Xml/exceptions/class.ilSaxParserException.php');                      
                        throw new ilSaxParserException ($message, $code);
                } else {
                        if (is_object($this->ilias))
                        {
                                $this->ilias->raiseError($message, $code);
                        }
                        else
                        {
                                die($message);
                        }
                }
                return false;
        }

References $code.

Referenced by createParser(), openXMLFile(), parse(), and startParsing().

Here is the caller graph for this function:

◆ ilSaxParser()

ilSaxParser::ilSaxParser	(	$a_xml_file = `''`,
		$throwException = `false`
	)

Constructor setup ILIAS global object @access public.

Definition at line 68 of file class.ilSaxParser.php.

        {
                global $ilias, $lng;
 
                if($a_xml_file)
                {
                        $this->xml_file = $a_xml_file;
                        $this->input_type = 'file';
                }
 
                $this->throwException = $throwException;
                $this->ilias = &$ilias;
                $this->lng = &$lng;
        }

References $ilias, $lng, and $throwException.

◆ openXMLFile()

ilSaxParser::openXMLFile ( )

open xml file

@access private

Exceptions

ilSaxParserException or ILIAS Error

Reimplemented in ilQTIParser.

Definition at line 169 of file class.ilSaxParser.php.

        {
                if(!($fp = fopen($this->xml_file,'r')))
                {
                        $this->handleError("Cannot open xml file \"".$this->xml_file."\"",$this->ilias->error_obj->FATAL);
                }
                return $fp;
        }

References handleError().

Referenced by startParsing().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parse()

ilSaxParser::parse	(	$a_xml_parser,
		$a_fp = `null`
	)

parse xml file

@access private

Exceptions

ilSaxParserException or ILIAS Error

Reimplemented in ilXMLChecker, SurveyImportParser, SurveyImportParserPre38, and ilObjectXMLParser.

Definition at line 183 of file class.ilSaxParser.php.

        {
                switch($this->getInputType())
                {
                        case 'file':
 
                                while($data = fread($a_fp,4096))
                                {
                                        $parseOk = xml_parse($a_xml_parser,$data,feof($a_fp));
                                }
                                break;
                                
                        case 'string':
                                $parseOk = xml_parse($a_xml_parser,$this->getXMLContent());
                                break;
                }
                if(!$parseOk
                   && (xml_get_error_code($a_xml_parser) != XML_ERROR_NONE))
                {
                        $errorCode = xml_get_error_code($a_xml_parser);
                        $line = xml_get_current_line_number($a_xml_parser);
                        $col = xml_get_current_column_number($a_xml_parser);                    
                        $this->handleError("XML Parse Error: ".xml_error_string($errorCode)." at line ".$line.", col ". $col . " (Code: ".$errorCode.")" ,$this->ilias->error_obj->FATAL);
                }
                return true;
                                
        }

References $data, getInputType(), getXMLContent(), and handleError().

Referenced by startParsing().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setHandlers()

ilSaxParser::setHandlers ( $a_xml_parser )

set event handler should be overwritten by inherited class @access private

Reimplemented in ilCategoryImportParser, ilCategoryXmlParser, ilCourseXMLParser, ilExerciseXMLParser, ilFileXMLParser, ilFolderXmlParser, ilForumXMLParser, ilGroupXMLParser, ilContObjParser, ilSCORMPackageParser, ilTestResultsImportParser, ilWebLinkXmlParser, ilAdvancedMDParser, ilXMLChecker, ilPluginReader, ilContainerReferenceXmlParser, ilTableDataParser, ilDataSetImportParser, ilExportFileParser, ilManifestParser, ilMailImportParser, ilMDSaxParser, ilMDXMLCopier, ilMDXMLParser, ilQTIParser, ilStyleDefinition, ilStyleImportParser, SurveyImportParser, SurveyImportParserPre38, ilUserImportParser, ilModuleReader, ilObjDefReader, ilServiceReader, ilCopyWizardSettingsXMLParser, ilObjectXMLParser, ilSoapMailXmlParser, ilXMLResultSetParser, and ilObjQuestionPoolXMLParser.

Definition at line 159 of file class.ilSaxParser.php.

        {
                echo 'ilSaxParser::setHandlers() must be overwritten';
        }

Referenced by startParsing().

Here is the caller graph for this function:

◆ setOptions()

ilSaxParser::setOptions ( $a_xml_parser )

set parser options

@access private

Definition at line 150 of file class.ilSaxParser.php.

        {
                xml_parser_set_option($a_xml_parser,XML_OPTION_CASE_FOLDING,false);
        }

Referenced by startParsing().

Here is the caller graph for this function:

◆ setThrowException()

ilSaxParser::setThrowException ( $throwException )

set error handling

Parameters

$error_handler

Definition at line 252 of file class.ilSaxParser.php.

        {
                $this->throwException = $throwException;
        }

References $throwException.

Referenced by ilSoapMailXmlParser\__construct(), ilFolderXmlParser\__construct(), and ilWebLinkXmlParser\__construct().

Here is the caller graph for this function:

◆ setXMLContent()

ilSaxParser::setXMLContent ( $a_xml_content )

Reimplemented in ilQTIParser.

Definition at line 83 of file class.ilSaxParser.php.

        {
                $this->xml_content = $a_xml_content;
                $this->input_type = 'string';
        }

Referenced by ilDataSetImportParser\__construct(), ilSoapMailXmlParser\__construct(), ilCategoryXmlParser\__construct(), ilContainerReferenceXmlParser\__construct(), ilFolderXmlParser\__construct(), ilForumXMLParser\__construct(), ilWebLinkXmlParser\__construct(), ilCopyWizardSettingsXMLParser\ilCopyWizardSettingsXMLParser(), ilExerciseXMLParser\ilExerciseXMLParser(), ilFileXMLParser\ilFileXMLParser(), ilGroupXMLParser\ilGroupXMLParser(), ilMDXMLCopier\ilMDXMLCopier(), ilMDXMLParser\ilMDXMLParser(), ilObjectXMLParser\ilObjectXMLParser(), and ilXMLResultSetParser\ilXMLResultSetParser().

Here is the caller graph for this function:

◆ startParsing()

ilSaxParser::startParsing ( )

stores xml data in array

@access private

Exceptions

ilSaxParserException or ILIAS Error

Reimplemented in ilCategoryImportParser, ilCategoryXmlParser, ilGroupXMLParser, ilContObjParser, ilSCORMPackageParser, ilXMLChecker, ilPluginReader, ilContainerReferenceXmlParser, ilSimpleXMLTableDataParser, ilDataSetImportParser, ilExportFileParser, ilManifestParser, ilMailImportParser, ilQTIParser, ilStyleImportParser, SurveyImportParser, SurveyImportParserPre38, and ilUserImportParser.

Definition at line 105 of file class.ilSaxParser.php.

        {
                $xml_parser = $this->createParser();
                $this->setOptions($xml_parser);
                $this->setHandlers($xml_parser);
 
                switch($this->getInputType())
                {
                        case 'file':
                                $fp = $this->openXMLFile();
                                $this->parse($xml_parser,$fp);
                                break;
 
                        case 'string':
                                $this->parse($xml_parser);
                                break;
 
                        default:
                                $this->handleError("No input type given. Set filename in constructor or choose setXMLContent()",
                                                                                 $this->ilias->error_obj->FATAL);
                                break;
                }
                $this->freeParser($xml_parser);
        }