Class: ElasticGraph::GraphQL::Schema::Field

Inherits:
Object
  • Object
show all
Defined in:
lib/elastic_graph/graphql/schema/field.rb

Overview

Represents a field within a GraphQL type.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(schema, parent_type, graphql_field, runtime_metadata, resolvers_needing_lookahead) ⇒ Field

Returns a new instance of Field.



23
24
25
26
27
28
29
30
31
32
33
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 23

def initialize(schema, parent_type, graphql_field, runtime_metadata, resolvers_needing_lookahead)
  @schema = schema
  @schema_element_names = schema.element_names
  @parent_type = parent_type
  @graphql_field = graphql_field
  @relation = runtime_metadata&.relation
  @computation_detail = runtime_metadata&.computation_detail
  @resolver = runtime_metadata&.resolver
  @name_in_index = runtime_metadata&.name_in_index || name
  @graphql_field.extras([:lookahead]) if resolvers_needing_lookahead.include?(@resolver&.name)
end

Instance Attribute Details

#computation_detail ⇒ Object (readonly)

Returns the value of attribute computation_detail.



21
22
23
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 21

def computation_detail
  @computation_detail
end

#graphql_field ⇒ Object (readonly)

Returns the value of attribute graphql_field.



21
22
23
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 21

def graphql_field
  @graphql_field
end

#name_in_index ⇒ Object (readonly)

Returns the value of attribute name_in_index.



21
22
23
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 21

def name_in_index
  @name_in_index
end

#parent_type ⇒ Object (readonly)

The type in which the field resides.



19
20
21
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 19

def parent_type
  @parent_type
end

#relation ⇒ Object (readonly)

Returns the value of attribute relation.



21
22
23
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 21

def relation
  @relation
end

#resolver ⇒ Object (readonly)

Returns the value of attribute resolver.



21
22
23
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 21

def resolver
  @resolver
end

#schema ⇒ Object (readonly)

Returns the value of attribute schema.



21
22
23
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 21

def schema
  @schema
end

#schema_element_names ⇒ Object (readonly)

Returns the value of attribute schema_element_names.



21
22
23
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 21

def schema_element_names
  @schema_element_names
end

Instance Method Details

#aggregated? ⇒ Boolean

Indicates if this is an aggregated field (used inside an ‘Aggregation` type).

Returns:

  • (Boolean) 


63
64
65
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 63

def aggregated?
  type.unwrap_non_null.elasticgraph_category == :scalar_aggregated_values
end

#args_to_schema_form(args) ⇒ Object 



67
68
69
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 67

def args_to_schema_form(args)
  Arguments.to_schema_form(args, @graphql_field)
end

#coerce_result(result) ⇒ Object 



94
95
96
97
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 94

def coerce_result(result)
  return result unless parent_type.graphql_only_return_type
  type.coerce_result(result)
end

#description ⇒ Object 



99
100
101
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 99

def description
  "#{@parent_type.name}.#{name}"
end

#hidden_from_queries? ⇒ Boolean

Indicates this field should be hidden in the GraphQL schema so as to not be queryable. We only hide a field if resolving it would require using a datastore cluster that we can’t access. For the most part, this just delegates to ‘Type#hidden_from_queries?` which does the index accessibility check.

Returns:

  • (Boolean) 


88
89
90
91
92
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 88

def hidden_from_queries?
  # The type has logic to check if the backing datastore index is accessible, so we just
  # delegate to that logic here.
  type.unwrap_fully.hidden_from_queries?
end

#index_field_names_for_resolution ⇒ Object

Returns a list of field names that are required from the datastore in order to resolve this field at GraphQL query handling time.



73
74
75
76
77
78
79
80
81
82
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 73

def index_field_names_for_resolution
  # For an embedded object, we do not require any fields because it is the nested fields
  # that we will request from the datastore, which will be required to resolve them. But
  # we do not need to request the embedded object field itself.
  return [] if type.embedded_object?
  return [] if parent_type.relay_connection? || parent_type.relay_edge?
  return index_id_field_names_for_relation if relation_join

  [name_in_index]
end

#name ⇒ Object 



39
40
41
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 39

def name
  @name ||= @graphql_field.name
end

#path_in_index ⇒ Object 



43
44
45
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 43

def path_in_index
  @path_in_index ||= name_in_index.split(".")
end

#relation_join ⇒ Object

Returns an object that knows how this field joins to its relation. Used by ElasticGraph::Resolvers::NestedRelationships.



49
50
51
52
53
54
55
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 49

def relation_join
  # Not every field has a join relation, so it can be nil. But we do not want
  # to re-compute that on every call, so we return @relation_join if it's already
  # defined rather than if its truthy.
  return @relation_join if defined?(@relation_join)
  @relation_join = RelationJoin.from(self)
end

#sort_clauses_for(sorts) ⇒ Object

Given an array of sort enums, returns an array of datastore compatible sort clauses



58
59
60
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 58

def sort_clauses_for(sorts)
  Array(sorts).flat_map { |sort| sort_argument_type.enum_value_named(sort).sort_clauses }
end

#to_s ⇒ Object Also known as: inspect 



103
104
105
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 103

def to_s
  "#<#{self.class.name} #{description}>"
end

#type ⇒ Object 



35
36
37
 
# File 'lib/elastic_graph/graphql/schema/field.rb', line 35

def type
  @type ||= @schema.type_from(@graphql_field.type)
end