Merge pull request #1165 from Ocramius/feature/#1120-metadata-info-command
[DDC-3205] #1120 - metadata info command
This commit is contained in:
Kim Hemsø Rasmussen
commit
6fc6d18882
@ -18,7 +18,7 @@
|
|||||||
"doctrine/collections": "~1.2",
|
"doctrine/collections": "~1.2",
|
||||||
"doctrine/dbal": ">=2.5-dev,<2.6-dev",
|
"doctrine/dbal": ">=2.5-dev,<2.6-dev",
|
||||||
"doctrine/instantiator": "~1.0.1",
|
"doctrine/instantiator": "~1.0.1",
|
||||||
"symfony/console": "2.*"
|
"symfony/console": "~2.3"
|
||||||
},
|
},
|
||||||
"require-dev": {
|
"require-dev": {
|
||||||
"symfony/yaml": "~2.1",
|
"symfony/yaml": "~2.1",
|
||||||
|
|||||||
@ -0,0 +1,298 @@
|
|||||||
|
<?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\Tools\Console\Command;
|
||||||
|
|
||||||
|
use Doctrine\Common\Persistence\Mapping\MappingException;
|
||||||
|
use Doctrine\ORM\EntityManagerInterface;
|
||||||
|
use Symfony\Component\Console\Command\Command;
|
||||||
|
use Symfony\Component\Console\Helper\TableHelper;
|
||||||
|
use Symfony\Component\Console\Input\InputArgument;
|
||||||
|
use Symfony\Component\Console\Input\InputInterface;
|
||||||
|
use Symfony\Component\Console\Output\OutputInterface;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Show information about mapped entities.
|
||||||
|
*
|
||||||
|
* @link www.doctrine-project.org
|
||||||
|
* @since 2.4
|
||||||
|
* @author Daniel Leech <daniel@dantleech.com>
|
||||||
|
*/
|
||||||
|
final class MappingDescribeCommand extends Command
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected function configure()
|
||||||
|
{
|
||||||
|
$this
|
||||||
|
->setName('orm:mapping:describe')
|
||||||
|
->addArgument('entityName', InputArgument::REQUIRED, 'Full or partial name of entity')
|
||||||
|
->setDescription('Display information about mapped objects')
|
||||||
|
->setHelp(<<<EOT
|
||||||
|
The %command.full_name% command describes the metadata for the given full or partial entity class name.
|
||||||
|
|
||||||
|
<info>%command.full_name%</info> My\Namespace\Entity\MyEntity
|
||||||
|
|
||||||
|
Or:
|
||||||
|
|
||||||
|
<info>%command.full_name%</info> MyEntity
|
||||||
|
EOT
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* {@inheritdoc}
|
||||||
|
*/
|
||||||
|
protected function execute(InputInterface $input, OutputInterface $output)
|
||||||
|
{
|
||||||
|
/* @var $entityManager \Doctrine\ORM\EntityManagerInterface */
|
||||||
|
$entityManager = $this->getHelper('em')->getEntityManager();
|
||||||
|
|
||||||
|
$this->displayEntity($input->getArgument('entityName'), $entityManager, $output);
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Display all the mapping information for a single Entity.
|
||||||
|
*
|
||||||
|
* @param string $entityName Full or partial entity class name
|
||||||
|
* @param EntityManagerInterface $entityManager
|
||||||
|
* @param OutputInterface $output
|
||||||
|
*/
|
||||||
|
private function displayEntity($entityName, EntityManagerInterface $entityManager, OutputInterface $output)
|
||||||
|
{
|
||||||
|
$table = new TableHelper();
|
||||||
|
|
||||||
|
$table->setHeaders(array('Field', 'Value'));
|
||||||
|
|
||||||
|
$metadata = $this->getClassMetadata($entityName, $entityManager);
|
||||||
|
|
||||||
|
array_map(
|
||||||
|
array($table, 'addRow'),
|
||||||
|
array_merge(
|
||||||
|
array(
|
||||||
|
$this->formatField('Name', $metadata->name),
|
||||||
|
$this->formatField('Root entity name', $metadata->rootEntityName),
|
||||||
|
$this->formatField('Custom generator definition', $metadata->customGeneratorDefinition),
|
||||||
|
$this->formatField('Custom repository class', $metadata->customRepositoryClassName),
|
||||||
|
$this->formatField('Mapped super class?', $metadata->isMappedSuperclass),
|
||||||
|
$this->formatField('Embedded class?', $metadata->isEmbeddedClass),
|
||||||
|
$this->formatField('Parent classes', $metadata->parentClasses),
|
||||||
|
$this->formatField('Sub classes', $metadata->subClasses),
|
||||||
|
$this->formatField('Embedded classes', $metadata->subClasses),
|
||||||
|
$this->formatField('Named queries', $metadata->namedQueries),
|
||||||
|
$this->formatField('Named native queries', $metadata->namedNativeQueries),
|
||||||
|
$this->formatField('SQL result set mappings', $metadata->sqlResultSetMappings),
|
||||||
|
$this->formatField('Identifier', $metadata->identifier),
|
||||||
|
$this->formatField('Inheritance type', $metadata->inheritanceType),
|
||||||
|
$this->formatField('Discriminator column', $metadata->discriminatorColumn),
|
||||||
|
$this->formatField('Discriminator value', $metadata->discriminatorValue),
|
||||||
|
$this->formatField('Discriminator map', $metadata->discriminatorMap),
|
||||||
|
$this->formatField('Generator type', $metadata->generatorType),
|
||||||
|
$this->formatField('Table', $metadata->table),
|
||||||
|
$this->formatField('Composite identifier?', $metadata->isIdentifierComposite),
|
||||||
|
$this->formatField('Foreign identifier?', $metadata->containsForeignIdentifier),
|
||||||
|
$this->formatField('Sequence generator definition', $metadata->sequenceGeneratorDefinition),
|
||||||
|
$this->formatField('Table generator definition', $metadata->tableGeneratorDefinition),
|
||||||
|
$this->formatField('Change tracking policy', $metadata->changeTrackingPolicy),
|
||||||
|
$this->formatField('Versioned?', $metadata->isVersioned),
|
||||||
|
$this->formatField('Version field', $metadata->versionField),
|
||||||
|
$this->formatField('Read only?', $metadata->isReadOnly),
|
||||||
|
|
||||||
|
$this->formatEntityListeners($metadata->entityListeners),
|
||||||
|
),
|
||||||
|
array($this->formatField('Association mappings:', '')),
|
||||||
|
$this->formatMappings($metadata->associationMappings),
|
||||||
|
array($this->formatField('Field mappings:', '')),
|
||||||
|
$this->formatMappings($metadata->fieldMappings)
|
||||||
|
)
|
||||||
|
);
|
||||||
|
|
||||||
|
$table->render($output);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return all mapped entity class names
|
||||||
|
*
|
||||||
|
* @param EntityManagerInterface $entityManager
|
||||||
|
*
|
||||||
|
* @return string[]
|
||||||
|
*/
|
||||||
|
private function getMappedEntities(EntityManagerInterface $entityManager)
|
||||||
|
{
|
||||||
|
$entityClassNames = $entityManager
|
||||||
|
->getConfiguration()
|
||||||
|
->getMetadataDriverImpl()
|
||||||
|
->getAllClassNames();
|
||||||
|
|
||||||
|
if ( ! $entityClassNames) {
|
||||||
|
throw new \InvalidArgumentException(
|
||||||
|
'You do not have any mapped Doctrine ORM entities according to the current configuration. '.
|
||||||
|
'If you have entities or mapping files you should check your mapping configuration for errors.'
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
return $entityClassNames;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Return the class metadata for the given entity
|
||||||
|
* name
|
||||||
|
*
|
||||||
|
* @param string $entityName Full or partial entity name
|
||||||
|
* @param EntityManagerInterface $entityManager
|
||||||
|
*
|
||||||
|
* @return \Doctrine\ORM\Mapping\ClassMetadata
|
||||||
|
*/
|
||||||
|
private function getClassMetadata($entityName, EntityManagerInterface $entityManager)
|
||||||
|
{
|
||||||
|
try {
|
||||||
|
return $entityManager->getClassMetadata($entityName);
|
||||||
|
} catch (MappingException $e) {
|
||||||
|
}
|
||||||
|
|
||||||
|
$matches = array_filter(
|
||||||
|
$this->getMappedEntities($entityManager),
|
||||||
|
function ($mappedEntity) use ($entityName) {
|
||||||
|
return preg_match('{' . preg_quote($entityName) . '}', $mappedEntity);
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
if ( ! $matches) {
|
||||||
|
throw new \InvalidArgumentException(sprintf(
|
||||||
|
'Could not find any mapped Entity classes matching "%s"',
|
||||||
|
$entityName
|
||||||
|
));
|
||||||
|
}
|
||||||
|
|
||||||
|
if (count($matches) > 1) {
|
||||||
|
throw new \InvalidArgumentException(sprintf(
|
||||||
|
'Entity name "%s" is ambigous, possible matches: "%s"',
|
||||||
|
$entityName, implode(', ', $matches)
|
||||||
|
));
|
||||||
|
}
|
||||||
|
|
||||||
|
return $entityManager->getClassMetadata(current($matches));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Format the given value for console output
|
||||||
|
*
|
||||||
|
* @param mixed $value
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
private function formatValue($value)
|
||||||
|
{
|
||||||
|
if ('' === $value) {
|
||||||
|
return '';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (null === $value) {
|
||||||
|
return '<comment>Null</comment>';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (is_bool($value)) {
|
||||||
|
return '<comment>' . ($value ? 'True' : 'False') . '</comment>';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (empty($value)) {
|
||||||
|
return '<comment>Empty</comment>';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (is_array($value)) {
|
||||||
|
if (defined('JSON_UNESCAPED_UNICODE') && defined('JSON_UNESCAPED_SLASHES')) {
|
||||||
|
return json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
|
||||||
|
}
|
||||||
|
|
||||||
|
return json_encode($value);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (is_object($value)) {
|
||||||
|
return sprintf('<%s>', get_class($value));
|
||||||
|
}
|
||||||
|
|
||||||
|
if (is_scalar($value)) {
|
||||||
|
return $value;
|
||||||
|
}
|
||||||
|
|
||||||
|
throw new \InvalidArgumentException(sprintf('Do not know how to format value "%s"', print_r($value, true)));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add the given label and value to the two column table output
|
||||||
|
*
|
||||||
|
* @param string $label Label for the value
|
||||||
|
* @param mixed $value A Value to show
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
|
*/
|
||||||
|
private function formatField($label, $value)
|
||||||
|
{
|
||||||
|
if (null === $value) {
|
||||||
|
$value = '<comment>None</comment>';
|
||||||
|
}
|
||||||
|
|
||||||
|
return array(sprintf('<info>%s</info>', $label), $this->formatValue($value));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Format the association mappings
|
||||||
|
*
|
||||||
|
* @param array
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
|
*/
|
||||||
|
private function formatMappings(array $propertyMappings)
|
||||||
|
{
|
||||||
|
$output = array();
|
||||||
|
|
||||||
|
foreach ($propertyMappings as $propertyName => $mapping) {
|
||||||
|
$output[] = $this->formatField(sprintf(' %s', $propertyName), '');
|
||||||
|
|
||||||
|
foreach ($mapping as $field => $value) {
|
||||||
|
$output[] = $this->formatField(sprintf(' %s', $field), $this->formatValue($value));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return $output;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Format the entity listeners
|
||||||
|
*
|
||||||
|
* @param array $entityListeners
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
|
*/
|
||||||
|
private function formatEntityListeners(array $entityListeners)
|
||||||
|
{
|
||||||
|
return $this->formatField(
|
||||||
|
'Entity listeners',
|
||||||
|
array_map(
|
||||||
|
function ($entityListener) {
|
||||||
|
return get_class($entityListener);
|
||||||
|
},
|
||||||
|
$entityListeners
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
@ -107,7 +107,8 @@ class ConsoleRunner
|
|||||||
new \Doctrine\ORM\Tools\Console\Command\ConvertMappingCommand(),
|
new \Doctrine\ORM\Tools\Console\Command\ConvertMappingCommand(),
|
||||||
new \Doctrine\ORM\Tools\Console\Command\RunDqlCommand(),
|
new \Doctrine\ORM\Tools\Console\Command\RunDqlCommand(),
|
||||||
new \Doctrine\ORM\Tools\Console\Command\ValidateSchemaCommand(),
|
new \Doctrine\ORM\Tools\Console\Command\ValidateSchemaCommand(),
|
||||||
new \Doctrine\ORM\Tools\Console\Command\InfoCommand()
|
new \Doctrine\ORM\Tools\Console\Command\InfoCommand(),
|
||||||
|
new \Doctrine\ORM\Tools\Console\Command\MappingDescribeCommand(),
|
||||||
));
|
));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@ -0,0 +1,56 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace Doctrine\Tests\ORM\Tools\Console\Command;
|
||||||
|
|
||||||
|
use Doctrine\ORM\Tools\Console\Command\ClearCache\CollectionRegionCommand;
|
||||||
|
use Doctrine\ORM\Tools\Console\Helper\EntityManagerHelper;
|
||||||
|
use Symfony\Component\Console\Tester\CommandTester;
|
||||||
|
use Symfony\Component\Console\Helper\HelperSet;
|
||||||
|
use Symfony\Component\Console\Application;
|
||||||
|
use Doctrine\Tests\OrmFunctionalTestCase;
|
||||||
|
use Doctrine\ORM\Tools\Console\Command\InfoCommand;
|
||||||
|
|
||||||
|
class InfoCommandTest extends OrmFunctionalTestCase
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* @var \Symfony\Component\Console\Application
|
||||||
|
*/
|
||||||
|
private $application;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @var \Doctrine\ORM\Tools\Console\Command\InfoCommand
|
||||||
|
*/
|
||||||
|
private $command;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @var \Symfony\Component\Console\Tester\CommandTester
|
||||||
|
*/
|
||||||
|
private $tester;
|
||||||
|
|
||||||
|
protected function setUp()
|
||||||
|
{
|
||||||
|
parent::setUp();
|
||||||
|
|
||||||
|
$this->application = new Application();
|
||||||
|
$command = new InfoCommand();
|
||||||
|
|
||||||
|
$this->application->setHelperSet(new HelperSet(array(
|
||||||
|
'em' => new EntityManagerHelper($this->_em)
|
||||||
|
)));
|
||||||
|
|
||||||
|
$this->application->add($command);
|
||||||
|
|
||||||
|
$this->command = $this->application->find('orm:info');
|
||||||
|
$this->tester = new CommandTester($command);
|
||||||
|
}
|
||||||
|
|
||||||
|
public function testListAllClasses()
|
||||||
|
{
|
||||||
|
$this->tester->execute(array(
|
||||||
|
'command' => $this->command->getName(),
|
||||||
|
));
|
||||||
|
|
||||||
|
$this->assertContains('Doctrine\Tests\Models\Cache\AttractionInfo', $this->tester->getDisplay());
|
||||||
|
$this->assertContains('Doctrine\Tests\Models\Cache\City', $this->tester->getDisplay());
|
||||||
|
}
|
||||||
|
}
|
||||||
@ -0,0 +1,87 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace Doctrine\Tests\ORM\Tools\Console\Command;
|
||||||
|
|
||||||
|
use Doctrine\ORM\Tools\Console\Command\MappingDescribeCommand;
|
||||||
|
use Doctrine\ORM\Tools\Console\Helper\EntityManagerHelper;
|
||||||
|
use Doctrine\Tests\OrmFunctionalTestCase;
|
||||||
|
use Symfony\Component\Console\Application;
|
||||||
|
use Symfony\Component\Console\Helper\HelperSet;
|
||||||
|
use Symfony\Component\Console\Tester\CommandTester;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Tests for {@see \Doctrine\ORM\Tools\Console\Command\MappingDescribeCommand}
|
||||||
|
*
|
||||||
|
* @covers \Doctrine\ORM\Tools\Console\Command\MappingDescribeCommand
|
||||||
|
*/
|
||||||
|
class MappingDescribeCommandTest extends OrmFunctionalTestCase
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* @var \Symfony\Component\Console\Application
|
||||||
|
*/
|
||||||
|
private $application;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @var \Doctrine\ORM\Tools\Console\Command\InfoCommand
|
||||||
|
*/
|
||||||
|
private $command;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @var \Symfony\Component\Console\Tester\CommandTester
|
||||||
|
*/
|
||||||
|
private $tester;
|
||||||
|
|
||||||
|
protected function setUp()
|
||||||
|
{
|
||||||
|
parent::setUp();
|
||||||
|
|
||||||
|
$this->application = new Application();
|
||||||
|
$command = new MappingDescribeCommand();
|
||||||
|
|
||||||
|
$this->application->setHelperSet(new HelperSet(array(
|
||||||
|
'em' => new EntityManagerHelper($this->_em)
|
||||||
|
)));
|
||||||
|
|
||||||
|
$this->application->add($command);
|
||||||
|
|
||||||
|
$this->command = $this->application->find('orm:mapping:describe');
|
||||||
|
$this->tester = new CommandTester($command);
|
||||||
|
}
|
||||||
|
|
||||||
|
public function testShowSpecificFuzzySingle()
|
||||||
|
{
|
||||||
|
$this->tester->execute(array(
|
||||||
|
'command' => $this->command->getName(),
|
||||||
|
'entityName' => 'AttractionInfo',
|
||||||
|
));
|
||||||
|
|
||||||
|
$display = $this->tester->getDisplay();
|
||||||
|
$this->assertContains('Doctrine\Tests\Models\Cache\AttractionInfo', $display);
|
||||||
|
$this->assertContains('Root entity name', $display);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @expectedException \InvalidArgumentException
|
||||||
|
* @expectedExceptionMessage possible matches
|
||||||
|
*/
|
||||||
|
public function testShowSpecificFuzzyAmbiguous()
|
||||||
|
{
|
||||||
|
$this->tester->execute(array(
|
||||||
|
'command' => $this->command->getName(),
|
||||||
|
'entityName' => 'Attraction',
|
||||||
|
));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @expectedException \InvalidArgumentException
|
||||||
|
* @expectedExceptionMessage Could not find any mapped Entity classes matching "AttractionFooBar"
|
||||||
|
*/
|
||||||
|
public function testShowSpecificNotFound()
|
||||||
|
{
|
||||||
|
$this->tester->execute(array(
|
||||||
|
'command' => $this->command->getName(),
|
||||||
|
'entityName' => 'AttractionFooBar'
|
||||||
|
));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
Loading…
x
Reference in New Issue
Block a user