Class: I2CE FormFactory

This article desrcibes the class I2CE_FormFactory.

• Extends the class: I2CE_Fuzzy.
• Location: Part of the module forms in the package I2CE
• Source: Defined in the file modules/Forms/lib/I2CE_FormFactory.php
• Author: Luke Duncan <lduncan@intrahealth.org>
• Since: v1.0.0

This factory is used to create instances of I2CE_Form objects from the form name.

Variables

$instance

The single instance of this class.

• Type: static private I2CE_FormFactory $instance

$classes

The classes that have been registered with the factory.

• Type: private array $classes

Methods

__construct()

• Signature: public function __construct()

callStatic()

Call a static function in the form's class object.

• Signature: public function callStatic($form,$func,$args)
• Parameters:
  • string $form
    The name of the form.
  • string $func
    The function to be called.
  • array $args
    The arguments to pass to the function.
    • Default Value: array()

createForm()

Return an instance of a I2CE_Form from the factory.

• Signature: public function createForm($formId)
• Parameters:
  • string $formId
    The name of the form possible with an id
• Returns: I2CE_Form
  or null on failure

exists()

Checks to see if the given form has been registered.

• Signature: public function exists($form)
• Parameters:
  • string $form
    The name of the form.
• Returns: boolean

getClassHierarchy()

Get the class hierarchy associated to a class.

• Signature: public function getClassHierarchy($form)
• Parameters:
  • $form
• Returns: array
  The keys of the array range from 0 to N. The value of key 0 is the class associated to the form. The last key is has value 'I2CE_Form'. Returns null in error.

getClassName()

• Signature: public function getClassName($form)
• Parameters:
  • $form

getConst()

Shortcut to retrieving a constant value from a form's class object.

• Signature: public function getConst($form,$var)
• Parameters:
  • string $form
    The name of the form.
  • string $var
    The name of the constant.

getFieldNames()

Get the fields for a given form via what is stored in magic data. @param mixed $restict. Defaults to null which means there are no restrictions. Otherwise it should be an array consisting of any numbder of the following keys 'in_db', 'required', and 'unique' the values associated to each key should be true or false. We then only return fields who match the given value

• Signature: public function getFieldNames($form,$restrictions)
• Parameters:
  • string $form
    the short name of a form
  • $restrictions
    • Default Value: array()
• Returns: associative
  array of string. key is the field the value is the form class

getForms()

get the available forms.

• Signature: public function getForms()
• Returns: array
  with values the form name

getStatic()

Return a static variable from the form's class object.

• Signature: public function getStatic($form,$var,$const)
• Parameters:
  • string $form
    The name of the form.
  • string $var
    The name of the variable.
  • boolean $const
    Set to true to get a constant instead of a variable
    • Default Value: false

instance()

Return the instance of this factory and create it if it doesn't exist.

• Signature: static public function instance()

Inherited Fuzzy Methods

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()

Fuzzy Methods

getRecords()

This method is implemented by I2CE_FormStorage->getRecords()