Ontology.php

Go to the documentation of this file.

<?php
class Dataface_Ontology {

        var $table;
        var $attributes;
        var $fieldnames;
        var $relationships;
        
        function Dataface_Ontology($tablename){
                $this->table =& Dataface_Table::loadTable($tablename);
        }
        
        function &getAttributes(){
                if ( !isset($this->attributes) ){
                        $this->buildAttributes();
                }
                return $this->attributes;
        }
        
        function &getAttribute($name){
                $atts =& $this->getAttributes();
                if ( !isset($atts[$name]) ){
                        return PEAR::raiseError("No attribute '$name' exists in this Ontology.", DATAFACE_E_ERROR);             
                }
                return $atts[$name];
        }
        
        function &newIndividual(&$record){
                $ind = new Dataface_Ontology_individual($this, $record);
                return $ind;
        }
        
        static function &newOntology($type, $tablename){
                $ontologies =& self::getRegisteredOntologies();
                if ( !isset($ontologies[$type]) ){
                        return PEAR::raiseError("No ontology of type '$type' has been registered.", DATAFACE_E_ERROR);
                }
                import($ontologies[$type]['path']);
                $class = $ontologies[$type]['class'];
                $ont = new $class($tablename);
                return $ont;
        }
        
        public static function registerType($type, $path, $class){
                $ontologies =& self::getRegisteredOntologies();
                $ontologies[$type] = array('type'=>$type, 'path'=>$path, 'class'=>$class);
                return true;
        }
        
        public static function &getRegisteredOntologies(){
                static $ontologies = 0;
                if ( $ontologies === 0 ) $ontologies = array();
                return $ontologies;
        }
        
        function buildAttributes(){
                trigger_error("Please implement the ".__FUNCTION__." method", E_USER_ERROR);
        }
        
        function getFieldname($attname){
                if ( !isset($this->fieldnames) ){
                        // If the fieldNames map hasn't been created yet, we need to 
                        // tell the subclass to create it.  We can do this by calling
                        // getAttributes, which, in turn, calls buildAttributes()
                        // which should build both the attributes array and the 
                        // fieldNames array
                        $this->getAttributes();
                }
                
                if ( !isset($this->fieldnames) ){
                        throw new Exception("The fieldnames array has not been set so there is a problem with this Ontology.  An ontology should populate the fieldNames array inside its buildAttributes() method.  If it does not, then there is a problem.", DATAFACE_E_ERROR);
                }
                return @$this->fieldnames[$attname];
                
        }
        
        function _is($method, $attname){
                return $this->table->$method(
                        $this->getFieldname($attname)
                        );
        }
        
        function validate($attname, $value, $allowBlanks=true){
                if ( method_exists($this, 'validate_'.$attname) ){
                        $method = 'validate_'.$attname;
                        return $this->$method($value, $allowBlanks);
                } else {
                        if ( !$allowBlanks and !trim($value) ) return false;
                        else return true;
                }
        }
        
        function getType($attname){ return $this->_is('getType', $attname);}
        function isDate($attname){ return $this->_is('isDate', $attname);}
        function isBlob($attname){ return $this->_is(__FUNCTION__, $attname);}
        function isContainer($attname){ return $this->_is(__FUNCTION__, $attname);}
        function isPassword($attname){ return $this->_is(__FUNCTION__, $attname);}
        function isText($attname){ return $this->_is(__FUNCTION__, $attname);}
        function isXML($attname){ return $this->_is(__FUNCTION__, $attname);}
        function isChar($attname){ return $this->_is(__FUNCTION__, $attname);}
        function isInt($attname){ return $this->_is(__FUNCTION__, $attname);}
        function isFloat($attname){ return $this->_is(__FUNCTION__, $attname);}
        
        
}

class Dataface_Ontology_individual {
        var $record;
        var $ontology;
        
        function Dataface_Ontology_individual(&$ontology, &$record){
                $this->record =& $record;
                $this->ontology =& $ontology;
        }
        
        function _get($method, $attname){
                return $this->record->$method(
                        $this->ontology->getFieldname($attname)
                        );
        }
        function getValue($attname){return $this->_get('getValue',$attname);}
        function val($attname){ return $this->getValue($attname);}
        
        function display($attname){ return $this->_get('display',$attname);}
        function q($attname){ return $this->_get('q', $attname);}
        function qq($attname){ return $this->_get('qq', $attname);}
        function strval($attname){ return $this->_get('strval', $attname);}
        function getValueAsString($attname){ return $this->_get('getValueAsString', $attname);}
        function htmlValue($attname){ return $this->_get('htmlValue', $attname);}
        

}

?>