You are here

class ValidatorBuilder in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 vendor/symfony/validator/ValidatorBuilder.php \Symfony\Component\Validator\ValidatorBuilder

The default implementation of {@link ValidatorBuilderInterface}.

@author Bernhard Schussek <bschussek@gmail.com>

Hierarchy

Expanded class hierarchy of ValidatorBuilder

1 file declares its use of ValidatorBuilder
ValidatorBuilderTest.php in vendor/symfony/validator/Tests/ValidatorBuilderTest.php

File

vendor/symfony/validator/ValidatorBuilder.php, line 40

Namespace

Symfony\Component\Validator
View source
class ValidatorBuilder implements ValidatorBuilderInterface {

  /**
   * @var array
   */
  private $initializers = array();

  /**
   * @var array
   */
  private $xmlMappings = array();

  /**
   * @var array
   */
  private $yamlMappings = array();

  /**
   * @var array
   */
  private $methodMappings = array();

  /**
   * @var Reader|null
   */
  private $annotationReader;

  /**
   * @var MetadataFactoryInterface|null
   */
  private $metadataFactory;

  /**
   * @var ConstraintValidatorFactoryInterface|null
   */
  private $validatorFactory;

  /**
   * @var CacheInterface|null
   */
  private $metadataCache;

  /**
   * @var TranslatorInterface|null
   */
  private $translator;

  /**
   * @var null|string
   */
  private $translationDomain;

  /**
   * @var PropertyAccessorInterface|null
   */
  private $propertyAccessor;

  /**
   * {@inheritdoc}
   */
  public function addObjectInitializer(ObjectInitializerInterface $initializer) {
    $this->initializers[] = $initializer;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addObjectInitializers(array $initializers) {
    $this->initializers = array_merge($this->initializers, $initializers);
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addXmlMapping($path) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    $this->xmlMappings[] = $path;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addXmlMappings(array $paths) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    $this->xmlMappings = array_merge($this->xmlMappings, $paths);
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addYamlMapping($path) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    $this->yamlMappings[] = $path;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addYamlMappings(array $paths) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    $this->yamlMappings = array_merge($this->yamlMappings, $paths);
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addMethodMapping($methodName) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    $this->methodMappings[] = $methodName;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function addMethodMappings(array $methodNames) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot add custom mappings after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    $this->methodMappings = array_merge($this->methodMappings, $methodNames);
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function enableAnnotationMapping(Reader $annotationReader = null) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot enable annotation mapping after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    if (null === $annotationReader) {
      if (!class_exists('Doctrine\\Common\\Annotations\\AnnotationReader') || !class_exists('Doctrine\\Common\\Cache\\ArrayCache')) {
        throw new \RuntimeException('Enabling annotation based constraint mapping requires the packages doctrine/annotations and doctrine/cache to be installed.');
      }
      $annotationReader = new CachedReader(new AnnotationReader(), new ArrayCache());
    }
    $this->annotationReader = $annotationReader;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function disableAnnotationMapping() {
    $this->annotationReader = null;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function setMetadataFactory(MetadataFactoryInterface $metadataFactory) {
    if (count($this->xmlMappings) > 0 || count($this->yamlMappings) > 0 || count($this->methodMappings) > 0 || null !== $this->annotationReader) {
      throw new ValidatorException('You cannot set a custom metadata factory after adding custom mappings. You should do either of both.');
    }
    $this->metadataFactory = $metadataFactory;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function setMetadataCache(CacheInterface $cache) {
    if (null !== $this->metadataFactory) {
      throw new ValidatorException('You cannot set a custom metadata cache after setting a custom metadata factory. Configure your metadata factory instead.');
    }
    $this->metadataCache = $cache;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function setConstraintValidatorFactory(ConstraintValidatorFactoryInterface $validatorFactory) {
    if (null !== $this->propertyAccessor) {
      throw new ValidatorException('You cannot set a validator factory after setting a custom property accessor. Remove the call to setPropertyAccessor() if you want to call setConstraintValidatorFactory().');
    }
    $this->validatorFactory = $validatorFactory;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function setTranslator(TranslatorInterface $translator) {
    $this->translator = $translator;
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function setTranslationDomain($translationDomain) {
    $this->translationDomain = $translationDomain;
    return $this;
  }

  /**
   * {@inheritdoc}
   *
   * @deprecated since version 2.5, to be removed in 3.0.
   *             The validator will function without a property accessor.
   */
  public function setPropertyAccessor(PropertyAccessorInterface $propertyAccessor) {
    @trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.5 and will be removed in 3.0. The validator will function without a property accessor.', E_USER_DEPRECATED);
    if (null !== $this->validatorFactory) {
      throw new ValidatorException('You cannot set a property accessor after setting a custom validator factory. Configure your validator factory instead.');
    }
    $this->propertyAccessor = $propertyAccessor;
    return $this;
  }

  /**
   * {@inheritdoc}
   *
   * @deprecated since version 2.7, to be removed in 3.0.
   */
  public function setApiVersion($apiVersion) {
    @trigger_error('The ' . __METHOD__ . ' method is deprecated in version 2.7 and will be removed in version 3.0.', E_USER_DEPRECATED);
    if (!in_array($apiVersion, array(
      Validation::API_VERSION_2_4,
      Validation::API_VERSION_2_5,
      Validation::API_VERSION_2_5_BC,
    ))) {
      throw new InvalidArgumentException(sprintf('The requested API version is invalid: "%s"', $apiVersion));
    }
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function getValidator() {
    $metadataFactory = $this->metadataFactory;
    if (!$metadataFactory) {
      $loaders = array();
      if (count($this->xmlMappings) > 1) {
        $loaders[] = new XmlFilesLoader($this->xmlMappings);
      }
      elseif (1 === count($this->xmlMappings)) {
        $loaders[] = new XmlFileLoader($this->xmlMappings[0]);
      }
      if (count($this->yamlMappings) > 1) {
        $loaders[] = new YamlFilesLoader($this->yamlMappings);
      }
      elseif (1 === count($this->yamlMappings)) {
        $loaders[] = new YamlFileLoader($this->yamlMappings[0]);
      }
      foreach ($this->methodMappings as $methodName) {
        $loaders[] = new StaticMethodLoader($methodName);
      }
      if ($this->annotationReader) {
        $loaders[] = new AnnotationLoader($this->annotationReader);
      }
      $loader = null;
      if (count($loaders) > 1) {
        $loader = new LoaderChain($loaders);
      }
      elseif (1 === count($loaders)) {
        $loader = $loaders[0];
      }
      $metadataFactory = new LazyLoadingMetadataFactory($loader, $this->metadataCache);
    }
    $validatorFactory = $this->validatorFactory ?: new ConstraintValidatorFactory($this->propertyAccessor);
    $translator = $this->translator;
    if (null === $translator) {
      $translator = new IdentityTranslator();

      // Force the locale to be 'en' when no translator is provided rather than relying on the Intl default locale
      // This avoids depending on Intl or the stub implementation being available. It also ensures that Symfony
      // validation messages are pluralized properly even when the default locale gets changed because they are in
      // English.
      $translator
        ->setLocale('en');
    }
    $contextFactory = new ExecutionContextFactory($translator, $this->translationDomain);
    return new RecursiveValidator($contextFactory, $metadataFactory, $validatorFactory, $this->initializers);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
ValidatorBuilder::$annotationReader private property
ValidatorBuilder::$initializers private property
ValidatorBuilder::$metadataCache private property
ValidatorBuilder::$metadataFactory private property
ValidatorBuilder::$methodMappings private property
ValidatorBuilder::$propertyAccessor private property
ValidatorBuilder::$translationDomain private property
ValidatorBuilder::$translator private property
ValidatorBuilder::$validatorFactory private property
ValidatorBuilder::$xmlMappings private property
ValidatorBuilder::$yamlMappings private property
ValidatorBuilder::addMethodMapping public function Enables constraint mapping using the given static method. Overrides ValidatorBuilderInterface::addMethodMapping
ValidatorBuilder::addMethodMappings public function Enables constraint mapping using the given static methods. Overrides ValidatorBuilderInterface::addMethodMappings
ValidatorBuilder::addObjectInitializer public function Adds an object initializer to the validator. Overrides ValidatorBuilderInterface::addObjectInitializer
ValidatorBuilder::addObjectInitializers public function Adds a list of object initializers to the validator. Overrides ValidatorBuilderInterface::addObjectInitializers
ValidatorBuilder::addXmlMapping public function Adds an XML constraint mapping file to the validator. Overrides ValidatorBuilderInterface::addXmlMapping
ValidatorBuilder::addXmlMappings public function Adds a list of XML constraint mapping files to the validator. Overrides ValidatorBuilderInterface::addXmlMappings
ValidatorBuilder::addYamlMapping public function Adds a YAML constraint mapping file to the validator. Overrides ValidatorBuilderInterface::addYamlMapping
ValidatorBuilder::addYamlMappings public function Adds a list of YAML constraint mappings file to the validator. Overrides ValidatorBuilderInterface::addYamlMappings
ValidatorBuilder::disableAnnotationMapping public function Disables annotation based constraint mapping. Overrides ValidatorBuilderInterface::disableAnnotationMapping
ValidatorBuilder::enableAnnotationMapping public function Enables annotation based constraint mapping. Overrides ValidatorBuilderInterface::enableAnnotationMapping
ValidatorBuilder::getValidator public function Builds and returns a new validator object. Overrides ValidatorBuilderInterface::getValidator
ValidatorBuilder::setApiVersion Deprecated public function Overrides ValidatorBuilderInterface::setApiVersion
ValidatorBuilder::setConstraintValidatorFactory public function Sets the constraint validator factory used by the validator. Overrides ValidatorBuilderInterface::setConstraintValidatorFactory
ValidatorBuilder::setMetadataCache public function Sets the cache for caching class metadata. Overrides ValidatorBuilderInterface::setMetadataCache
ValidatorBuilder::setMetadataFactory public function Sets the class metadata factory used by the validator. Overrides ValidatorBuilderInterface::setMetadataFactory
ValidatorBuilder::setPropertyAccessor Deprecated public function Overrides ValidatorBuilderInterface::setPropertyAccessor
ValidatorBuilder::setTranslationDomain public function Sets the default translation domain of violation messages. Overrides ValidatorBuilderInterface::setTranslationDomain
ValidatorBuilder::setTranslator public function Sets the translator used for translating violation messages. Overrides ValidatorBuilderInterface::setTranslator