ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
ilFileXMLWriter Class Reference

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 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 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 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
stringxml version
stringoutput encoding
stringinput encoding public

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

References $CONTENT_ATTACH_NO.

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

Member Function Documentation

◆ __buildFooter()

ilFileXMLWriter::__buildFooter ( )

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

Referenced by start().

228  {
229 
230  }
+ Here is the caller graph for this function:

◆ __buildHeader()

ilFileXMLWriter::__buildHeader ( )

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

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

Referenced by start().

216  {
217  if (!$this->getOmitHeader())
218  {
219  $this->xmlSetDtdDef("<!DOCTYPE File PUBLIC \"-//ILIAS//DTD FileAdministration//EN\" \"".ILIAS_HTTP_PATH."/xml/ilias_file_3_8.dtd\">");
220  $this->xmlSetGenCmt("Exercise Object");
221  $this->xmlHeader();
222  }
223 
224  return true;
225  }
xmlSetGenCmt($genCmt)
Sets generated comment.
xmlSetDtdDef($dtdDef)
Sets dtd definition.
getOmitHeader()
Get omit header.
xmlHeader()
Writes xml header public.
+ 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.

References $omit_header.

Referenced by __buildHeader().

85  {
86  return $this->omit_header;
87  }
+ Here is the caller graph for this function:

◆ getXML()

ilFileXMLWriter::getXML ( )

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

References ilXmlWriter\xmlDumpMem().

210  {
211  return $this->xmlDumpMem(false);
212  }
xmlDumpMem($format=TRUE)
Returns xml document from memory.
+ Here is the call graph for this function:

◆ setAttachFileContents()

ilFileXMLWriter::setAttachFileContents (   $attachFileContents)

set attachment content mode

Parameters
int$attachFileContents
Exceptions
ilExerciseExceptionif 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.

109  {
110  if ($attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_GZIP_ENCODED && !function_exists("gzencode"))
111  {
112  throw new ilFileException ("Inflating with gzip is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
113  }
114  if ($attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_ZLIB_ENCODED && !function_exists("gzcompress"))
115  {
116  throw new ilFileException ("Inflating with zlib (compress/uncompress) is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
117  }
118  $this->attachFileContents = $attachFileContents;
119  }
Class to report exception.

◆ setFile()

ilFileXMLWriter::setFile ( ilObjFile  $file)

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

References $file, and file.

64  {
65  $this->file = & $file;
66  }
Reload workbook from saved file

◆ setFileTargetDirectories()

ilFileXMLWriter::setFileTargetDirectories (   $a_rel,
  $a_abs 
)

Set file target directories.

Parameters
stringrelative file target directory
stringabsolute file target directory

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

96  {
97  $this->target_dir_relative = $a_rel;
98  $this->target_dir_absolute = $a_abs;
99  }

◆ setOmitHeader()

ilFileXMLWriter::setOmitHeader (   $a_val)

Set omit header.

Parameters
booleanomit header

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

75  {
76  $this->omit_header = $a_val;
77  }

◆ start()

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(), array, ilUtil\date_mysql2time(), file, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

123  {
124  $this->__buildHeader();
125 
126  $attribs =array (
127  "obj_id" => "il_".IL_INST_ID."_file_".$this->file->getId(),
128  "version" => $this->file->getVersion(),
129  "size" => $this->file->getFileSize(),
130  "type" => $this->file->getFileType()
131  );
132 
133  $this->xmlStartTag("File", $attribs);
134  $this->xmlElement("Filename",null,$this->file->getFileName());
135 
136  $this->xmlElement("Title", null,$this->file->getTitle());
137  $this->xmlElement("Description", null,$this->file->getDescription());
138  $this->xmlElement("Rating", null,(int)$this->file->hasRating());
139 
140  if ($this->attachFileContents)
141  {
142  $filename = $this->file->getDirectory($this->file->getVersion())."/".$this->file->getFileName();
143  if (@is_file($filename))
144  {
145  if ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_COPY)
146  {
147  $attribs = array("mode" =>"COPY");
148  copy($filename, $this->target_dir_absolute."/".$this->file->getFileName());
149  $content = $this->target_dir_relative."/".$this->file->getFileName();
150  $this->xmlElement("Content",$attribs, $content);
151  }
152  // begin-patch fm
153  elseif($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_REST)
154  {
155  $attribs = array('mode' => "REST");
156  include_once './Services/WebServices/Rest/classes/class.ilRestFileStorage.php';
157  $fs = new ilRestFileStorage();
158  $tmpname = $fs->storeFileForRest(base64_encode(@file_get_contents($filename)));
159  $this->xmlElement("Content",$attribs, $tmpname);
160  }
161  // end-patch fm
162  else
163  {
164  $content = @file_get_contents($filename);
165  $attribs = array("mode" =>"PLAIN");
166  if ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_ZLIB_ENCODED)
167  {
168  $attribs ["mode"] ="ZLIB";
169  $content = @gzcompress($content, 9);
170  }elseif ($this->attachFileContents == ilFileXMLWriter::$CONTENT_ATTACH_GZIP_ENCODED)
171  {
172  $attribs ["mode"] ="GZIP";
173  $content = @gzencode($content, 9);
174  }
175  $content = base64_encode($content);
176  $this->xmlElement("Content",$attribs, $content);
177  }
178  }
179 
180  }
181 
182  include_once("./Services/History/classes/class.ilHistory.php");
183 
184  $versions = ilHistory::_getEntriesForObject($this->file->getId(), $this->file->getType());
185 
186  if (count($versions)) {
187  $this->xmlStartTag("Versions");
188  foreach ($versions as $version) {
189  $info_params = $version["info_params"];
190  list($filename,$history_id) = explode(",",$info_params);
191  $attribs = array (
192  "id" => $history_id,
193  "date" => ilUtil::date_mysql2time($version["date"]),
194  "usr_id" => "il_".IL_INST_ID."_usr_".$version["user_id"]
195  );
196  $this->xmlElement("Version", $attribs);
197  }
198  $this->xmlEndTag("Versions");
199 
200  }
201 
202  $this->xmlEndTag("File");
203 
204  $this->__buildFooter();
205 
206  return true;
207  }
xmlStartTag($tag, $attrs=NULL, $empty=FALSE, $encode=TRUE, $escape=TRUE)
Writes a starttag.
xmlElement($tag, $attrs=NULL, $data=Null, $encode=TRUE, $escape=TRUE)
Writes a basic element (no children, just textual content)
xmlEndTag($tag)
Writes an endtag.
static date_mysql2time($mysql_date_time)
make time object from mysql_date_time
Reload workbook from saved file
static _getEntriesForObject($a_obj_id, $a_obj_type="")
get all history entries for an object
Create styles array
The data for the language used.
File storage handling.
+ Here is the call graph for this function:

Field Documentation

◆ $attachFileContents

ilFileXMLWriter::$attachFileContents

Definition at line 38 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 30 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 45 of file class.ilFileXMLWriter.php.

Referenced by setFile().

◆ $omit_header

ilFileXMLWriter::$omit_header = false

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

Referenced by getOmitHeader().


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