function RequestHandler::deserialize
Same name in other branches
- 8.9.x core/modules/rest/src/RequestHandler.php \Drupal\rest\RequestHandler::deserialize()
- 10 core/modules/rest/src/RequestHandler.php \Drupal\rest\RequestHandler::deserialize()
- 11.x core/modules/rest/src/RequestHandler.php \Drupal\rest\RequestHandler::deserialize()
Deserializes request body, if any.
Parameters
\Drupal\Core\Routing\RouteMatchInterface $route_match: The route match.
\Symfony\Component\HttpFoundation\Request $request: The HTTP request object.
\Drupal\rest\Plugin\ResourceInterface $resource: The REST resource plugin.
Return value
array|null An object normalization, ikf there is a valid request body. NULL if there is no request body.
Throws
\Symfony\Component\HttpKernel\Exception\BadRequestHttpException Thrown if the request body cannot be decoded.
\Symfony\Component\HttpKernel\Exception\UnprocessableEntityHttpException Thrown if the request body cannot be denormalized.
1 call to RequestHandler::deserialize()
- RequestHandler::handle in core/
modules/ rest/ src/ RequestHandler.php - Handles a REST API request.
File
-
core/
modules/ rest/ src/ RequestHandler.php, line 155
Class
- RequestHandler
- Acts as intermediate request forwarder for resource plugins.
Namespace
Drupal\restCode
protected function deserialize(RouteMatchInterface $route_match, Request $request, ResourceInterface $resource) {
// Deserialize incoming data if available.
$received = $request->getContent();
$unserialized = NULL;
if (!empty($received)) {
$method = static::getNormalizedRequestMethod($route_match);
$format = $request->getContentType();
$definition = $resource->getPluginDefinition();
// First decode the request data. We can then determine if the
// serialized data was malformed.
try {
$unserialized = $this->serializer
->decode($received, $format, [
'request_method' => $method,
]);
} catch (UnexpectedValueException $e) {
// If an exception was thrown at this stage, there was a problem
// decoding the data. Throw a 400 http exception.
throw new BadRequestHttpException($e->getMessage());
}
// Then attempt to denormalize if there is a serialization class.
if (!empty($definition['serialization_class'])) {
try {
$unserialized = $this->serializer
->denormalize($unserialized, $definition['serialization_class'], $format, [
'request_method' => $method,
]);
} catch (UnexpectedValueException $e) {
throw new UnprocessableEntityHttpException($e->getMessage());
} catch (InvalidArgumentException $e) {
throw new UnprocessableEntityHttpException($e->getMessage());
}
}
}
return $unserialized;
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.