Example documentation is ignored for Enum resources

[gnito-org]

API Platform version(s) affected: 3.2.20

Description

When using a Backed Enum class as an API resource, any example value provided in the ApiProperty attribute is ignored and does not appear in the OpenAPI documentation.

This is true for example: 'foo' and openapiContext: ['example' => 'foo'].

On API resources that are Doctrine entities, the supplied example values appear in the OpenAPI documentation.

How to reproduce

https://github.com/gnito-org/problem-replicator-api-platform-enum-example

Possible Solution

Additional Context

[GwendolenLynch]

Linking this as I'm working on backed enum resources in #6309.

[GwendolenLynch]

I think this is where the breakage occurs.

core/src/Metadata/Property/Factory/AttributePropertyMetadataFactory.php

Lines 62 to 71 in 97c8ae2

	if ($reflectionEnum) {
	if ($reflectionEnum->hasCase($property)) {
	$reflectionCase = $reflectionEnum->getCase($property);
	if ($attributes = $reflectionCase->getAttributes(ApiProperty::class)) {
	return $this->createMetadata($attributes[0]->newInstance(), $parentPropertyMetadata);
	}
	}
	return $this->handleNotFound($parentPropertyMetadata, $resourceClass, $property);
	}

Removing the return, and handling $reflectionEnum below works (caveat emptor).