Spaces:
Running
Running
File size: 3,487 Bytes
b110593 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 |
// _ _
// __ _____ __ ___ ___ __ _| |_ ___
// \ \ /\ / / _ \/ _` \ \ / / |/ _` | __/ _ \
// \ V V / __/ (_| |\ V /| | (_| | || __/
// \_/\_/ \___|\__,_| \_/ |_|\__,_|\__\___|
//
// Copyright © 2016 - 2024 Weaviate B.V. All rights reserved.
//
// CONTACT: [email protected]
//
// Package graphql provides the graphql endpoint for Weaviate
package graphql
import (
"context"
"fmt"
"runtime/debug"
"github.com/sirupsen/logrus"
"github.com/tailor-inc/graphql"
"github.com/weaviate/weaviate/adapters/handlers/graphql/local"
"github.com/weaviate/weaviate/adapters/handlers/graphql/local/get"
"github.com/weaviate/weaviate/entities/schema"
"github.com/weaviate/weaviate/usecases/config"
"github.com/weaviate/weaviate/usecases/modules"
)
type Traverser interface {
local.Resolver
}
type RequestsLogger interface {
get.RequestsLog
}
// The communication interface between the REST API and the GraphQL API.
type GraphQL interface {
// Resolve the GraphQL query in 'query'.
Resolve(context context.Context, query string, operationName string, variables map[string]interface{}) *graphql.Result
}
type graphQL struct {
schema graphql.Schema
traverser Traverser
config config.Config
}
// Construct a GraphQL API from the database schema, and resolver interface.
func Build(schema *schema.Schema, traverser Traverser,
logger logrus.FieldLogger, config config.Config, modulesProvider *modules.Provider,
) (GraphQL, error) {
logger.WithField("action", "graphql_rebuild").
WithField("schema", schema).
Debug("rebuilding the graphql schema")
graphqlSchema, err := buildGraphqlSchema(schema, logger, config, modulesProvider)
if err != nil {
return nil, err
}
return &graphQL{
schema: graphqlSchema,
traverser: traverser,
config: config,
}, nil
}
// Resolve at query time
func (g *graphQL) Resolve(context context.Context, query string, operationName string, variables map[string]interface{}) *graphql.Result {
return graphql.Do(graphql.Params{
Schema: g.schema,
RootObject: map[string]interface{}{
"Resolver": g.traverser,
"Config": g.config,
},
RequestString: query,
OperationName: operationName,
VariableValues: variables,
Context: context,
})
}
func buildGraphqlSchema(dbSchema *schema.Schema, logger logrus.FieldLogger,
config config.Config, modulesProvider *modules.Provider,
) (graphql.Schema, error) {
localSchema, err := local.Build(dbSchema, logger, config, modulesProvider)
if err != nil {
return graphql.Schema{}, err
}
schemaObject := graphql.ObjectConfig{
Name: "WeaviateObj",
Description: "Location of the root query",
Fields: localSchema,
}
// Run graphql.NewSchema in a sub-closure, so that we can recover from panics.
// We need to use panics to return errors deep inside the dynamic generation of the GraphQL schema,
// inside the FieldThunks. There is _no_ way to bubble up an error besides panicking.
var result graphql.Schema
func() {
defer func() {
if r := recover(); r != nil {
err = fmt.Errorf("%v at %s", r, debug.Stack())
}
}()
result, err = graphql.NewSchema(graphql.SchemaConfig{
Query: graphql.NewObject(schemaObject),
})
}()
if err != nil {
return graphql.Schema{}, fmt.Errorf("Could not build GraphQL schema, because: %v", err)
}
return result, nil
}
|