class ClassMetadata

class ClassMetadata extends GenericMetadata implements ClassMetadataInterface {
    
    /**
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getClassName()} instead.
     */
    public string $name;
    
    /**
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getDefaultGroup()} instead.
     */
    public string $defaultGroup;
    
    /**
     * @var MemberMetadata[][]
     *
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getPropertyMetadata()} instead.
     */
    public array $members = [];
    
    /**
     * @var PropertyMetadata[]
     *
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getPropertyMetadata()} instead.
     */
    public array $properties = [];
    
    /**
     * @var GetterMetadata[]
     *
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getPropertyMetadata()} instead.
     */
    public array $getters = [];
    
    /**
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getGroupSequence()} instead.
     */
    public ?GroupSequence $groupSequence = null;
    
    /**
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link isGroupSequenceProvider()} instead.
     */
    public bool $groupSequenceProvider = false;
    
    /**
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getGroupProvider()} instead.
     */
    public ?string $groupProvider = null;
    
    /**
     * The strategy for traversing traversable objects.
     *
     * By default, only instances of {@link \Traversable} are traversed.
     *
     * @var TraversalStrategy::*
     *
     * @internal This property is public in order to reduce the size of the
     *           class' serialized representation. Do not access it. Use
     *           {@link getTraversalStrategy()} instead.
     */
    public int $traversalStrategy = TraversalStrategy::IMPLICIT;
    private \ReflectionClass $reflClass;
    public function __construct(string $class) {
        $this->name = $class;
        // class name without namespace
        if (false !== ($nsSep = strrpos($class, '\\'))) {
            $this->defaultGroup = substr($class, $nsSep + 1);
        }
        else {
            $this->defaultGroup = $class;
        }
    }
    public function __sleep() : array {
        $parentProperties = parent::__sleep();
        // Don't store the cascading strategy. Classes never cascade.
        unset($parentProperties[array_search('cascadingStrategy', $parentProperties)]);
        return array_merge($parentProperties, [
            'getters',
            'groupSequence',
            'groupSequenceProvider',
            'groupProvider',
            'members',
            'name',
            'properties',
            'defaultGroup',
        ]);
    }
    public function getClassName() : string {
        return $this->name;
    }
    
    /**
     * Returns the name of the default group for this class.
     *
     * For each class, the group "Default" is an alias for the group
     * "<ClassName>", where <ClassName> is the non-namespaced name of the
     * class. All constraints implicitly or explicitly assigned to group
     * "Default" belong to both of these groups, unless the class defines
     * a group sequence.
     *
     * If a class defines a group sequence, validating the class in "Default"
     * will validate the group sequence. The constraints assigned to "Default"
     * can still be validated by validating the class in "<ClassName>".
     */
    public function getDefaultGroup() : string {
        return $this->defaultGroup;
    }
    
    /**
     * If the constraint {@link Cascade} is added, the cascading strategy will be
     * changed to {@link CascadingStrategy::CASCADE}.
     *
     * If the constraint {@link Traverse} is added, the traversal strategy will be
     * changed. Depending on the $traverse property of that constraint,
     * the traversal strategy will be set to one of the following:
     *
     *  - {@link TraversalStrategy::IMPLICIT} by default
     *  - {@link TraversalStrategy::NONE} if $traverse is disabled
     *  - {@link TraversalStrategy::TRAVERSE} if $traverse is enabled
     */
    public function addConstraint(Constraint $constraint) : static {
        $this->checkConstraint($constraint);
        if ($constraint instanceof Traverse) {
            if ($constraint->traverse) {
                // If traverse is true, traversal should be explicitly enabled
                $this->traversalStrategy = TraversalStrategy::TRAVERSE;
            }
            else {
                // If traverse is false, traversal should be explicitly disabled
                $this->traversalStrategy = TraversalStrategy::NONE;
            }
            // The constraint is not added
            return $this;
        }
        if ($constraint instanceof Cascade) {
            $this->cascadingStrategy = CascadingStrategy::CASCADE;
            foreach ($this->getReflectionClass()
                ->getProperties() as $property) {
                if (isset($constraint->exclude[$property->getName()])) {
                    continue;
                }
                if ($this->canCascade($property->getType())) {
                    $this->addPropertyConstraint($property->getName(), new Valid());
                }
            }
            // The constraint is not added
            return $this;
        }
        $constraint->addImplicitGroupName($this->getDefaultGroup());
        parent::addConstraint($constraint);
        return $this;
    }
    
    /**
     * Adds a constraint to the given property.
     *
     * @return $this
     */
    public function addPropertyConstraint(string $property, Constraint $constraint) : static {
        if (!isset($this->properties[$property])) {
            $this->properties[$property] = new PropertyMetadata($this->getClassName(), $property);
            $this->addPropertyMetadata($this->properties[$property]);
        }
        $constraint->addImplicitGroupName($this->getDefaultGroup());
        $this->properties[$property]
            ->addConstraint($constraint);
        return $this;
    }
    
    /**
     * @param Constraint[] $constraints
     *
     * @return $this
     */
    public function addPropertyConstraints(string $property, array $constraints) : static {
        foreach ($constraints as $constraint) {
            $this->addPropertyConstraint($property, $constraint);
        }
        return $this;
    }
    
    /**
     * Adds a constraint to the getter of the given property.
     *
     * The name of the getter is assumed to be the name of the property with an
     * uppercased first letter and the prefix "get", "is" or "has".
     *
     * @return $this
     */
    public function addGetterConstraint(string $property, Constraint $constraint) : static {
        if (!isset($this->getters[$property])) {
            $this->getters[$property] = new GetterMetadata($this->getClassName(), $property);
            $this->addPropertyMetadata($this->getters[$property]);
        }
        $constraint->addImplicitGroupName($this->getDefaultGroup());
        $this->getters[$property]
            ->addConstraint($constraint);
        return $this;
    }
    
    /**
     * Adds a constraint to the getter of the given property.
     *
     * @return $this
     */
    public function addGetterMethodConstraint(string $property, string $method, Constraint $constraint) : static {
        if (!isset($this->getters[$property])) {
            $this->getters[$property] = new GetterMetadata($this->getClassName(), $property, $method);
            $this->addPropertyMetadata($this->getters[$property]);
        }
        $constraint->addImplicitGroupName($this->getDefaultGroup());
        $this->getters[$property]
            ->addConstraint($constraint);
        return $this;
    }
    
    /**
     * @param Constraint[] $constraints
     *
     * @return $this
     */
    public function addGetterConstraints(string $property, array $constraints) : static {
        foreach ($constraints as $constraint) {
            $this->addGetterConstraint($property, $constraint);
        }
        return $this;
    }
    
    /**
     * @param Constraint[] $constraints
     *
     * @return $this
     */
    public function addGetterMethodConstraints(string $property, string $method, array $constraints) : static {
        foreach ($constraints as $constraint) {
            $this->addGetterMethodConstraint($property, $method, $constraint);
        }
        return $this;
    }
    
    /**
     * Merges the constraints of the given metadata into this object.
     */
    public function mergeConstraints(self $source) : void {
        if ($source->isGroupSequenceProvider()) {
            $this->setGroupProvider($source->getGroupProvider());
            $this->setGroupSequenceProvider(true);
        }
        foreach ($source->getConstraints() as $constraint) {
            $this->addConstraint(clone $constraint);
        }
        foreach ($source->getConstrainedProperties() as $property) {
            foreach ($source->getPropertyMetadata($property) as $member) {
                $member = clone $member;
                foreach ($member->getConstraints() as $constraint) {
                    if (\in_array($constraint::DEFAULT_GROUP, $constraint->groups, true)) {
                        $member->constraintsByGroup[$this->getDefaultGroup()][] = $constraint;
                    }
                    $constraint->addImplicitGroupName($this->getDefaultGroup());
                }
                if ($member instanceof MemberMetadata && !$member->isPrivate($this->name)) {
                    $property = $member->getPropertyName();
                    $this->members[$property][] = $member;
                    if ($member instanceof PropertyMetadata && !isset($this->properties[$property])) {
                        $this->properties[$property] = $member;
                    }
                    elseif ($member instanceof GetterMetadata && !isset($this->getters[$property])) {
                        $this->getters[$property] = $member;
                    }
                }
                else {
                    $this->addPropertyMetadata($member);
                }
            }
        }
    }
    public function hasPropertyMetadata(string $property) : bool {
        return \array_key_exists($property, $this->members);
    }
    public function getPropertyMetadata(string $property) : array {
        return $this->members[$property] ?? [];
    }
    public function getConstrainedProperties() : array {
        return array_keys($this->members);
    }
    
    /**
     * Sets the default group sequence for this class.
     *
     * @param string[]|GroupSequence $groupSequence An array of group names
     *
     * @return $this
     *
     * @throws GroupDefinitionException
     */
    public function setGroupSequence(array|GroupSequence $groupSequence) : static {
        if ($this->isGroupSequenceProvider()) {
            throw new GroupDefinitionException('Defining a static group sequence is not allowed with a group sequence provider.');
        }
        if (\is_array($groupSequence)) {
            $groupSequence = new GroupSequence($groupSequence);
        }
        if (\in_array(Constraint::DEFAULT_GROUP, $groupSequence->groups, true)) {
            throw new GroupDefinitionException(\sprintf('The group "%s" is not allowed in group sequences.', Constraint::DEFAULT_GROUP));
        }
        if (!\in_array($this->getDefaultGroup(), $groupSequence->groups, true)) {
            throw new GroupDefinitionException(\sprintf('The group "%s" is missing in the group sequence.', $this->getDefaultGroup()));
        }
        $this->groupSequence = $groupSequence;
        return $this;
    }
    public function hasGroupSequence() : bool {
        return isset($this->groupSequence) && \count($this->groupSequence->groups) > 0;
    }
    public function getGroupSequence() : ?GroupSequence {
        return $this->groupSequence;
    }
    
    /**
     * Returns a ReflectionClass instance for this class.
     */
    public function getReflectionClass() : \ReflectionClass {
        return $this->reflClass ??= new \ReflectionClass($this->getClassName());
    }
    
    /**
     * Sets whether a group sequence provider should be used.
     *
     * @throws GroupDefinitionException
     */
    public function setGroupSequenceProvider(bool $active) : void {
        if ($this->hasGroupSequence()) {
            throw new GroupDefinitionException('Defining a group sequence provider is not allowed with a static group sequence.');
        }
        if (null === $this->groupProvider && !$this->getReflectionClass()
            ->implementsInterface(GroupSequenceProviderInterface::class)) {
            throw new GroupDefinitionException(\sprintf('Class "%s" must implement GroupSequenceProviderInterface.', $this->name));
        }
        $this->groupSequenceProvider = $active;
    }
    public function isGroupSequenceProvider() : bool {
        return $this->groupSequenceProvider;
    }
    public function setGroupProvider(?string $provider) : void {
        $this->groupProvider = $provider;
    }
    public function getGroupProvider() : ?string {
        return $this->groupProvider;
    }
    public function getCascadingStrategy() : int {
        return $this->cascadingStrategy;
    }
    private function addPropertyMetadata(PropertyMetadataInterface $metadata) : void {
        $property = $metadata->getPropertyName();
        $this->members[$property][] = $metadata;
    }
    private function checkConstraint(Constraint $constraint) : void {
        if (!\in_array(Constraint::CLASS_CONSTRAINT, (array) $constraint->getTargets(), true)) {
            throw new ConstraintDefinitionException(\sprintf('The constraint "%s" cannot be put on classes.', get_debug_type($constraint)));
        }
        if ($constraint instanceof Composite) {
            foreach ($constraint->getNestedConstraints() as $nestedConstraint) {
                $this->checkConstraint($nestedConstraint);
            }
        }
    }
    private function canCascade(?\ReflectionType $type = null) : bool {
        if (null === $type) {
            return false;
        }
        if ($type instanceof \ReflectionIntersectionType) {
            foreach ($type->getTypes() as $nestedType) {
                if ($this->canCascade($nestedType)) {
                    return true;
                }
            }
            return false;
        }
        if ($type instanceof \ReflectionUnionType) {
            foreach ($type->getTypes() as $nestedType) {
                if (!$this->canCascade($nestedType)) {
                    return false;
                }
            }
            return true;
        }
        return $type instanceof \ReflectionNamedType && (\in_array($type->getName(), [
            'array',
            'null',
        ], true) || class_exists($type->getName()));
    }

}