CLICK HERE TO BUY IT TODAY! OR GET IT FREE VIA TRIALPAY  

PHP Demo Application - Source Code

/Application/Model/DataObjects/Sample/_Sample.php

<?php
/**
* Script Contents: Apeel_Application_Model_DataObjects_XXX Class
* Extends Apeel_Application_Model_DataObjects_Connection Class
* (replace XXX with name of Data Object)
* @package Apeel_Application_Model_DataObjects
*/

/**
* Main Data Object for XXX
* which manipulates data derived from one or more database tables. 

* The core abstract class contains all the PDO code for connecting to the 
* database, reading and writing data.  

* This concrete class contain the specifics of which tables/fields to read, 
* what kind of editor should be used with each field  (e.g. text box, dropdown,
* autocomplete etc) and could represent (for example) the data required to 
* populate a data entry form, or a grid, or to populate a drop down list, or 
* any other use you can think of.  

* The structure of Data Objects is based on the Template Design Pattern.  
*
* @package      Apeel_Application_Model_DataObjects
* @version      1.1.0
* @author       John W. King (email: contact@apeelframework.net)
* @copyright    City Business Logic Limited 2001-2011
* @license      Dual MIT / GNU Lesser General Public License Version 3
*/
class Apeel_Application_Model_DataObjects_XXX extends Apeel_Application_Model_DataObjects_Connection {
    
    
/**
    * Return SQL SELECT clause.  
    * 
    * @return string 
    */
    
protected function getSelect() {
        
// Return the SELECT part of the SQL statement, e.g.
        // return 'SELECT table1.field1, table1.field2, table2.field3';
        // The binary upload mechanism expects upload fields to have an additional field containing the 
        // length of the field, with the suffix _length so for example if your upload field was called Upload
        // you would have:
        //
        // SELECT
        //      Upload,
        //      LENGTH(Upload) AS Upload_length,
        //      ...

    
}
    
    
/**
    * Return SQL FROM clause.  
    * 
    * @return string 
    */
    
protected function getFrom() {
        
// Return the FROM part of the SQL statement, e.g.
        // return 'FROM table1 LEFT JOIN table2 ON table1.field = table2.field';

    
}
    
    
    
/**
    * Return shorthand PDO field type for given field.  
    * s = PDO::PARAM_STRING
    * i = PDO::PARAM_INT  
    * b = PDO::PARAM_BOOL
    * l = PDO::PARAM_LOB 
    * 
    * @param string $field
    * @return string
    */
    
public function getFieldDefinition($field) {
        
        
$definitions 
            array 
                (
                    
// e.g.                    
                    // "FIELDNAME1" => 's',
                    // "FIELDNAME2" => 'i',
                    // ...
                
)
                ;
                
        
// Check if requested field exists in the array.  
        
return Apeel_Framework_Controller_Libraries_Input::getArrayValueByIndexMustExist($definitions$field'Field Definitions');        
    }
    
    
    
/**
    * Stores blob and filename fieldnames for Binary Objects.  
    * Leave Array empty if none for this Data Object.  
    * 
    * @param integer $index
    * @return array
    */
    
public function getBinaryObjectDefinitions($index) {
        
$definitions 
            array (
            
                
// e.g.
                // "0" => array("contentField" => 'FIRSTBLOBFIELD', "filenameField" => 'FIRSTFILENAMEFIELD'),
                // "1" => array("contentField" => 'SECONDBLOBFIELD', "filenameField" => 'SECONDFILENAMEFIELD'),
                // ...
            
)
            ;
        
        
// Check if requested field exists in the array.  
        
return Apeel_Framework_Controller_Libraries_Input::getArrayValueByIndexMustExist($definitions$index'Binary Object Definitions');
    }
    
    
    
/**
    * Returns an array containing definitions of Multi Linked Objects 
    * (many-to-many relationships).  
    * 
    * return @array
    */
    
public function getMultiLinkedObjects() {
        
// e.g.
        //return array(array('object' => 'MIDDLE_TABLE_DATA_OBJECT', 'pkLink' => 'PRIMARY_KEY_IN_MIDDLE_TABLE_LINKED_TO_THIS_DATA_OBJECT'));
    
}
    
    
    
/**
    * Returns a string or an array containing one or more fieldnames that form 
    * the Primary key that identifies a unique row in this Data Object.  
    * 
    * @return string | array
    */
    
public function getPrimarykey() {
        
// e.g. 
        // return "FIELDNAME";
        // or
        // return array('FIELDNAME1', 'FIELDNAME2' ...)
        
    
}
    
    
    
/**
    * Returns a human-readable description of this Data Object
    * 
    * @return string
    */
    
public function getDataObjectName() {
        
// e.g.
        // return 'MY DATA OBJECT';
    
}
    
    
    
/**
    * Returns the name of the main table represented by this Data Object.  
    * 
    * @return string
    */
    
public function getMainTableName() {
        
// e.g. 
        // return 'MAINTABLE';
    
}        
}

?>

PHP Demo Source Code Index