ADT Active Record service wrapper class. More...

Inheritance diagram for ilADTActiveRecordWrapper:

Collaboration diagram for ilADTActiveRecordWrapper:

Public Member Functions
	__construct (ilADTGroupActiveRecordBridge $a_properties)
	Constructor. More...

	getConnectorContainerName ()

	getPrimaryFieldValue ()

	sleep ($field_name)

	wakeUp ($field_name, $field_value)

Public Member Functions inherited from ActiveRecord
	getArConnector ()

	getArFieldList ()

	getConnectorContainerName ()

	setConnectorContainerName ($connector_container_name)

	getPrimaryFieldValue ()

	setPrimaryFieldValue ($value)

	__construct ($primary_key=0, arConnector $connector=null)

	storeObjectToCache ()

	__getConvertedDateFieldsAsArray ($format=null)

	__asCsv ($separator=';', $header=false)

	__asArray ()

	__asStdClass ()

	__asSerializedObject ()

	buildFromArray (array $array)

	fixDateField ($field_name, $value)

	sleep ($field_name)

	wakeUp ($field_name, $field_value)

	getArrayForDb ()

	getArrayForConnector ()

	installConnector ()

	store ()

	save ()

	create ()

	copy ($new_id=0)

	afterObjectLoad ()

	read ()

	update ()

	delete ()

	__call ($name, $arguments)

Static Public Member Functions
static	returnDbTableName ()

Static Public Member Functions inherited from ActiveRecord
static	returnDbTableName ()

static	installDB ()

static	renameDBField ($old_name, $new_name)

static	tableExists ()

static	fieldExists ($field_name)

static	removeDBField ($field_name)

static	updateDB ()

static	resetDB ()

static	truncateDB ()

static	flushDB ()

static	preloadObjects ()

static	additionalParams (array $additional_params)

static	findOrFail ($primary_key, array $add_constructor_args=array())
	Tries to find the object and throws an Exception if object is not found, instead of returning null. More...

static	findOrGetInstance ($primary_key, array $add_constructor_args=array())

static	where ($where, $operator=null)

static	innerjoinAR (ActiveRecord $ar, $on_this, $on_external, $fields=array(' *'), $operator='=', $both_external=false)

static	innerjoin ($tablename, $on_this, $on_external, $fields=array(' *'), $operator='=', $both_external=false)

static	leftjoin ($tablename, $on_this, $on_external, $fields=array(' *'), $operator='=', $both_external=false)

static	orderBy ($orderBy, $orderDirection='ASC')

static	dateFormat ($date_format='d.m.Y - H:i:s')

static	limit ($start, $end)

static	affectedRows ()

static	count ()

static	get ()

static	debug ()

static	first ()

static	getCollection ()

static	last ()

static	getFirstFromLastQuery ()

static	connector (arConnector $connector)

static	raw ($set_raw=true)

static	getArray ($key=null, $values=null)

static	_toCamelCase ($str, $capitalise_first_char=false)

Protected Member Functions
	getActiveRecordFieldTypeFromMDB2 ($a_mdb2_type)

	initFieldList ()
	Get field list instance for ADT group. More...

Protected Member Functions inherited from ActiveRecord
	serializeToCSV ($field)
	This method is called for every field of your instance if you use __asCsv. More...

	installDatabase ()

Protected Attributes
	$properties

	$fields

	$field_element_map = []

Protected Attributes inherited from ActiveRecord
	$ar_safe_read = true

	$connector_container_name = ''

Additional Inherited Members
Data Fields inherited from ActiveRecord
const	ACTIVE_RECORD_VERSION = '2.0.7'

Static Protected Member Functions inherited from ActiveRecord
static	getCalledClass ()

static	fromCamelCase ($str)

Detailed Description

ADT Active Record service wrapper class.

:TODO: EXPERIMENTAL!

This class expects a valid primary for all actions!

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

Definition at line 17 of file class.ilADTActiveRecordWrapper.php.

Constructor & Destructor Documentation

◆ __construct()

ilADTActiveRecordWrapper::__construct ( ilADTGroupActiveRecordBridge $a_properties )

Constructor.

Parameters

ilADTGroupActiveRecordBridge $a_properties

Returns: self

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

References initFieldList(), and properties.

     {
         $this->properties = $a_properties;
         
         // see ActiveRecord::__construct();
         $this->initFieldList();
         $this->arConnector = new arConnectorDB();
     }

Here is the call graph for this function:

Member Function Documentation

◆ getActiveRecordFieldTypeFromMDB2()

ilADTActiveRecordWrapper::getActiveRecordFieldTypeFromMDB2 ( $a_mdb2_type )

protected

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

References arField\FIELD_TYPE_DATE, arField\FIELD_TYPE_FLOAT, arField\FIELD_TYPE_INTEGER, arField\FIELD_TYPE_TEXT, and arField\FIELD_TYPE_TIMESTAMP.

Referenced by initFieldList().

     {
         // currently they are all the same
         switch ($a_mdb2_type) {
             case "integer":
                 return arField::FIELD_TYPE_INTEGER;
                 
             case "float":
                 return arField::FIELD_TYPE_FLOAT;
                 
             case "text":
                 return arField::FIELD_TYPE_TEXT;
                 
             case "date":
                 return arField::FIELD_TYPE_DATE;
                 
             case "timestamp":
                 return arField::FIELD_TYPE_TIMESTAMP;
                 
             case "integer":
                 return arField::FIELD_TYPE_INTEGER;
                 
             /*
             case "clob":
                 return arField::FIELD_TYPE_CLOB;
 
             case "time":
                 return arField::FIELD_TYPE_TIME;
             */
         }
     }

Here is the caller graph for this function:

◆ getConnectorContainerName()

ilADTActiveRecordWrapper::getConnectorContainerName ( )

Definition at line 117 of file class.ilADTActiveRecordWrapper.php.

References properties.

     {
         return $this->properties->getTableName();
     }

◆ getPrimaryFieldValue()

ilADTActiveRecordWrapper::getPrimaryFieldValue ( )

Definition at line 127 of file class.ilADTActiveRecordWrapper.php.

References properties.

     {
         $primary = array_shift($this->properties->getPrimary());
         return $primary[1];
     }

◆ initFieldList()

ilADTActiveRecordWrapper::initFieldList ( )

protected

Get field list instance for ADT group.

Definition at line 78 of file class.ilADTActiveRecordWrapper.php.

References $fields, array, fields, getActiveRecordFieldTypeFromMDB2(), and properties.

Referenced by __construct().

     {
         require_once "Services/ActiveRecord/classes/Fields/class.arFieldList.php";
         $this->fields = new arFieldList();
 
         // element => fields
 
         $fields = array();
         foreach ($this->properties->getActiveRecordFields() as $element_id => $element_fields) {
             foreach ($element_fields as $field) {
                 $this->field_element_map[$field->getName()] = $element_id;
             }
 
             $fields = array_merge($fields, $element_fields);
         }
 
         $this->fields->setFields($fields);
 
         // primary
 
         if (sizeof($this->properties->getPrimary()) > 1) {
             throw new ilException("ilADTActiveRecordWrapper - no complex primary keys supported yet");
         }
 
         foreach ($this->properties->getPrimary() as $primary_id => $primary_element) {
             $field = new arField();
             $field->setHasField(true);
             $field->setNotNull(true);
             $field->setFieldType($this->getActiveRecordFieldTypeFromMDB2($primary_element[0]));
             $field->setName($primary_id);
             $this->fields->setPrimaryField($field);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ returnDbTableName()

static ilADTActiveRecordWrapper::returnDbTableName ( )

static

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

     {
         // :TODO: cannot be static
     }

◆ sleep()

ilADTActiveRecordWrapper::sleep ( $field_name )

Definition at line 138 of file class.ilADTActiveRecordWrapper.php.

References properties.

     {
         if (array_key_exists($field_name, $this->field_element_map)) {
             $element = $this->properties->getElement($this->field_element_map[$field_name]);
             return $element->getFieldValue($field_name);
         }
         
         // returning NULL would result in direct property access!
         return false;
     }

◆ wakeUp()

ilADTActiveRecordWrapper::wakeUp	(	$field_name,
		$field_value
	)

Definition at line 149 of file class.ilADTActiveRecordWrapper.php.

References properties.

     {
         if (array_key_exists($field_name, $this->field_element_map)) {
             $element = $this->properties->getElement($this->field_element_map[$field_name]);
             return $element->setFieldValue($field_name, $field_value);
         }
         
         // returning NULL would result in direct property access!
         return false;
     }

Field Documentation

◆ $field_element_map

ilADTActiveRecordWrapper::$field_element_map = []

protected

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

◆ $fields

ilADTActiveRecordWrapper::$fields

protected

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

Referenced by initFieldList().

◆ $properties

ilADTActiveRecordWrapper::$properties

protected

Definition at line 19 of file class.ilADTActiveRecordWrapper.php.

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

Services/ADT/classes/ActiveRecord/class.ilADTActiveRecordWrapper.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getActiveRecordFieldTypeFromMDB2()

◆ getConnectorContainerName()

◆ getPrimaryFieldValue()

◆ initFieldList()

◆ returnDbTableName()

◆ sleep()

◆ wakeUp()

Field Documentation

◆ $field_element_map

◆ $fields

◆ $properties