class ReadOnlyModeMethodFilter
Same name in other branches
- 9 core/modules/jsonapi/src/Routing/ReadOnlyModeMethodFilter.php \Drupal\jsonapi\Routing\ReadOnlyModeMethodFilter
- 10 core/modules/jsonapi/src/Routing/ReadOnlyModeMethodFilter.php \Drupal\jsonapi\Routing\ReadOnlyModeMethodFilter
- 11.x core/modules/jsonapi/src/Routing/ReadOnlyModeMethodFilter.php \Drupal\jsonapi\Routing\ReadOnlyModeMethodFilter
Filters routes based on the HTTP method and JSON:API's read-only mode.
Hierarchy
- class \Drupal\jsonapi\Routing\ReadOnlyModeMethodFilter implements \Drupal\Core\Routing\FilterInterface
Expanded class hierarchy of ReadOnlyModeMethodFilter
1 string reference to 'ReadOnlyModeMethodFilter'
- jsonapi.services.yml in core/
modules/ jsonapi/ jsonapi.services.yml - core/modules/jsonapi/jsonapi.services.yml
1 service uses ReadOnlyModeMethodFilter
- method_filter.jsonapi in core/
modules/ jsonapi/ jsonapi.services.yml - Drupal\jsonapi\Routing\ReadOnlyModeMethodFilter
File
-
core/
modules/ jsonapi/ src/ Routing/ ReadOnlyModeMethodFilter.php, line 15
Namespace
Drupal\jsonapi\RoutingView source
class ReadOnlyModeMethodFilter implements FilterInterface {
/**
* The decorated method filter.
*
* @var \Drupal\Core\Routing\FilterInterface
*/
protected $inner;
/**
* Whether JSON:API's read-only mode is enabled.
*
* @var bool
*/
protected $readOnlyModeIsEnabled;
/**
* ReadOnlyModeMethodFilter constructor.
*
* @param \Drupal\Core\Routing\FilterInterface $inner
* The decorated method filter.
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
* The configuration factory.
*/
public function __construct(FilterInterface $inner, ConfigFactoryInterface $config_factory) {
$this->inner = $inner;
$this->readOnlyModeIsEnabled = $config_factory->get('jsonapi.settings')
->get('read_only');
}
/**
* {@inheritdoc}
*/
public function filter(RouteCollection $collection, Request $request) {
$all_supported_methods = [];
foreach ($collection->all() as $name => $route) {
$all_supported_methods = array_merge($all_supported_methods, $route->getMethods());
}
$collection = $this->inner
->filter($collection, $request);
if (!$this->readOnlyModeIsEnabled) {
return $collection;
}
$read_only_methods = [
'GET',
'HEAD',
'OPTIONS',
'TRACE',
];
foreach ($collection->all() as $name => $route) {
if (!$route->hasDefault(Routes::JSON_API_ROUTE_FLAG_KEY)) {
continue;
}
$supported_methods = $route->getMethods();
assert(count($supported_methods) > 0, 'JSON:API routes always have a method specified.');
$is_read_only_route = empty(array_diff($supported_methods, $read_only_methods));
if (!$is_read_only_route) {
$collection->remove($name);
}
}
if (count($collection)) {
return $collection;
}
throw new MethodNotAllowedHttpException(array_intersect($all_supported_methods, $read_only_methods), sprintf("JSON:API is configured to accept only read operations. Site administrators can configure this at %s.", Url::fromRoute('jsonapi.settings')->setAbsolute()
->toString(TRUE)
->getGeneratedUrl()));
}
}
Members
Title Sort descending | Modifiers | Object type | Summary |
---|---|---|---|
ReadOnlyModeMethodFilter::$inner | protected | property | The decorated method filter. |
ReadOnlyModeMethodFilter::$readOnlyModeIsEnabled | protected | property | Whether JSON:API's read-only mode is enabled. |
ReadOnlyModeMethodFilter::filter | public | function | |
ReadOnlyModeMethodFilter::__construct | public | function | ReadOnlyModeMethodFilter constructor. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.