SemanticMediaWiki/includes/SMW_SemanticData.php

Go to the documentation of this file.

<?php
class SMWSemanticData {

        static protected $mPropertyPrefix = '';

        public $stubObject;

        protected $mPropVals = array();

        protected $mProperties = array();

        protected $mHasVisibleProps = false;

        protected $mHasVisibleSpecs = false;

        protected $mNoDuplicates;

        protected $mSubject;

        public function __construct( SMWDIWikiPage $subject, $noDuplicates = true ) {
                $this->clear();
                $this->mSubject = $subject;
                $this->mNoDuplicates = $noDuplicates;
        }

        public function __sleep() {
                return array( 'mSubject' );
        }

        public function getSubject() {
                return $this->mSubject;
        }

        public function getProperties() {
                ksort( $this->mProperties, SORT_STRING );
                return $this->mProperties;
        }

        public function getPropertyValues( SMWDIProperty $property ) {
                if ( $property->isInverse() ) { // we never have any data for inverses
                        return array();
                }

                if ( array_key_exists( $property->getKey(), $this->mPropVals ) ) {
                        return $this->mPropVals[$property->getKey()];
                } else {
                        return array();
                }
        }

        public function getHash() {
                $ctx = hash_init( 'md5' );

                // here and below, use "_#_" to separate values; really not much care needed here
                hash_update( $ctx, '_#_' . $this->mSubject->getSerialization() );

                foreach ( $this->getProperties() as $property ) {
                        hash_update( $ctx, '_#_' . $property->getKey() . '##' );

                        foreach ( $this->getPropertyValues( $property ) as $di ) {
                                hash_update( $ctx, '_#_' . $di->getSerialization() );
                        }
                }

                return hash_final( $ctx );
        }

        public function hasVisibleProperties() {
                return $this->mHasVisibleProps;
        }

        public function hasVisibleSpecialProperties() {
                return $this->mHasVisibleSpecs;
        }

        public function addPropertyObjectValue( SMWDIProperty $property, SMWDataItem $dataItem ) {
                if ( $property->isInverse() ) { // inverse properties cannot be used for annotation
                        return;
                }

                if ( !array_key_exists( $property->getKey(), $this->mPropVals ) ) {
                        $this->mPropVals[$property->getKey()] = array();
                        $this->mProperties[$property->getKey()] = $property;
                }

                if ( $this->mNoDuplicates ) {
                        $this->mPropVals[$property->getKey()][$dataItem->getHash()] = $dataItem;
                } else {
                        $this->mPropVals[$property->getKey()][] = $dataItem;
                }

                if ( !$property->isUserDefined() ) {
                        if ( $property->isShown() ) {
                                $this->mHasVisibleSpecs = true;
                                $this->mHasVisibleProps = true;
                        }
                } else {
                        $this->mHasVisibleProps = true;
                }
        }

        public function addPropertyValue( $propertyName, SMWDataItem $dataItem ) {
                $propertyKey = smwfNormalTitleDBKey( $propertyName );

                if ( array_key_exists( $propertyKey, $this->mProperties ) ) {
                        $property = $this->mProperties[$propertyKey];
                } else {
                        if ( self::$mPropertyPrefix === '' ) {
                                global $wgContLang;
                                self::$mPropertyPrefix = $wgContLang->getNsText( SMW_NS_PROPERTY ) . ':';
                        } // explicitly use prefix to cope with things like [[Property:User:Stupid::somevalue]]

                        $propertyDV = SMWPropertyValue::makeUserProperty( self::$mPropertyPrefix . $propertyName );

                        if ( !$propertyDV->isValid() ) { // error, maybe illegal title text
                                return;
                        }
                        
                        $property = $propertyDV->getDataItem();
                }

                $this->addPropertyObjectValue( $property, $dataItem );
        }

        public function clear() {
                $this->mPropVals = array();
                $this->mProperties = array();
                $this->mHasVisibleProps = false;
                $this->mHasVisibleSpecs = false;
                $this->stubObject = false;
        }

        public function importDataFrom( SMWSemanticData $semanticData ) {
                // Shortcut when copying into empty objects that don't ask for more duplicate elimination:
                if ( count( $this->mProperties ) == 0 &&
                     ( $semanticData->mNoDuplicates >= $this->mNoDuplicates ) ) {
                        $this->mProperties = $semanticData->getProperties();
                        $this->mPropVals = array();
                        foreach ( $this->mProperties as $property ) {
                                $this->mPropVals[$property->getKey()] = $semanticData->getPropertyValues( $property );
                        }
                        $this->mHasVisibleProps = $semanticData->hasVisibleProperties();
                        $this->mHasVisibleSpecs = $semanticData->hasVisibleSpecialProperties();
                } else {
                        foreach ( $semanticData->getProperties() as $property ) {
                                $values = $semanticData->getPropertyValues( $property );
                                foreach ( $values as $dataItem ) {
                                        $this->addPropertyObjectValue( $property, $dataItem);
                                }
                        }
                }
        }

}

---