PEAR Handbuch
ZurückNach vorne

Auto Form Utilities, Validation, Autoloading

Auto Form Utilities, Validation, Autoloading  --  ::setFrom(), ::validate(), and DB_DataObject::staticAutoLoad()

::setFrom()

Copies data from an Array or object into the current object

::setFrom ((Array or Object) from)

copies all the data that relates to this table (Except keys) into the current object

Beispiel 1. Copying data from post or object

$person = new DataObjects_Person;
$person->get(12);
$person->setFrom($_POST['input']);
$person->update();


// or copying from another object
$personA = new DataObjects_Person;
$personA->get(12);

$personB = new DataObjects_Person;
$personB->get(12);

$personA->setFrom($personB);
$person->update();

Copies all the data (with names the of this objects columns) from another object or array into this one.

::validate()

Either validates data as Integers or strings, otherwise calls user defined validation methods

(mixed boolean or array)::validate ()

check all the objects variables to see if they are valid, by default this means is a column an integer or string, if you define methods like validateEmail(), in your extended class then it will be called to validate that rows data.

Note: that this validation depends on the PEAR validation package

Beispiel 2. validate usage

$person = new DataObjects_Person;
$person->get(12);
$person->setFrom($_POST['input']);
$val = $person->validate();
if ($val === TRUE) {
  $person->update();
} else {
  foreach ($val as $k=>$v) {
    if ($v) {
      echo "there was something wrong with ($k)";
    }
  }
}

To add a validation routine to your extended class you should create a method with the name, ValidateXXXXXXX where XXXXX is the name of the row to validate.

Beispiel 3. validate methods

/* inside class DataObject_Person */
function validateEmail() {
  return Validate::email($this->email, true);
}

function validateHomepage() {
  return Validate::url($this->homepage, true);
}
function validateDate() {
  return Validate::date($this->date, "%d-%m-%Y", array(01,01,1970), array(01,01,2030));
}
Refer to the Validation package for more details on Validation methods.

::staticAutoloadTable()

automatically load (include a DataObject class)

string classname::staticAutoLoadTable (string tablename)

based on the config file, automatically includes the class definition for a table and returns the class name

Beispiel 4. Auto loading a tables class 

$personclass = DB_DataObject::staticAutoloadTable('person');
if (!$personclass) {
  echo "NO PERSON TABLE exists..";
  exit;
}

$person = new $personclass
$person->get(12);

ZurückZum AnfangNach vorne
Automatic Table LinkingNach obenDebugging