Skip to main content
Version: 1.x

GraphQL Controllers

A Controller defines the shape of the GraphQL queries and mutations. Each decorated method in the controller acts as a resolver.

Implements GraphQL controller methods

A controller method is a decorated class method that takes parameter and return a result.

The @grapqhl.[query|mutation]() decorators mark a class method as a query or mutation resolver.

A resolver can accept arguments, that can be defined using the @graphql.arg() decorator. The type of each argument will be inferred and inspected, and validated against the value provided.\ You can even supply complex types, like schema classes.
Please note that due to a limitation on the typescript reflection mechanism, there are cases where you need to pass the type explicitly.

// file: ./AuthorController.ts
import { graphql } from '@davinci/graphql';
import { context } from '@davinci/core';
import model from './AuthorModel';
import AuthorSchema, { AuthorQuery } from './AuthorSchema';
import { BookSchema } from '../book';

const { query, parent, mutation, fieldResolver, arg } = graphql;

export default class AuthorController {
model = model;

@query(AuthorSchema, 'authorById')
getAuthorById(@arg({ required: true }) id: string) {
return this.model.findById(id);
}

@query([AuthorSchema], 'authors')
findAuthors(@arg() query: AuthorQuery, @context() context: any) {
return this.model.find(query, {}, { context });
}

@mutation(AuthorSchema)
createAuthor(@arg({ required: true }) data: AuthorSchema) {
return this.model.create(data);
}

@mutation(AuthorSchema)
updateAuthorById(@arg({ required: true }) id: string, @arg({ required: true }) data: AuthorSchema) {
return this.model.findByIdAndUpdate(id, data, { new: true });
}

@fieldResolver<BookSchema>(BookSchema, 'authors', [AuthorSchema])
getBookAuthors(@parent() book: BookSchema, @arg() query: AuthorQuery, @context() context: any) {
console.log(query);
// @ts-ignore
return this.findAuthors({ ...query, _id: { $in: book.authorIds } }, context);
}
}