wikimedia/mediawiki-extensions-Wikibase

<?php

namespace Wikibase\Lib;

use DataValues\DataValue;
use DataValues\IllegalValueException;
use Deserializers\Deserializer;
use Deserializers\Exceptions\DeserializationException;
use InvalidArgumentException;

/**
 * @license GPL-2.0-or-later
 * @author Jeroen De Dauw < jeroendedauw@gmail.com >
 * @author Daniel Kinzler
 */
class DataValueFactory {

    /**
     * @var Deserializer
     */
    private $deserializer;

    public function __construct( Deserializer $dataValueDeserializer ) {
        $this->deserializer = $dataValueDeserializer;
    }

    /**
     * Constructs and returns a new DataValue of specified type with the provided data.
     *
     * @param string $dataValueType
     * @param mixed $data
     *
     * @return DataValue
     * @throws InvalidArgumentException
     */
    public function newDataValue( $dataValueType, $data ) {
        if ( !is_string( $dataValueType ) || $dataValueType === '' ) {
            throw new InvalidArgumentException( '$dataValueType must be a non-empty string' );
        }

        try {
            $value = $this->deserializer->deserialize( [
                'value' => $data,
                'type' => $dataValueType,
            ] );
        } catch ( DeserializationException $ex ) {
            throw new InvalidArgumentException( $ex->getMessage(), 0, $ex );
        }

        return $value;
    }

    /**
     * Constructs a DataValue from its array representation.
     * This is what @see DataValue::toArray returns.
     *
     * @param array $data
     *
     * @return DataValue
     * @throws IllegalValueException
     */
    public function newFromArray( array $data ) {
        if ( !array_key_exists( 'type', $data ) ) {
            throw new IllegalValueException( 'DataValue type is missing' );
        }

        if ( $data['type'] === null || $data['type'] === '' ) {
            throw new IllegalValueException( 'DataValue type is empty' );
        }

        if ( !array_key_exists( 'value', $data ) ) {
            throw new IllegalValueException( 'DataValue value is missing' );
        }

        return $this->newDataValue( $data['type'], $data['value'] );
    }

}