Class: GraphQL::StaticValidation::ValidationContext

Inherits:
Object
  • Object
show all
Defined in:
lib/graphql/static_validation/validation_context.rb

Overview

The validation context gets passed to each validator.

It exposes a Language::Visitor where validators may add hooks. (Visitor#visit is called in GraphQL::StaticValidation::Validator#validate)

It provides access to the schema & fragments which validators may read from.

It holds a list of errors which each validator may add to.

It also provides limited access to the TypeStack instance, which tracks state as you climb in and out of different fields.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(query) ⇒ ValidationContext

Returns a new instance of ValidationContext


15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# File 'lib/graphql/static_validation/validation_context.rb', line 15

def initialize(query)
  @query = query
  @schema = query.schema
  @document = query.document
  @fragments = {}
  @operations = {}
  @warden = query.warden

  document.definitions.each do |definition|
    case definition
    when GraphQL::Language::Nodes::FragmentDefinition
      @fragments[definition.name] = definition
    when GraphQL::Language::Nodes::OperationDefinition
      @operations[definition.name] = definition
    end
  end

  @errors = []
  @visitor = GraphQL::Language::Visitor.new(document)
  @type_stack = GraphQL::StaticValidation::TypeStack.new(schema, visitor)
end

Instance Attribute Details

#documentObject (readonly)

Returns the value of attribute document


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def document
  @document
end

#errorsObject (readonly)

Returns the value of attribute errors


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def errors
  @errors
end

#fragmentsObject (readonly)

Returns the value of attribute fragments


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def fragments
  @fragments
end

#operationsObject (readonly)

Returns the value of attribute operations


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def operations
  @operations
end

#queryObject (readonly)

Returns the value of attribute query


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def query
  @query
end

#schemaObject (readonly)

Returns the value of attribute schema


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def schema
  @schema
end

#visitorObject (readonly)

Returns the value of attribute visitor


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def visitor
  @visitor
end

#wardenObject (readonly)

Returns the value of attribute warden


14
15
16
# File 'lib/graphql/static_validation/validation_context.rb', line 14

def warden
  @warden
end

Instance Method Details

#argument_definitionGraphQL::Argument?

Returns The most-recently-entered GraphQL::Argument, if currently inside one

Returns:

  • (GraphQL::Argument, nil)

    The most-recently-entered GraphQL::Argument, if currently inside one


67
68
69
70
71
# File 'lib/graphql/static_validation/validation_context.rb', line 67

def argument_definition
  # Don't get the _last_ one because that's the current one.
  # Get the second-to-last one, which is the parent of the current one.
  @type_stack.argument_definitions[-2]
end

#directive_definitionGraphQL::Directive?

Returns The most-recently-entered GraphQL::Directive, if currently inside one

Returns:

  • (GraphQL::Directive, nil)

    The most-recently-entered GraphQL::Directive, if currently inside one


62
63
64
# File 'lib/graphql/static_validation/validation_context.rb', line 62

def directive_definition
  @type_stack.directive_definitions.last
end

#field_definitionGraphQL::Field?

Returns The most-recently-entered GraphQL::Field, if currently inside one

Returns:

  • (GraphQL::Field, nil)

    The most-recently-entered GraphQL::Field, if currently inside one


52
53
54
# File 'lib/graphql/static_validation/validation_context.rb', line 52

def field_definition
  @type_stack.field_definitions.last
end

#object_typesObject


37
38
39
# File 'lib/graphql/static_validation/validation_context.rb', line 37

def object_types
  @type_stack.object_types
end

#parent_type_definitionGraphQL::BaseType

Returns The type which the current type came from

Returns:


47
48
49
# File 'lib/graphql/static_validation/validation_context.rb', line 47

def parent_type_definition
  object_types[-2]
end

#pathArray<String>

Returns Field names to get to the current field

Returns:

  • (Array<String>)

    Field names to get to the current field


57
58
59
# File 'lib/graphql/static_validation/validation_context.rb', line 57

def path
  @type_stack.path.dup
end

#type_definitionGraphQL::BaseType

Returns The current object type

Returns:


42
43
44
# File 'lib/graphql/static_validation/validation_context.rb', line 42

def type_definition
  object_types.last
end

#valid_literal?(ast_value, type) ⇒ Boolean

Returns:

  • (Boolean)

73
74
75
76
# File 'lib/graphql/static_validation/validation_context.rb', line 73

def valid_literal?(ast_value, type)
  @literal_validator ||= LiteralValidator.new(warden: @warden)
  @literal_validator.validate(ast_value, type)
end