XML writer class. More...

Inheritance diagram for ilFileXMLWriter:

Collaboration diagram for ilFileXMLWriter:

Public Member Functions
	ilFileXMLWriter ()
	constructor
	setFile (ilObjFile $file)
	setOmitHeader ($a_val)
	Set omit header.
	getOmitHeader ()
	Get omit header.
	setFileTargetDirectories ($a_rel, $a_abs)
	Set file target directories.
	setAttachFileContents ($attachFileContents)
	set attachment content mode
	start ()
	getXML ()
	__buildHeader ()
	__buildFooter ()
Public Member Functions inherited from ilXmlWriter
	ilXmlWriter ($version="1.0", $outEnc="utf-8", $inEnc="utf-8")
	constructor
	_ilXmlWriter ()
	destructor public
	xmlSetDtdDef ($dtdDef)
	Sets dtd definition.
	xmlSetStSheet ($stSheet)
	Sets stylesheet.
	xmlSetGenCmt ($genCmt)
	Sets generated comment.
	_xmlEscapeData ($data)
	Escapes reserved characters.
	xmlEncodeData ($data)
	Encodes text from input encoding into output encoding.
	xmlFormatData ($data)
	Indents text for better reading.
	xmlFormatElement ($array)
	Callback function for xmlFormatData; do not invoke directly.
	xmlHeader ()
	Writes xml header public.
	xmlStartTag ($tag, $attrs=NULL, $empty=FALSE, $encode=TRUE, $escape=TRUE)
	Writes a starttag.
	xmlEndTag ($tag)
	Writes an endtag.
	xmlComment ($comment)
	Writes a comment.
	xmlData ($data, $encode=TRUE, $escape=TRUE)
	Writes data.
	xmlElement ($tag, $attrs=NULL, $data=Null, $encode=TRUE, $escape=TRUE)
	Writes a basic element (no children, just textual content)
	xmlDumpFile ($file, $format=TRUE)
	Dumps xml document from memory into a file.
	xmlDumpMem ($format=TRUE)
	Returns xml document from memory.
	appendXML ($a_str)
	append xml string to document
	xmlClear ()
	clears xmlStr public

Data Fields
	$attachFileContents
	$file
	$omit_header = false
Data Fields inherited from ilXmlWriter
	$xmlStr
	$version
	$outEnc
	$inEnc
	$dtdDef = ""
	$stSheet = ""
	$genCmt = "Generated by ILIAS XmlWriter"

Static Public Attributes
static	$CONTENT_ATTACH_NO = 0
static	$CONTENT_ATTACH_ENCODED = 1
static	$CONTENT_ATTACH_ZLIB_ENCODED = 2
static	$CONTENT_ATTACH_GZIP_ENCODED = 3
static	$CONTENT_ATTACH_COPY = 4
static	$CONTENT_ATTACH_REST = 5

Detailed Description

XML writer class.

Class to simplify manual writing of xml documents. It only supports writing xml sequentially, because the xml document is saved in a string with no additional structure information. The author is responsible for well-formedness and validity of the xml document.

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

Version

Id:: class.ilExerciseXMLWriter.php,v 1.3 2005/11/04 12:50:24 smeyer Exp

Definition at line 21 of file class.ilFileXMLWriter.php.

Member Function Documentation

ilFileXMLWriter::__buildFooter ( )

Definition at line 227 of file class.ilFileXMLWriter.php.

Referenced by start().

        {
        }

Here is the caller graph for this function:

ilFileXMLWriter::__buildHeader ( )

Definition at line 215 of file class.ilFileXMLWriter.php.

References getOmitHeader(), ilXmlWriter\xmlHeader(), ilXmlWriter\xmlSetDtdDef(), and ilXmlWriter\xmlSetGenCmt().

Referenced by start().

        {
                if (!$this->getOmitHeader())
                {
                        $this->xmlSetDtdDef("<!DOCTYPE File PUBLIC \"-//ILIAS//DTD FileAdministration//EN\" \"".ILIAS_HTTP_PATH."/xml/ilias_file_3_8.dtd\">");
                        $this->xmlSetGenCmt("Exercise Object");
                        $this->xmlHeader();
                }
                return true;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilFileXMLWriter::getOmitHeader ( )

Get omit header.

Returns: boolean omit header

Definition at line 84 of file class.ilFileXMLWriter.php.

References $omit_header.

Referenced by __buildHeader().

        {
                return $this->omit_header;
        }

Here is the caller graph for this function:

ilFileXMLWriter::getXML ( )

Definition at line 209 of file class.ilFileXMLWriter.php.

References ilXmlWriter\xmlDumpMem().

        {
                return $this->xmlDumpMem(false);
        }

Here is the call graph for this function:

ilFileXMLWriter::ilFileXMLWriter ( )

constructor

Parameters

string	xml version
string	output encoding
string	input encoding public

Definition at line 56 of file class.ilFileXMLWriter.php.

References $CONTENT_ATTACH_NO, and ilXmlWriter\ilXmlWriter().

        {
                parent::ilXmlWriter();
                $this->attachFileContents = ilFileXMLWriter::$CONTENT_ATTACH_NO;
        }

Here is the call graph for this function:

ilFileXMLWriter::setAttachFileContents ( $attachFileContents )

set attachment content mode

Parameters

int $attachFileContents

Exceptions

ilExerciseException if mode is not supported

Definition at line 108 of file class.ilFileXMLWriter.php.

References $attachFileContents, $CONTENT_ATTACH_GZIP_ENCODED, $CONTENT_ATTACH_ZLIB_ENCODED, and ilFileException\$ID_DEFLATE_METHOD_MISMATCH.

        {
                 if ($attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_GZIP_ENCODED && !function_exists("gzencode"))
                 {
                      throw new ilFileException ("Inflating with gzip is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
         }
         if ($attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_ZLIB_ENCODED && !function_exists("gzcompress"))
         {
            throw new ilFileException ("Inflating with zlib (compress/uncompress) is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
         }
             $this->attachFileContents = $attachFileContents;
        }

ilFileXMLWriter::setFile ( ilObjFile $file )

Definition at line 63 of file class.ilFileXMLWriter.php.

References $file.

        {
                $this->file = & $file;
        }

ilFileXMLWriter::setFileTargetDirectories	(	$a_rel,
		$a_abs
	)

Set file target directories.

Parameters

string	relative file target directory
string	absolute file target directory

Definition at line 95 of file class.ilFileXMLWriter.php.

        {
                $this->target_dir_relative = $a_rel;
                $this->target_dir_absolute = $a_abs;
        }

ilFileXMLWriter::setOmitHeader ( $a_val )

Set omit header.

Parameters

boolean omit header

Definition at line 74 of file class.ilFileXMLWriter.php.

        {
                $this->omit_header = $a_val;
        }

ilFileXMLWriter::start ( )

Definition at line 122 of file class.ilFileXMLWriter.php.

References $CONTENT_ATTACH_COPY, $CONTENT_ATTACH_GZIP_ENCODED, $CONTENT_ATTACH_REST, $CONTENT_ATTACH_ZLIB_ENCODED, $filename, ilXmlWriter\$version, __buildFooter(), __buildHeader(), ilHistory\_getEntriesForObject(), ilUtil\date_mysql2time(), ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

        {
                $this->__buildHeader();
                $attribs =array (
                  "obj_id" => "il_".IL_INST_ID."_file_".$this->file->getId(),
                  "version" => $this->file->getVersion(),
                  "size" => $this->file->getFileSize(),
                  "type" => $this->file->getFileType()
                );
        $this->xmlStartTag("File", $attribs);
        $this->xmlElement("Filename",null,$this->file->getFileName());
                $this->xmlElement("Title",  null,$this->file->getTitle());
        $this->xmlElement("Description",  null,$this->file->getDescription());
        $this->xmlElement("Rating",  null,(int)$this->file->hasRating());
        if ($this->attachFileContents)
        {
            $filename = $this->file->getDirectory($this->file->getVersion())."/".$this->file->getFileName();
            if (@is_file($filename))
            {
                                if ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_COPY)
                                {
                                        $attribs = array("mode" =>"COPY");
                                        copy($filename, $this->target_dir_absolute."/".$this->file->getFileName());
                                        $content = $this->target_dir_relative."/".$this->file->getFileName();
                                        $this->xmlElement("Content",$attribs, $content);
                                }
                                // begin-patch fm
                                elseif($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_REST)
                                {
                                        $attribs = array('mode' => "REST");
                                        include_once './Services/WebServices/Rest/classes/class.ilRestFileStorage.php';
                                        $fs = new ilRestFileStorage();
                                        $tmpname = $fs->storeFileForRest(base64_encode(@file_get_contents($filename)));
                                        $this->xmlElement("Content",$attribs, $tmpname);
                                }
                                // end-patch fm
                                else
                                {
                                        $content = @file_get_contents($filename);
                                        $attribs = array("mode" =>"PLAIN");
                                        if ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_ZLIB_ENCODED)
                                        {
                                                $attribs ["mode"] ="ZLIB";
                                                $content = @gzcompress($content, 9);
                                        }elseif ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_GZIP_ENCODED)
                                        {
                                                $attribs ["mode"] ="GZIP";
                                                $content = @gzencode($content, 9);
                                        }
                                        $content = base64_encode($content);
                                        $this->xmlElement("Content",$attribs, $content);
                                }
            }
        }
        include_once("./Services/History/classes/class.ilHistory.php");
                $versions = ilHistory::_getEntriesForObject($this->file->getId(), $this->file->getType());
                if (count($versions)) {
                    $this->xmlStartTag("Versions");
                    foreach ($versions as $version) {
                        $info_params = $version["info_params"];
                        list($filename,$history_id) = split(",",$info_params);
                        $attribs = array (
                          "id" => $history_id,
                          "date" => ilUtil::date_mysql2time($version["date"]),
                          "usr_id" => "il_".IL_INST_ID."_usr_".$version["user_id"]
                        );
                        $this->xmlElement("Version", $attribs);
                    }
            $this->xmlEndTag("Versions");
                }
        $this->xmlEndTag("File");
                $this->__buildFooter();
                return true;
        }