GraphQL API が必要になったので、ASP.NET Core で実装できるか試してみた。ライブラリは現状 GraphQL 一択。
www.nuget.org
GraphiQL っていう、GraphQL を試すのに便利な Web UI があるので、それも利用した。ASP.NET Core のミドルウェアを使えば組み込むのは簡単。
www.nuget.org
必要になったのはクエリだけで、ミューテーションはまだ。なので今回は、ASP.NET Core MVC で GraphQL のエンドポイントを用意し、Entity Framework Core と組み合わせてデータベースに保存されたデータを取得するところまでをやってみた。
using GraphiQl;
using GraphQL;
using GraphQL.Types;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
namespace HelloGraphQL
{
public class Team
{
public int Id { get; set; }
public string Name { get; set; }
public IList<Player> Players { get; set; }
}
public class Player
{
public int Id { get; set; }
public string Name { get; set; }
public string Position { get; set; }
public int Number { get; set; }
public int TeamId { get; set; }
public Team Team { get; set; }
}
public class ApplicationDbContext : DbContext
{
public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
: base(options)
{
}
public DbSet<Team> Teams => Set<Team>();
public DbSet<Player> Players => Set<Player>();
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Team>(e =>
{
e.Property(x => x.Id).IsRequired();
e.Property(x => x.Name).IsRequired();
e.HasKey(x => x.Id);
e.HasMany(x => x.Players);
});
modelBuilder.Entity<Player>(e =>
{
e.Property(x => x.Id).IsRequired();
e.Property(x => x.Name).IsRequired();
e.Property(x => x.Number).IsRequired();
e.Property(x => x.Position).IsRequired();
e.Property(x => x.TeamId).IsRequired();
e.HasKey(x => x.Id);
e.HasOne(x => x.Team);
});
}
public void EnsureSeedData()
{
if (!Teams.Any())
{
Teams.Add(new Team
{
Name = "バルセロナ",
Players = new List<Player>
{
new Player
{
Name = "メッシ",
Number = 10,
Position = "FW",
},
new Player
{
Name = "スアレス",
Number = 9,
Position = "FW",
},
},
});
Teams.Add(new Team
{
Name = "レアルマドリード",
Players = new List<Player>
{
new Player
{
Name = "ベイル",
Number = 11,
Position = "FW",
},
new Player
{
Name = "モドリッチ",
Number = 10,
Position = "MF",
},
},
});
SaveChanges();
}
}
}
public class PlayerType : ObjectGraphType<Player>
{
public PlayerType()
{
Field(x => x.Id);
Field(x => x.Name);
Field(x => x.Position);
Field(x => x.Number);
Field(x => x.TeamId);
}
}
public class TeamType : ObjectGraphType<Team>
{
public TeamType()
{
Field(x => x.Id);
Field(x => x.Name);
Field<ListGraphType<PlayerType>>("players");
}
}
public class HelloGraphQLQuery : ObjectGraphType
{
public HelloGraphQLQuery(ApplicationDbContext context)
{
Field<ListGraphType<TeamType>>(
"teams",
arguments: new QueryArguments(
new QueryArgument<IntGraphType>
{
Name = "id",
}),
resolve: ctx =>
{
var query = context.Teams.AsQueryable();
if (ctx.HasArgument("id"))
{
var id = ctx.GetArgument<int>("id");
query = query.Where(b => b.Id == id);
}
var teams = query.Include(b => b.Players)
.ToList();
return teams;
});
}
}
public class HelloGraphQLSchema : Schema
{
public HelloGraphQLSchema(IDependencyResolver dependencyResolver)
: base(dependencyResolver)
{
Query = dependencyResolver.Resolve<HelloGraphQLQuery>();
}
}
public class GraphQLModel
{
public string OperationName { get; set; }
public string Query { get; set; }
}
[Route("graphql")]
[ApiController]
public class GraphQLController : ControllerBase
{
readonly IDocumentExecuter documentExecuter;
readonly ISchema schema;
public GraphQLController(IDocumentExecuter documentExecuter, ISchema schema)
{
this.documentExecuter = documentExecuter;
this.schema = schema;
}
[HttpPost]
public async Task<IActionResult> Post([FromBody] GraphQLModel model)
{
var result = await documentExecuter.ExecuteAsync(new ExecutionOptions
{
Schema = schema,
OperationName = model.OperationName,
Query = model.Query
});
return Ok(result);
}
}
public class Startup
{
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
public IConfiguration Configuration { get; }
public void ConfigureServices(IServiceCollection services)
{
services.AddDbContext<ApplicationDbContext>(options =>
options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
services.AddMvc()
.SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
services.AddTransient<IDocumentExecuter, DocumentExecuter>();
services.AddTransient<ISchema, HelloGraphQLSchema>();
services.AddTransient<HelloGraphQLQuery>();
services.AddTransient<TeamType>();
services.AddTransient<PlayerType>();
var sp = services.BuildServiceProvider();
services.AddSingleton<IDependencyResolver>(x => new FuncDependencyResolver(sp.GetService));
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ApplicationDbContext context)
{
app.UseGraphiQl();
app.UseMvc();
context.Database.EnsureDeleted();
context.Database.EnsureCreated();
context.EnsureSeedData();
}
}
public class Program
{
public static void Main(string[] args)
{
CreateWebHostBuilder(args).Build().Run();
}
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>();
}
}
デバッグ実行して /graphql に Web ブラウザでアクセスすると、GraphiQL の UI が表示される。全チーム取得するクエリを実行してみると、ちゃんとデータベースからデータを引っ張ってこれた。余談だけど、GraphiQL は補完が効いて、これを使わないなんてとんでもない、ってレベル。
次に、指定した id に該当するチームだけ取得するクエリを実行してみると、こちらも上手く動いた。
クエリの解析は GraphQL.NET がやってくれるけど、データベースからデータを引っ張ってくるところは自分で書く必要があって、なかなかツラミがあった。
あと、今回みたいな簡単なクエリを実装するだけでも結構苦労した。GraphQL 自体の仕様だけでなく、ライブラリの使い方も知る必要があったし、何より、REST API と GraphQL API では考え方が違いすぎて、切り替えるのが大変。GraphQL 脳にならないといけないな。
GraphQL API だと URL を考える必要は無くなったけど、どんなクエリやミューテーションを提供するか考える必要があるので、API 提供側の苦労はさほど変わらない印象だ。
黄金の福ワンタン まくり
黄金の福ワンタン まくり 飯倉本店をぐるなびで見る | 福岡市早良区の飲茶・点心をぐるなびで見る
![[まとめ買い] 五等分の花嫁](https://images-fe.ssl-images-amazon.com/images/I/D10FWJiOC4S.png "[まとめ買い] 五等分の花嫁")
![[まとめ買い] 五等分の花嫁](https://images-fe.ssl-images-amazon.com/images/I/D10FWJiOC4S._SL160_.png "[まとめ買い] 五等分の花嫁")