zRom_form Class Reference
[Request Object Model.]

Works as a container of GET/POST. More...

Inheritance diagram for zRom_form:

[legend]

Collaboration diagram for zRom_form:

[legend]

Public Member Functions
	zRom_form ($method=null)
	__construct ($method=null)
	Sets the Form Method First argument should be either get or post in any case if no arguments are given it would try to detect the form method.
	initValidator ($map_file)
	Initilizes the validation System.
	valueOf ($fieldName, $strict=false)
	Returns the value of a Form Field Name.
	isSubmitted ()
	Checks wheather or not form has been submitted.
Data Fields
	$items = array()
	$isValid = true
	$is_submited = false
	$frm_method

---

Detailed Description

Works as a container of GET/POST.

$request->get or $request->post both are actually an Instance of zRom_form Class. This class works like a Container or all Get or post Field(s). actually There is a composition relation between zRom_fields and zRom_form cause all fields are contained into zRom_form as a zRom_fields object

Definition at line 162 of file map.php.

---

Constructor & Destructor Documentation

zRom_form::__construct

(

$

method = null

)

Sets the Form Method First argument should be either get or post in any case if no arguments are given it would try to detect the form method.

Parameters:

$method

string

Reimplemented from validation.

Definition at line 184 of file map.php.

References validation::$method, and perror().

                                      {
    parent::__construct($method);
    //{ Make the $items array
    switch($method){
      case 'GET':
        if(count($_GET) >= 1){
          $this->items = $_GET;
          $this->is_submited = true;
        }else{
          $this->is_submited = false;
        }
        $this->frm_method = '_GET';
        break;
      case 'POST':
        if(count($_POST) >= 1){
          $this->items = $_POST;
          $this->is_submited = true;
        }else{
          $this->is_submited = false;
        }
        $this->frm_method = '_POST';
        break;
      default:
        perror('Invalid method name supplied');
    }
    //}
  }

Here is the call graph for this function:

---

Member Function Documentation

zRom_form::zRom_form

(

$

method = null

)

Definition at line 181 of file map.php.

References validation::$method, and zCore::__construct().

                                  {
    $this->__construct($method);
  }

Here is the call graph for this function:

zRom_form::initValidator

(

$

map_file

)

Initilizes the validation System.

Validates the form by the provided Validation Map Name.

Parameters:

$map_file

string Name of the Validation Map e.g. if the map Name is abcd.vld.map.php just specify ancd here

Definition at line 217 of file map.php.

References validationCore::$rules, zLogger::debug(), validationCore::errtext(), validationCore::isValid(), validationCore::parseCriteria(), and validationCore::validationStatus().

                                   {
    //load_module('validation');
    zLogger::debug("Initializing Validation(GET/POST) System reading ".$map_file, 'rom.validation');
    $this->isValid = false;
    $this->parseCriteria($map_file);
    $this->isValid = $this->isValid();
    foreach($this->rules as $field_name => $rules){
      $field_name = str_replace(' ', '_', $field_name);//Replace all SPACE with _
      $errText =  $this->errtext($field_name);
      $this->{$field_name} = &new zRom_fields($this->items[$field_name], $errText, $this->isValid($field_name), $this->validationStatus($field_name));
      $validString = ($this->isValid($field_name)) ? "Valid" : "InValid";
      zLogger::debug("Storing Form Field: $field_name Value:$field_name as $validString ErrText: ".$errText, 'rom.Validation');
      //}
    }
  }

Here is the call graph for this function:

zRom_form::valueOf	(	$	fieldName,
		$	strict = false
	)

Returns the value of a Form Field Name.

You can access get request parameters using $_GET/$_POST. However items/$_GET/$_POST is an associative array. If your error level is E_NOTICE PHP will fire Notice if you try to use items['someNonExistingField'] It will say index doesn't exist or similar Notice message. valueOf('fieldName') will also return value of that form field But if the form field doesn't exists it returns "" e.g. an empty string or false(if $strict is set to true) So PHP will not fire any Error message.

Parameters:

	$fieldName	string Name of teh form Field thats value you want to retrive
	$strict	boolean if set to true returns boolean false if the form field doesn't exists

Returns:

mixed

Definition at line 245 of file map.php.

                                             {
    return isset($this->items[$fieldName]) ? $this->items[$fieldName] : ($strict ? false : "");
  }

zRom_form::isSubmitted

(

)

Checks wheather or not form has been submitted.

Returns boolean value wheather or not the form has been submitted. e.g. true if the form has been submitted else false

Returns:

boolean

Definition at line 255 of file map.php.

                        {
    return $this->is_submited;
  }

---

Field Documentation

zRom_form::$items = array()

Definition at line 169 of file map.php.

zRom_form::$isValid = true

Definition at line 177 of file map.php.

zRom_form::$is_submited = false

Definition at line 178 of file map.php.

zRom_form::$frm_method

Definition at line 179 of file map.php.

---

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

• map.php