Class: GraphQL::Execution::Multiplex Private
- Inherits:
-
Object
- Object
- GraphQL::Execution::Multiplex
- Includes:
- Tracing::Traceable
- Defined in:
- lib/graphql/execution/multiplex.rb
Overview
This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.
Execute multiple queries under the same multiplex “umbrella”. They can share a batching context and reduce redundant database hits.
The flow is:
- Multiplex instrumentation setup
- Query instrumentation setup
- Analyze the multiplex + each query
- Begin each query
- Resolve lazy values, breadth-first across all queries
- Finish each query (eg, get errors)
- Query instrumentation teardown
- Multiplex instrumentation teardown
If one query raises an application error, all queries will be in undefined states.
Validation errors and GraphQL::ExecutionErrors are handled in isolation: one of these errors in one query will not affect the other queries.
Constant Summary collapse
- NO_OPERATION =
This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.
Used internally to signal that the query shouldn’t be executed
{}.freeze
Instance Attribute Summary collapse
-
#context ⇒ Object
readonly
private
-
#max_complexity ⇒ Object
readonly
private
-
#queries ⇒ Object
readonly
private
-
#schema ⇒ Object
readonly
private
Class Method Summary collapse
-
.run_all(schema, query_options, *args) ⇒ Object
private
-
.run_queries(schema, queries, context: {}, max_complexity: schema.max_complexity) ⇒ Array<Hash>
private
One result per query.
Instance Method Summary collapse
-
#initialize(schema:, queries:, context:, max_complexity:) ⇒ Multiplex
constructor
private
A new instance of Multiplex.
Methods included from Tracing::Traceable
Constructor Details
#initialize(schema:, queries:, context:, max_complexity:) ⇒ Multiplex
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns a new instance of Multiplex
33 34 35 36 37 38 39 40 41 42 43 44 |
# File 'lib/graphql/execution/multiplex.rb', line 33 def initialize(schema:, queries:, context:, max_complexity:) @schema = schema @queries = queries @context = context # TODO remove support for global tracers @tracers = schema.tracers + GraphQL::Tracing.tracers + (context[:tracers] || []) # Support `context: {backtrace: true}` if context[:backtrace] && !@tracers.include?(GraphQL::Backtrace::Tracer) @tracers << GraphQL::Backtrace::Tracer end @max_complexity = max_complexity end |
Instance Attribute Details
#context ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
32 33 34 |
# File 'lib/graphql/execution/multiplex.rb', line 32 def context @context end |
#max_complexity ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
32 33 34 |
# File 'lib/graphql/execution/multiplex.rb', line 32 def max_complexity @max_complexity end |
#queries ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
32 33 34 |
# File 'lib/graphql/execution/multiplex.rb', line 32 def queries @queries end |
#schema ⇒ Object (readonly)
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
32 33 34 |
# File 'lib/graphql/execution/multiplex.rb', line 32 def schema @schema end |
Class Method Details
.run_all(schema, query_options, *args) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
47 48 49 50 |
# File 'lib/graphql/execution/multiplex.rb', line 47 def run_all(schema, , *args) queries = .map { |opts| GraphQL::Query.new(schema, nil, opts) } run_queries(schema, queries, *args) end |
.run_queries(schema, queries, context: {}, max_complexity: schema.max_complexity) ⇒ Array<Hash>
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns One result per query
57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 |
# File 'lib/graphql/execution/multiplex.rb', line 57 def run_queries(schema, queries, context: {}, max_complexity: schema.max_complexity) multiplex = self.new(schema: schema, queries: queries, context: context, max_complexity: max_complexity) multiplex.trace("execute_multiplex", { multiplex: multiplex }) do if supports_multiplexing?(schema) instrument_and_analyze(multiplex) do run_as_multiplex(multiplex) end else if queries.length != 1 raise ArgumentError, "Multiplexing doesn't support custom execution strategies, run one query at a time instead" else instrument_and_analyze(multiplex) do [run_one_legacy(schema, queries.first)] end end end end end |