492 lines
16 KiB
PHP
492 lines
16 KiB
PHP
<?php
|
|
|
|
namespace Symfony\Tests\Component\Form;
|
|
|
|
require_once __DIR__ . '/Fixtures/Author.php';
|
|
require_once __DIR__ . '/Fixtures/TestField.php';
|
|
require_once __DIR__ . '/Fixtures/InvalidField.php';
|
|
require_once __DIR__ . '/Fixtures/RequiredOptionsField.php';
|
|
|
|
use Symfony\Component\Form\ValueTransformer\ValueTransformerInterface;
|
|
use Symfony\Component\Form\PropertyPath;
|
|
use Symfony\Tests\Component\Form\Fixtures\Author;
|
|
use Symfony\Tests\Component\Form\Fixtures\TestField;
|
|
use Symfony\Tests\Component\Form\Fixtures\InvalidField;
|
|
use Symfony\Tests\Component\Form\Fixtures\RequiredOptionsField;
|
|
|
|
class FieldTest extends \PHPUnit_Framework_TestCase
|
|
{
|
|
protected $field;
|
|
|
|
protected function setUp()
|
|
{
|
|
$this->field = new TestField('title');
|
|
}
|
|
|
|
public function testGetPropertyPath_defaultPath()
|
|
{
|
|
$field = new TestField('title');
|
|
|
|
$this->assertEquals(new PropertyPath('title'), $field->getPropertyPath());
|
|
}
|
|
|
|
public function testGetPropertyPath_pathIsZero()
|
|
{
|
|
$field = new TestField('title', array('property_path' => '0'));
|
|
|
|
$this->assertEquals(new PropertyPath('0'), $field->getPropertyPath());
|
|
}
|
|
|
|
public function testGetPropertyPath_pathIsEmpty()
|
|
{
|
|
$field = new TestField('title', array('property_path' => ''));
|
|
|
|
$this->assertEquals(null, $field->getPropertyPath());
|
|
}
|
|
|
|
public function testGetPropertyPath_pathIsNull()
|
|
{
|
|
$field = new TestField('title', array('property_path' => null));
|
|
|
|
$this->assertEquals(null, $field->getPropertyPath());
|
|
}
|
|
|
|
public function testPassRequiredAsOption()
|
|
{
|
|
$field = new TestField('title', array('required' => false));
|
|
|
|
$this->assertFalse($field->isRequired());
|
|
|
|
$field = new TestField('title', array('required' => true));
|
|
|
|
$this->assertTrue($field->isRequired());
|
|
}
|
|
|
|
public function testPassDisabledAsOption()
|
|
{
|
|
$field = new TestField('title', array('disabled' => false));
|
|
|
|
$this->assertFalse($field->isDisabled());
|
|
|
|
$field = new TestField('title', array('disabled' => true));
|
|
|
|
$this->assertTrue($field->isDisabled());
|
|
}
|
|
|
|
public function testFieldIsDisabledIfParentIsDisabled()
|
|
{
|
|
$field = new TestField('title', array('disabled' => false));
|
|
$field->setParent(new TestField('title', array('disabled' => true)));
|
|
|
|
$this->assertTrue($field->isDisabled());
|
|
}
|
|
|
|
public function testFieldWithNoErrorsIsValid()
|
|
{
|
|
$this->field->bind('data');
|
|
|
|
$this->assertTrue($this->field->isValid());
|
|
}
|
|
|
|
public function testFieldWithErrorsIsInvalid()
|
|
{
|
|
$this->field->bind('data');
|
|
$this->field->addError('Some error');
|
|
|
|
$this->assertFalse($this->field->isValid());
|
|
}
|
|
|
|
public function testBindResetsErrors()
|
|
{
|
|
$this->field->addError('Some error');
|
|
$this->field->bind('data');
|
|
|
|
$this->assertTrue($this->field->isValid());
|
|
}
|
|
|
|
public function testUnboundFieldIsInvalid()
|
|
{
|
|
$this->assertFalse($this->field->isValid());
|
|
}
|
|
|
|
public function testGetNameReturnsKey()
|
|
{
|
|
$this->assertEquals('title', $this->field->getName());
|
|
}
|
|
|
|
public function testGetNameIncludesParent()
|
|
{
|
|
$this->field->setParent($this->createMockGroupWithName('news[article]'));
|
|
|
|
$this->assertEquals('news[article][title]', $this->field->getName());
|
|
}
|
|
|
|
public function testGetIdReturnsKey()
|
|
{
|
|
$this->assertEquals('title', $this->field->getId());
|
|
}
|
|
|
|
public function testGetIdIncludesParent()
|
|
{
|
|
$this->field->setParent($this->createMockGroupWithId('news_article'));
|
|
|
|
$this->assertEquals('news_article_title', $this->field->getId());
|
|
}
|
|
|
|
public function testLocaleIsPassedToLocalizableValueTransformer_setLocaleCalledBefore()
|
|
{
|
|
$transformer = $this->getMock('Symfony\Component\Form\ValueTransformer\ValueTransformerInterface');
|
|
$transformer->expects($this->once())
|
|
->method('setLocale')
|
|
->with($this->equalTo('de_DE'));
|
|
|
|
$this->field->setLocale('de_DE');
|
|
$this->field->setValueTransformer($transformer);
|
|
}
|
|
|
|
public function testLocaleIsPassedToValueTransformer_setLocaleCalledAfter()
|
|
{
|
|
$transformer = $this->getMock('Symfony\Component\Form\ValueTransformer\ValueTransformerInterface');
|
|
$transformer->expects($this->exactly(2))
|
|
->method('setLocale'); // we can't test the params cause they differ :(
|
|
|
|
$this->field->setValueTransformer($transformer);
|
|
$this->field->setLocale('de_DE');
|
|
}
|
|
|
|
public function testIsRequiredReturnsOwnValueIfNoParent()
|
|
{
|
|
$this->field->setRequired(true);
|
|
$this->assertTrue($this->field->isRequired());
|
|
|
|
$this->field->setRequired(false);
|
|
$this->assertFalse($this->field->isRequired());
|
|
}
|
|
|
|
public function testIsRequiredReturnsOwnValueIfParentIsRequired()
|
|
{
|
|
$group = $this->createMockGroup();
|
|
$group->expects($this->any())
|
|
->method('isRequired')
|
|
->will($this->returnValue(true));
|
|
|
|
$this->field->setParent($group);
|
|
|
|
$this->field->setRequired(true);
|
|
$this->assertTrue($this->field->isRequired());
|
|
|
|
$this->field->setRequired(false);
|
|
$this->assertFalse($this->field->isRequired());
|
|
}
|
|
|
|
public function testIsRequiredReturnsFalseIfParentIsNotRequired()
|
|
{
|
|
$group = $this->createMockGroup();
|
|
$group->expects($this->any())
|
|
->method('isRequired')
|
|
->will($this->returnValue(false));
|
|
|
|
$this->field->setParent($group);
|
|
$this->field->setRequired(true);
|
|
|
|
$this->assertFalse($this->field->isRequired());
|
|
}
|
|
|
|
public function testExceptionIfUnknownOption()
|
|
{
|
|
$this->setExpectedException('Symfony\Component\Form\Exception\InvalidOptionsException');
|
|
|
|
new RequiredOptionsField('name', array('bar' => 'baz', 'moo' => 'maa'));
|
|
}
|
|
|
|
public function testExceptionIfMissingOption()
|
|
{
|
|
$this->setExpectedException('Symfony\Component\Form\Exception\MissingOptionsException');
|
|
|
|
new RequiredOptionsField('name');
|
|
}
|
|
|
|
public function testIsBound()
|
|
{
|
|
$this->assertFalse($this->field->isBound());
|
|
$this->field->bind('symfony');
|
|
$this->assertTrue($this->field->isBound());
|
|
}
|
|
|
|
public function testDefaultValuesAreTransformedCorrectly()
|
|
{
|
|
$field = new TestField('name');
|
|
|
|
$this->assertEquals(null, $this->field->getData());
|
|
$this->assertEquals('', $this->field->getDisplayedData());
|
|
}
|
|
|
|
public function testValuesAreTransformedCorrectlyIfNull()
|
|
{
|
|
// The value is converted to an empty string and NOT passed to the
|
|
// value transformer
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->never())
|
|
->method('transform');
|
|
|
|
$this->field->setValueTransformer($transformer);
|
|
$this->field->setData(null);
|
|
|
|
$this->assertSame(null, $this->field->getData());
|
|
$this->assertSame('', $this->field->getDisplayedData());
|
|
}
|
|
|
|
public function testValuesAreTransformedCorrectlyIfNull_noValueTransformer()
|
|
{
|
|
$this->field->setData(null);
|
|
|
|
$this->assertSame(null, $this->field->getData());
|
|
$this->assertSame('', $this->field->getDisplayedData());
|
|
}
|
|
|
|
public function testBoundValuesAreTransformedCorrectly()
|
|
{
|
|
$field = $this->getMock(
|
|
'Symfony\Tests\Component\Form\Fixtures\TestField',
|
|
array('processData'), // only mock processData()
|
|
array('title')
|
|
);
|
|
|
|
// 1. The value is converted to a string and passed to the value transformer
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->once())
|
|
->method('reverseTransform')
|
|
->with($this->identicalTo('0'))
|
|
->will($this->returnValue('reverse[0]'));
|
|
|
|
$field->setValueTransformer($transformer);
|
|
|
|
// 2. The output of the reverse transformation is passed to processData()
|
|
$field->expects($this->once())
|
|
->method('processData')
|
|
->with($this->equalTo('reverse[0]'))
|
|
->will($this->returnValue('processed[reverse[0]]'));
|
|
|
|
// 3. The processed data is transformed again (for displayed data)
|
|
$transformer->expects($this->once())
|
|
->method('transform')
|
|
->with($this->equalTo('processed[reverse[0]]'))
|
|
->will($this->returnValue('transform[processed[reverse[0]]]'));
|
|
|
|
$field->bind(0);
|
|
|
|
$this->assertEquals('processed[reverse[0]]', $field->getData());
|
|
$this->assertEquals('transform[processed[reverse[0]]]', $field->getDisplayedData());
|
|
}
|
|
|
|
public function testBoundValuesAreTransformedCorrectlyIfEmpty_processDataReturnsValue()
|
|
{
|
|
$field = $this->getMock(
|
|
'Symfony\Tests\Component\Form\Fixtures\TestField',
|
|
array('processData'), // only mock processData()
|
|
array('title')
|
|
);
|
|
|
|
// 1. Empty values are always converted to NULL. They are never passed to
|
|
// the value transformer
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->never())
|
|
->method('reverseTransform');
|
|
|
|
$field->setValueTransformer($transformer);
|
|
|
|
// 2. NULL is passed to processData()
|
|
$field->expects($this->once())
|
|
->method('processData')
|
|
->with($this->identicalTo(null))
|
|
->will($this->returnValue('processed'));
|
|
|
|
// 3. The processed data is transformed (for displayed data)
|
|
$transformer->expects($this->once())
|
|
->method('transform')
|
|
->with($this->equalTo('processed'))
|
|
->will($this->returnValue('transform[processed]'));
|
|
|
|
$field->bind('');
|
|
|
|
$this->assertSame('processed', $field->getData());
|
|
$this->assertEquals('transform[processed]', $field->getDisplayedData());
|
|
}
|
|
|
|
public function testBoundValuesAreTransformedCorrectlyIfEmpty_processDataReturnsNull()
|
|
{
|
|
// 1. Empty values are always converted to NULL. They are never passed to
|
|
// the value transformer
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->never())
|
|
->method('reverseTransform');
|
|
|
|
$this->field->setValueTransformer($transformer);
|
|
|
|
// 2. The processed data is NULL and therefore transformed to an empty
|
|
// string. It is NOT passed to the value transformer
|
|
$transformer->expects($this->never())
|
|
->method('transform');
|
|
|
|
$this->field->bind('');
|
|
|
|
$this->assertSame(null, $this->field->getData());
|
|
$this->assertEquals('', $this->field->getDisplayedData());
|
|
}
|
|
|
|
public function testBoundValuesAreTransformedCorrectlyIfEmpty_processDataReturnsNull_noValueTransformer()
|
|
{
|
|
$this->field->bind('');
|
|
|
|
$this->assertSame(null, $this->field->getData());
|
|
$this->assertEquals('', $this->field->getDisplayedData());
|
|
}
|
|
|
|
public function testValuesAreTransformedCorrectly()
|
|
{
|
|
// The value is passed to the value transformer
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->once())
|
|
->method('transform')
|
|
->with($this->identicalTo(0))
|
|
->will($this->returnValue('transform[0]'));
|
|
|
|
$this->field->setValueTransformer($transformer);
|
|
$this->field->setData(0);
|
|
|
|
$this->assertEquals(0, $this->field->getData());
|
|
$this->assertEquals('transform[0]', $this->field->getDisplayedData());
|
|
}
|
|
|
|
public function testBoundValuesAreTrimmedBeforeTransforming()
|
|
{
|
|
// The value is passed to the value transformer
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->once())
|
|
->method('reverseTransform')
|
|
->with($this->identicalTo('a'))
|
|
->will($this->returnValue('reverse[a]'));
|
|
|
|
$transformer->expects($this->once())
|
|
->method('transform')
|
|
->with($this->identicalTo('reverse[a]'))
|
|
->will($this->returnValue('a'));
|
|
|
|
$this->field->setValueTransformer($transformer);
|
|
$this->field->bind(' a ');
|
|
|
|
$this->assertEquals('a', $this->field->getDisplayedData());
|
|
$this->assertEquals('reverse[a]', $this->field->getData());
|
|
}
|
|
|
|
public function testBoundValuesAreNotTrimmedBeforeTransformingIfDisabled()
|
|
{
|
|
// The value is passed to the value transformer
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->once())
|
|
->method('reverseTransform')
|
|
->with($this->identicalTo(' a '))
|
|
->will($this->returnValue('reverse[ a ]'));
|
|
|
|
$transformer->expects($this->once())
|
|
->method('transform')
|
|
->with($this->identicalTo('reverse[ a ]'))
|
|
->will($this->returnValue(' a '));
|
|
|
|
$field = new TestField('title', array('trim' => false));
|
|
$field->setValueTransformer($transformer);
|
|
$field->bind(' a ');
|
|
|
|
$this->assertEquals(' a ', $field->getDisplayedData());
|
|
$this->assertEquals('reverse[ a ]', $field->getData());
|
|
}
|
|
|
|
/*
|
|
* The use case of this test is a field group with an empty property path.
|
|
* Even if the field group itself is not associated to a specific property,
|
|
* nested fields might be.
|
|
*/
|
|
public function testUpdateFromObjectPassesObjectThroughIfPropertyPathIsEmpty()
|
|
{
|
|
$object = new Author();
|
|
$object->firstName = 'Bernhard';
|
|
|
|
$field = new TestField('firstName', array('property_path' => null));
|
|
$field->updateFromObject($object);
|
|
|
|
$this->assertEquals($object, $field->getData());
|
|
}
|
|
|
|
/*
|
|
* This is important so that bind() can work even if setData() was not called
|
|
* before
|
|
*/
|
|
public function testUpdateObjectTreatsEmptyValuesAsArrays()
|
|
{
|
|
$array = null;
|
|
|
|
$field = new TestField('firstName');
|
|
$field->bind('Bernhard');
|
|
$field->updateObject($array);
|
|
|
|
$this->assertEquals(array('firstName' => 'Bernhard'), $array);
|
|
}
|
|
|
|
public function testUpdateObjectDoesNotUpdatePropertyIfPropertyPathIsEmpty()
|
|
{
|
|
$object = new Author();
|
|
|
|
$field = new TestField('firstName', array('property_path' => null));
|
|
$field->bind('Bernhard');
|
|
$field->updateObject($object);
|
|
|
|
$this->assertEquals(null, $object->firstName);
|
|
}
|
|
|
|
protected function createMockTransformer()
|
|
{
|
|
return $this->getMock('Symfony\Component\Form\ValueTransformer\ValueTransformerInterface', array(), array(), '', false, false);
|
|
}
|
|
|
|
protected function createMockTransformerTransformingTo($value)
|
|
{
|
|
$transformer = $this->createMockTransformer();
|
|
$transformer->expects($this->any())
|
|
->method('reverseTransform')
|
|
->will($this->returnValue($value));
|
|
|
|
return $transformer;
|
|
}
|
|
|
|
protected function createMockGroup()
|
|
{
|
|
return $this->getMock(
|
|
'Symfony\Component\Form\FieldGroup',
|
|
array(),
|
|
array(),
|
|
'',
|
|
false // don't call constructor
|
|
);
|
|
}
|
|
|
|
protected function createMockGroupWithName($name)
|
|
{
|
|
$group = $this->createMockGroup();
|
|
$group->expects($this->any())
|
|
->method('getName')
|
|
->will($this->returnValue($name));
|
|
|
|
return $group;
|
|
}
|
|
|
|
protected function createMockGroupWithId($id)
|
|
{
|
|
$group = $this->createMockGroup();
|
|
$group->expects($this->any())
|
|
->method('getId')
|
|
->will($this->returnValue($id));
|
|
|
|
return $group;
|
|
}
|
|
}
|