ORMInvalidArgumentException::newEntitiesFoundThroughRelationships() - Code Metrics - Inspection of "Merge branch 'fix/#1521-DDC-2922-defer-checking-no..." - doctrine/orm - Measure and Improve Code Quality continuously with Scrutinizer

Failed Conditions

Push — master ( ddccd4...8ad3df )

by Marco

created 2017-08-22 08:27 UTC

newEntitiesFoundThroughRelationships() A

↳ Parent: ORMInvalidArgumentException

Complexity

Conditions	2
Paths	2

Size

Total Lines	21
Code Lines	12

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	11
CRAP Score	2

Importance

Changes

Metric	Value
dl	0
loc	21
ccs	11
cts	11
cp	1
rs	9.3142
c	0
b	0
f	0
cc	2
eloc	12
nc	2
nop	1
crap	2

<?php
/*
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * This software consists of voluntary contributions made by many individuals
 * and is licensed under the MIT license. For more information, see
 * <http://www.doctrine-project.org>.
 */

namespace Doctrine\ORM;
use Doctrine\ORM\Mapping\ClassMetadata;

/**
 * Contains exception messages for all invalid lifecycle state exceptions inside UnitOfWork
 *
 * @author Benjamin Eberlei <[email protected]>
 */
class ORMInvalidArgumentException extends \InvalidArgumentException
{
    /**
     * @param object $entity
     *
     * @return ORMInvalidArgumentException
     */
    static public function scheduleInsertForManagedEntity($entity)

    {
        return new self("A managed+dirty entity " . self::objToStr($entity) . " can not be scheduled for insertion.");
    }

    /**
     * @param object $entity
     *
     * @return ORMInvalidArgumentException
     */
    static public function scheduleInsertForRemovedEntity($entity)

    {
        return new self("Removed entity " . self::objToStr($entity) . " can not be scheduled for insertion.");
    }

    /**
     * @param object $entity
     *
     * @return ORMInvalidArgumentException
     */
    static public function scheduleInsertTwice($entity)

    {
        return new self("Entity " . self::objToStr($entity) . " can not be scheduled for insertion twice.");
    }

    /**
     * @param string $className
     * @param object $entity
     *
     * @return ORMInvalidArgumentException
     */
    static public function entityWithoutIdentity($className, $entity)

    {
        return new self(
            "The given entity of type '" . $className . "' (".self::objToStr($entity).") has no identity/no " .
            "id values set. It cannot be added to the identity map."
        );
    }

    /**
     * @param object $entity
     *
     * @return ORMInvalidArgumentException
     */
    static public function readOnlyRequiresManagedEntity($entity)

    {
        return new self("Only managed entities can be marked or checked as read only. But " . self::objToStr($entity) . " is not");
    }

    /**
     * @param array[][]|object[][] $newEntitiesWithAssociations non-empty an array
 *                                                              of [array $associationMapping, object $entity] pairs
     *
     * @return ORMInvalidArgumentException
     */
    static public function newEntitiesFoundThroughRelationships($newEntitiesWithAssociations)

    {
        $errorMessages = array_map(
            function (array $newEntityWithAssociation) : string {
                [$associationMapping, $entity] = $newEntityWithAssociation;


                return self::newEntityFoundThroughRelationshipMessage($associationMapping, $entity);

            },
            $newEntitiesWithAssociations
        );

        if (1 === count($errorMessages)) {
            return new self(reset($errorMessages));
        }

        return new self(
            'Multiple non-persisted new entities were found through the given association graph:'
            . "\n\n * "
            . implode("\n * ", $errorMessages)
        );
    }

    /**
     * @param array  $associationMapping
     * @param object $entry
     *
     * @return ORMInvalidArgumentException
     */
    static public function newEntityFoundThroughRelationship(array $associationMapping, $entry)

    {
        return new self(self::newEntityFoundThroughRelationshipMessage($associationMapping, $entry));
    }

    /**
     * @param array  $assoc
     * @param object $entry
     *
     * @return ORMInvalidArgumentException
     */
    static public function detachedEntityFoundThroughRelationship(array $assoc, $entry)

    {
        return new self("A detached entity of type " . $assoc['targetEntity'] . " (" . self::objToStr($entry) . ") "
            . " was found through the relationship '" . $assoc['sourceEntity'] . "#" . $assoc['fieldName'] . "' "
            . "during cascading a persist operation.");
    }

    /**
     * @param object $entity
     *
     * @return ORMInvalidArgumentException
     */
    static public function entityNotManaged($entity)

    {
        return new self("Entity " . self::objToStr($entity) . " is not managed. An entity is managed if its fetched " .
            "from the database or registered as new through EntityManager#persist");
    }

    /**
     * @param object $entity
     * @param string $operation
     *
     * @return ORMInvalidArgumentException
     */
    static public function entityHasNoIdentity($entity, $operation)

    {
        return new self("Entity has no identity, therefore " . $operation ." cannot be performed. " . self::objToStr($entity));
    }

    /**
     * @param object $entity
     * @param string $operation
     *
     * @return ORMInvalidArgumentException
     */
    static public function entityIsRemoved($entity, $operation)

    {
        return new self("Entity is removed, therefore " . $operation ." cannot be performed. " . self::objToStr($entity));
    }

    /**
     * @param object $entity
     * @param string $operation
     *
     * @return ORMInvalidArgumentException
     */
    static public function detachedEntityCannot($entity, $operation)

    {
        return new self("Detached entity " . self::objToStr($entity) . " cannot be " . $operation);
    }

    /**
     * @param string $context
     * @param mixed  $given
     * @param int    $parameterIndex
     *
     * @return ORMInvalidArgumentException
     */
    public static function invalidObject($context, $given, $parameterIndex = 1)
    {
        return new self($context . ' expects parameter ' . $parameterIndex .
            ' to be an entity object, '. gettype($given) . ' given.');
    }

    /**
     * @return ORMInvalidArgumentException
     */
    public static function invalidCompositeIdentifier()
    {
        return new self("Binding an entity with a composite primary key to a query is not supported. " .
            "You should split the parameter into the explicit fields and bind them separately.");
    }

    /**
     * @return ORMInvalidArgumentException
     */
    public static function invalidIdentifierBindingEntity()
    {
        return new self("Binding entities to query parameters only allowed for entities that have an identifier.");
    }

    /**
     * @param ClassMetadata $targetClass
     * @param array         $assoc
     * @param mixed         $actualValue
     *
     * @return self
     */
    public static function invalidAssociation(ClassMetadata $targetClass, $assoc, $actualValue)
    {
        $expectedType = 'Doctrine\Common\Collections\Collection|array';

        if (($assoc['type'] & ClassMetadata::TO_ONE) > 0) {
            $expectedType = $targetClass->getName();
        }

        return new self(sprintf(
            'Expected value of type "%s" for association field "%s#$%s", got "%s" instead.',
            $expectedType,
            $assoc['sourceEntity'],
            $assoc['fieldName'],
            is_object($actualValue) ? get_class($actualValue) : gettype($actualValue)
        ));
    }

    /**
     * Used when a given entityName hasn't the good type
     *
     * @param mixed $entityName The given entity (which shouldn't be a string)
     *
     * @return self
     */
    public static function invalidEntityName($entityName)
    {
        return new self(sprintf('Entity name must be a string, %s given', gettype($entityName)));
    }

    /**
     * Helper method to show an object as string.
     *
     * @param object $obj
     *
     * @return string
     */
    private static function objToStr($obj) : string
    {
        return method_exists($obj, '__toString') ? (string) $obj : get_class($obj).'@'.spl_object_hash($obj);
    }

    /**
     * @param array  $associationMapping
     * @param object $entity
     */
    private static function newEntityFoundThroughRelationshipMessage(array $associationMapping, $entity) : string
    {
        return 'A new entity was found through the relationship \''
            . $associationMapping['sourceEntity'] . '#' . $associationMapping['fieldName'] . '\' that was not'
            . ' configured to cascade persist operations for entity: ' . self::objToStr($entity) . '.'
            . ' To solve this issue: Either explicitly call EntityManager#persist()'
            . ' on this unknown entity or configure cascade persist'
            . ' this association in the mapping for example @ManyToOne(..,cascade={"persist"}).'
            . (method_exists($entity, '__toString')
                ? ''
                : ' If you cannot find out which entity causes the problem implement \''
                . $associationMapping['targetEntity'] . '#__toString()\' to get a clue.'
            );
    }
}


1		<?php
2		/*
3		* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
4		* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
5		* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
6		* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
7		* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
8		* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
9		* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
10		* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
11		* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
12		* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
13		* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
14		*
15		* This software consists of voluntary contributions made by many individuals
16		* and is licensed under the MIT license. For more information, see
17		* <http://www.doctrine-project.org>.
18		*/
19
20		namespace Doctrine\ORM;
21		use Doctrine\ORM\Mapping\ClassMetadata;
22
23		/**
24		* Contains exception messages for all invalid lifecycle state exceptions inside UnitOfWork
25		*
26		* @author Benjamin Eberlei <[email protected]>
27		*/
28		class ORMInvalidArgumentException extends \InvalidArgumentException
29		{
30		/**
31		* @param object $entity
32		*
33		* @return ORMInvalidArgumentException
34		*/
35	1	static public function scheduleInsertForManagedEntity($entity)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
36		{
37	1	return new self("A managed+dirty entity " . self::objToStr($entity) . " can not be scheduled for insertion.");
38		}
39
40		/**
41		* @param object $entity
42		*
43		* @return ORMInvalidArgumentException
44		*/
45	1	static public function scheduleInsertForRemovedEntity($entity)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
46		{
47	1	return new self("Removed entity " . self::objToStr($entity) . " can not be scheduled for insertion.");
48		}
49
50		/**
51		* @param object $entity
52		*
53		* @return ORMInvalidArgumentException
54		*/
55	1	static public function scheduleInsertTwice($entity)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
56		{
57	1	return new self("Entity " . self::objToStr($entity) . " can not be scheduled for insertion twice.");
58		}
59
60		/**
61		* @param string $className
62		* @param object $entity
63		*
64		* @return ORMInvalidArgumentException
65		*/
66	6	static public function entityWithoutIdentity($className, $entity)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
67		{
68	6	return new self(
69	6	"The given entity of type '" . $className . "' (".self::objToStr($entity).") has no identity/no " .
70	6	"id values set. It cannot be added to the identity map."
71		);
72		}
73
74		/**
75		* @param object $entity
76		*
77		* @return ORMInvalidArgumentException
78		*/
79	1	static public function readOnlyRequiresManagedEntity($entity)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
80		{
81	1	return new self("Only managed entities can be marked or checked as read only. But " . self::objToStr($entity) . " is not");
82		}
83
84		/**
85		* @param array[][]\|object[][] $newEntitiesWithAssociations non-empty an array
86		* of [array $associationMapping, object $entity] pairs
87		*
88		* @return ORMInvalidArgumentException
89		*/
90	8	static public function newEntitiesFoundThroughRelationships($newEntitiesWithAssociations)
		0 ignored issues – show Coding Style introduced 2017-08-22 08:40 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
91		{
92	8	$errorMessages = array_map(
93	8	function (array $newEntityWithAssociation) : string {
94	8	[$associationMapping, $entity] = $newEntityWithAssociation;
		0 ignored issues – show Bug introduced 2017-08-22 08:40 UTC by Report Bug Copy Issue Report The variable `$associationMapping` does not exist. Did you forget to declare it? This check marks access to variables or properties that have not been declared yet. While PHP has no explicit notion of declaring a variable, accessing it before a value is assigned to it is most likely a bug. Loading history... Bug introduced 2017-08-22 08:40 UTC by Report Bug Copy Issue Report The variable `$entity` does not exist. Did you mean `$newEntityWithAssociation`? This check looks for variables that are accessed but have not been defined. It raises an issue if it finds another variable that has a similar name. The variable may have been renamed without also renaming all references. Loading history...
95
96	8	return self::newEntityFoundThroughRelationshipMessage($associationMapping, $entity);
		0 ignored issues – show Bug introduced 2017-08-22 08:40 UTC by Report Bug Copy Issue Report The variable `$entity` does not exist. Did you mean `$newEntityWithAssociation`? This check looks for variables that are accessed but have not been defined. It raises an issue if it finds another variable that has a similar name. The variable may have been renamed without also renaming all references. Loading history...
97	8	},
98	8	$newEntitiesWithAssociations
99		);
100
101	8	if (1 === count($errorMessages)) {
102	7	return new self(reset($errorMessages));
103		}
104
105	1	return new self(
106		'Multiple non-persisted new entities were found through the given association graph:'
107		. "\n\n * "
108	1	. implode("\n * ", $errorMessages)
109		);
110		}
111
112		/**
113		* @param array $associationMapping
114		* @param object $entry
115		*
116		* @return ORMInvalidArgumentException
117		*/
118		static public function newEntityFoundThroughRelationship(array $associationMapping, $entry)
		0 ignored issues – show Coding Style introduced 2017-08-22 08:40 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
119		{
120		return new self(self::newEntityFoundThroughRelationshipMessage($associationMapping, $entry));
121		}
122
123		/**
124		* @param array $assoc
125		* @param object $entry
126		*
127		* @return ORMInvalidArgumentException
128		*/
129		static public function detachedEntityFoundThroughRelationship(array $assoc, $entry)
		0 ignored issues – show Coding Style introduced 2017-08-01 02:13 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
130		{
131		return new self("A detached entity of type " . $assoc['targetEntity'] . " (" . self::objToStr($entry) . ") "
132		. " was found through the relationship '" . $assoc['sourceEntity'] . "#" . $assoc['fieldName'] . "' "
133		. "during cascading a persist operation.");
134		}
135
136		/**
137		* @param object $entity
138		*
139		* @return ORMInvalidArgumentException
140		*/
141	1	static public function entityNotManaged($entity)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
142		{
143	1	return new self("Entity " . self::objToStr($entity) . " is not managed. An entity is managed if its fetched " .
144	1	"from the database or registered as new through EntityManager#persist");
145		}
146
147		/**
148		* @param object $entity
149		* @param string $operation
150		*
151		* @return ORMInvalidArgumentException
152		*/
153		static public function entityHasNoIdentity($entity, $operation)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
154		{
155		return new self("Entity has no identity, therefore " . $operation ." cannot be performed. " . self::objToStr($entity));
156		}
157
158		/**
159		* @param object $entity
160		* @param string $operation
161		*
162		* @return ORMInvalidArgumentException
163		*/
164		static public function entityIsRemoved($entity, $operation)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
165		{
166		return new self("Entity is removed, therefore " . $operation ." cannot be performed. " . self::objToStr($entity));
167		}
168
169		/**
170		* @param object $entity
171		* @param string $operation
172		*
173		* @return ORMInvalidArgumentException
174		*/
175		static public function detachedEntityCannot($entity, $operation)
		0 ignored issues – show Coding Style introduced 2017-07-31 20:33 UTC by Report Bug Copy Issue Report As per PSR2, the `static` declaration should come after the visibility declaration. Loading history...
176		{
177		return new self("Detached entity " . self::objToStr($entity) . " cannot be " . $operation);
178		}
179
180		/**
181		* @param string $context
182		* @param mixed $given
183		* @param int $parameterIndex
184		*
185		* @return ORMInvalidArgumentException
186		*/
187	5	public static function invalidObject($context, $given, $parameterIndex = 1)
188		{
189	5	return new self($context . ' expects parameter ' . $parameterIndex .
190	5	' to be an entity object, '. gettype($given) . ' given.');
191		}
192
193		/**
194		* @return ORMInvalidArgumentException
195		*/
196		public static function invalidCompositeIdentifier()
197		{
198		return new self("Binding an entity with a composite primary key to a query is not supported. " .
199		"You should split the parameter into the explicit fields and bind them separately.");
200		}
201
202		/**
203		* @return ORMInvalidArgumentException
204		*/
205	1	public static function invalidIdentifierBindingEntity()
206		{
207	1	return new self("Binding entities to query parameters only allowed for entities that have an identifier.");
208		}
209
210		/**
211		* @param ClassMetadata $targetClass
212		* @param array $assoc
213		* @param mixed $actualValue
214		*
215		* @return self
216		*/
217	13	public static function invalidAssociation(ClassMetadata $targetClass, $assoc, $actualValue)
218		{
219	13	$expectedType = 'Doctrine\Common\Collections\Collection\|array';
220
221	13	if (($assoc['type'] & ClassMetadata::TO_ONE) > 0) {
222	13	$expectedType = $targetClass->getName();
223		}
224
225	13	return new self(sprintf(
226	13	'Expected value of type "%s" for association field "%s#$%s", got "%s" instead.',
227	13	$expectedType,
228	13	$assoc['sourceEntity'],
229	13	$assoc['fieldName'],
230	13	is_object($actualValue) ? get_class($actualValue) : gettype($actualValue)
231		));
232		}
233
234		/**
235		* Used when a given entityName hasn't the good type
236		*
237		* @param mixed $entityName The given entity (which shouldn't be a string)
238		*
239		* @return self
240		*/
241	6	public static function invalidEntityName($entityName)
242		{
243	6	return new self(sprintf('Entity name must be a string, %s given', gettype($entityName)));
244		}
245
246		/**
247		* Helper method to show an object as string.
248		*
249		* @param object $obj
250		*
251		* @return string
252		*/
253	19	private static function objToStr($obj) : string
254		{
255	19	return method_exists($obj, '__toString') ? (string) $obj : get_class($obj).'@'.spl_object_hash($obj);
256		}
257
258		/**
259		* @param array $associationMapping
260		* @param object $entity
261		*/
262	8	private static function newEntityFoundThroughRelationshipMessage(array $associationMapping, $entity) : string
263		{
264		return 'A new entity was found through the relationship \''
265	8	. $associationMapping['sourceEntity'] . '#' . $associationMapping['fieldName'] . '\' that was not'
266	8	. ' configured to cascade persist operations for entity: ' . self::objToStr($entity) . '.'
267	8	. ' To solve this issue: Either explicitly call EntityManager#persist()'
268	8	. ' on this unknown entity or configure cascade persist'
269	8	. ' this association in the mapping for example @ManyToOne(..,cascade={"persist"}).'
270	8	. (method_exists($entity, '__toString')
271	2	? ''
272		: ' If you cannot find out which entity causes the problem implement \''
273	8	. $associationMapping['targetEntity'] . '#__toString()\' to get a clue.'
274		);
275		}
276		}
277

doctrine / orm

Push — master ( ddccd4...8ad3df )

newEntitiesFoundThroughRelationships() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like