SemanticMediaWiki / SemanticExternalQueryLookup

src/DataValueDeserializer.php

<?php

namespace SEQL;

use SMW\DataValueFactory;
use SMW\DIProperty;
use SMW\DIWikiPage;
use SMWContainerSemanticData as ContainerSemanticData;
use SMWDIContainer as DIContainer;
use SMWDITime as DITime;
use SMWDIBlob as DIBlob;

/**
 * @license GNU GPL v2+
 * @since 1.0
 *
 * @author mwjames
 */
class DataValueDeserializer {

	/**
	 * @var string
	 */
	private $querySource;

	/**
	 * @var EmbeddedLinksReplacer
	 */
	private $embeddedLinksReplacer;

	/**
	 * @since 1.0
	 *
	 * @param string $querySource
	 */
	public function __construct( $querySource ) {
		$this->querySource = $querySource;
		$this->embeddedLinksReplacer = new EmbeddedLinksReplacer( $querySource );
	}

	/**
	 * @since 1.0
	 *
	 * @return string
	 */
	public function getQuerySource() {
		return $this->querySource;
	}

	/**
	 * @since 1.0
	 *
	 * @param DIProperty $property
	 * @param array|string $value
	 *
	 * @return DataValue
	 */
	public function newDataValueFrom( DIProperty $property, $value ) {

		$dv = null;
		$propertyList = array();

		if ( $property->findPropertyTypeId() === '_wpg' || isset( $value['fulltext'] ) ) {

The method SMW\DIProperty::findPropertyTypeId() has been deprecated with message: since 3.0, use DIProperty::findPropertyValueType

			$dv = $this->newDataValueFromDataItem( $property, $this->newDiWikiPage( $value ) );

It seems like $this->newDiWikiPage($value) targeting SEQL\DataValueDeserializer::newDiWikiPage() can also be of type object<SMW\DIWikiPage>; however, SEQL\DataValueDeserializer::newDataValueFromDataItem() does only seem to accept boolean, maybe add an additional type check?

It seems like $value defined by parameter $value on line 58 can also be of type string; however, SEQL\DataValueDeserializer::newDiWikiPage() does only seem to accept array, maybe add an additional type check?

		} elseif ( strpos( $property->findPropertyTypeId(), '_rec' ) !== false ) {

The method SMW\DIProperty::findPropertyTypeId() has been deprecated with message: since 3.0, use DIProperty::findPropertyValueType

			$dv = $this->newDataValueFromDataItem( $property, $this->newDiContainerOnRecordType( $value, $propertyList ) );

$this->newDiContainerOnRecordType($value, $propertyList) is of type object<SMWDIContainer>, but the function expects a boolean.

It seems like $value defined by parameter $value on line 58 can also be of type string; however, SEQL\DataValueDeserializer::newDiContainerOnRecordType() does only seem to accept array, maybe add an additional type check?

			$dv->setFieldProperties( $propertyList );
		} elseif ( $property->findPropertyTypeId() === '_dat' ) {

The method SMW\DIProperty::findPropertyTypeId() has been deprecated with message: since 3.0, use DIProperty::findPropertyValueType

			$dv = $this->newDataValueFromDataItem( $property, $this->newDiTime( $value ) );

It seems like $this->newDiTime($value) targeting SEQL\DataValueDeserializer::newDiTime() can also be of type object<SMWDITime>; however, SEQL\DataValueDeserializer::newDataValueFromDataItem() does only seem to accept boolean, maybe add an additional type check?

		} elseif ( strpos( $property->findPropertyTypeId(), '_txt' ) !== false ) {

The method SMW\DIProperty::findPropertyTypeId() has been deprecated with message: since 3.0, use DIProperty::findPropertyValueType

			$dv = $this->newDataValueFromDataItem( $property, $this->newDiBlob( $value ) );

$this->newDiBlob($value) is of type object<SMWDIBlob>, but the function expects a boolean.

		} elseif ( $property->findPropertyTypeId() === '_qty' ) {

The method SMW\DIProperty::findPropertyTypeId() has been deprecated with message: since 3.0, use DIProperty::findPropertyValueType

			$dv = $this->newDataValueFromPropertyObject( $property, $value['value'] . ' ' . $value['unit']  );
		}

		if ( $dv === null ) {
			$dv = $this->newDataValueFromPropertyObject( $property, $value );
		}

		return $dv;
	}

	/**
	 * @since 1.0
	 *
	 * @param array $value
	 *
	 * @return DIWikiPage|false
	 */
	public function newDiWikiPage( array $value ) {

		if ( !isset( $value['namespace'] ) || !isset( $value['fulltext'] ) ) {
			return false;
		}

		$ns = (int)$value['namespace'] === NS_CATEGORY ? NS_CATEGORY : NS_MAIN;

		if ( $ns === NS_CATEGORY ) {
			$value['fulltext'] = substr( $value['fulltext'], ($pos = strpos( $value['fulltext'], ':') ) !== false ? $pos + 1 : 0 );
		}

		$title = \Title::newFromText( $this->querySource . ':' . str_replace(" ", "_", $value['fulltext'] ), $ns );

		return DIWikiPage::newFromTitle( $title );
	}

	private function newDiTime( $value ) {

		if ( isset( $value['raw'] ) ) {
			return DITime::doUnserialize( $value['raw'] );
		}

		// < 0.7 API format
		// Avoid something like "Part of the date is out of bounds" where the API
		// doesn't sent a raw format
		// return 9999 BC to indicate that we hit a bounds with the timespamp
		try{
			$dataItem = DITime::newFromTimestamp( $value );
		} catch ( \Exception $e ) {
			$dataItem = DITime::doUnserialize( '2/-9999' );
		}

		return $dataItem;
	}

	private function newDiBlob( $value ) {
		return new DIBlob( $this->embeddedLinksReplacer->replace( $value ) );
	}

	private function newDataValueFromPropertyObject( $property, $value ) {

		try{
			$dv = DataValueFactory::newPropertyObjectValue( $property, $value );

The method SMW\DataValueFactory::newPropertyObjectValue() has been deprecated with message: since 2.4, use DataValueFactory::newDataValueByProperty

		} catch ( \Exception $e ) {
			$dv = false;
		}

		return $dv;
	}

	private function newDataValueFromDataItem( $property, $dataItem = false ) {

		if ( $dataItem === false ) {
			return false;
		}

		try{
			$dv = DataValueFactory::newDataItemValue( $dataItem, $property );

$dataItem is of type boolean, but the function expects a object<SMWDataItem>.

The method SMW\DataValueFactory::newDataItemValue() has been deprecated with message: since 2.4, use DataValueFactory::newDataValueByItem

		} catch ( \Exception $e ) {
			$dv = false;
		}

		return $dv;
	}

	private function newDiContainerOnRecordType( array $value, &$propertyList ) {

		// Remote container to use an anonymous
		$semanticData = ContainerSemanticData::makeAnonymousContainer();

		foreach ( $value as $recValue ) {
			$recordProperty = DIProperty::newFromUserLabel( $recValue['label'] );
			$recordProperty->setInterwiki( $this->querySource );
			$recordProperty->setPropertyTypeId( $recValue['typeid'] );
			$propertyList[] = $recordProperty;

			foreach ( $recValue['item'] as $item ) {
				$dataValue = $this->newDataValueFrom( $recordProperty, $item );

				if ( $dataValue === false ) {
					continue;
				}

				$semanticData->addPropertyObjectValue( $recordProperty, $dataValue->getDataItem() );
			}
		}

		return new DIContainer( $semanticData );
	}

}