Split the jqGrid code out a bit further, giving the application controller full responsibility for handling the jqGrid requests. Virtual functions have been added to allow a derived controller to customize this action as needed.

git-svn-id: file:///svn-source/pmgr/branches/ledger_transactions_20090605@111 97e9348a-65ac-dc4b-aefc-98561f571b83
This commit is contained in:
abijah
2009-06-14 00:53:08 +00:00
parent e7b4b21328
commit 90a16c721e
2 changed files with 193 additions and 87 deletions

View File

@@ -63,17 +63,75 @@ class AppController extends Controller {
* - Fetches the actual data requested by jqGrid as XML
*/
function jqGridData($model, $records, $query) {
function jqGridData() {
// Grab a copy of the parameters that control this request
$params = array();
if (isset($this->params['url']) && is_array($this->params['url']))
$params = $this->params['url'];
// Do any preliminary setup necessary
$this->jqGridDataSetup($params);
// Get the top level model for this grid
$model = $this->jqGridDataModel($params);
// Establish the basic query and conditions
$query = array_intersect_key($this->jqGridDataTables($params),
array('link'=>1, 'contain'=>1));
$query['conditions'] = $this->jqGridDataConditions($params);
// Get the number of records prior to pagination
$count = $this->jqGridDataRecordCount($params, $model, $query);
// Verify a few parameters and determine our starting row
$limit = $params['rows'];
$total = ($count < 0) ? 0 : ceil($count/$limit);
$page = ($params['page'] <= 1) ? 1 : (($params['page'] > $total) ? $total : $params['page']);
$start = $limit*$page - $limit;
$sidx = isset($params['sidx']) ? $params['sidx'] : '';
$sord = isset($params['sord']) ? ' ' . $params['sord'] : '';
// Grab the actual records taking pagination into account
$query['group'] = $model->alias . '.id';
$query['order'] = $sidx ? $sidx . $sord : null;
$query['limit'] = $start . ', ' . $limit;
$query['fields'] = $this->jqGridDataFields($params);
$results = $this->jqGridDataRecords($params, $model, $query);
// DEBUG PURPOSES ONLY
$params['query'] = $query;
// Finally, dump out the data
$this->jqGridDataOutputHeader($params);
echo "<?xml version='1.0' encoding='utf-8'?>\n";
echo "<rows>\n";
$this->jqGridDataOutputSummary($params, $page, $total, $count);
$this->jqGridDataOutputRecords($params, $model, $results);
echo "</rows>\n";
// Call out to finalize everything
$this->jqGridDataFinalize($params);
}
/**************************************************************************
**************************************************************************
**************************************************************************
* virtual: jqGridData* functions
* - These set up the context for the jqGrid data, and will
* need to be overridden in the derived class for anything
* other than the most basic of grids.
*/
function jqGridDataSetup(&$params) {
// Assume we're debugging.
// The actual jqGrid request will set this to false
$debug = true;
$model_alias = $model->alias;
$model_id = $model_alias . '.id';
if (isset($this->passedArgs['debug']))
$debug = $this->passedArgs['debug'];
$params['debug'] = $debug;
if (!$debug) {
$this->layout = null;
$this->autoLayout = false;
@@ -81,80 +139,96 @@ class AppController extends Controller {
Configure::write('debug', '0');
}
// Set up some defaults
$page = 1; // page number
$rows = 20; // rows in the grid - rowNum parameter
$sidx = $model_id; // sort column - index from colModel
$sord = 'ASC'; // sort order
// Extract the actual settings from the jqGrid request
if (isset($this->params['url']) && is_array($this->params['url']))
extract($this->params['url']);
// Unserialize our complex structure of fields
// This SHOULD be always set, except when debugging
if (isset($fields))
$fields = unserialize($fields);
if (isset($params['fields']))
$fields = unserialize($params['fields']);
else
$fields = array($model_id);
$fields = array($this->modelClass . '.id');
if (isset($_search) && $_search === 'true') {
$ops = array('eq' => array('op' => null, 'pre' => '', 'post' => ''),
'ne' => array('op' => '<>', 'pre' => '', 'post' => ''),
'lt' => array('op' => '<', 'pre' => '', 'post' => ''),
'le' => array('op' => '<=', 'pre' => '', 'post' => ''),
'gt' => array('op' => '>', 'pre' => '', 'post' => ''),
'ge' => array('op' => '>=', 'pre' => '', 'post' => ''),
'bw' => array('op' => 'LIKE', 'pre' => '', 'post' => '%'),
'ew' => array('op' => 'LIKE', 'pre' => '%', 'post' => ''),
'cn' => array('op' => 'LIKE', 'pre' => '%', 'post' => '%'),
);
$params['fields_str'] = $params['fields'];
$params['fields'] = $fields;
$op = $ops[$searchOper];
$field = $searchField . ($op['op'] ? ' '.$op['op'] : '');
$val = $op['pre'] . $searchString . $op['post'];
$query['conditions'][] = array($field => $val);
}
// Establish some defaults before extracting params
$params = array_merge(array('page' => 1,
'rows' => 20),
$params);
}
// Verify a few parameters and determine our starting row
$total = ($records < 0) ? 0 : ceil($records/$rows);
$page = ($page < 1) ? 1 : (($page > $total) ? $total : $page);
$start = $rows*$page - $rows;
function jqGridDataModel(&$params) {
return $this->{$this->modelClass};
}
// the actual query for the grid data
$query['group'] = $model_id;
$query['order'] = "$sidx $sord";
$query['limit'] = "$start, $rows";
$results = $model->find('all', $query);
function jqGridDataTables(&$params) {
return array('contain' => false);
}
if ($debug) {
function jqGridDataConditions(&$params) {
if (!isset($params['_search']) || $params['_search'] !== 'true')
return array();
$ops = array('eq' => array('op' => null, 'pre' => '', 'post' => ''),
'ne' => array('op' => '<>', 'pre' => '', 'post' => ''),
'lt' => array('op' => '<', 'pre' => '', 'post' => ''),
'le' => array('op' => '<=', 'pre' => '', 'post' => ''),
'gt' => array('op' => '>', 'pre' => '', 'post' => ''),
'ge' => array('op' => '>=', 'pre' => '', 'post' => ''),
'bw' => array('op' => 'LIKE', 'pre' => '', 'post' => '%'),
'ew' => array('op' => 'LIKE', 'pre' => '%', 'post' => ''),
'cn' => array('op' => 'LIKE', 'pre' => '%', 'post' => '%'),
);
$op = $ops[$params['searchOper']];
$field = $params['searchField'] . ($op['op'] ? ' '.$op['op'] : '');
$val = $op['pre'] . $params['searchString'] . $op['post'];
return array($field => $val);
}
function jqGridDataFields(&$params) {
return null;
}
function jqGridDataRecordCount(&$params, $model, $query) {
return $model->find('count', $query);
}
function jqGridDataRecords(&$params, $model, $query) {
return $model->find('all', $query);
}
function jqGridDataOutputHeader(&$params) {
if ($params['debug']) {
ob_start();
print_r(compact('records', 'rows', 'total', 'page', 'start'));
}
else {
header("Content-type: text/xml;charset=utf-8");
}
}
echo "<?xml version='1.0' encoding='utf-8'?>\n";
echo "<rows>\n";
/* echo " <req><![CDATA[\n" . print_r($this->params['url'], true) . "\n]]></req>\n"; */
/* echo " <query><![CDATA[\n" . print_r($query, true) . "\n]]></query>\n"; */
function jqGridDataOutputSummary(&$params, $page, $total, $records) {
echo " <params><![CDATA[\n" . print_r($params, true) . "\n]]></params>\n";
echo " <page>$page</page>\n";
echo " <total>$total</total>\n";
echo " <records>$records</records>\n";
}
foreach ($results AS $result) {
function jqGridDataOutputRecords(&$params, $model, $records) {
$model_alias = $model->alias;
foreach ($records AS $record) {
// Add the calculated fields (if any), to the model fields
if (isset($result[0]))
$result[$model_alias] += $result[0];
if (isset($record[0]))
$record[$model_alias] += $record[0];
echo " <row id='{$result[$model_alias]['id']}'>\n";
foreach ($fields AS $field) {
list($tbl, $col) = explode(".", $field);
if (isset($col))
$data = $result[$tbl][$col];
else
$data = $result[$model_alias][$tbl];
echo " <row id='{$record[$model_alias]['id']}'>\n";
foreach ($params['fields'] AS $field) {
if (preg_match("/\./", $field)) {
list($tbl, $col) = explode(".", $field);
$data = $record[$tbl][$col];
}
else {
$data = $record[$model_alias][$field];
}
// be sure to put text data in CDATA
if (preg_match("/^\d*$/", $data))
@@ -164,9 +238,10 @@ class AppController extends Controller {
}
echo " </row>\n";
}
echo "</rows>\n";
}
if ($debug) {
function jqGridDataFinalize(&$params) {
if ($params['debug']) {
$xml = ob_get_contents();
ob_end_clean();
@@ -177,6 +252,5 @@ class AppController extends Controller {
echo ("\n<PRE>\n$xml\n</PRE>\n");
}
}
}
?>