Class: GraphQL::Field
- Inherits:
-
Object
- Object
- GraphQL::Field
- Includes:
- Define::InstanceDefinable
- Defined in:
- lib/graphql/field.rb,
lib/graphql/field/resolve.rb
Overview
Fields belong to ObjectTypes and InterfaceTypes.
They're usually created with the field
helper. If you create it by hand, make sure #name is a String.
A field must have a return type, but if you want to defer the return type calculation until later, you can pass a proc for the return type. That proc will be called when the schema is defined.
For complex field definition, you can pass a block to the field
helper, eg field :name do ... end
.
This block is equivalent to calling GraphQL::Field.define { ... }
.
Resolve
Fields have resolve
functions to determine their values at query-time.
The default implementation is to call a method on the object based on the field name.
You can specify a custom proc with the resolve
helper.
There are some shortcuts for common resolve
implementations:
- Provide
property:
to call a method with a different name than the field name - Provide
hash_key:
to resolve the field by doing a key lookup, egobj[:my_hash_key]
Arguments
Fields can take inputs; they're called arguments. You can define them with the argument
helper.
They can have default values which will be provided to resolve
if the query doesn't include a value.
Only certain types maybe used for inputs:
- Scalars
- Enums
- Input Objects
- Lists of those types
Input types may also be non-null -- in that case, the query will fail if the input is not present.
Complexity
Fields can have complexity values which describe the computation cost of resolving the field.
You can provide the complexity as a constant with complexity:
or as a proc, with the complexity
helper.
Defined Under Namespace
Modules: DefaultLazyResolve, Resolve
Instance Attribute Summary collapse
-
#arguments ⇒ Hash<String => GraphQL::Argument>
Map String argument names to their Argument implementations.
-
#arguments_class ⇒ Object
Returns the value of attribute arguments_class.
-
#complexity ⇒ Numeric, Proc
The complexity for this field (default: 1), as a constant or a proc like
->(query_ctx, args, child_complexity) { } # Numeric
. -
#connection ⇒ Object
writeonly
Sets the attribute connection.
- #connection_max_page_size ⇒ nil, Integer
-
#deprecation_reason ⇒ String?
The client-facing reason why this field is deprecated (if present, the field is deprecated).
-
#description ⇒ String?
The client-facing description of this field.
- #edge_class ⇒ nil, Class private
-
#function ⇒ Object, GraphQL::Function
The function used to derive this field.
-
#hash_key ⇒ Object?
The key to access with
obj.[]
to resolve this field (overrides #name if present). -
#lazy_resolve_proc ⇒ <#call(obj, args, ctx)>
readonly
A proc-like object which can be called trigger a lazy resolution.
-
#mutation ⇒ GraphQL::Relay::Mutation?
The mutation this field was derived from, if it was derived from a mutation.
-
#name ⇒ String
The name of this field on its ObjectType (or InterfaceType).
-
#property ⇒ Symbol?
The method to call on
obj
to return this field (overrides #name if present). -
#relay_node_field ⇒ Boolean
True if this is the Relay find-by-id field.
-
#relay_nodes_field ⇒ Boolean
True if this is the Relay find-by-ids field.
-
#resolve_proc ⇒ <#call(obj, args, ctx)>
readonly
A proc-like object which can be called to return the field's value.
-
#subscription_scope ⇒ nil, String
Prefix for subscription names from this field.
-
#trace ⇒ Boolean
True if this field should be traced.
Instance Method Summary collapse
- #connection? ⇒ Boolean
- #edges? ⇒ Boolean
-
#initialize ⇒ Field
constructor
A new instance of Field.
- #initialize_copy(other) ⇒ Object
-
#lazy_resolve(obj, args, ctx) ⇒ Object
If #resolve returned and object which should be handled lazily, this method will be called later force the object to return its value.
-
#lazy_resolve=(new_lazy_resolve_proc) ⇒ Object
Assign a new resolve proc to this field.
-
#prepare_lazy(obj, args, ctx) ⇒ GraphQL::Execution::Lazy
Prepare a lazy value for this field.
-
#resolve(object, arguments, context) ⇒ Object
Get a value for this field.
-
#resolve=(new_resolve_proc) ⇒ Object
Provide a new callable for this field's resolve function.
- #to_s ⇒ Object
-
#type ⇒ Object
Get the return type for this field.
- #type=(new_return_type) ⇒ Object
Methods included from Define::InstanceDefinable
Constructor Details
#initialize ⇒ Field
Returns a new instance of Field.
210 211 212 213 214 215 216 217 218 219 220 |
# File 'lib/graphql/field.rb', line 210 def initialize @complexity = 1 @arguments = {} @resolve_proc = build_default_resolver @lazy_resolve_proc = DefaultLazyResolve @relay_node_field = false @connection = false @connection_max_page_size = nil @edge_class = nil @trace = nil end |
Instance Attribute Details
#arguments ⇒ Hash<String => GraphQL::Argument>
Returns Map String argument names to their Argument implementations.
166 167 168 |
# File 'lib/graphql/field.rb', line 166 def arguments @arguments end |
#arguments_class ⇒ Object
Returns the value of attribute arguments_class.
183 184 185 |
# File 'lib/graphql/field.rb', line 183 def arguments_class @arguments_class end |
#complexity ⇒ Numeric, Proc
Returns The complexity for this field (default: 1), as a constant or a proc like ->(query_ctx, args, child_complexity) { } # Numeric
.
172 173 174 |
# File 'lib/graphql/field.rb', line 172 def complexity @complexity end |
#connection=(value) ⇒ Object (writeonly)
Sets the attribute connection
185 186 187 |
# File 'lib/graphql/field.rb', line 185 def connection=(value) @connection = value end |
#connection_max_page_size ⇒ nil, Integer
208 209 210 |
# File 'lib/graphql/field.rb', line 208 def connection_max_page_size @connection_max_page_size end |
#deprecation_reason ⇒ String?
Returns The client-facing reason why this field is deprecated (if present, the field is deprecated).
163 164 165 |
# File 'lib/graphql/field.rb', line 163 def deprecation_reason @deprecation_reason end |
#description ⇒ String?
Returns The client-facing description of this field.
160 161 162 |
# File 'lib/graphql/field.rb', line 160 def description @description end |
#edge_class ⇒ nil, Class
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.
200 201 202 |
# File 'lib/graphql/field.rb', line 200 def edge_class @edge_class end |
#function ⇒ Object, GraphQL::Function
Returns The function used to derive this field.
181 182 183 |
# File 'lib/graphql/field.rb', line 181 def function @function end |
#hash_key ⇒ Object?
Returns The key to access with obj.[]
to resolve this field (overrides #name if present).
178 179 180 |
# File 'lib/graphql/field.rb', line 178 def hash_key @hash_key end |
#lazy_resolve_proc ⇒ <#call(obj, args, ctx)> (readonly)
Returns A proc-like object which can be called trigger a lazy resolution.
154 155 156 |
# File 'lib/graphql/field.rb', line 154 def lazy_resolve_proc @lazy_resolve_proc end |
#mutation ⇒ GraphQL::Relay::Mutation?
Returns The mutation this field was derived from, if it was derived from a mutation.
169 170 171 |
# File 'lib/graphql/field.rb', line 169 def mutation @mutation end |
#name ⇒ String
Returns The name of this field on its ObjectType (or InterfaceType).
157 158 159 |
# File 'lib/graphql/field.rb', line 157 def name @name end |
#property ⇒ Symbol?
Returns The method to call on obj
to return this field (overrides #name if present).
175 176 177 |
# File 'lib/graphql/field.rb', line 175 def property @property end |
#relay_node_field ⇒ Boolean
Returns True if this is the Relay find-by-id field.
145 146 147 |
# File 'lib/graphql/field.rb', line 145 def relay_node_field @relay_node_field end |
#relay_nodes_field ⇒ Boolean
Returns True if this is the Relay find-by-ids field.
148 149 150 |
# File 'lib/graphql/field.rb', line 148 def relay_nodes_field @relay_nodes_field end |
#resolve_proc ⇒ <#call(obj, args, ctx)> (readonly)
Returns A proc-like object which can be called to return the field's value.
151 152 153 |
# File 'lib/graphql/field.rb', line 151 def resolve_proc @resolve_proc end |
#subscription_scope ⇒ nil, String
Returns Prefix for subscription names from this field.
188 189 190 |
# File 'lib/graphql/field.rb', line 188 def subscription_scope @subscription_scope end |
#trace ⇒ Boolean
Returns True if this field should be traced. By default, fields are only traced if they are not a ScalarType or EnumType.
191 192 193 |
# File 'lib/graphql/field.rb', line 191 def trace @trace end |
Instance Method Details
#connection? ⇒ Boolean
194 195 196 |
# File 'lib/graphql/field.rb', line 194 def connection? @connection end |
#edges? ⇒ Boolean
203 204 205 |
# File 'lib/graphql/field.rb', line 203 def edges? !!@edge_class end |
#initialize_copy(other) ⇒ Object
222 223 224 225 |
# File 'lib/graphql/field.rb', line 222 def initialize_copy(other) super @arguments = other.arguments.dup end |
#lazy_resolve(obj, args, ctx) ⇒ Object
If #resolve returned and object which should be handled lazily, this method will be called later force the object to return its value.
288 289 290 |
# File 'lib/graphql/field.rb', line 288 def lazy_resolve(obj, args, ctx) @lazy_resolve_proc.call(obj, args, ctx) end |
#lazy_resolve=(new_lazy_resolve_proc) ⇒ Object
Assign a new resolve proc to this field. Used for #lazy_resolve
293 294 295 |
# File 'lib/graphql/field.rb', line 293 def lazy_resolve=(new_lazy_resolve_proc) @lazy_resolve_proc = new_lazy_resolve_proc end |
#prepare_lazy(obj, args, ctx) ⇒ GraphQL::Execution::Lazy
Prepare a lazy value for this field. It may be then
-ed and resolved later.
299 300 301 302 303 |
# File 'lib/graphql/field.rb', line 299 def prepare_lazy(obj, args, ctx) GraphQL::Execution::Lazy.new { lazy_resolve(obj, args, ctx) } end |
#resolve(object, arguments, context) ⇒ Object
Get a value for this field
234 235 236 |
# File 'lib/graphql/field.rb', line 234 def resolve(object, arguments, context) resolve_proc.call(object, arguments, context) end |
#resolve=(new_resolve_proc) ⇒ Object
241 242 243 |
# File 'lib/graphql/field.rb', line 241 def resolve=(new_resolve_proc) @resolve_proc = new_resolve_proc || build_default_resolver end |
#to_s ⇒ Object
278 279 280 |
# File 'lib/graphql/field.rb', line 278 def to_s "<Field name:#{name || "not-named"} desc:#{description} resolve:#{resolve_proc}>" end |
#type ⇒ Object
Get the return type for this field.
251 252 253 |
# File 'lib/graphql/field.rb', line 251 def type @clean_type ||= GraphQL::BaseType.(@dirty_type) end |
#type=(new_return_type) ⇒ Object
245 246 247 248 |
# File 'lib/graphql/field.rb', line 245 def type=(new_return_type) @clean_type = nil @dirty_type = new_return_type end |