130 lines
4.5 KiB
PHP
130 lines
4.5 KiB
PHP
<?php
|
|
/*
|
|
* $Id$
|
|
*
|
|
* 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 LGPL. For more information, see
|
|
* <http://www.phpdoctrine.org>.
|
|
*/
|
|
|
|
namespace Doctrine\ORM\Mapping;
|
|
|
|
/**
|
|
* A MappingException indicates that something is wrong with the mapping setup.
|
|
*
|
|
* @since 2.0
|
|
*/
|
|
class MappingException extends \Doctrine\ORM\ORMException
|
|
{
|
|
public static function identifierRequired($entityName)
|
|
{
|
|
return new self("No identifier/primary key specified for Entity '$entityName'."
|
|
. " Every Entity must have an identifier/primary key.");
|
|
}
|
|
|
|
public static function invalidInheritanceType($type)
|
|
{
|
|
return new self("The inheritance type '$type' does not exist.");
|
|
}
|
|
|
|
public static function generatorNotAllowedWithCompositeId()
|
|
{
|
|
return new self("Id generators can't be used with a composite id.");
|
|
}
|
|
|
|
public static function missingFieldName()
|
|
{
|
|
return new self("The association mapping misses the 'fieldName' attribute.");
|
|
}
|
|
|
|
public static function missingTargetEntity($fieldName)
|
|
{
|
|
return new self("The association mapping '$fieldName' misses the 'targetEntity' attribute.");
|
|
}
|
|
|
|
public static function missingSourceEntity($fieldName)
|
|
{
|
|
return new self("The association mapping '$fieldName' misses the 'sourceEntity' attribute.");
|
|
}
|
|
|
|
public static function mappingFileNotFound($fileName)
|
|
{
|
|
return new self("No mapping file found named '$fileName'.");
|
|
}
|
|
|
|
public static function mappingNotFound($fieldName)
|
|
{
|
|
return new self("No mapping found for field '$fieldName'.");
|
|
}
|
|
|
|
public static function oneToManyRequiresMappedBy($fieldName)
|
|
{
|
|
return new self("OneToMany mapping on field '$fieldName' requires the 'mappedBy' attribute.");
|
|
}
|
|
|
|
public static function joinTableRequired($fieldName)
|
|
{
|
|
return new self("The mapping of field '$fieldName' requires an the 'joinTable' attribute.");
|
|
}
|
|
|
|
/**
|
|
* Called if a required option was not found but is required
|
|
*
|
|
* @param string $field which field cannot be processed?
|
|
* @param string $expectedOption which option is required
|
|
* @param string $hint Can optionally be used to supply a tip for common mistakes,
|
|
* e.g. "Did you think of the plural s?"
|
|
* @return MappingException
|
|
*/
|
|
static function missingRequiredOption($field, $expectedOption, $hint = '')
|
|
{
|
|
$message = "The mapping of field '{$field}' is invalid: The option '{$expectedOption}' is required.";
|
|
|
|
if ( ! empty($hint)) {
|
|
$message .= ' (Hint: ' . $hint . ')';
|
|
}
|
|
|
|
return new self($message);
|
|
}
|
|
|
|
/**
|
|
* Generic exception for invalid mappings.
|
|
*
|
|
* @param string $fieldName
|
|
*/
|
|
public static function invalidMapping($fieldName)
|
|
{
|
|
return new self("The mapping of field '$fieldName' is invalid.");
|
|
}
|
|
|
|
/**
|
|
* Exception for reflection exceptions - adds the entity name,
|
|
* because there might be long classnames that will be shortened
|
|
* within the stacktrace
|
|
*
|
|
* @param string $entity The entity's name
|
|
* @param \ReflectionException $previousException
|
|
*/
|
|
public static function reflectionFailure($entity, \ReflectionException $previousException)
|
|
{
|
|
return new self('An error occurred in ' . $entity, 0, $previousException);
|
|
}
|
|
|
|
public static function joinColumnMustPointToMappedField($className, $joinColumn)
|
|
{
|
|
return new self('The column ' . $joinColumn . ' must be mapped to a field in class '
|
|
. $className . ' since it is referenced by a join column of another class.');
|
|
}
|
|
} |