git.roojs.org Git - Pman.Core/blob - RooPostTrait.php

   1 <?php
   2
   3 trait Pman_Core_RooPostTrait {
   4
   5     /**
   6      * POST method   Roo/TABLENAME
   7      * -- creates, updates, or deletes data.
   8      *
   9      * INSERT
  10      *    if the primary key is empty, this happens
  11      *    will automatically set these to current date and authUser->id
  12      *        created, created_by, created_dt
  13      *        updated, update_by, updated_dt
  14      *        modified, modified_by, modified_dt
  15      *
  16      *   will return a GET request SINGLE SELECT (and accepts same)
  17      *
  18      * DELETE
  19      *    _delete=1,2,3     delete a set of data.
  20      * UPDATE
  21      *    if the primary key value is set, then update occurs.
  22      *    will automatically set these to current date and authUser->id
  23      *        updated, update_by, updated_dt
  24      *        modified, modified_by, modified_dt
  25      *
  26      *
  27      * Params:
  28      *   _delete=1,2,3   causes a delete to occur.
  29      *   _ids=1,2,3,4    causes update to occur on all primary ids.
  30      *
  31      *  RETURNS
  32      *     = same as single SELECT GET request..
  33      *
  34      *
  35      *
  36      * DEBUGGING
  37      *   _debug=1    forces debug
  38      *   _get=1 - causes a get request to occur when doing a POST..
  39      *
  40      *
  41      * CALLS
  42      *   these methods on dataobjects if they exist
  43      *
  44      *   checkPerm('E' / 'D' , $authuser)
  45      *                      - can we list the stuff
  46      *                      - return false to disallow...
  47
  48      *   toRooSingleArray($authUser, $request) : array
  49      *                       - called on single fetch only, add or maniuplate returned array data.
  50      *   toRooArray($request) : array
  51      *                      - Called if toSingleArray does not exist.
  52      *                      - if you need to return different data than toArray..
  53      *
  54      *   toEventString()
  55      *                  (for logging - this is generically prefixed to all database operations.)
  56      *
  57      *
  58      *   onUpload($roo)
  59      *                  called when $_FILES is not empty
  60      *
  61      *
  62      *   setFromRoo($ar, $roo)
  63      *                      - alternative to setFrom() which is called if this method does not exist
  64      *                      - values from post (deal with dates etc.) - return true|error string.
  65      *                      - call $roo->jerr() on failure...
  66      *
  67      * CALLS BEFORE change occurs:
  68      *
  69      *      beforeDelete($dependants_array, $roo)
  70      *                      Argument is an array of un-find/fetched dependant items.
  71      *                      - jerr() will stop insert.. (Prefered)
  72      *                      - return false for fail and set DO->err;
  73      *
  74      *      beforeUpdate($old, $request,$roo)
  75      *                      - after update - jerr() will stop insert..
  76      *      beforeInsert($request,$roo)
  77      *                      - before insert - jerr() will stop insert..
  78      *
  79      *
  80      * CALLS AFTER change occured
  81      *
  82      *      onUpdate($old, $request,$roo)
  83      *               - after update // return value ignored
  84      *
  85      *      onInsert($request,$roo)
  86      *                  - after insert
  87      *
  88      *      onDelete($request, $roo) - after delete
  89      *
  90      */
  91
  92     function post($tab) // update / insert (?? delete??)
  93     {
  94         PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, array($this, 'onPearError'));
  95
  96         $this->checkDebug();
  97
  98         if (!empty($_REQUEST['_get'])) {
  99             return $this->get($tab);
 100         }
 101
 102         $this->init();
 103
 104         $x = $this->dataObject($tab);
 105
 106         $this->transObj = clone($x);
 107
 108         $this->transObj->query('BEGIN');
 109         // find the key and use that to get the thing..
 110         $keys = $x->keys();
 111         if (empty($keys) ) {
 112             $this->jerr('no key');
 113         }
 114
 115         $this->key = $keys[0];
 116
 117           // delete should be here...
 118         if (isset($_REQUEST['_delete'])) {
 119             // do we really delete stuff!?!?!?
 120             return $this->delete($x,$_REQUEST);
 121         }
 122
 123
 124         $old = false;
 125
 126         // not sure if this is a good idea here...
 127
 128         if (!empty($_REQUEST['_ids'])) {
 129             $ids = explode(',',$_REQUEST['_ids']);
 130             $x->whereAddIn($this->key, $ids, 'int');
 131             $ar = $x->fetchAll();
 132
 133             foreach($ar as $x) {
 134                 $this->update($x, $_REQUEST);
 135
 136             }
 137             // all done..
 138             $this->jok("UPDATED");
 139
 140
 141         }
 142
 143         if (!empty($_REQUEST[$this->key])) {
 144             // it's a create..
 145             if (!$x->get($this->key, $_REQUEST[$this->key]))  {
 146                 $this->jerr("Invalid request");
 147             }
 148             $this->jok($this->update($x, $_REQUEST));
 149         } else {
 150
 151             if (empty($_POST)) {
 152                 $this->jerr("No data recieved for inserting");
 153             }
 154
 155             $this->jok($this->insert($x, $_REQUEST));
 156
 157         }
 158
 159
 160
 161     }
 162 }