当我需要在路由中手动要求一个参数时,我遇到了 Api 平台和自定义集合操作的问题。
query/userjob/[USER UUID]
并检索给定用户的所有作业的集合。query/userjob/[USER UUID]/[JOB UUID]
并检索给定用户的工作的详细信息。说我没有 Api 资源或实体用户可能很重要,因此我排除了所有类型的子资源映射或查询。
所以,假设我有一个映射如下的 UserJob ApiResource:
App\Domain\User\Projection\UserJob:
itemOperations:
get:
method: 'GET'
path: '/userjob/{userId}/{jobId}'
requirements:
userId: '%uuid_regex%'
jobId: '%uuid_regex%'
collectionOperations:
get:
method: 'GET'
path: '/userjob/{userId}'
requirements:
userId: '%uuid_regex%'
attributes:
route_prefix: "/query"
在类里面,我有:
final class UserJob
{
public $id; //int Auto inc
public $userId; //a UUID
public $jobId; //a UUID
public function __construct($userId, $jobId)
{
$this->userId = $userId;
$this->jobId = $jobId;
}
public function getId(): int
{
return $this->id;
}
public function getUserId()
{
return $this->userId;
}
public function getJobId()
{
return $this->jobId
}
我为这个类构建了一个自定义数据提供者,我在其中写了从 giver 参数(userId)获取资源的方法:
public function getCollection(string $resourceClass, string $operationName = null)
{
$userId = $this->request->getCurrentRequest()->attributes->get('userId');
return $this->repository->entityManager->getRepository($resourceClass)->findByUserId($userId);
}
当我对 query/userjob/148e3200-f793-447b-bde8-af6b7b27372c
进行 GET 调用时,它会引发异常:
Unable to generate an IRI for App\Domain\User\Projection\UserJob
如果我更深入地调试,在 IRIConverter 类中,我发现原来的异常是从 Router 抛出的:
Some mandatory parameters are missing ("userId") to generate a URL for route "api_user_jobs_get_collection".
然而,如果我转储 $this->repository->entityManager->getRepository($resourceClass)->findByUserId($userId);
的结果,我正在寻找的所有元素for 很好地从数据库中获取。
所以我的直觉是 ApiPlatform 进程以某种方式无法构建我们通常可以在有效负载开头找到的集合 IRI,在我的例子中是 query/userjob/148e3200-f793-447b-bde8 -af6b7b27372c
。
在规范化或序列化过程中它失败了,因为我的自定义操作的“额外”参数(用户 UUID)没有传递给集合规范化器,iri 转换器类,所以它无法提供给路由缺少的参数以构建“api_user_jobs_get_collection”路由。
我在这里错过了什么?这是一个众所周知的问题,有一个我错过的现成解决方案吗?
或者我必须寻找:
最佳答案
您的用例可能有更多解决方案,这取决于首选:
/**
* @var Uuid
* @ApiProperty(identifier=true)
*/
public $code;
但我还没有用多个 ID 尝试过,这可能只适用于项目 url。您可以尝试使用自定义数据提供程序(文档:https://api-platform.com/docs/core/data-providers/)。这将需要按资源或全局(supports()
方法)完成,并且您需要以某种方式(正则表达式?)从 $context
数组中的 url 中提取 ids getCollection()
和 getItem()
方法。但是由于 ApiPlatform 将尝试生成项目 iri,您最终可能仍会装饰 iri 转换器。
注意:在集合 url 中使用 id 可能会导致其他问题,例如 OpenAPI 文档生成。您可能会考虑,如果您想要的不是按“id”字段过滤集合,得到很好的支持,或者只检索“您的”项目的集合。这可以由您的数据提供者注入(inject)安全性来完成,或者如果有人使用了学说,则可以通过学说查询扩展来完成。
https://stackoverflow.com/questions/58040770/