XML writer class. More...

Inheritance diagram for ilFileXMLWriter:

Collaboration diagram for ilFileXMLWriter:

Public Member Functions
	__construct ()
	constructor More...

	setFile (ilObjFile $file)

	setOmitHeader ($a_val)
	Set omit header. More...

	getOmitHeader ()
	Get omit header. More...

	setFileTargetDirectories ($a_rel, $a_abs)
	Set file target directories. More...

	setAttachFileContents ($attachFileContents)
	set attachment content mode More...

	start ()

	getXML ()

	__buildHeader ()

	__buildFooter ()

Public Member Functions inherited from ilXmlWriter
	__construct ($version="1.0", $outEnc="utf-8", $inEnc="utf-8")
	constructor More...

	_ilXmlWriter ()
	destructor @access public More...

	xmlSetDtdDef ($dtdDef)
	Sets dtd definition. More...

	xmlSetStSheet ($stSheet)
	Sets stylesheet. More...

	xmlSetGenCmt ($genCmt)
	Sets generated comment. More...

	xmlEncodeData ($data)
	Encodes text from input encoding into output encoding. More...

	xmlFormatData ($data)
	Indents text for better reading. More...

	xmlFormatElement ($array)
	Callback function for xmlFormatData; do not invoke directly. More...

	xmlHeader ()
	Writes xml header @access public. More...

	xmlStartTag ($tag, $attrs=null, $empty=false, $encode=true, $escape=true)
	Writes a starttag. More...

	xmlEndTag ($tag)
	Writes an endtag. More...

	xmlComment ($comment)
	Writes a comment. More...

	xmlData ($data, $encode=true, $escape=true)
	Writes data. More...

	xmlElement ($tag, $attrs=null, $data=null, $encode=true, $escape=true)
	Writes a basic element (no children, just textual content) More...

	xmlDumpFile ($file, $format=true)
	Dumps xml document from memory into a file. More...

	xmlDumpMem ($format=true)
	Returns xml document from memory. More...

	appendXML ($a_str)
	append xml string to document More...

	xmlClear ()
	clears xmlStr @access public More...

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

Additional Inherited Members
Static Public Member Functions inherited from ilXmlWriter
static	_xmlEscapeData ($data)
	Escapes reserved characters. More...

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.

Constructor & Destructor Documentation

◆ __construct()

ilFileXMLWriter::__construct ( )

constructor

Parameters

string	xml version
string	output encoding
string	input encoding

@access public

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

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

References $CONTENT_ATTACH_NO, and ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

◆ __buildFooter()

ilFileXMLWriter::__buildFooter ( )

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

226 {

227 }

Referenced by start().

Here is the caller graph for this function:

◆ __buildHeader()

ilFileXMLWriter::__buildHeader ( )

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

    {
        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;
    }

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

Referenced by start().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getOmitHeader()

ilFileXMLWriter::getOmitHeader ( )

Get omit header.

Returns: boolean omit header

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

    {
        return $this->omit_header;
    }

References $omit_header.

Referenced by __buildHeader().

Here is the caller graph for this function:

◆ getXML()

ilFileXMLWriter::getXML ( )

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

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

References ilXmlWriter\xmlDumpMem().

Here is the call graph for this function:

◆ setAttachFileContents()

ilFileXMLWriter::setAttachFileContents ( $attachFileContents )

set attachment content mode

Parameters

int $attachFileContents

Exceptions

ilExerciseException if mode is not supported

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

    {
        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;
    }

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

◆ setFile()

ilFileXMLWriter::setFile ( ilObjFile $file )

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

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

References $file.

◆ setFileTargetDirectories()

ilFileXMLWriter::setFileTargetDirectories	(	$a_rel,
		$a_abs
	)

Set file target directories.

Parameters

string	relative file target directory
string	absolute file target directory

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

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

◆ setOmitHeader()

ilFileXMLWriter::setOmitHeader ( $a_val )

Set omit header.

Parameters

boolean omit header

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

    {
        $this->omit_header = $a_val;
    }

◆ start()

ilFileXMLWriter::start ( )

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

    {
        $this->__buildHeader();
 
        $attribs = array(
            "obj_id" => "il_" . IL_INST_ID . "_file_" . $this->file->getId(),
            "version" => $this->file->getVersion(),
            "max_version" => $this->file->getMaxVersion(),
            "size" => $this->file->getFileSize(),
            "type" => $this->file->getFileType(),
            "action" => $this->file->getAction(),
        );
 
        $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());
 
        include_once("./Services/History/classes/class.ilHistory.php");
 
        $versions = $this->file->getVersions();
 
        if (count($versions)) {
            $this->xmlStartTag("Versions");
 
            foreach ($versions as $version) {
                $attribs = array(
                    "version" => $version["version"],
                    "max_version" => $version["max_version"],
                    "date" => ilUtil::date_mysql2time($version["date"]),
                    "usr_id" => "il_" . IL_INST_ID . "_usr_" . $version["user_id"],
                    "action" => $version["action"],
                    "rollback_version" => $version["rollback_version"],
                    "rollback_user_id" => $version["rollback_user_id"],
                );
 
                $content = "";
 
                if ($this->attachFileContents) {
                    $filename = $this->file->getFile($version["version"]);
 
                    if (@is_file($filename)) {
                        if ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_COPY) {
                            $attribs ["mode"] = "COPY";
                            $content = "/" . $version["version"] . "_" . $this->file->getFileName();
                            copy($filename, $this->target_dir_absolute . $content);
                            $content = $this->target_dir_relative . $content;
                        } // begin-patch fm
                        elseif ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_REST) {
                            $attribs ['mode'] = "REST";
                            include_once './Services/WebServices/Rest/classes/class.ilRestFileStorage.php';
                            $fs = new ilRestFileStorage();
                            $content = $fs->storeFileForRest(base64_encode(@file_get_contents($filename)));
                            ;
                        } // end-patch fm
                        else {
                            $content = @file_get_contents($filename);
                            $attribs ["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("Version", $attribs, $content);
            }
            $this->xmlEndTag("Versions");
        }
 
        $this->xmlEndTag("File");
 
        $this->__buildFooter();
 
        return true;
    }

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

Here is the call graph for this function:

Field Documentation

◆ $attachFileContents

ilFileXMLWriter::$attachFileContents

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

Referenced by setAttachFileContents().

◆ $CONTENT_ATTACH_COPY

ilFileXMLWriter::$CONTENT_ATTACH_COPY = 4

static

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

Referenced by ilFileExporter\getXmlRepresentation(), and start().

◆ $CONTENT_ATTACH_ENCODED

ilFileXMLWriter::$CONTENT_ATTACH_ENCODED = 1

static

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

◆ $CONTENT_ATTACH_GZIP_ENCODED

ilFileXMLWriter::$CONTENT_ATTACH_GZIP_ENCODED = 3

static

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

Referenced by setAttachFileContents(), and start().

◆ $CONTENT_ATTACH_NO

ilFileXMLWriter::$CONTENT_ATTACH_NO = 0

static

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

Referenced by __construct().

◆ $CONTENT_ATTACH_REST

ilFileXMLWriter::$CONTENT_ATTACH_REST = 5

static

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

Referenced by start().

◆ $CONTENT_ATTACH_ZLIB_ENCODED

ilFileXMLWriter::$CONTENT_ATTACH_ZLIB_ENCODED = 2

static

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

Referenced by setAttachFileContents(), and start().

◆ $file

ilFileXMLWriter::$file

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

Referenced by setFile().

◆ $omit_header

ilFileXMLWriter::$omit_header = false

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

Referenced by getOmitHeader().

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

Modules/File/classes/class.ilFileXMLWriter.php

Public Member Functions

Data Fields

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __buildFooter()

◆ __buildHeader()

◆ getOmitHeader()

◆ getXML()

◆ setAttachFileContents()

◆ setFile()

◆ setFileTargetDirectories()

◆ setOmitHeader()

◆ start()

Field Documentation

◆ $attachFileContents

◆ $CONTENT_ATTACH_COPY

◆ $CONTENT_ATTACH_ENCODED

◆ $CONTENT_ATTACH_GZIP_ENCODED

◆ $CONTENT_ATTACH_NO

◆ $CONTENT_ATTACH_REST

◆ $CONTENT_ATTACH_ZLIB_ENCODED

◆ $file

◆ $omit_header