Doctrine\ODM\MongoDB\MongoDBException

Complexity

Total Complexity

20

Size/Duplication

Total Lines	114
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Test Coverage

Coverage

48%

Importance

Changes

0

17 Methods

Rating	Name	Duplication	Size	Complexity
A	unknownDocumentNamespace()	0	4	1
A	detachedDocumentCannotBeRemoved()	0	4	1
A	invalidDocumentState()	0	4	1
A	documentNotMappedToCollection()	0	4	1
A	documentManagerClosed()	0	4	1
A	cannotPersistMappedSuperclass()	0	4	1
A	invalidDocumentRepository()	0	4	1
A	invalidGridFSRepository()	0	4	1
A	invalidValueForType()	0	18	4
A	shardKeyFieldMissing()	0	4	1
A	failedToEnableSharding()	0	8	1
A	commitInProgress()	0	4	1
A	documentBucketOnlyAvailableForGridFSFiles()	0	4	1
A	cannotPersistGridFSFile()	0	4	1
A	cannotReadGridFSSourceFile()	0	4	1
A	failedToEnsureDocumentSharding()	0	8	1
A	shardKeyFieldCannotBeChanged()	0	4	1

<?php

declare(strict_types=1);

namespace Doctrine\ODM\MongoDB;

use Doctrine\Common\Persistence\ObjectRepository;
use Doctrine\ODM\MongoDB\Repository\GridFSRepository;
use function array_slice;
use function end;
use function get_class;
use function implode;
use function is_array;
use function is_object;
use function sprintf;

/**
 * Class for all exceptions related to the Doctrine MongoDB ODM
 *
 */
class MongoDBException extends \Exception
{
    public static function detachedDocumentCannotBeRemoved(): self
    {
        return new self('Detached document cannot be removed');
    }

    public static function invalidDocumentState(int $state): self
    {
        return new self(sprintf('Invalid document state "%s"', $state));
    }

    public static function documentNotMappedToCollection(string $className): self
    {
        return new self(sprintf('The "%s" document is not mapped to a MongoDB database collection.', $className));
    }

    public static function documentManagerClosed(): self
    {
        return new self('The DocumentManager is closed.');
    }

    public static function unknownDocumentNamespace(string $documentNamespaceAlias): self
    {
        return new self(sprintf("Unknown Document namespace alias '%s'.", $documentNamespaceAlias));
    }

    public static function cannotPersistMappedSuperclass(string $className): self
    {
        return new self('Cannot persist an embedded document, aggregation result document or mapped superclass ' . $className);
    }

    public static function invalidDocumentRepository(string $className): self
    {
        return new self(sprintf("Invalid repository class '%s'. It must be a %s.", $className, ObjectRepository::class));
    }

    public static function invalidGridFSRepository(string $className): self
    {
        return new self(sprintf("Invalid repository class '%s'. It must be a %s.", $className, GridFSRepository::class));
    }

    /**
     * @param string|array $expected
     * @param mixed        $got
     * @return MongoDBException
     */
    public static function invalidValueForType(string $type, $expected, $got): self
    {
        if (is_array($expected)) {
            $expected = sprintf(
                '%s or %s',
                implode(', ', array_slice($expected, 0, -1)),
                end($expected)
            );
        }
        if (is_object($got)) {
            $gotType = get_class($got);
        } elseif (is_array($got)) {
            $gotType = 'array';
        } else {
            $gotType = 'scalar';
        }
        return new self(sprintf('%s type requires value of type %s, %s given', $type, $expected, $gotType));
    }

    public static function shardKeyFieldCannotBeChanged(string $field, string $className): self
    {
        return new self(sprintf('Shard key field "%s" in class "%s" cannot be changed.', $field, $className));
    }

    public static function shardKeyFieldMissing(string $field, string $className): self
    {
        return new self(sprintf('Shard key field "%s" in class "%s" is missing.', $field, $className));
    }

    public static function failedToEnableSharding(string $dbName, string $errorMessage): self
    {
        return new self(sprintf(
            'Failed to enable sharding for database "%s". Error from MongoDB: %s',
            $dbName,
            $errorMessage
        ));
    }

    public static function failedToEnsureDocumentSharding(string $className, string $errorMessage): self
    {
        return new self(sprintf(
            'Failed to ensure sharding for document "%s". Error from MongoDB: %s',
            $className,
            $errorMessage
        ));
    }

    public static function commitInProgress(): self
    {
        return new self('There is already a commit operation in progress. Did you call flush from an event listener?');
    }

    public static function documentBucketOnlyAvailableForGridFSFiles(string $className): self
    {
        return new self(sprintf('Cannot fetch document bucket for document "%s".', $className));
    }

    public static function cannotPersistGridFSFile(string $className): self
    {
        return new self(sprintf('Cannot persist GridFS file for class "%s" through UnitOfWork.', $className));
    }

    public static function cannotReadGridFSSourceFile(string $filename): self
    {
        return new self(sprintf('Cannot open file "%s" for uploading to GridFS.', $filename));
    }
}