Class: I2CE FormStorage multi flat: Difference between revisions

From IHRIS Wiki
No edit summary
No edit summary
Line 26: Line 26:
===__construct()===
===__construct()===
The constructor for the storage mechanism
The constructor for the storage mechanism
the same across all all forms which share a commone storage mechanisms
*Signature: public function __construct($name,$global_options)
*Signature: public function __construct($name,$global_options)
Parameters:
*Parameters:
* [http://www.php.net/manual/en/language.types.string.php string ] $name
** [http://www.php.net/manual/en/language.types.string.php string ] $name
* [http://www.php.net/manual/en/language.types.array.php array ] $global_options<br/>Default to empty array. The array of options that are
** [http://www.php.net/manual/en/language.types.array.php array ] $global_options <br/>Default to empty array. The array of options that are the same across all all forms which share a commone storage mechanisms
**Default Value: array()
***Default Value: array()
===fieldIsColumn()===
===fieldIsColumn()===
*Signature: protected function fieldIsColumn($data)
*Signature: protected function fieldIsColumn($data)
Parameters:
*Parameters:
*$data  
*$data  
===getFieldData()===
===getFieldData()===
*Signature: protected function getFieldData($data)
*Signature: protected function getFieldData($data)
Parameters:
*Parameters:
*$data  
*$data  
===getFormObj()===
===getFormObj()===
Get a (cached) form object for the given form
Get a (cached) form object for the given form
*Signature: protected function getFormObj($form)
*Signature: protected function getFormObj($form)
*Returns: [[Class: I2CE_Form | I2CE_Form]] or false on failure.
*Parameters:
Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $form
* [http://www.php.net/manual/en/language.types.string.php string ] $form
*Returns: [[Class: I2CE_Form | I2CE_Form]]<br/>or false on failure.
===getRequiredFieldsQuery()===
===getRequiredFieldsQuery()===
Construct a query (to be used as a sub-select) to view the fields of the given form.  It always will return the id of the form as well
Construct a query (to be used as a sub-select) to view the fields of the given form.  It always will return the id of the form as well @param callback $field_refernece_callback.  A callback function whose first arguement is the form, the second arguements is the field and which returns the way the field value should be references as a field.  If the callback is null (the default) then the reference used is "$form+$field"
If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id.
@param callback $field_refernece_callback.  A callback function whose first arguement is the form, the second arguements
is the field and which returns the way the field value should be references as a field.  If the callback is null (the default) then
the reference used is "$form+$field"
time greater than or equal to $mod_time.  If the form storage has no way of tracking modifucation time, all entries are listed.
*Signature: public function getRequiredFieldsQuery($form,$fields,$id,$parent,$field_reference_callback,$mod_time)
*Signature: public function getRequiredFieldsQuery($form,$fields,$id,$parent,$field_reference_callback,$mod_time)
*Returns: [http://www.php.net/manual/en/language.types.string.php string ] the query or false on failed.
*Parameters:
Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $form
* [http://www.php.net/manual/en/language.types.string.php string ] $form
** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $fields <br/>Either a string, the field, or an array of string, the fields.
* [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $fields<br/>Either a string, the field, or an array of string, the fields.
** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $id <br/>Defaults to null.  If non-null it is the id that we wish to limit to.
* [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $id<br/>Defaults to null.  If non-null it is the id that we wish to limit to.
***Default Value: null
**Default Value: null
** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $parent <br/>Defaults to false.  If true, we include the parent id as a referenced field If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id.
* [http://www.php.net/manual/en/language.types.boolean.php boolean ] $parent<br/>Defaults to false.  If true, we include the parent id as a referenced field
***Default Value: false
**Default Value: false
*$field_reference_callback  
*$field_reference_callback  
**Default Value: null
***Default Value: null
* integer $mod_time<br/>Defaults to -1.  If non-negative, we only list the requested fields for an id if at least one of them has a modification
** integer $mod_time <br/>Defaults to -1.  If non-negative, we only list the requested fields for an id if at least one of them has a modification time greater than or equal to $mod_time.  If the form storage has no way of tracking modifucation time, all entries are listed.
**Default Value: -1
***Default Value: -1
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]<br/>the query or false on failed.
===getStorageOptions()===
===getStorageOptions()===
Checks that the storage mechansim for the given form is 'multi_flat' and has storage options.
Checks that the storage mechansim for the given form is 'multi_flat' and has storage options.
*Signature: protected function getStorageOptions($form)
*Signature: protected function getStorageOptions($form)
*Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ] I2CE_MagicDataNode of flat storage options on success, false on failure.
*Parameters:
Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $form
* [http://www.php.net/manual/en/language.types.string.php string ] $form
*Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]<br/>I2CE_MagicDataNode of flat storage options on success, false on failure.
===isWritable()===
===isWritable()===
Checks to see if this storage mechansim is writable
Checks to see if this storage mechansim is writable
*Signature: public function isWritable()
*Signature: public function isWritable()
*Returns: boolean. false
*Returns: boolean.<br/>false
==Inherited Variables==
==Inherited Variables==
===$db===
===$db===

Revision as of 23:41, 16 October 2009

This article desrcibes the class I2CE_FormStorage_multi_flat.

@filesource Class I2CE_FormStorage_multi_flat

Variables

$storage_options_cache

of I2CE_MagicDataNodes. The keys are the names of forms which have flat storage.

  • Type: protected y $storage_options_cache

$databases

sting. Keys are componentities and values are the assoicated database

  • Type: protected y $databases

$componentized_forms

componentized_forms. The array of componentized forms

  • Type: protected y $componentized_forms

$formObjs

. Keys are form names, values are instanceof I2CE_Form

  • Type: protected y $formObjs

Methods

__construct()

The constructor for the storage mechanism

  • Signature: public function __construct($name,$global_options)
  • Parameters:
    • string $name
    • array $global_options
      Default to empty array. The array of options that are the same across all all forms which share a commone storage mechanisms
      • Default Value: array()

fieldIsColumn()

  • Signature: protected function fieldIsColumn($data)
  • Parameters:
  • $data

getFieldData()

  • Signature: protected function getFieldData($data)
  • Parameters:
  • $data

getFormObj()

Get a (cached) form object for the given form

  • Signature: protected function getFormObj($form)
  • Parameters:
  • Returns: I2CE_Form
    or false on failure.

getRequiredFieldsQuery()

Construct a query (to be used as a sub-select) to view the fields of the given form. It always will return the id of the form as well @param callback $field_refernece_callback. A callback function whose first arguement is the form, the second arguements is the field and which returns the way the field value should be references as a field. If the callback is null (the default) then the reference used is "$form+$field"

  • Signature: public function getRequiredFieldsQuery($form,$fields,$id,$parent,$field_reference_callback,$mod_time)
  • Parameters:
    • string $form
    • mixed $fields
      Either a string, the field, or an array of string, the fields.
    • mixed $id
      Defaults to null. If non-null it is the id that we wish to limit to.
      • Default Value: null
    • boolean $parent
      Defaults to false. If true, we include the parent id as a referenced field If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id.
      • Default Value: false
  • $field_reference_callback
      • Default Value: null
    • integer $mod_time
      Defaults to -1. If non-negative, we only list the requested fields for an id if at least one of them has a modification time greater than or equal to $mod_time. If the form storage has no way of tracking modifucation time, all entries are listed.
      • Default Value: -1
  • Returns: string
    the query or false on failed.

getStorageOptions()

Checks that the storage mechansim for the given form is 'multi_flat' and has storage options.

  • Signature: protected function getStorageOptions($form)
  • Parameters:
  • Returns: mixed
    I2CE_MagicDataNode of flat storage options on success, false on failure.

isWritable()

Checks to see if this storage mechansim is writable

  • Signature: public function isWritable()
  • Returns: boolean.
    false

Inherited Variables

$db

Theis protected variable is inherited from I2CE_FormStorage_DB->$db

$name

Theis protected variable is inherited from I2CE_FormStorage_Mechanism->$name

$global_options

Theis protected variable is inherited from I2CE_FormStorage_Mechanism->$global_options

$ordering

Theis protected variable is inherited from I2CE_FormStorage_Mechanism->$ordering

Inherited Fuzzy Methods

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()