Analogue\ORM\System\Aggregate

Complexity

Total Complexity

140

Size/Duplication

Total Lines	1015
Duplicated Lines	3.15 %

Coupling/Cohesion

Components	1
Dependencies	9

Importance

Changes	13
Bugs	6	Features	1

53 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	18	1
A	parseRelationships()	0	10	3
B	parseForCommonValues()	0	26	3
D	parseSingleRelationship()	0	40	10
B	isParentOrRoot()	12	16	5
D	parseManyRelationship()	0	32	10
B	getRelationshipValue()	0	10	5
A	createSubAggregates()	0	10	2
A	createSubAggregate()	0	11	2
A	getEntityId()	0	4	1
A	getEntityKey()	0	4	1
A	getEntityMap()	0	4	1
A	getEntityHash()	0	4	1
A	getEntityClass()	0	4	1
A	getEntityCache()	0	4	1
A	getRelationship()	0	8	2
A	getPivotAttributes()	0	4	1
A	getNonExistingRelated()	0	12	4
A	getNonExistingFromRelation()	0	12	3
A	syncRelationships()	0	10	4
A	synchronize()	0	6	1
A	getMissingEntities()	0	18	4
B	getDirtyRelationships()	0	14	6
A	isDirty()	0	8	2
A	getRawAttributes()	0	14	2
B	flattenEmbeddables()	0	28	3
A	getCachedRawAttributes()	10	10	2
A	getCachedAttribute()	10	10	2
A	getForeignKeyAttributes()	0	18	4
A	getForeignKeyAttributesFromRelation()	0	15	2
A	getForeignKeyAttributesFromParent()	0	22	3
A	updatePivotRecords()	0	10	3
B	updatePivotRelation()	0	28	5
A	updatePivotIfDirty()	0	20	3
A	getDirtyAttributes()	0	12	3
A	getPivotAttributesFromCache()	0	12	3
A	getRelatedAggregatesFromHashes()	0	14	3
A	getRelatedAggregateFromHash()	0	9	3
A	getEntityHashesFromRelation()	0	6	1
A	isActualRelationships()	0	5	2
A	getCache()	0	4	1
C	getDirtyRawAttributes()	0	22	8
A	isRelation()	0	4	1
A	originalIsNumericallyEquivalent()	0	4	3
A	getEntityObject()	0	4	1
A	getMapper()	0	4	1
A	exists()	0	4	1
A	setEntityAttributes()	0	4	1
A	getEntityAttributes()	0	4	1
A	setEntityAttribute()	0	4	1
A	getEntityAttribute()	0	4	1
A	hasAttribute()	0	4	1
A	setProxies()	0	4	1

<?php

namespace Analogue\ORM\System;

use Analogue\ORM\Relationships\Pivot;
use Illuminate\Support\Collection;
use Analogue\ORM\System\Wrappers\Factory;
use Analogue\ORM\System\Proxies\EntityProxy;
use Analogue\ORM\System\Proxies\CollectionProxy;
use Analogue\ORM\Exceptions\MappingException;

/**
 * This class is aimed to facilitate the handling of
 * complex root aggregate scenarios.
 */
class Aggregate implements InternallyMappable
{
    /**
     * The Root Entity
     *
     * @var \Analogue\ORM\System\Wrappers\Wrapper
     */
    protected $wrappedEntity;

    /**
     * Parent Root Aggregate
     *
     * @var \Analogue\ORM\System\Aggregate
     */
    protected $parent;

    /**
     * Parent's relationship method
     *
     * @var string
     */
    protected $parentRelationship;

    /**
     * Root Entity
     *
     * @var \Analogue\ORM\System\Aggregate
     */
    protected $root;

    /**
     * An associative array containing entity's
     * relationships converted to Aggregates
     *
     * @var array
     */
    protected $relationships = [];

    /**
     * Relationship that need post-command synchronization
     *
     * @var array
     */
    protected $needSync = [];

    /**
     * Mapper
     *
     * @var \Analogue\ORM\System\Mapper;
     */
    protected $mapper;

    /**
     * Entity Map
     *
     * @var \Analogue\ORM\EntityMap;
     */
    protected $entityMap;

    /**
     * Create a new Aggregated Entity instance
     *
     * @param mixed          $entity
     * @param Aggregate|null $parent
     * @param string         $parentRelationship
     * @param Aggregate|null $root
     * @throws MappingException
     */
    public function __construct($entity, Aggregate $parent = null, $parentRelationship = null, Aggregate $root = null)
    {
        $factory = new Factory;
        
        $this->wrappedEntity = $factory->make($entity);

        $this->parent = $parent;

        $this->parentRelationship = $parentRelationship;

        $this->root = $root;

        $this->mapper = Manager::getMapper($entity);

        $this->entityMap = $this->mapper->getEntityMap();
             
        $this->parseRelationships();
    }

    /**
     * Parse Every relationships defined on the entity
     *
     * @throws MappingException
     * @return void
     */
    protected function parseRelationships()
    {
        foreach ($this->entityMap->getSingleRelationships() as $relation) {
            $this->parseSingleRelationship($relation);
        }

        foreach ($this->entityMap->getManyRelationships() as $relation) {
            $this->parseManyRelationship($relation);
        }
    }

    /**
     * Parse for values common to single & many relations
     *
     * @param  string $relation
     * @throws MappingException
     * @return mixed|boolean
     */
    protected function parseForCommonValues($relation)
    {
        if (!$this->hasAttribute($relation)) {
            // If no attribute exists for this relationships
            // we'll make it a simple empty array. This will
            // save us from constantly checking for the attributes
            // actual existence.
            $this->relationships[$relation] = [];
            return false;
        }

        $value = $this->getRelationshipValue($relation);

        if (is_null($value)) {
            $this->relationships[$relation] = [];

            // If the relationship's content is the null value
            // and the Entity's exist in DB, we'll interpret this
            // as the need to detach all related Entities,
            // therefore a sync operation is needed.
            $this->needSync[] = $relation;
            return false;
        }

        return $value;
    }

    /**
     * Parse a 'single' relationship
     *
     * @param  string $relation
     * @throws MappingException
     * @return boolean
     */
    protected function parseSingleRelationship($relation)
    {
        if (!$value = $this->parseForCommonValues($relation)) {
            return true;
        }
        
        if ($value instanceof Collection || is_array($value) || $value instanceof CollectionProxy) {
            throw new MappingException("Entity's attribute $relation should not be array, or collection");
        }

        if ($value instanceof EntityProxy && !$value->isLoaded()) {
            $this->relationships[$relation] = [];
            return true;
        }

        // If the attribute is a loaded proxy, swap it for its
        // loaded entity.
        if ($value instanceof EntityProxy && $value->isLoaded()) {
            $value = $value->getUnderlyingObject();
        }

        if ($this->isParentOrRoot($value)) {
            $this->relationships[$relation] = [];
            return true;
        }

        // At this point, we can assume the attribute is an Entity instance
        // so we'll treat it as such.
        $subAggregate = $this->createSubAggregate($value, $relation);
         
        // Even if it's a single entity, we'll store it as an array
        // just for consistency with other relationships
        $this->relationships[$relation] = [$subAggregate];

        // We always need to check a loaded relation is in sync
        // with its local key
        $this->needSync[] = $relation;

        return true;
    }

    /**
     * Check if value isn't parent or root in the aggregate
     *
     * @param  mixed
     * @return boolean|null
     */
    protected function isParentOrRoot($value)
    {
        if (!is_null($this->root)) {

This code seems to be duplicated across your project.

            $rootClass = get_class($this->root->getEntityObject());
            if ($rootClass == get_class($value)) {
                return true;
            }
        }

        if (!is_null($this->parent)) {

This code seems to be duplicated across your project.

            $parentClass = get_class($this->parent->getEntityObject());
            if ($parentClass == get_class($value)) {
                return true;
            }
        }
    }

    /**
     * Parse a 'many' relationship
     *
     * @param  string $relation
     * @throws MappingException
     * @return boolean
     */
    protected function parseManyRelationship($relation)
    {
        if (!$value = $this->parseForCommonValues($relation)) {
            return true;
        }
        
        if (is_array($value) || $value instanceof Collection) {
            $this->needSync[] = $relation;
        }

        // If the relation is a proxy, we test is the relation
        // has been lazy loaded, otherwise we'll just treat
        // the subset of newly added items.
        if ($value instanceof CollectionProxy && $value->isLoaded()) {
            $this->needSync[] = $relation;
            $value = $value->getUnderlyingCollection();
        }

        if ($value instanceof CollectionProxy && !$value->isLoaded()) {
            $value = $value->getAddedItems();
        }

        // At this point $value should be either an array or an instance
        // of a collection class.
        if (!is_array($value) && !$value instanceof Collection) {
            throw new MappingException("'$relation' attribute should be array() or Collection");
        }

        $this->relationships[$relation] = $this->createSubAggregates($value, $relation);
        
        return true;
    }

    /**
     * Return Entity's relationship attribute
     *
     * @param  string $relation
     * @throws MappingException
     * @return mixed
     */
    protected function getRelationshipValue($relation)
    {
        $value = $this->getEntityAttribute($relation);
        //if($relation == "role") tdd($this->wrappedEntity->getEntityAttributes());

65% of this comment could be valid code. Did you maybe forget this after debugging?

        if (is_bool($value) || is_float($value) || is_int($value) || is_string($value)) {
            throw new MappingException("Entity's attribute $relation should be array, object, collection or null");
        }

        return $value;
    }

    /**
     * Create a child, aggregated entity
     *
     * @param  mixed $entities
     * @param string $relation
     * @return array
     */
    protected function createSubAggregates($entities, $relation)
    {
        $aggregates = [];

        foreach ($entities as $entity) {
            $aggregates[] = $this->createSubAggregate($entity, $relation);
        }

        return $aggregates;
    }

    /**
     * Create a related subAggregate
     *
     * @param  mixed $entity
     * @param  string $relation
     * @throws MappingException
     * @return self
     */
    protected function createSubAggregate($entity, $relation)
    {
        // If root isn't defined, then this is the Aggregate Root
        if (is_null($this->root)) {
            $root = $this;
        } else {
            $root = $this->root;
        }

        return new self($entity, $this, $relation, $root);
    }

    /**
     * Get the Entity's primary key attribute
     *
     * @return string|integer
     */
    public function getEntityId()
    {
        return $this->wrappedEntity->getEntityAttribute($this->entityMap->getKeyName());
    }

    /**
     * Get the name of the primary key
     *
     * @return string
     */
    public function getEntityKey()
    {
        return $this->entityMap->getKeyName();
    }

    /**
     * Return the entity map for the current entity
     *
     * @return \Analogue\ORM\EntityMap
     */
    public function getEntityMap()
    {
        return $this->entityMap;
    }

    /**
     * Return the Entity's hash $class.$id
     *
     * @return string
     */
    public function getEntityHash()
    {
        return $this->getEntityClass() . '.' . $this->getEntityId();
    }

    /**
     * Get wrapped entity class
     *
     * @return string
     */
    public function getEntityClass()
    {
        return $this->entityMap->getClass();
    }

    /**
     * Return the Mapper's entity cache
     *
     * @return \Analogue\ORM\System\EntityCache
     */
    protected function getEntityCache()
    {
        return $this->mapper->getEntityCache();
    }

    /**
     * Get a relationship as an aggregated entities' array
     *
     * @param  string $name
     * @return array
     */
    public function getRelationship($name)
    {
        if (array_key_exists($name, $this->relationships)) {
            return $this->relationships[$name];
        } else {
            return [];
        }
    }

    /**
     * [TO IMPLEMENT]
     *
     * @return array
     */
    public function getPivotAttributes()
    {
        return [];
    }

    /**
     * Get Non existing related entities from several relationships
     *
     * @param  array $relationships
     * @return array
     */
    public function getNonExistingRelated(array $relationships)
    {
        $nonExisting = [];

        foreach ($relationships as $relation) {
            if ($this->hasAttribute($relation) && array_key_exists($relation, $this->relationships)) {
                $nonExisting = array_merge($nonExisting, $this->getNonExistingFromRelation($relation));
            }
        }

        return $nonExisting;
    }

    /**
     * Get non-existing related entities from a single relation
     *
     * @param  string $relation
     * @return array
     */
    protected function getNonExistingFromRelation($relation)
    {
        $nonExisting = [];

        foreach ($this->relationships[$relation] as $aggregate) {
            if (!$aggregate->exists()) {
                $nonExisting[] = $aggregate;
            }
        }

        return $nonExisting;
    }

    /**
     * Synchronize relationships if needed
     */
    public function syncRelationships(array $relationships)
    {
        if ($this->exists()) {
            foreach ($relationships as $relation) {
                if (in_array($relation, $this->needSync)) {
                    $this->synchronize($relation);
                }
            }
        }
    }

    /**
     * Synchronize a relationship attribute
     *
     * @param $relation
     */
    protected function synchronize($relation)
    {
        $actualContent = $this->relationships[$relation];

        $this->entityMap->$relation($this->getEntityObject())->sync($actualContent);
    }

    /**
     * Returns an array of Missing related Entities for the
     * given $relation
     *
     * @param  string $relation
     * @return array
     */
    public function getMissingEntities($relation)
    {
        $cachedRelations = $this->getCachedAttribute($relation);

        if (!is_null($cachedRelations)) {
            $missing = [];

            foreach ($cachedRelations as $hash) {

The expression $cachedRelations of type object|integer|double|string|array|boolean is not guaranteed to be traversable. How about adding an additional type check?

                if (!$this->getRelatedAggregateFromHash($hash, $relation)) {
                    $missing[] = $hash;
                }
            }

            return $missing;
        } else {
            return [];
        }
    }
       
    /**
     * Get Relationships who have dirty attributes / dirty relationships
     *
     * @return array
     */
    public function getDirtyRelationships()
    {
        $dirtyAggregates = [];

        foreach ($this->relationships as $relation) {
            foreach ($relation as $aggregate) {
                if (!$aggregate->exists() || $aggregate->isDirty() || count($aggregate->getDirtyRelationships() > 0)) {
                    $dirtyAggregates[] = $aggregate;
                }
            }
        }

        return $dirtyAggregates;
    }
    
    /**
     * Compare the object's raw attributes with the record in cache
     *
     * @return boolean
     */
    public function isDirty()
    {
        if (count($this->getDirtyRawAttributes()) > 0) {
            return true;
        } else {
            return false;
        }
    }

    /**
     * Get Raw Entity's attributes, as they are represented
     * in the database, including value objects & foreign keys
     *
     * @return array
     */
    public function getRawAttributes()
    {
        $attributes = $this->wrappedEntity->getEntityAttributes();

        foreach ($this->entityMap->getRelationships() as $relation) {
            unset($attributes[$relation]);
        }

        $attributes = $this->flattenEmbeddables($attributes);

        $foreignKeys = $this->getForeignKeyAttributes();

        return $attributes + $foreignKeys;
    }

    /**
     * Convert Value Objects to raw db attributes
     *
     * @param  array $attributes
     * @return array
     */
    protected function flattenEmbeddables($attributes)
    {
        $embeddables = $this->entityMap->getEmbeddables();
        
        foreach ($embeddables as $localKey => $embed) {
            // Retrieve the value object from the entity's attributes
            $valueObject = $attributes[$localKey];

            // Unset the corresponding key
            unset($attributes[$localKey]);

            // TODO Make wrapper object compatible with value objects
            $valueObjectAttributes = $valueObject->getEntityAttributes();

            // Now (if setup in the entity map) we prefix the value object's
            // attributes with the snake_case name of the embedded class.
            $prefix = snake_case(class_basename($embed));

            foreach ($valueObjectAttributes as $key=>$value) {
                $valueObjectAttributes[$prefix . '_' . $key] = $value;
                unset($valueObjectAttributes[$key]);
            }

            $attributes = array_merge($attributes, $valueObjectAttributes);
        }
        
        return $attributes;
    }

    /**
     * Return's entity raw attributes in the state they were at last
     * query.
     *
     * @param  array|null $columns
     * @return array
     */
    protected function getCachedRawAttributes(array $columns = null)

This method seems to be duplicated in your project.

    {
        $cachedAttributes = $this->getCache()->get($this->getEntityId());

        if (is_null($columns)) {
            return $cachedAttributes;
        } else {
            return array_only($cachedAttributes, $columns);
        }
    }

    /**
     * Return a single attribute from the cache
     * @param  string $key
     * @return mixed
     */
    protected function getCachedAttribute($key)

This method seems to be duplicated in your project.

    {
        $cachedAttributes = $this->getCache()->get($this->getEntityId());

        if (!array_key_exists($key, $cachedAttributes)) {
            return null;
        } else {
            return $cachedAttributes[$key];
        }
    }

    /**
     * Convert related Entity's attributes to foreign keys
     *
     * @return array
     */
    protected function getForeignKeyAttributes()
    {
        $foreignKeys = [];

        foreach ($this->entityMap->getLocalRelationships() as $relation) {
            // check if relationship has been parsed, meaning it has an actual object
            // in the entity's attributes
            if ($this->isActualRelationships($relation)) {
                $foreignKeys = $foreignKeys + $this->getForeignKeyAttributesFromRelation($relation);
            }
        }

        if (!is_null($this->parent)) {
            $foreignKeys = $foreignKeys + $this->getForeignKeyAttributesFromParent();
        }

        return $foreignKeys;
    }

    /**
     * Return an associative array containing the key-value pair(s) from
     * the related entity.
     *
     * @param  string $relation
     * @return array
     */
    protected function getForeignKeyAttributesFromRelation($relation)
    {
        $localRelations = $this->entityMap->getLocalRelationships();

        if (in_array($relation, $localRelations)) {
            // Call Relationship's method
            $relationship = $this->entityMap->$relation($this->getEntityObject());

            $relatedAggregate = $this->relationships[$relation][0];

            return $relationship->getForeignKeyValuePair($relatedAggregate->getEntityObject());
        } else {
            return [];
        }
    }

    /**
     * Get foreign key attribute(s) from a parent entity in this
     * aggregate context
     *
     * @return array
     */
    protected function getForeignKeyAttributesFromParent()
    {
        $parentMap = $this->parent->getEntityMap();

        $parentForeignRelations = $parentMap->getForeignRelationships();
        $parentPivotRelations = $parentMap->getPivotRelationships();

        $parentRelation = $this->parentRelationship;

        if (in_array($parentRelation, $parentForeignRelations)
            && !in_array($parentRelation, $parentPivotRelations)
        ) {
            $parentObject = $this->parent->getEntityObject();

            // Call Relationship's method on parent map
            $relationship = $parentMap->$parentRelation($parentObject);

            return $relationship->getForeignKeyValuePair();
        } else {
            return [];
        }
    }

    /**
     * Update Pivot records on loaded relationships, by comparing the
     * values from the Entity Cache to the actual relationship inside
     * the aggregated entity.
     *
     * @return void
     */
    public function updatePivotRecords()
    {
        $pivots = $this->entityMap->getPivotRelationships();

        foreach ($pivots as $pivot) {
            if (array_key_exists($pivot, $this->relationships)) {
                $this->updatePivotRelation($pivot);
            }
        }
    }

    /**
     * Update Single pivot relationship
     *
     * @param  string $relation
     * @return void
     */
    protected function updatePivotRelation($relation)
    {
        $hashes = $this->getEntityHashesFromRelation($relation);

        $cachedAttributes = $this->getCachedRawAttributes();

        if (array_key_exists($relation, $cachedAttributes)) {
            // Compare the two array of hashes to find out existing
            // pivot records, and the ones to be created.
            $new = array_diff($hashes, array_keys($cachedAttributes[$relation]));
            $existing = array_intersect($hashes, array_keys($cachedAttributes[$relation]));
        } else {
            $existing = [];
            $new = $hashes;
        }

        if (count($new) > 0) {
            $pivots = $this->getRelatedAggregatesFromHashes($new, $relation);

            $this->entityMap->$relation($this->getEntityObject())->createPivots($pivots);
        }

        if (count($existing) > 0) {
            foreach ($existing as $pivotHash) {
                $this->updatePivotIfDirty($pivotHash, $relation);
            }
        }
    }

    /**
     * Compare existing pivot record in cache and update it
     * if the pivot attributes are dirty
     *
     * @param  string $pivotHash
     * @param  string $relation
     * @return void
     */
    protected function updatePivotIfDirty($pivotHash, $relation)
    {
        $aggregate = $this->getRelatedAggregateFromHash($pivotHash, $relation);

        if ($aggregate->hasAttribute('pivot')) {
            $pivot = $aggregate->getEntityAttribute('pivot')->getEntityAttributes();

            $cachedPivotAttributes = $this->getPivotAttributesFromCache($pivotHash, $relation);

            $actualPivotAttributes = array_only($pivot, array_keys($cachedPivotAttributes));

            $dirty = $this->getDirtyAttributes($actualPivotAttributes, $cachedPivotAttributes);

            if (count($dirty) > 0) {
                $id = $aggregate->getEntityId();

                $this->entityMap->$relation($this->getEntityObject())->updateExistingPivot($id, $dirty);
            }
        }
    }

    /**
     * Compare two attributes array and return dirty attributes
     *
     * @param  array $actual
     * @param  array $cached
     * @return array
     */
    protected function getDirtyAttributes(array $actual, array $cached)
    {
        $dirty = [];

        foreach ($actual as $key => $value) {
            if (!$this->originalIsNumericallyEquivalent($value, $cached[$key])) {
                $dirty[$key] = $actual[$key];
            }
        }

        return $dirty;
    }

    /**
     *
     * @param  string $pivotHash
     * @param  string $relation
     * @return array
     */
    protected function getPivotAttributesFromCache($pivotHash, $relation)
    {
        $cachedAttributes = $this->getCachedRawAttributes();

        $cachedRelations = $cachedAttributes[$relation];

        foreach ($cachedRelations as $cachedRelation) {
            if ($cachedRelation == $pivotHash) {
                return $cachedRelation->getPivotAttributes();
            }
        }
    }

    /**
     * Returns an array of related Aggregates from its entity hashes
     *
     * @param  array  $hashes
     * @param  string $relation
     * @return array
     */
    protected function getRelatedAggregatesFromHashes(array $hashes, $relation)
    {
        $related = [];

        foreach ($hashes as $hash) {
            $aggregate = $this->getRelatedAggregateFromHash($hash, $relation);

            if (!is_null($aggregate)) {
                $related[] = $aggregate;
            }
        }

        return $related;
    }

    /**
     * Get related aggregate from its hash
     *
     * @param  string $hash
     * @param  string $relation
     * @return \Analogue\ORM\System\Aggregate|null
     */
    protected function getRelatedAggregateFromHash($hash, $relation)
    {
        foreach ($this->relationships[$relation] as $aggregate) {
            if ($aggregate->getEntityHash() == $hash) {
                return $aggregate;
            }
        }
        return null;
    }

    /**
     * Return an array of Entity Hashes from a specific relation
     *
     * @param  string $relation
     * @return array
     */
    protected function getEntityHashesFromRelation($relation)
    {
        return array_map(function ($aggregate) {
            return $aggregate->getEntityHash();
        }, $this->relationships[$relation]);
    }

    /**
     * Check the existence of an actual relationship
     *
     * @param  string $relation
     * @return boolean
     */
    protected function isActualRelationships($relation)
    {
        return array_key_exists($relation, $this->relationships)
            && count($this->relationships[$relation]) > 0;
    }

    /**
     * Return cache instance for the current entity type
     *
     * @return \Analogue\ORM\System\EntityCache
     */
    protected function getCache()
    {
        return $this->mapper->getEntityCache();
    }

    /**
     * Get Only Raw Entiy's attributes which have been modified
     * since last query
     *
     * @return array
     */
    public function getDirtyRawAttributes()
    {
        $attributes = $this->getRawAttributes();
        $cachedAttributes = $this->getCachedRawAttributes(array_keys($attributes));

        $dirty = [];

        foreach ($attributes as $key => $value) {
            if ($this->isRelation($key) || $key == 'pivot') {
                continue;
            }

            if (!array_key_exists($key, $cachedAttributes) && !$value instanceof Pivot) {
                $dirty[$key] = $value;
            } elseif ($value !== $cachedAttributes[$key] &&
                !$this->originalIsNumericallyEquivalent($value, $cachedAttributes[$key])) {
                $dirty[$key] = $value;
            }
        }

        return $dirty;
    }

    /**
     * @param $key
     * @return bool
     */
    protected function isRelation($key)
    {
        return in_array($key, $this->entityMap->getRelationships());
    }

    /**
     * Determine if the new and old values for a given key are numerically equivalent.
     *
     * @param $current
     * @param $original
     * @return boolean
     */
    protected function originalIsNumericallyEquivalent($current, $original)
    {
        return is_numeric($current) && is_numeric($original) && strcmp((string) $current, (string) $original) === 0;
    }

    /**
     * Get the underlying entity object
     *
     * @return mixed
     */
    public function getEntityObject()
    {
        return $this->wrappedEntity->getObject();
    }

    /**
     * Return the Mapper instance for the current Entity Type
     *
     * @return \Analogue\ORM\System\Mapper
     */
    public function getMapper()
    {
        return $this->mapper;
    }

    /**
     * Check that the entity already exists in the database, by checking
     * if it has an EntityCache record
     *
     * @return boolean
     */
    public function exists()
    {
        return $this->getCache()->has($this->getEntityId());
    }

    /**
     * Set the object attribute raw values (hydration)
     *
     * @param array $attributes
     */
    public function setEntityAttributes(array $attributes)
    {
        $this->wrappedEntity->setEntityAttributes($attributes);
    }

    /**
     * Get the raw object's values.
     *
     * @return array
     */
    public function getEntityAttributes()
    {
        return $this->wrappedEntity->getEntityAttributes();
    }

    /**
     * Set the raw entity attributes
     * @param string $key
     * @param string $value
     */
    public function setEntityAttribute($key, $value)
    {
        $this->wrappedEntity->setEntityAttribute($key, $value);
    }

    /**
     * Return the entity's attribute
     * @param  string $key
     * @return mixed
     */
    public function getEntityAttribute($key)
    {
        return $this->wrappedEntity->getEntityAttribute($key);
    }

    /**
     * Does the attribute exists on the entity
     *
     * @param  string  $key
     * @return boolean
     */
    public function hasAttribute($key)
    {
        return $this->wrappedEntity->hasAttribute($key);
    }

    /**
     * Set the lazyloading proxies on the wrapped entity
     */
    public function setProxies()
    {
        $this->wrappedEntity->setProxies();
    }
}