Source for file jDaoProperty.class.php

Documentation is available at jDaoProperty.class.php

  1. <?php
  2. /**
  3. @package     jelix
  4. @subpackage  dao
  5. @author      GĂ©rald Croes, Laurent Jouanneau
  6. @contributor Laurent Jouanneau
  7. @contributor Philippe Villiers
  8. @copyright   2001-2005 CopixTeam, 2005-2011 Laurent Jouanneau
  9. *  This class was get originally from the Copix project (CopixDAODefinitionV1, Copix 2.3dev20050901, http://www.copix.org)
  10. *  Few lines of code are still copyrighted 2001-2005 CopixTeam (LGPL licence).
  11. *  Initial authors of this Copix class are Gerald Croes and Laurent Jouanneau,
  12. *  and this class was adapted/improved for Jelix by Laurent Jouanneau
  13. *
  14. @link        http://www.jelix.org
  15. @licence  http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public Licence, see LICENCE file
  16. */
  17.  
  18. /**
  19.  * Container for properties of a dao property
  20.  * @package  jelix
  21.  * @subpackage dao
  22.  */
  23.  
  24. class jDaoProperty {
  25.     /**
  26.     * the name of the property of the object
  27.     */
  28.     public $name = '';
  29.  
  30.     /**
  31.     * the name of the field in table
  32.     */
  33.     public $fieldName = '';
  34.  
  35.     /**
  36.     * give the regular expression that needs to be matched against.
  37.     * @var string 
  38.     */
  39.     public $regExp = null;
  40.  
  41.     /**
  42.     * says if the field is required when doing a check
  43.     * @var boolean 
  44.     */
  45.     public $required = false;
  46.  
  47.     /**
  48.     * says if the value of the field is required when construct SQL conditions
  49.     * @var boolean 
  50.     */
  51.     public $requiredInConditions = false;
  52.  
  53.     /**
  54.     * Says if it's a primary key.
  55.     * @var boolean 
  56.     */
  57.     public $isPK = false;
  58.  
  59.     /**
  60.     * Says if it's a foreign key
  61.     * @var boolean 
  62.     */
  63.     public $isFK = false;
  64.  
  65.     public $datatype;
  66.  
  67.     public $unifiedType;
  68.  
  69.     public $table=null;
  70.     public $updatePattern='%s';
  71.     public $insertPattern='%s';
  72.     public $selectPattern='%s';
  73.     public $sequenceName='';
  74.  
  75.     /**
  76.     * the maxlength of the key if given
  77.     * @var int 
  78.     */
  79.     public $maxlength = null;
  80.     public $minlength = null;
  81.  
  82.     public $ofPrimaryTable = true;
  83.  
  84.     public $defaultValue = null;
  85.  
  86.     public $autoIncrement = false;
  87.     /**
  88.     * constructor.
  89.     * @param array  $attributes  list of attributes of a simpleXmlElement
  90.     * @param jDaoParser $parser the parser on the dao file
  91.     * @param jDbTools $tools 
  92.     */
  93.     function __construct ($aAttributes$parser$tools){
  94.         $needed array('name''fieldname''table''datatype''required',
  95.                         'minlength''maxlength''regexp''sequence''default''autoincrement');
  96.  
  97.         // Allowed attributes names
  98.         $allowed array('name''fieldname''table''datatype''required',
  99.                         'minlength''maxlength''regexp''sequence''default''autoincrement',
  100.                         'updatepattern''insertpattern''selectpattern');
  101.  
  102.         foreach($aAttributes as $attributeName => $attributeValue{
  103.             if(!in_array($attributeName$allowed)) {
  104.                 throw new jDaoXmlException ($parser->selector'unknown.attr'array($attributeName'property'));
  105.             }
  106.         }
  107.  
  108.         $params $parser->getAttr($aAttributes$needed);
  109.  
  110.         if ($params['name']===null){
  111.             throw new jDaoXmlException ($parser->selector'missing.attr'array('name''property'));
  112.         }
  113.         $this->name       = $params['name'];
  114.  
  115.         if(!preg_match('/^[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*$/'$this->name)){
  116.             throw new jDaoXmlException ($parser->selector'property.invalid.name'$this->name);
  117.         }
  118.  
  119.  
  120.         $this->fieldName  = $params['fieldname'!==null $params['fieldname'$this->name;
  121.         $this->table      = $params['table'!==null $params['table'$parser->getPrimaryTable();
  122.  
  123.         $tables $parser->getTables();
  124.  
  125.         if(!isset$tables[$this->table])){
  126.             throw new jDaoXmlException ($parser->selector'property.unknown.table'$this->name);
  127.         }
  128.  
  129.         $this->required   = $this->requiredInConditions = $parser->getBool ($params['required']);
  130.         $this->maxlength  = $params['maxlength'!== null intval($params['maxlength']null;
  131.         $this->minlength  = $params['minlength'!== null intval($params['minlength']null;
  132.         $this->regExp     = $params['regexp'];
  133.         $this->autoIncrement = $parser->getBool ($params['autoincrement']);
  134.  
  135.         if ($params['datatype']===null){
  136.             throw new jDaoXmlException ($parser->selector'missing.attr'array('datatype''property'));
  137.         }
  138.         $params['datatype'trim(strtolower($params['datatype']));
  139.  
  140.         if ($params['datatype'== ''{
  141.             throw new jDaoXmlException ($parser->selector'wrong.attr'array($params['datatype'],
  142.                                                            $this->fieldName,
  143.                                                            'property'));
  144.         }
  145.         $this->datatype = strtolower($params['datatype']);
  146.  
  147.         $ti $tools->getTypeInfo($this->datatype);
  148.         $this->unifiedType = $ti[1];
  149.         if (!$this->autoIncrement)
  150.             $this->autoIncrement = $ti[6];
  151.  
  152.         if ($this->unifiedType == 'integer' || $this->unifiedType == 'numeric'{
  153.             if ($params['sequence'!== null{
  154.                 $this->sequenceName = $params['sequence'];
  155.                 $this->autoIncrement = true;
  156.             }
  157.         }
  158.  
  159.         $this->isPK = in_array($this->fieldName$tables[$this->table]['pk']);
  160.         if(!$this->isPK && $this->table == $parser->getPrimaryTable()){
  161.             foreach($tables as $table=>$info{
  162.                 if ($table == $this->table)
  163.                     continue;
  164.                 if (isset($info['fk']&& in_array($this->fieldName$info['fk'])) {
  165.                     $this->isFK = true;
  166.                     break;
  167.                 }
  168.             }
  169.         }
  170.         else {
  171.             $this->required = true;
  172.             $this->requiredInConditions = true;
  173.         }
  174.  
  175.         if ($this->autoIncrement{
  176.             $this->required = false;
  177.             $this->requiredInConditions = true;
  178.         }
  179.  
  180.         if ($params['default'!== null{
  181.             $this->defaultValue = $tools->stringToPhpValue($this->unifiedType$params['default']);
  182.         }
  183.  
  184.         // insertpattern is allowed on primary keys noy autoincremented
  185.         if ($this->isPK && !$this->autoIncrement && isset($aAttributes['insertpattern'])) {
  186.             $this->insertPattern=(string)$aAttributes['insertpattern'];
  187.         }
  188.         if ($this->isPK{
  189.             $this->updatePattern = '';
  190.         }
  191.         // we ignore *pattern attributes on PK and FK fields
  192.         if (!$this->isPK && !$this->isFK{
  193.             if(isset($aAttributes['updatepattern'])) {
  194.                 $this->updatePattern=(string)$aAttributes['updatepattern'];
  195.             }
  196.  
  197.             if(isset($aAttributes['insertpattern'])) {
  198.                 $this->insertPattern=(string)$aAttributes['insertpattern'];
  199.             }
  200.  
  201.             if(isset($aAttributes['selectpattern'])) {
  202.                 $this->selectPattern=(string)$aAttributes['selectpattern'];
  203.             }
  204.         }
  205.  
  206.         // no update and insert patterns for field of external tables
  207.         if ($this->table != $parser->getPrimaryTable()) {
  208.             $this->updatePattern = '';
  209.             $this->insertPattern = '';
  210.             $this->required = false;
  211.             $this->requiredInConditions = false;
  212.             $this->ofPrimaryTable = false;
  213.         }
  214.         else {
  215.             $this->ofPrimaryTable=true;
  216.         }
  217.     }
  218. }

Documentation generated on Mon, 26 Oct 2015 21:52:53 +0100 by phpDocumentor 1.4.3