<?php

namespace Akeneo\Pim\Enrichment\Component\Product\Model;

/**
 * This interface wears the responsibility of having values.
 * A value is defined by an attribute, a locale, a scope and a data.
 *
 * @author    Julien Janvier <julien.janvier@akeneo.com>
 * @copyright 2017 Akeneo SAS (http://www.akeneo.com)
 * @license   http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)
 */
interface EntityWithValuesInterface
{
    /**
     * @return mixed
     */
    public function getId();

    /**
     * @return mixed
     */
    public function getIdentifier();

    /**
     * @return array
     */
    public function getRawValues();

    /**
     * @param array $rawValues
     *
     * @return EntityWithValuesInterface
     */
    public function setRawValues(array $rawValues);

    /**
     * Get values
     *
     * @return WriteValueCollection
     */
    public function getValues();

    /**
     * Set values
     *
     * @param WriteValueCollection $values
     *
     * @return EntityWithValuesInterface
     */
    public function setValues(WriteValueCollection $values);

    /**
     * Get value related to attribute code
     *
     * @param string $attributeCode
     * @param string $localeCode
     * @param string $scopeCode
     *
     * @return ValueInterface|null
     */
    public function getValue($attributeCode, $localeCode = null, $scopeCode = null);

    /**
     * Add value, override to deal with relation owner side
     *
     * @param ValueInterface $value
     *
     * @return EntityWithValuesInterface
     */
    public function addValue(ValueInterface $value);

    /**
     * Remove value
     *
     * @param ValueInterface $value
     *
     * @return EntityWithValuesInterface
     */
    public function removeValue(ValueInterface $value);

    /**
     * Get whether or not an attribute is part of a product from its attribute code
     */
    public function hasAttribute(string $attributeCode): bool;

    /**
     * Get the list of used attribute codes from the indexed values
     */
    public function getUsedAttributeCodes(): array;

    public function isNew(): bool;
}