class.ilDataSet.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */

abstract class ilDataSet
{
        var $dircnt;
        
        function __construct()
        {
        }
        
        final public function init($a_entity, $a_target_release)
        {
                $this->entity = $a_entity;
                $this->target_release = $a_target_release;
                $this->data = array();
        }
        
        abstract public function getSupportedVersions($a_entity);
                
        abstract protected function getTypes($a_entity, $a_version);
        
        abstract protected function getXmlNamespace($a_entity, $a_target_release);
        
        abstract function readData($a_entity, $a_version, $a_ids);
        
        function setExportDirectories($a_relative, $a_absolute)
        {
                $this->relative_export_dir = $a_relative;
                $this->absolute_export_dir = $a_absolute;
        }

        function setImportDirectory($a_val)
        {
                $this->import_directory = $a_val;
        }

        function getImportDirectory()
        {
                return $this->import_directory;
        }

        function setDSPrefix($a_val)
        {
                $this->var = $a_val;
        }

        function getDSPrefix()
        {
                return $this->var;
        }

        function getDSPrefixString()
        {
                if ($this->getDSPrefix() != "")
                {
                        return $this->getDSPrefix().":";
                }
        }

        function getDirectDataFromQuery($a_query, $a_convert_to_leading_upper = true)
        {
                global $ilDB;
                
                $set = $ilDB->query($a_query);
                $this->data = array();
                while ($rec  = $ilDB->fetchAssoc($set))
                {
                        if ($a_convert_to_leading_upper)
                        {
                                $tmp = array();
                                foreach ($rec as $k => $v)
                                {
                                        $tmp[$this->convertToLeadingUpper($k)]
                                                = $v;
                                }
                                $rec = $tmp;
                        }

                        $this->data[] = $rec;
                }
        }

        function convertToLeadingUpper($a_str)
        {
                $a_str = strtoupper(substr($a_str, 0, 1)).substr($a_str, 1);
                while (is_int($pos = strpos($a_str, "_")))
                {
                        $a_str = substr($a_str, 0, $pos).
                                strtoupper(substr($a_str, $pos+1, 1)).
                                substr($a_str, $pos+2);
                }
                return $a_str;
        }

                        
        final function getJsonRepresentation()
        {
                if ($this->version === false)
                {
                        return false;
                }
                
                $arr["entity"] = $this->getJsonEntityName();
                $arr["version"] = $this->version;
                $arr["install_id"] = IL_INST_ID;
                $arr["install_url"] = ILIAS_HTTP_PATH;
                $arr["types"] = $this->getJsonTypes();
                $arr["set"] = array();
                foreach ($this->data as $d)
                {
                        $arr["set"][] = $this->getJsonRecord($d);
                }
                
                include_once("./Services/JSON/classes/class.ilJsonUtil.php");

                return ilJsonUtil::encode($arr);
        }

        final function getXmlRepresentation($a_entity, $a_target_release,
                $a_ids, $a_field = "", $a_omit_header = false, $a_omit_types = false)
        {       
                $this->dircnt = 1;
                
                // step 1: check target release and supported versions
                
                
                
                // step 2: init writer
                include_once "./Services/Xml/classes/class.ilXmlWriter.php";
                $writer = new ilXmlWriter();
                if (!$a_omit_header)
                {
                        $writer->xmlHeader();
                }
                
                // collect namespaces
                $namespaces = $prefixes = array();
                $this->getNamespaces($namespaces, $a_entity, $a_target_release);
                $atts = array("InstallationId" => IL_INST_ID,
                        "InstallationUrl" => ILIAS_HTTP_PATH, "TopEntity" => $a_entity);
                $cnt = 1;
                foreach ($namespaces as $entity => $ns)
                {
                        $prefix = "ns".$cnt;
                        $prefixes[$entity] = $prefix; 
//                      $atts["xmlns:".$prefix] = $ns;
                        $cnt++;
                }
                
                $writer->xmlStartTag($this->getDSPrefixString().'DataSet', $atts);
                
                // add types
                if (!$a_omit_types)
                {
                        $this->addTypesXml($writer, $a_entity, $a_target_release);
                }
                
                // add records
                $this->addRecordsXml($writer, $prefixes, $a_entity, $a_target_release, $a_ids, $a_field = "");
                
                
                $writer->xmlEndTag($this->getDSPrefixString()."DataSet");
//if ($a_entity == "mep")
//{
//      echo "<pre>".htmlentities($writer->xmlDumpMem(true))."</pre>"; exit;
//}
                return $writer->xmlDumpMem(false);
        }
        
        
        function addRecordsXml($a_writer, $a_prefixes, $a_entity, $a_target_release, $a_ids, $a_field = "")
        {
                $types = $this->getXmlTypes($a_entity, $a_target_release);
                
                $this->readData($a_entity, $a_target_release, $a_ids, $a_field);
                if (is_array($this->data))
                {               
                        foreach ($this->data as $d)
                        {
                                $a_writer->xmlStartTag($this->getDSPrefixString()."Rec",
                                        array("Entity" => $this->getXmlEntityName($a_entity, $a_target_release)));

                                // entity tag
                                $a_writer->xmlStartTag($this->getXmlEntityTag($a_entity, $a_target_release));

                                $rec = $this->getXmlRecord($a_entity, $a_target_release, $d);
                                foreach ($rec as $f => $c)
                                {
                                        switch ($types[$f])
                                        {
                                                case "directory":
                                                        if ($this->absolute_export_dir != "" && $this->relative_export_dir != "")
                                                        {
                                                                ilUtil::makeDirParents($this->absolute_export_dir."/dsDir_".$this->dircnt);
                                                                ilUtil::rCopy($c, $this->absolute_export_dir."/dsDir_".$this->dircnt);
//echo "<br>copy-".$c."-".$this->absolute_export_dir."/dsDir_".$this->dircnt."-";
                                                                $c = $this->relative_export_dir."/dsDir_".$this->dircnt;
                                                                $this->dircnt++;
                                                        }
                                                        break;
                                        }       
                                        // this changes schema/dtd
                                        //$a_writer->xmlElement($a_prefixes[$a_entity].":".$f,
                                        //      array(), $c);
                                        $a_writer->xmlElement($f, array(), $c);
                                }

                                $a_writer->xmlEndTag($this->getXmlEntityTag($a_entity, $a_target_release));

                                $a_writer->xmlEndTag($this->getDSPrefixString()."Rec");

                                // foreach record records of dependent entities (no record)
                                $deps = $this->getDependencies($a_entity, $a_target_release, $rec, $a_ids);
                                if (is_array($deps))
                                {
                                        foreach ($deps as $dp => $par)
                                        {
                                                $this->addRecordsXml($a_writer, $a_prefixes, $dp, $a_target_release, $par["ids"], $par["field"]);
                                        }
                                }
                        }
                }
                else if ($this->data === false)
                {
                        // false -> add records of dependent entities (no record)
                        $deps = $this->getDependencies($a_entity, $a_target_release, null, $a_ids);
                        if (is_array($deps))
                        {
                                foreach ($deps as $dp => $par)
                                {
                                        $this->addRecordsXml($a_writer, $a_prefixes, $dp, $a_target_release, $par["ids"], $par["field"]);
                                }
                        }
                }
        }
        
        private function addTypesXml($a_writer, $a_entity, $a_target_release)
        {
                $types = $this->getXmlTypes($a_entity, $a_target_release);
                
                // add types of current entity
                if (is_array($types))
                {
                        $a_writer->xmlStartTag($this->getDSPrefixString()."Types",
                                array("Entity" => $this->getXmlEntityName($a_entity, $a_target_release),
                                        "TargetRelease" => $a_target_release));
                        foreach ($this->getXmlTypes($a_entity, $a_target_release) as $f => $t)
                        {
                                $a_writer->xmlElement($this->getDSPrefixString().'FieldType',
                                        array("Name" => $f, "Type" => $t));
                        }
                        $a_writer->xmlEndTag($this->getDSPrefixString()."Types");
                }
                
                // add types of dependent entities
                $deps = $this->getDependencies($a_entity, $a_target_release, null, null);
                if (is_array($deps))
                {
                        foreach ($deps as $dp => $w)
                        {
                                $this->addTypesXml($a_writer, $dp, $a_target_release);
                        }
                }
                
        }
        
        function getNamespaces(&$namespaces, $a_entity, $a_target_release)
        {
                $ns = $this->getXmlNamespace($a_entity, $a_target_release);
                if ($ns != "")
                {
                        $namespaces[$a_entity] = $ns;
                }               
                // add types of dependent entities
                $deps = $this->getDependencies($a_entity, $a_target_release, null, null);
                if (is_array($deps))
                {
                        foreach ($deps as $dp => $w)
                        {
                                $this->getNamespaces($namespaces, $dp, $a_target_release);
                        }
                }
        }
        
        function getXmlRecord($a_entity, $a_version, $a_set)
        {
                return $a_set;
        }
        
        function getJsonRecord($a_set)
        {
                return $a_set;          
        }
        
        function getXmlTypes($a_entity, $a_version)
        {
                return $this->getTypes($a_entity, $a_version);
        }
        
        function getJsonTypes($a_entity, $a_version)
        {
                return $this->getTypes($a_entity, $a_version);
        }
        
        function getXMLEntityName($a_entity, $a_version)
        {
                return $a_entity;
        }

        function getXMLEntityTag($a_entity, $a_target_release)
        {
                return $this->convertToLeadingUpper($a_entity);
        }
        
        function getJsonEntityName($a_entity, $a_version)
        {
                return $a_entity;
        }
        
        function setImport($a_val)
        {
                $this->import = $a_val;
        }
        
        function getImport()
        {
                return $this->import;
        }
}

?>