function OffsetPage::createFromQueryParameter

Same name in other branches
  1. 8.9.x core/modules/jsonapi/src/Query/OffsetPage.php \Drupal\jsonapi\Query\OffsetPage::createFromQueryParameter()
  2. 10 core/modules/jsonapi/src/Query/OffsetPage.php \Drupal\jsonapi\Query\OffsetPage::createFromQueryParameter()
  3. 11.x core/modules/jsonapi/src/Query/OffsetPage.php \Drupal\jsonapi\Query\OffsetPage::createFromQueryParameter()

Creates an OffsetPage object from a query parameter.

Parameters

mixed $parameter: The `page` query parameter from the Symfony request object.

Return value

static An OffsetPage object with defaults.

3 calls to OffsetPage::createFromQueryParameter()
EntityResource::getJsonApiParams in core/modules/jsonapi/src/Controller/EntityResource.php
Extracts JSON:API query parameters from the request.
OffsetPageTest::testCreateFromQueryParameter in core/modules/jsonapi/tests/src/Unit/Query/OffsetPageTest.php
@covers ::createFromQueryParameter @dataProvider parameterProvider
OffsetPageTest::testCreateFromQueryParameterFail in core/modules/jsonapi/tests/src/Unit/Query/OffsetPageTest.php
@covers ::createFromQueryParameter

File

core/modules/jsonapi/src/Query/OffsetPage.php, line 110

Class

OffsetPage
Value object for containing the requested offset and page parameters.

Namespace

Drupal\jsonapi\Query

Code

public static function createFromQueryParameter($parameter) {
    if (!is_array($parameter)) {
        $cacheability = (new CacheableMetadata())->addCacheContexts([
            'url.query_args:page',
        ]);
        throw new CacheableBadRequestHttpException($cacheability, 'The page parameter needs to be an array.');
    }
    $expanded = $parameter + [
        static::OFFSET_KEY => static::DEFAULT_OFFSET,
        static::SIZE_KEY => static::SIZE_MAX,
    ];
    if ($expanded[static::SIZE_KEY] > static::SIZE_MAX) {
        $expanded[static::SIZE_KEY] = static::SIZE_MAX;
    }
    return new static($expanded[static::OFFSET_KEY], $expanded[static::SIZE_KEY]);
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.