class ReadOnlyModeMethodFilter

Same name in other branches
  1. 9 core/modules/jsonapi/src/Routing/ReadOnlyModeMethodFilter.php \Drupal\jsonapi\Routing\ReadOnlyModeMethodFilter
  2. 10 core/modules/jsonapi/src/Routing/ReadOnlyModeMethodFilter.php \Drupal\jsonapi\Routing\ReadOnlyModeMethodFilter
  3. 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

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\Routing
View 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.