API平台-如何使用DTO发帖？

Question

我在我的 Symfony4 应用程序中使用 API 平台来公开我的资源。这是一个很棒的框架，但默认情况下它会强制您将所有业务逻辑放在前端，因为它公开了您的所有实体而不是业务对象。

我不喜欢这样，我更喜欢将我的业务逻辑放在后端。

我需要创建用户，但是有不同类型的用户。所以我在后端创建了一个 UserFactory。所以前端只需要推送一个业务对象，后端会处理所有事情。

前台永远不能直接在数据库中持久化用户对象。就是后台的作用

按照本教程使用 DTO 进行阅读： https://api-platform.com/docs/core/dto/#how-to-use-a-dto-for-reading

我正在尝试对发帖做同样的事情。它有效。这是我的控制器代码：

/**
 * @Route(
 *     path="/create/model",
 *     name="create-model",
 *     methods={"POST"},
 *     defaults={
 *          "_api_respond"=true,
 *          "_api_normalization_context"={"api_sub_level"=true},
 *          "_api_swagger_context"={
 *              "tags"={"User"},
 *              "summary"="Create a user Model",
 *              "parameters"={
 *                  
 *              },
 *              "responses"={
 *                  "201"={
 *                      "description"="User Model created",
 *                      "schema"={
 *                          "type"="object",
 *                          "properties"={
 *                              "firstName"={"type"="string"},
 *                              "lastName"={"type"="string"},
 *                              "email"={"type"="string"},
 *                          }
 *                      }
 *                  }
 *              }
 *          }
 *     }
 * )
 * @param Request $request
 * @return \App\Entity\User
 * @throws \App\Exception\ClassNotFoundException
 * @throws \App\Exception\InvalidUserException
 */
public function createModel(Request $request)
{
    $model = $this->serializer->deserialize($request->getContent(), Model::class, 'json');
    $user = $this->userFactory->create($model);
    $this->userRepository->save($user);

    return $user;
}

效果很好，但我希望我的新资源能够在 Swagger UI 中工作，这样我就可以直接在 Web 界面中通过 POST 方法创建新资源。

为此，我认为我需要完成 _api_swagger_context 中的参数部分。但我没有找到任何相关文件。

我该怎么做？

Answer 1

在这里找到答案：https://github.com/api-platform/docs/issues/666

您可以这样填写参数：

 "parameters" = {
     {
        "name" = "data",
        "in" = "body",
        "required" = "true",
        "schema" = {
            "type" = "object",
            "properties" = {
                 "firstName"={"type"="string"},
                 "lastName"={"type"="string"},
                 "email" = {"type" = "string" }
             }
         },
     },
 },

更多关于 swagger 参数的文档：https://swagger.io/docs/specification/2-0/describing-parameters/

API平台-如何使用DTO发帖？

API Platform - How to Use a DTO for Posting?

symfony

swagger

swagger-ui

api-platform.com

symfony4