HotChocolate GraphQL Schema Generator for Entity Framework DbSets It enables you to create hassle-free GraphQL APIs without having to write Schema manually (for queries and subscriptions - i still recommend using rest for writes)
dotnet add package HotChocolatier.Adnotations --version 1.0.0
or
NuGet\Install-Package HotChocolatier.Adnotations -Version 1.0.0
dotnet tool install --global HotChocolatier.Tool --version 1.0.0
It generates GraphQL Schema for Query and Subscription. Example use:
You need to add <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
to your DbContext Project
in the first propertygroup section
<PropertyGroup>
<TargetFramework>net7.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> <!-- Here -->
</PropertyGroup>
Then you need to build the project and call HotChocolatier with following attributes:
hotchocolatier -a E:\Projects\GameDesignStudio\src\Backend\GameDesignStudio.Data\bin\Debug\net7.0\GameDesignStudio.Data.dll -n GameDesignStudio.GraphQL.Schema -v -o E:\Projects\GameDesignStudio\src\Backend\GameDesignStudio.GraphQL
If you feel lost, there's always -h that displays the manual, but here's a rundown of options:
- -a is a dll holding the DbContext class
- -n is a target namespace of generated schema
- -v is used to display verbose logs
- -o defines output directory (of course it will create its' own Schema folder with subsequent Query and Subscription folders to organize each partial classes.
It automatically names partials based on DbSet name. So example output will look like:
// ... inside DbContext
[GraphQlSubscription(Authorize = true),
GraphQlList(UseSorting = true, UseFiltering = true, UseProjection = true, Authorize = true),
GraphQlPagedList(UseSorting = true, UseFiltering = true, UseProjection = true, Authorize = true),
GraphQlGetById(Authorize = true)]
public DbSet<User> Users { get; set; }
In order to get the attributes you need the HotChocolatier.Adnotations package. It contains following attributes:
- GraphQLSubscription (creates subscriptions with Added and Updated Event - you need to trigger them manually from other services - see (https://chillicream.com/docs/hotchocolate/v13/defining-a-schema/subscriptions)
- GraphQLList (exposes raw IQueryable for projections, sorting etc - of course you can configure which one you want and which one you don't want)
- GraphQlPagedList (uses offset paging)
- GraphQLGetById (allows to get one item by integer id)
Output for Users DbSet will look like this (File Name: Query.Users.cs):
using Microsoft.EntityFrameworkCore;
using HotChocolate.Authorization;
namespace GameDesignStudio.GraphQL.Schema;
public partial class Query{
[Authorize, UseProjection, UseFiltering, UseSorting]
public IQueryable<GameDesignStudio.Data.Model.Auth.User> GetUsers([Service(ServiceKind.Synchronized)] GameDesignStudio.Data.Context.GameDesignStudioContext context)
=> context.Users;
[Authorize, UseOffsetPaging(DefaultPageSize = 50, IncludeTotalCount = true, MaxPageSize = 1000), UseProjection, UseFiltering, UseSorting]
public IQueryable<GameDesignStudio.Data.Model.Auth.User> GetUsersWithPaging([Service(ServiceKind.Synchronized)] GameDesignStudio.Data.Context.GameDesignStudioContext context)
=> context.Users;
public async ValueTask<GameDesignStudio.Data.Model.Auth.User?> GetUser([Service(ServiceKind.Synchronized)] GameDesignStudio.Data.Context.GameDesignStudioContext context, int id)
=> await context.Users.FirstOrDefaultAsync(x => x.Id == id);
}