viewHandler = $viewHandler; $this->repository = $repository; $this->dispatcher = $dispatcher; } /** * Returns a collection of customers * * @SWG\Response( * response=200, * description="Returns a collection of customer entities", * @SWG\Schema( * type="array", * @SWG\Items(ref="#/definitions/CustomerCollection") * ) * ) * @Rest\QueryParam(name="visible", requirements="\d+", strict=true, nullable=true, description="Visibility status to filter activities (1=visible, 2=hidden, 3=both)") * @Rest\QueryParam(name="order", requirements="ASC|DESC", strict=true, nullable=true, description="The result order. Allowed values: ASC, DESC (default: ASC)") * @Rest\QueryParam(name="orderBy", requirements="id|name", strict=true, nullable=true, description="The field by which results will be ordered. Allowed values: id, name (default: name)") * * @return Response */ public function cgetAction(ParamFetcherInterface $paramFetcher) { $query = new CustomerQuery(); $query->setCurrentUser($this->getUser()); if (null !== ($order = $paramFetcher->get('order'))) { $query->setOrder($order); } if (null !== ($orderBy = $paramFetcher->get('orderBy'))) { $query->setOrderBy($orderBy); } if (null !== ($visible = $paramFetcher->get('visible'))) { $query->setVisibility($visible); } $data = $this->repository->getCustomersForQuery($query); $view = new View($data, 200); $view->getContext()->setGroups(['Default', 'Collection', 'Customer']); return $this->viewHandler->handle($view); } /** * Returns one customer * * @SWG\Response( * response=200, * description="Returns one customer entity", * @SWG\Schema(ref="#/definitions/CustomerEntity"), * ) * * @param int $id * @return Response */ public function getAction($id) { /** @var Customer $data */ $data = $this->repository->find($id); if (null === $data) { throw new NotFoundException(); } $view = new View($data, 200); $view->getContext()->setGroups(['Default', 'Entity', 'Customer']); return $this->viewHandler->handle($view); } /** * Creates a new customer * * @SWG\Post( * description="Creates a new customer and returns it afterwards", * @SWG\Response( * response=200, * description="Returns the new created customer", * @SWG\Schema(ref="#/definitions/CustomerEntity"), * ) * ) * @SWG\Parameter( * name="body", * in="body", * required=true, * @SWG\Schema(ref="#/definitions/CustomerEditForm") * ) * * @param Request $request * @return Response * @throws \App\Repository\RepositoryException * @throws \Doctrine\ORM\ORMException * @throws \Doctrine\ORM\OptimisticLockException */ public function postAction(Request $request) { if (!$this->isGranted('create_customer')) { throw new AccessDeniedHttpException('User cannot create customers'); } $customer = new Customer(); $event = new CustomerMetaDefinitionEvent($customer); $this->dispatcher->dispatch($event, CustomerMetaDefinitionEvent::class); $form = $this->createForm(CustomerApiEditForm::class, $customer); $form->submit($request->request->all()); if ($form->isValid()) { $this->repository->saveCustomer($customer); $view = new View($customer, 200); $view->getContext()->setGroups(['Default', 'Entity', 'Customer']); return $this->viewHandler->handle($view); } $view = new View($form); $view->getContext()->setGroups(['Default', 'Entity', 'Customer']); return $this->viewHandler->handle($view); } /** * Update an existing customer * * @SWG\Patch( * description="Update an existing customer, you can pass all or just a subset of all attributes", * @SWG\Response( * response=200, * description="Returns the updated customer", * @SWG\Schema(ref="#/definitions/CustomerEntity") * ) * ) * @SWG\Parameter( * name="body", * in="body", * required=true, * @SWG\Schema(ref="#/definitions/CustomerEditForm") * ) * @SWG\Parameter( * name="id", * in="path", * type="integer", * description="Customer ID to update", * required=true, * ) * * @param Request $request * @param string $id * @return Response * @throws \Doctrine\ORM\ORMException * @throws \Doctrine\ORM\OptimisticLockException */ public function patchAction(Request $request, string $id) { $customer = $this->repository->find($id); if (null === $customer) { throw new NotFoundException(); } if (!$this->isGranted('edit', $customer)) { throw new AccessDeniedHttpException('User cannot update customer'); } $event = new CustomerMetaDefinitionEvent($customer); $this->dispatcher->dispatch($event, CustomerMetaDefinitionEvent::class); $form = $this->createForm(CustomerApiEditForm::class, $customer); $form->setData($customer); $form->submit($request->request->all(), false); if (false === $form->isValid()) { $view = new View($form, Response::HTTP_OK); $view->getContext()->setGroups(['Default', 'Entity', 'Customer']); return $this->viewHandler->handle($view); } $this->repository->saveCustomer($customer); $view = new View($customer, Response::HTTP_OK); $view->getContext()->setGroups(['Default', 'Entity', 'Customer']); return $this->viewHandler->handle($view); } /** * Sets the value of a meta-field for an existing customer. * * @SWG\Response( * response=200, * description="Sets the value of an existing/configured meta-field. You cannot create unknown meta-fields, if the given name is not a configured meta-field, this will return an exception.", * @SWG\Schema(ref="#/definitions/CustomerEntity") * ) * @SWG\Parameter( * name="id", * in="path", * type="integer", * description="Customer record ID to set the meta-field value for", * required=true, * ) * @Rest\RequestParam(name="name", strict=true, nullable=false, description="The meta-field name") * @Rest\RequestParam(name="value", strict=true, nullable=false, description="The meta-field value") * * @param int $id * @param ParamFetcherInterface $paramFetcher * @return Response * @throws \Doctrine\ORM\ORMException * @throws \Doctrine\ORM\OptimisticLockException */ public function metaAction($id, ParamFetcherInterface $paramFetcher) { $customer = $this->repository->find($id); if (null === $customer) { throw new NotFoundException(); } if (!$this->isGranted('edit', $customer)) { throw new AccessDeniedHttpException('You are not allowed to update this customer'); } $event = new CustomerMetaDefinitionEvent($customer); $this->dispatcher->dispatch($event, CustomerMetaDefinitionEvent::class); $name = $paramFetcher->get('name'); $value = $paramFetcher->get('value'); if (null === ($meta = $customer->getMetaField($name))) { throw new \InvalidArgumentException('Unknown meta-field requested'); } $meta->setValue($value); $this->repository->saveCustomer($customer); $view = new View($customer, 200); $view->getContext()->setGroups(['Default', 'Entity', 'Customer']); return $this->viewHandler->handle($view); } }