Collaboration diagram for ilObjectFactory:

Public Member Functions
	ObjectIdExists ($a_obj_id)
	check if obj_id exists. More...

	getObjectsForOwner ($object_type, $owner_id)
	returns all objects of an owner, filtered by type, objects are not deleted! More...

	getInstanceByObjId ($a_obj_id, $stop_on_error=true)
	get an instance of an Ilias object by object id More...

	getInstanceByRefId ($a_ref_id, $stop_on_error=true)
	get an instance of an Ilias object by reference id More...

	getTypeByRefId ($a_ref_id, $stop_on_error=true)
	get object type by reference id More...

Static Public Member Functions
static	getClassByType ($a_obj_type)
	Get class by type. More...

Detailed Description

Class ilObjectFactory.

This class offers methods to get instances of the type-specific object classes (derived from ilObject) by their object or reference id

Note: The term "Ilias objects" means all object types that are stored in the database table "object_data"

Author: Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

Definition at line 20 of file class.ilObjectFactory.php.

Member Function Documentation

◆ getClassByType()

static ilObjectFactory::getClassByType ( $a_obj_type )

static

Get class by type.

Returns

Definition at line 260 of file class.ilObjectFactory.php.

References $location.

Referenced by ilWorkspaceExplorer\__construct(), ilRepUtilGUI\confirmRemoveFromSystemObject(), ilWorkspaceTree\createTreeForUser(), ilAdministrationCommandGUI\delete(), ilObjStudyProgrammeTreeGUI\delete(), ilObject2GUI\deleteConfirmation(), ilObjectCopyGUI\saveSource(), ilObjectCopyGUI\saveTarget(), and ilRepUtilGUI\showDeleteConfirmation().

         {
                 global $objDefinition;
 
                 $location = $objDefinition->getLocation($a_obj_type);
                 $class_name = "ilObj".$objDefinition->getClassName($a_obj_type);
 
                 // create instance
                 include_once($location."/class.".$class_name.".php");
                 return $class_name;
         }

Here is the caller graph for this function:

◆ getInstanceByObjId()

ilObjectFactory::getInstanceByObjId	(	$a_obj_id,
		$stop_on_error = `true`
	)

get an instance of an Ilias object by object id

Parameters

int $obj_id object id

Returns: object instance of Ilias object (i.e. derived from ilObject)

Definition at line 72 of file class.ilObjectFactory.php.

References $ilDB, $location, DB_FETCHMODE_ASSOC, and exit.

         {
                 global $ilias, $objDefinition, $ilDB;
 
                 // check object id
                 if (!isset($a_obj_id))
                 {
                         $message = "ilObjectFactory::getInstanceByObjId(): No obj_id given!";
                         if ($stop_on_error === true)
                         {
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         #var_dump("<pre>",$message,"<pre>");
 
                         return false;
                 }
 
                 // read object data
                 $q = "SELECT * FROM object_data ".
                          "WHERE obj_id = ".$ilDB->quote($a_obj_id ,'integer');
                 $object_set = $ilias->db->query($q);
                 // check number of records
                 if ($object_set->numRows() == 0)
                 {
                         $message = "ilObjectFactory::getInstanceByObjId(): Object with obj_id: ".$a_obj_id." not found!";
                         if ($stop_on_error === true)
                         {
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         #var_dump("<pre>",$message,"<pre>");
                         return false;
                 }
 
                 $object_rec = $object_set->fetchRow(DB_FETCHMODE_ASSOC);
                 $class_name = "ilObj".$objDefinition->getClassName($object_rec["type"]);
                 
                 // check class
                 if ($class_name == "ilObj")
                 {
                         $message = "ilObjectFactory::getInstanceByObjId(): Not able to determine object ".
                                 "class for type".$object_rec["type"].".";
                         if ($stop_on_error === true)
                         {
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         return false;
                 }
 
                 // get location
                 $location = $objDefinition->getLocation($object_rec["type"]);
 
                 // create instance
                 include_once($location."/class.".$class_name.".php");
                 $obj = new $class_name(0, false);       // this avoids reading of data
                 $obj->setId($a_obj_id);
                 $obj->setObjDataRecord($object_rec);
                 $obj->read();
 
                 return $obj;
         }

Here is the caller graph for this function:

◆ getInstanceByRefId()

ilObjectFactory::getInstanceByRefId	(	$a_ref_id,
		$stop_on_error = `true`
	)

get an instance of an Ilias object by reference id

Parameters

int $obj_id object id

Returns: object instance of Ilias object (i.e. derived from ilObject)

Definition at line 143 of file class.ilObjectFactory.php.

References $ilDB, $location, $query, DB_FETCHMODE_ASSOC, and exit.

         {
                 global $ilias, $objDefinition, $ilDB;
 
                 // check reference id
                 if (!isset($a_ref_id))
                 {
                         if ($stop_on_error === true)
                         {
                                 $message = "ilObjectFactory::getInstanceByRefId(): No ref_id given!";
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         
                         return false;
                 }
 
                 // read object data
                 
                 $query = "SELECT * FROM object_data,object_reference ".
                         "WHERE object_reference.obj_id = object_data.obj_id ".
                         "AND object_reference.ref_id = ".$ilDB->quote($a_ref_id,'integer');
                 $object_set = $ilDB->query($query);
 
                 // check number of records
                 if ($object_set->numRows() == 0)
                 {
                         if ($stop_on_error === true)
                         {
                                 $message = "ilObjectFactory::getInstanceByRefId(): Object with ref_id ".$a_ref_id." not found!";
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         
                         return false;
                 }
 
                 $object_rec = $object_set->fetchRow(DB_FETCHMODE_ASSOC);
                 $class_name = "ilObj".$objDefinition->getClassName($object_rec["type"]);
 
                 // check class
                 if ($class_name == "ilObj")
                 {
                         if ($stop_on_error === true)
                         {
                                 $message = "ilObjectFactory::getInstanceByRefId(): Not able to determine object ".
                                                    "class for type".$object_rec["type"].".";
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         
                         return false;
                 }
 
                 // get location
                 $location = $objDefinition->getLocation($object_rec["type"]);
 
                 // create instance
                 include_once($location."/class.".$class_name.".php");
                 $obj = new $class_name(0, false);       // this avoids reading of data
                 $obj->setId($object_rec["obj_id"]);
                 $obj->setRefId($a_ref_id);
                 $obj->setObjDataRecord($object_rec);
                 $obj->read();
                 return $obj;
         }

Here is the caller graph for this function:

◆ getObjectsForOwner()

ilObjectFactory::getObjectsForOwner	(	$object_type,
		$owner_id
	)

returns all objects of an owner, filtered by type, objects are not deleted!

Parameters

unknown_type	$object_type
unknown_type	$owner_id

Returns: unknown

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

References $ilDB, $query, $res, and DB_FETCHMODE_ASSOC.

Referenced by ilSoapCourseAdministration\getCoursesForUser(), and ilSoapGroupAdministration\getGroupsForUser().

         {
                 global $ilias, $ilDB;
 
                 $query = "SELECT * FROM object_data,object_reference ".
                         "WHERE object_reference.obj_id = object_data.obj_id ".
                         " AND object_data.type=".$ilDB->quote($object_type,'text').
                         " AND object_data.owner = ".$ilDB->quote($owner_id,'integer');
                 $res = $ilDB->query($query);
 
                 $obj_ids = array();
                 while($object_rec = $res->fetchRow(DB_FETCHMODE_ASSOC)) {
                         $obj_ids [] = $object_rec["obj_id"];
                 }
                 
                 return $obj_ids;
                 
         }

Here is the caller graph for this function:

◆ getTypeByRefId()

ilObjectFactory::getTypeByRefId	(	$a_ref_id,
		$stop_on_error = `true`
	)

get object type by reference id

Parameters

int $obj_id object id

Returns: string object type

Definition at line 216 of file class.ilObjectFactory.php.

References $ilDB, DB_FETCHMODE_ASSOC, and exit.

Referenced by ilSoapAdministration\checkObjectAccess(), ilSoapObjectAdministration\copyObject(), ilCopyWizardSettingsXMLParser\handlerBeginTag(), ilSoapObjectAdministration\moveObject(), and ilSoapGroupAdministration\updateGroup().

         {
                 global $ilias, $objDefinition, $ilDB;
 
                 // check reference id
                 if (!isset($a_ref_id))
                 {
                         if ($stop_on_error === true)
                         {
                                 $message = "ilObjectFactory::getTypeByRefId(): No ref_id given!";
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         
                         return false;
                 }
 
                 // read object data
                 $q = "SELECT * FROM object_data ".
                          "LEFT JOIN object_reference ON object_data.obj_id=object_reference.obj_id ".
                          "WHERE object_reference.ref_id=".$ilDB->quote($a_ref_id,'integer');
                 $object_set = $ilias->db->query($q);
 
                 if ($object_set->numRows() == 0)
                 {
                         if ($stop_on_error === true)
                         {
                                 $message = "ilObjectFactory::getTypeByRefId(): Object with ref_id ".$a_ref_id." not found!";
                                 $ilias->raiseError($message,$ilias->error_obj->WARNING);
                                 exit();
                         }
                         
                         return false;
                 }
 
                 $object_rec = $object_set->fetchRow(DB_FETCHMODE_ASSOC);
                 return $object_rec["type"];
         }

Here is the caller graph for this function:

◆ ObjectIdExists()

ilObjectFactory::ObjectIdExists ( $a_obj_id )

check if obj_id exists.

To check for ref_ids use ilTree::isInTree()

Parameters

int $obj_id object id

Returns: bool

Definition at line 28 of file class.ilObjectFactory.php.

References $ilDB, $query, and $res.

         {
                 global $ilias, $ilDB;
 
                 $query = "SELECT * FROM object_data ".
                         "WHERE obj_id = ".$ilDB->quote($a_obj_id ,'integer');
 
                 $res = $ilias->db->query($query);
                 
                 return $res->numRows() ? true : false;
         }

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

Services/Object/classes/class.ilObjectFactory.php

Public Member Functions

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ getClassByType()

◆ getInstanceByObjId()

◆ getInstanceByRefId()

◆ getObjectsForOwner()

◆ getTypeByRefId()

◆ ObjectIdExists()