Completed
Pull Request — 8.x-3.x (#525)
by Sebastian
04:35
created

QueryProcessor::executeOperation()   C

Complexity

Conditions 13
Paths 86

Size

Total Lines 48
Code Lines 24

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 13
eloc 24
nc 86
nop 4
dl 0
loc 48
rs 5.0877
c 0
b 0
f 0

How to fix   Complexity   

Long Method

Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.

For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.

Commonly applied refactorings include:

1
<?php
2
3
namespace Drupal\graphql\GraphQL\Execution;
4
5
use Drupal\Core\Cache\CacheableMetadata;
6
use Drupal\Core\Cache\CacheBackendInterface;
7
use Drupal\Core\Cache\Context\CacheContextsManager;
8
use Drupal\Core\Session\AccountProxyInterface;
9
use Drupal\graphql\GraphQL\Visitors\CacheContextsCollector;
10
use Drupal\graphql\Plugin\SchemaPluginManager;
11
use Drupal\graphql\GraphQL\QueryProvider\QueryProviderInterface;
12
use GraphQL\Error\Error;
13
use GraphQL\Error\FormattedError;
14
use GraphQL\Executor\ExecutionResult;
15
use GraphQL\Executor\Executor;
16
use GraphQL\Executor\Promise\Adapter\SyncPromiseAdapter;
17
use GraphQL\Executor\Promise\PromiseAdapter;
18
use GraphQL\Language\AST\DocumentNode;
19
use GraphQL\Language\Parser;
20
use GraphQL\Language\Visitor;
21
use GraphQL\Server\Helper;
22
use GraphQL\Server\OperationParams;
23
use GraphQL\Server\RequestError;
24
use GraphQL\Server\ServerConfig;
25
use GraphQL\Utils\AST;
26
use GraphQL\Utils\TypeInfo;
27
use GraphQL\Utils\Utils;
28
use GraphQL\Validator\DocumentValidator;
29
use GraphQL\Validator\Rules\AbstractValidationRule;
30
use GraphQL\Validator\ValidationContext;
31
32
class QueryProcessor {
33
34
  /**
35
   * The current user account.
36
   *
37
   * @var \Drupal\Core\Session\AccountProxyInterface
38
   */
39
  protected $currentUser;
40
41
  /**
42
   * The schema plugin manager.
43
   *
44
   * @var \Drupal\graphql\Plugin\SchemaPluginManager
45
   */
46
  protected $pluginManager;
47
48
  /**
49
   * The query provider service.
50
   *
51
   * @var \Drupal\graphql\GraphQL\QueryProvider\QueryProviderInterface
52
   */
53
  protected $queryProvider;
54
55
  /**
56
   * The cache backend for caching query results.
57
   *
58
   * @var \Drupal\Core\Cache\CacheBackendInterface
59
   */
60
  protected $cacheBackend;
61
62
  /**
63
   * The cache contexts manager service.
64
   *
65
   * @var \Drupal\Core\Cache\Context\CacheContextsManager
66
   */
67
  protected $contextsManager;
68
69
  /**
70
   * Processor constructor.
71
   *
72
   * @param \Drupal\Core\Session\AccountProxyInterface $currentUser
73
   *   The current user.
74
   * @param \Drupal\Core\Cache\Context\CacheContextsManager $contextsManager
75
   *   The cache contexts manager service.
76
   * @param \Drupal\graphql\Plugin\SchemaPluginManager $pluginManager
77
   *   The schema plugin manager.
78
   * @param \Drupal\graphql\GraphQL\QueryProvider\QueryProviderInterface $queryProvider
79
   *   The query provider service.
80
   * @param \Drupal\Core\Cache\CacheBackendInterface $cacheBackend
81
   *   The cache backend for caching query results.
82
   */
83
  public function __construct(
84
    AccountProxyInterface $currentUser,
85
    CacheContextsManager $contextsManager,
86
    SchemaPluginManager $pluginManager,
87
    QueryProviderInterface $queryProvider,
88
    CacheBackendInterface $cacheBackend
89
  ) {
90
    $this->currentUser = $currentUser;
91
    $this->contextsManager = $contextsManager;
92
    $this->pluginManager = $pluginManager;
93
    $this->queryProvider = $queryProvider;
94
    $this->cacheBackend = $cacheBackend;
95
  }
96
97
  /**
98
   * Processes one or multiple graphql operations.
99
   *
100
   * @param string $schema
101
   *   The plugin id of the schema to use.
102
   * @param \GraphQL\Server\OperationParams|\GraphQL\Server\OperationParams[] $params
103
   *   The graphql operation(s) to execute.
104
   * @param array $globals
105
   *   The query context.
106
   *
107
   * @return \Drupal\graphql\GraphQL\Execution\QueryResult|\Drupal\graphql\GraphQL\Execution\QueryResult[]
108
   *   The query result.
109
   *
110
   */
111
  public function processQuery($schema, $params, array $globals = []) {
112
    // Load the plugin from the schema manager.
113
    $plugin = $this->pluginManager->createInstance($schema);
114
    $schema = $plugin->getSchema();
115
116
    // If the current user has appropriate permissions, allow to bypass
117
    // the secure fields restriction.
118
    $globals['bypass field security'] = $this->currentUser->hasPermission('bypass graphql field security');
119
120
    // Create the server config.
121
    $config = ServerConfig::create();
122
    $config->setDebug(!empty($globals['development']));
123
    $config->setSchema($schema);
124
    $config->setQueryBatching(TRUE);
125
    $config->setContext(function () use ($globals) {
126
      // Each document (e.g. in a batch query) gets its own resolve context but
127
      // the global parameters are shared. This allows us to collect the cache
128
      // metadata and contextual values (e.g. inheritance for language) for each
129
      // query separately.
130
      return new ResolveContext($globals);
131
    });
132
133
    $config->setValidationRules(function (OperationParams $params, DocumentNode $document, $operation) {
0 ignored issues
show
Unused Code introduced by
The parameter $document is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
Unused Code introduced by
The parameter $operation is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
134
      if (isset($params->queryId)) {
135
        // Assume that pre-parsed documents are already validated. This allows
136
        // us to store pre-validated query documents e.g. for persisted queries
137
        // effectively improving performance by skipping run-time validation.
138
        return [];
139
      }
140
141
      return array_values(DocumentValidator::defaultRules());
142
    });
143
144
    $config->setPersistentQueryLoader(function ($id, OperationParams $params) {
145
      if ($query = $this->queryProvider->getQuery($id, $params)) {
146
        return $query;
147
      }
148
149
      throw new RequestError(sprintf("Failed to load query map for id '%s'.", $id));
150
    });
151
152
    if (is_array($params)) {
153
      return $this->executeBatch($config, $params);
154
    }
155
156
    return $this->executeSingle($config, $params);
157
  }
158
159
  /**
160
   * @param \GraphQL\Server\ServerConfig $config
161
   * @param \GraphQL\Server\OperationParams $params
162
   *
163
   * @return mixed
164
   */
165
  public function executeSingle(ServerConfig $config, OperationParams $params) {
166
    $adapter = new SyncPromiseAdapter();
167
    $result = $this->executeOperationWithReporting($adapter, $config, $params, FALSE);
168
    return $adapter->wait($result);
169
  }
170
171
  /**
172
   * @param \GraphQL\Server\ServerConfig $config
173
   * @param array $params
174
   *
175
   * @return mixed
176
   */
177
  public function executeBatch(ServerConfig $config, array $params) {
178
    $adapter = new SyncPromiseAdapter();
179
    $result = array_map(function ($params) use ($adapter, $config) {
180
      return $this->executeOperationWithReporting($adapter, $config, $params, TRUE);
181
    }, $params);
182
183
    $result = $adapter->all($result);
184
    return $adapter->wait($result);
185
  }
186
187
  /**
188
   * @param \GraphQL\Executor\Promise\PromiseAdapter $adapter
189
   * @param \GraphQL\Server\ServerConfig $config
190
   * @param \GraphQL\Server\OperationParams $params
191
   * @param bool $batching
192
   *
193
   * @return \GraphQL\Executor\Promise\Promise
194
   */
195
  protected function executeOperationWithReporting(PromiseAdapter $adapter, ServerConfig $config, OperationParams $params, $batching = FALSE) {
196
    $result = $this->executeOperation($adapter, $config, $params, $batching);
197
198
    // Format and print errors.
199
    return $result->then(function(QueryResult $result) use ($config) {
200
      if ($config->getErrorsHandler()) {
201
        $result->setErrorsHandler($config->getErrorsHandler());
202
      }
203
204
      if ($config->getErrorFormatter() || $config->getDebug()) {
205
        $result->setErrorFormatter(FormattedError::prepareFormatter($config->getErrorFormatter(), $config->getDebug()));
206
      }
207
208
      return $result;
209
    });
210
  }
211
212
  /**
213
   * @param \GraphQL\Executor\Promise\PromiseAdapter $adapter
214
   * @param \GraphQL\Server\ServerConfig $config
215
   * @param \GraphQL\Server\OperationParams $params
216
   * @param bool $batching
217
   *
218
   * @return \GraphQL\Executor\Promise\Promise
219
   */
220
  protected function executeOperation(PromiseAdapter $adapter, ServerConfig $config, OperationParams $params, $batching = FALSE) {
221
    try {
222
      if (!$config->getSchema()) {
223
        throw new \LogicException('Missing schema for query execution.');
224
      }
225
226
      if ($batching && !$config->getQueryBatching()) {
227
        throw new RequestError('Batched queries are not supported by this server.');
228
      }
229
230
      if ($errors = $this->validateOperationParams($params)) {
231
        return $adapter->createFulfilled(new QueryResult(NULL, $errors));
232
      }
233
234
      $document = $params->queryId ? $this->loadPersistedQuery($config, $params) : $params->query;
235
      if (!$document instanceof DocumentNode) {
236
        $document = Parser::parse($document);
237
      }
238
239
      // Read the operation type from the document. Subscriptions and mutations
240
      // only work through POST requests. One cannot have mutations and queries
241
      // in the same document, hence this check is sufficient.
242
      $operation = $params->operation;
243
      $type = AST::getOperation($document, $operation);
244
      if ($params->isReadOnly() && $type !== 'query') {
245
        throw new RequestError('GET requests are only supported for query operations.');
246
      }
247
248
      // If one of the validation rules found any problems, do not resolve the
249
      // query and bail out early instead.
250
      if ($errors = $this->validateOperation($config, $params, $document)) {
251
        return $adapter->createFulfilled(new QueryResult(NULL, $errors));
252
      }
253
254
      // Only queries can be cached (mutations and subscriptions can't).
255
      if ($type === 'query') {
256
        return $this->executeCacheableOperation($adapter, $config, $params, $document);
257
      }
258
259
      return $this->executeUncachableOperation($adapter, $config, $params, $document);
260
    }
261
    catch (RequestError $exception) {
262
      return $adapter->createFulfilled(new QueryResult(NULL, [Error::createLocatedError($exception)]));
263
    }
264
    catch (Error $exception) {
265
      return $adapter->createFulfilled(new QueryResult(NULL, [$exception]));
266
    }
267
  }
268
269
  /**
270
   * @param \GraphQL\Executor\Promise\PromiseAdapter $adapter
271
   * @param \GraphQL\Server\ServerConfig $config
272
   * @param \GraphQL\Server\OperationParams $params
273
   * @param \GraphQL\Language\AST\DocumentNode $document
274
   *
275
   * @return \GraphQL\Executor\Promise\Promise|mixed
276
   */
277
  protected function executeCacheableOperation(PromiseAdapter $adapter, ServerConfig $config, OperationParams $params, DocumentNode $document) {
278
    $schema = $config->getSchema();
279
280
    // Collect cache contexts from the query document.
281
    $contexts = [];
282
    $info = new TypeInfo($schema);
283
    $visitor = (new CacheContextsCollector())->getVisitor($info, $contexts);
284
    Visitor::visit($document, Visitor::visitWithTypeInfo($info, $visitor));
285
286
    // Generate a cache identifier from the collected contexts.
287
    $metadata = (new CacheableMetadata())->addCacheContexts($contexts);
288
    $cid = $this->cacheIdentifier($document, $metadata);
289
    if (($cache = $this->cacheBackend->get($cid)) && $result = $cache->data) {
290
      return $adapter->createFulfilled($result);
291
    }
292
293
    $result = $this->doExecuteOperation($adapter, $config, $params, $document);
294
    return $result->then(function (QueryResult $result) use ($cid, $metadata) {
295
      if ($missing = array_diff($result->getCacheContexts(), $metadata->getCacheContexts())) {
296
        throw new \LogicException(sprintf(
297
          'The query result yielded cache contexts (%s) that were not part of the static query analysis.',
298
          implode(', ', $missing)
299
        ));
300
      }
301
302
      // Add the statically collected cache contexts and the global default
303
      // cache tag (useful for clearing all cached responses) to the result.
304
      $result->addCacheableDependency($metadata);
305
      $result->addCacheTags(['graphql_response']);
306
307
      // Write this query into the cache if it is cacheable.
308
      if ($result->getCacheMaxAge() !== 0) {
309
        $this->cacheBackend->set($cid, $result, $result->getCacheMaxAge(), $result->getCacheTags());
310
      }
311
312
      return $result;
313
    });
314
  }
315
316
  /**
317
   * @param \GraphQL\Executor\Promise\PromiseAdapter $adapter
318
   * @param \GraphQL\Server\ServerConfig $config
319
   * @param \GraphQL\Server\OperationParams $params
320
   * @param \GraphQL\Language\AST\DocumentNode $document
321
   *
322
   * @return \GraphQL\Executor\Promise\Promise
323
   */
324
  protected function executeUncachableOperation(PromiseAdapter $adapter, ServerConfig $config, OperationParams $params, DocumentNode $document) {
325
    return $this->doExecuteOperation($adapter, $config, $params, $document);
326
  }
327
328
  /**
329
   * @param \GraphQL\Executor\Promise\PromiseAdapter $adapter
330
   * @param \GraphQL\Server\ServerConfig $config
331
   * @param \GraphQL\Server\OperationParams $params
332
   * @param \GraphQL\Language\AST\DocumentNode $document
333
   *
334
   * @return \GraphQL\Executor\Promise\Promise
335
   */
336
  protected function doExecuteOperation(PromiseAdapter $adapter, ServerConfig $config, OperationParams $params, DocumentNode $document) {
337
    $operation = $params->operation;
338
    $variables = $params->variables;
339
    $context = $this->resolveContextValue($config, $params, $document, $operation);
340
    $root = $this->resolveRootValue($config, $params, $document, $operation);
341
    $resolver = $config->getFieldResolver();
342
    $schema = $config->getSchema();
343
344
    $promise = Executor::promiseToExecute(
345
      $adapter,
346
      $schema,
347
      $document,
348
      $root,
349
      $context,
350
      $variables,
351
      $operation,
352
      $resolver
353
    );
354
355
    return $promise->then(function (ExecutionResult $result) use ($context) {
356
      // Add the collected cache metadata to the result.
357
      $metadata = (new CacheableMetadata())->addCacheableDependency($context);
358
      $output = new QueryResult($result->data, $result->errors, $result->extensions, $metadata);
359
360
      return $output;
361
    });
362
  }
363
364
  /**
365
   * @param \GraphQL\Server\OperationParams $params
366
   *
367
   * @return array
368
   */
369
  protected function validateOperationParams(OperationParams $params) {
370
    $errors = (new Helper())->validateOperationParams($params);
371
    return array_map(function (RequestError $error) {
372
      return Error::createLocatedError($error, NULL, NULL);
373
    }, $errors);
374
  }
375
376
  /**
377
   * @param \GraphQL\Server\ServerConfig $config
378
   * @param \GraphQL\Server\OperationParams $params
379
   * @param \GraphQL\Language\AST\DocumentNode $document
380
   *
381
   * @return \GraphQL\Error\Error[]
382
   */
383
  protected function validateOperation(ServerConfig $config, OperationParams $params, DocumentNode $document) {
384
    $operation = $params->operation;
385
    // Skip validation if there are no validation rules to be applied.
386
    if (!$rules = $this->resolveValidationRules($config, $params, $document, $operation)) {
387
      return [];
388
    }
389
390
    $schema = $config->getSchema();
391
    $info = new TypeInfo($schema);
392
    $validation = new ValidationContext($schema, $document, $info);
393
    $visitors = array_values(array_map(function (AbstractValidationRule $rule) use ($validation) {
394
      return $rule($validation);
395
    }, $rules));
396
397
    // Run the query visitor with the prepared validation rules and the cache
398
    // metadata collector and query complexity calculator.
399
    Visitor::visit($document, Visitor::visitWithTypeInfo($info, Visitor::visitInParallel($visitors)));
400
401
    // Return any possible errors collected during validation.
402
    return $validation->getErrors();
403
  }
404
405
  /**
406
   * @param \GraphQL\Server\ServerConfig $config
407
   * @param \GraphQL\Server\OperationParams $params
408
   * @param \GraphQL\Language\AST\DocumentNode $document
409
   * @param $operation
410
   *
411
   * @return mixed
412
   */
413 View Code Duplication
  protected function resolveRootValue(ServerConfig $config, OperationParams $params, DocumentNode $document, $operation) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
414
    $root = $config->getRootValue();
415
    if (is_callable($root)) {
416
      $root = $root($params, $document, $operation);
417
    }
418
419
    return $root;
420
  }
421
422
  /**
423
   * @param \GraphQL\Server\ServerConfig $config
424
   * @param \GraphQL\Server\OperationParams $params
425
   * @param \GraphQL\Language\AST\DocumentNode $document
426
   * @param $operation
427
   *
428
   * @return mixed
429
   */
430 View Code Duplication
  protected function resolveContextValue(ServerConfig $config, OperationParams $params, DocumentNode $document, $operation) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
431
    $context = $config->getContext();
432
    if (is_callable($context)) {
433
      $context = $context($params, $document, $operation);
434
    }
435
436
    return $context;
437
  }
438
439
  /**
440
   * @param \GraphQL\Server\ServerConfig $config
441
   * @param \GraphQL\Server\OperationParams $params
442
   * @param \GraphQL\Language\AST\DocumentNode $document
443
   * @param $operation
444
   *
445
   * @return array
446
   */
447
  protected function resolveValidationRules(ServerConfig $config, OperationParams $params, DocumentNode $document, $operation) {
448
    // Allow customizing validation rules per operation:
449
    $rules = $config->getValidationRules();
450
    if (is_callable($rules)) {
451
      $rules = $rules($params, $document, $operation);
452
      if (!is_array($rules)) {
453
        throw new \LogicException(sprintf("Expecting validation rules to be array or callable returning array, but got: %s", Utils::printSafe($rules)));
454
      }
455
    }
456
457
    return $rules;
458
  }
459
460
  /**
461
   * @param \GraphQL\Server\ServerConfig $config
462
   * @param \GraphQL\Server\OperationParams $params
463
   *
464
   * @return mixed
465
   * @throws \GraphQL\Server\RequestError
466
   */
467
  protected function loadPersistedQuery(ServerConfig $config, OperationParams $params) {
468
    if (!$loader = $config->getPersistentQueryLoader()) {
469
      throw new RequestError('Persisted queries are not supported by this server.');
470
    }
471
472
    $source = $loader($params->queryId, $params);
473
    if (!is_string($source) && !$source instanceof DocumentNode) {
474
      throw new \LogicException(sprintf('The persisted query loader must return query string or instance of %s but got: %s.', DocumentNode::class, Utils::printSafe($source)));
475
    }
476
477
    return $source;
478
  }
479
480
  /**
481
   * @param \GraphQL\Language\AST\DocumentNode $document
482
   *
483
   * @return array
484
   */
485
  protected function serializeDocument(DocumentNode $document) {
486
    return $this->sanitizeRecursive(AST::toArray($document));
487
  }
488
489
  /**
490
   * @param array $item
491
   *
492
   * @return array
493
   */
494
  protected function sanitizeRecursive(array $item) {
495
    unset($item['loc']);
496
497
    foreach ($item as &$value) {
498
      if (is_array($value)) {
499
        $value = $this->sanitizeRecursive($value);
500
      }
501
    }
502
503
    return $item;
504
  }
505
506
  /**
507
   * @param \GraphQL\Language\AST\DocumentNode $document
508
   * @param \Drupal\Core\Cache\CacheableMetadata $metadata
509
   *
510
   * @return string
511
   */
512
  protected function cacheIdentifier(DocumentNode $document, CacheableMetadata $metadata) {
513
    $contexts = $metadata->getCacheContexts();
514
    $keys = $this->contextsManager->convertTokensToKeys($contexts)->getKeys();
515
    // Prepend the hash of the serialized document to the cache contexts.
516
    $hash = hash('sha256', json_encode($this->serializeDocument($document)));
517
    return implode(':', array_values(array_merge([$hash], $keys)));
518
  }
519
}
520