Asp.Net Core Api İle Graphql Projesi Oluşturmak

Bu yazı dizimiz de Asp.Net Core Api teması kullanarak graphql ile sql server veritabanina nasıl bağlantı kurabileceğimizi göreceğiz.
Kaynak Kodlara aşağıdaki repodan ulaşabilirsiniz.
GitHub - cagdaskarademir/aspnetcore-graphql-dapper-sqlkata-sqlserver: Tutorial Asp.Net Core 3.1 + GraphQLApi + Sql Server
GitHub
​
Makalenin Amacı
.Net Core Web Api ve GraphQL kullanarak SQL Server veritabanında select  işlemlerinin nasıl yapılacağını tecrübe edineceğiz. 
Bilmeniz veya Öğrenmeniz Gereken Terimler
Aşağıdaki terimler hakkında bilgi sahibi olmalısınız.
1..Net Core Web Api Nedir?
2..Net Core Web Api Projesi Nasıl Oluşturulur?
3.GraphQL Nedir? 
4.ObjectGraphType Nedir? 
5.Dapper Nedir?
6.SqlKata Nedir?
Kullanılan Yan Teknolojiler
Orm tool olarak Dapper altyapısı kullanılarak hızlı bir şekilde sql kodu yazabileceğimiz SqlKata Query Generater kütüphanesini kullanacağız.
SqlKata kütüphanesine https://sqlkata.com/ linki üzerinden erişebilirsiniz. 
Dökümantasyon ve örnekler için https://sqlkata.com/docs adresini ziyaret etmenizi öneririm.
Katmanların Oluşturulması
Web Projesinin Oluşturulması
asp.net web api projesi oluşturuyoruz.‌
Web Projemize aşağıdaki kütüphaneleri ekliyoruz.
1
<PackageReference Include="GraphQL" Version="2.4.0" />
Copied!
Entity Projesinin Oluşturulması
Tablo setlerimizi yöneteceğimiz Entity katmanını oluşturuyoruz.
Referans Projesi olarak aşağıdaki projeyi ekliyoruz.
1
<ProjectReference Include="..\CK.Tutorial.GraphQlApi.Common\CK.Tutorial.GraphQlApi.Common.csproj" />
Copied!
Common Katmanının Oluşturulması
‌Tüm katmanlarda kullanacağımız enum, const ve helper sınıfları için Common katmanını oluşturuyoruz.
Projemize Newtonsoft.Json kütüphanesini ekliyoruz.
1
 <PackageReference Include="Newtonsoft.Json" Version="12.0.2" />
Copied!
Business Katmanının Oluşturulması
İş süreçlerini kontrol edebileceğimiz Business katmanını oluşturuyoruz.
Model Katmanının Oluşturulması
Verilerimizi transfer edeceğimiz Model katmanını oluşturuyoruz.
Referans Projesi olarak aşağıdaki projeyi ekliyoruz.
1
<ProjectReference Include="..\CK.Tutorial.GraphQlApi.Common\CK.Tutorial.GraphQlApi.Common.csproj" />
Copied!
Repository Katmanının Oluşturulması
Veritabanı işlemlerini yönetebildiğimiz data katmanımız olan Repository katmanını oluşturuyoruz.
Repository katmanına aşağıdaki referansları ekleyin.
1
<PackageReference Include="System.Data.SqlClient" Version="4.7.0" />
2
<PackageReference Include="SqlKata" Version="1.1.7" />
3
<PackageReference Include="SqlKata.Execution" Version="1.1.7" />
Copied!
Referans projesini olarak aşağıdaki kütüphaneleri ekliyoruz.
CK.Tutorial.GraphQlApi.Repository.csproj
1
<ProjectReference Include="..\CK.Tutorial.GraphQlApi.Common\CK.Tutorial.GraphQlApi.Common.csproj" />
2
<ProjectReference Include="..\CK.Tutorial.GraphQlApi.Entity\CK.Tutorial.GraphQlApi.Entity.csproj" />
3
<ProjectReference Include="..\CK.Tutorial.GraphQlApi.Model\CK.Tutorial.GraphQlApi.Model.csproj" />
Copied!
Common Layer
Extension Dosyalarının Oluşturulması
Array değişkenlerimize yardımcı olması için aşağıdaki extension'ı yazıyoruz.
1
using System.Linq;
2
​
3
namespace CK.Tutorial.GraphQlApi.Common.Extension
4
{
5
    public static class ArrayExtension
6
    {
7
        public static bool AnyItem(this string[] value)
8
        {
9
            return value != null && value.Any();
10
        }
11
    }
12
}
Copied!
Primitive değişkenlerimize yardımcı olmak için aşağıdaki extension'ı yazıyoruz.
1
using System;
2
​
3
namespace CK.Tutorial.GraphQlApi.Common.Extension
4
{
5
    public static class PrimitiveExtension
6
    {
7
        public static bool IsNotNullOrEmpty(this string value)
8
        {
9
            return !string.IsNullOrEmpty(value);
10
        }
11
​
12
        public static bool IsNotNull(this bool? value)
13
        {
14
            return value != null;
15
        }
16
        
17
        public static bool IsTrue(this bool? value)
18
        {
19
            return value != null && value == true;
20
        }
21
        
22
        public static byte ConvertToByte(this bool? value)
23
        {
24
            if (value ==null )
25
            {
26
                throw new ArgumentException("Boolean Item must be convertible");
27
            }
28
​
29
            return (byte) (value.Value ? 1 : 0);
30
        }
31
    }
32
}
Copied!
Common Model Dosyalarının Oluşturulması
Kullanıcılardan parametrik olarak alacağımız veriler için base request sınıfı oluşturuyoruz.
1
namespace CK.Tutorial.GraphQlApi.Common.Model
2
{
3
    public class RequestBase
4
    {
5
        public int DefaultPage { get; } = 1;
6
        public int DefaultPageSize { get; } = 10;
7
        public string[] Columns { get; set; }
8
        public int? PageSize { get; set; }
9
        public int? Page { get; set; }
10
    }
11
}
Copied!
GraphQL için aşağıdaki model dosyamızı oluşturuyoruz.
1
using System.Text;
2
​
3
namespace CK.Tutorial.GraphQlApi.Common.Model
4
{
5
    public class GraphQlQuery
6
    {
7
        public string OperationName { get; set; }
8
        public string NamedQuery { get; set; }
9
        public string Query { get; set; }
10
        public string Variables { get; set; }
11
​
12
        public override string ToString()
13
        {
14
            var builder = new StringBuilder();
15
            builder.AppendLine();
16
            if (!string.IsNullOrWhiteSpace(OperationName)) builder.AppendLine(quot;OperationName = {OperationName}");
17
            if (!string.IsNullOrWhiteSpace(NamedQuery)) builder.AppendLine(quot;NamedQuery = {NamedQuery}");
18
            if (!string.IsNullOrWhiteSpace(Query)) builder.AppendLine(quot;Query = {Query}");
19
            if (!string.IsNullOrWhiteSpace(Variables)) builder.AppendLine(quot;Variables = {Variables}");
20
​
21
            return builder.ToString();
22
        }
23
    }
24
}
Copied!
Entity Katmanı
Company Entity
1
namespace CK.Tutorial.GraphQlApi.Entity
2
{
3
    public class Company
4
    {
5
        public int Id { get; set; }
6
        public string Name { get; set; }
7
        public bool IsActive { get; set; }
8
    }
9
}
Copied!
Product Entity
1
using CK.Tutorial.GraphQlApi.Common.Enum;
2
​
3
namespace CK.Tutorial.GraphQlApi.Entity
4
{
5
    public class Product
6
    {
7
        public int Id { get; set; }
8
        public int CompanyId { get; set; }
9
        public string Name { get; set; }
10
        public string Description { get; set; }
11
        public int ProductTypeId { get; set; }
12
        public Status Status { get; set; }
13
    }
14
}
Copied!
Model Katmanı
Search Company Database Transfer Object 
Kullanıcıdan aldığımız verileri alt katmanlara aşağıdaki veri deseniyle göndereceğiz.
1
using CK.Tutorial.GraphQlApi.Common.Model;
2
​
3
namespace CK.Tutorial.GraphQlApi.Model.Request
4
{
5
    public class SearchCompany : RequestBase
6
    {
7
        public int? Id { get; set; }
8
        public string Name { get; set; }
9
        public bool? IsActive { get; set; }
10
    }
11
}
Copied!
Repository Katmanı
‌IRepositoryBase Interface Oluşturulması
Repository sınıflarımız için generic base bir Interface tanımlıyoruz.
IRepository.cs
1
‌using SqlKata.Execution;
2
​
3
namespace CK.Tutorial.GraphQlApi.Repository
4
{
5
    public interface IRepositoryBase<TEntity>
6
    {
7
        QueryFactory QueryFactory { get; }
8
    }
9
}
Copied!
RepositoryBase Sınıfının Oluşturulması
Oluşturacağımız Entity Repository'leri için RepositoryBase sınıfını, IRepositoryBase interface'i üzerinden oluşturuyoruz.
RepositoryBase.cs
1
using SqlKata.Execution;
2
​
3
namespace CK.Tutorial.GraphQlApi.Repository
4
{
5
    public class RepositoryBase<TEntity> : IRepositoryBase<TEntity>
6
    {
7
        public RepositoryBase(QueryFactory queryFactory)
8
        {
9
            QueryFactory = queryFactory;
10
        }
11
​
12
        public QueryFactory QueryFactory { get; set; }
13
    }
14
}
Copied!
‌ICompanyRepository Interface Oluşturulması
ICompanyRepository.cs
1
using System.Collections.Generic;
2
using System.Threading.Tasks;
3
using CK.Tutorial.GraphQlApi.Entity;
4
using CK.Tutorial.GraphQlApi.Model.Request;
5
using SqlKata.Execution;
6
​
7
namespace CK.Tutorial.GraphQlApi.Repository
8
{
9
    public interface ICompanyRepository
10
    {
11
        Task<IEnumerable<Company>> GetCompanies(SearchCompany request);
12
        Task<Company> GetCompany(SearchCompany request);
13
    }
14
}
Copied!
CompanyRepository Sınıfının Oluşturulması
CompanyRepository.cs
1
using System.Collections.Generic;
2
using System.Linq;
3
using System.Threading.Tasks;
4
using CK.Tutorial.GraphQlApi.Common.Extension;
5
using CK.Tutorial.GraphQlApi.Entity;
6
using CK.Tutorial.GraphQlApi.Model.Request;
7
using SqlKata.Execution;
8
​
9
namespace CK.Tutorial.GraphQlApi.Repository
10
{
11
    public class CompanyRepository : RepositoryBase<Company>, ICompanyRepository
12
    {
13
        private readonly QueryFactory _queryFactory;
14
        private const string TableName = "Company";
15
​
16
        public CompanyRepository(QueryFactory queryFactory) : base(queryFactory)
17
        {
18
            _queryFactory = queryFactory;
19
        }
20
​
21
        public async Task<IEnumerable<Company>> GetCompanies(SearchCompany request)
22
        {
23
            var query = _queryFactory
24
                .Query(TableName)
25
                .When(request.Columns.AnyItem(),
26
                    q => q.Select(request.Columns))
27
                .When(request.IsActive.IsNotNull(), q => q.Where("IsActive", request.IsActive.ConvertToByte()))
28
                .OrderBy("Id")
29
                .ForPage(request.Page ?? request.DefaultPage, request.PageSize ?? request.DefaultPageSize)
30
                .GetAsync<Company>();
31
​
32
            return await query.ConfigureAwait(false);
33
        }
34
​
35
        public async Task<Company> GetCompany(SearchCompany request)
36
        {
37
            var query = _queryFactory
38
                .Query(TableName)
39
                .When(request.Columns.AnyItem(),
40
                    q => q.Select(request.Columns))
41
                .When(request.Id.HasValue, q => q.Where("Id", request.Id))
42
                .When(request.Name.IsNotNullOrEmpty(), q => q.WhereContains("Name", request.Name))
43
                .When(request.IsActive.IsNotNull(), q => q.Where("IsActive", request.IsActive.ConvertToByte()))
44
                .OrderBy("Id")
45
                .FirstOrDefaultAsync<Company>();
46
​
47
            return await query.ConfigureAwait(false);
48
        }
49
    }
50
}
51
​
Copied!
Business Katmanı
‌Company Entity'sinin iş süreçlerini yazmak için ICompanyService adında bir interface oluşturuyoruz. 
Şimdilik iki tane metod yazacağız. 
ICompanyService Oluşturulması
ICompanyService.cs
1
using System.Collections.Generic;
2
using System.Threading.Tasks;
3
using CK.Tutorial.GraphQlApi.Entity;
4
using CK.Tutorial.GraphQlApi.Model.Request;
5
using SqlKata.Execution;
6
​
7
namespace CK.Tutorial.GraphQlApi.Business
8
{
9
    public interface ICompanyService
10
    {
11
        Task<IEnumerable<Company>> GetCompanies(SearchCompany request);
12
        Task<Company> GetCompany(SearchCompany request);
13
    }
14
}
Copied!
CompanyService Sınıfının Oluşturulması
ICompanyService üzerinden CompanyService adında yeni bir sınıf oluşturuyoruz.
CompanyService.cs
1
using System.Collections.Generic;
2
using System.Threading.Tasks;
3
using CK.Tutorial.GraphQlApi.Entity;
4
using CK.Tutorial.GraphQlApi.Model.Request;
5
using CK.Tutorial.GraphQlApi.Repository;
6
​
7
namespace CK.Tutorial.GraphQlApi.Business
8
{
9
    public class CompanyService : ICompanyService
10
    {
11
        private readonly ICompanyRepository _companyRepository;
12
​
13
        public CompanyService(ICompanyRepository companyRepository)
14
        {
15
            _companyRepository = companyRepository;
16
        }
17
        
18
        public Task<IEnumerable<Company>> GetCompanies(SearchCompany request)
19
        {
20
            return _companyRepository.GetCompanies(request);
21
        }
22
​
23
        public Task<Company> GetCompany(SearchCompany request)
24
        {
25
            return _companyRepository.GetCompany(request);
26
        }
27
    }
28
}
Copied!
Web - Graphql Katmanı
GraphQL Schema adını verdiğimiz referans bir root sınıfından oluşur. 
Schema sınıfına Resolver bir tane QUERY referans gösterilir..
Query dosyaları ise GraphType'lardan beslenerek dinamik sorgular oluşturacağımız bir yapı kurmamızı sağlar.
Kısacası Schema > Query > GraphTypes olarak tanımlayabiliriz.
Retail adında bir tane Root Schema sınıfımızı aşağıdaki gibi tanımlıyoruz.
RetailSchema sınıfının TutorialQuery adında bir sorgulama sınıfını çözümlediğini bildiriyoruz.
Schema Sınıfının Oluşturulması
RetailSchema.cs
1
using CK.Tutorial.GraphQlApi.Web.Query;
2
using GraphQL;
3
​
4
namespace CK.Tutorial.GraphQlApi.Web.Schema
5
{
6
    public class RetailSchema : GraphQL.Types.Schema
7
    {
8
        public RetailSchema(IDependencyResolver resolver) : base(resolver)
9
        {
10
            Query = resolver.Resolve<TutorialQuery>();
11
        }
12
    }
13
}
Copied!
Company Graph Type Sınıfının Oluşturulması
Entity sınıflarımızın field alanlarını kullanarak graphql için sorgulanabilir tipler oluşturuyoruz.
Aşağıdaki örneğimizde Company Entity dosyasımızı referans göstermiş ve field alanları için Type tanımlamalarını yapmış olduğumuzu göreceksiniz. 
Örneğin Name alanı için ikinci parametre olan IsNullable alanını True vererek, bu field için null alabilen bir field düzenlemiş olduk. Diğer override parametrelerini kullanarak TYPE tipinide değiştirmeniz veya belirtmeniz mümkündür.
CompanyGraphType.cs
1
using System;
2
using CK.Tutorial.GraphQlApi.Business;
3
using CK.Tutorial.GraphQlApi.Entity;
4
using GraphQL.Types;
5
​
6
namespace CK.Tutorial.GraphQlApi.Web.Types
7
{
8
    public class CompanyGraphType : ObjectGraphType<Company>
9
    {
10
        public CompanyGraphType()
11
        {
12
            Name = "Company";
13
            Field(x => x.Id).Description("Şirket Benzersiz No");
14
            Field(x => x.Name, true).Description("Şirket Adı");
15
            Field(x => x.IsActive, true).Description("Şirket Aktif mi?");
16
        }
17
    }
18
}
Copied!
TutorialQuery Sınıfının Oluşturulması
Bu örneğimizde 2 tane sorgulama endpoint'i oluşturacağız.
Birinci endpoint; "company" adını verdiğimiz, CompanyGraphType kullanarak sorgu yapabileceğimiz, 
companyId
companyName
isActive
parametrelerinden oluşan ve return type değeri COMPANY entity sınıfımızdır.  
İkinci endpoint; "companies" adını verdiğimiz ve return tipi List<Company> olan sınıfımızdır.
TutorialQuery.cs
1
using System.Collections.Generic;
2
using CK.Tutorial.GraphQlApi.Business;
3
using CK.Tutorial.GraphQlApi.Model.Request;
4
using CK.Tutorial.GraphQlApi.Web.Extensions;
5
using CK.Tutorial.GraphQlApi.Web.Types;
6
using GraphQL.Types;
7
​
8
namespace CK.Tutorial.GraphQlApi.Web.Query
9
{
10
    public class TutorialQuery : ObjectGraphType
11
    {
12
        public TutorialQuery(ICompanyService companyService)
13
        {
14
            #region Company
15
​
16
            Field<CompanyGraphType>(
17
                name: "company",
18
                arguments: new QueryArguments(new List<QueryArgument>
19
                {
20
                    new QueryArgument<IntGraphType>
21
                    {
22
                        Name = "companyId"
23
                    },
24
                    new QueryArgument<StringGraphType>
25
                    {
26
                        Name = "companyName"
27
                    },
28
                    new QueryArgument<BooleanGraphType>
29
                    {
30
                        Name = "isActive"
31
                    }
32
                }),
33
                resolve: delegate (ResolveFieldContext<object> context)
34
                {
35
                    var columns = context.GetMainSelectedFields();
36
​
37
                    var companyId = context.GetArgument<int?>("companyId");
38
                    var companyName = context.GetArgument<string>("companyName");
39
                    var isActive = context.GetArgument<bool?>("isActive");
40
​
41
                    var request = new SearchCompany
42
                    {
43
                        Id = companyId,
44
                        Name = companyName,
45
                        IsActive = isActive,
46
                        Columns = columns
47
                    };
48
                    return companyService.GetCompany(request);
49
                });
50
​
51
            Field<ListGraphType<CompanyGraphType>>(
52
                "companies",
53
                arguments: new QueryArguments(new List<QueryArgument>
54
                {
55
                    new QueryArgument<ListGraphType<IntGraphType>>
56
                    {
57
                        Name = "companyIds"
58
                    },
59
                    new QueryArgument<ListGraphType<StringGraphType>>
60
                    {
61
                        Name = "companyNames"
62
                    },
63
                     new QueryArgument<BooleanGraphType>
64
                    {
65
                        Name = "isActive"
66
                    },
67
                    new QueryArgument<IntGraphType>
68
                    {
69
                        Name = "page"
70
                    },
71
                    new QueryArgument<IntGraphType>
72
                    {
73
                        Name = "pageSize"
74
                    }
75
                }),
76
                resolve: delegate (ResolveFieldContext<object> context)
77
                {
78
                    var columns = context.GetMainSelectedFields();
79
                    var companyIds = context.GetArgument<int?[]>("companyIds");
80
                    var companyNames = context.GetArgument<string[]>("companyNames");
81
                    var isActive = context.GetArgument<bool?>("isActive");
82
​
83
                    var page = context.GetArgument<int?>("page");
84
                    var pageSize = context.GetArgument<int?>("pageSize");
85
​
86
                    var request = new SearchCompanies()
87
                    {
88
                        Ids = companyIds,
89
                        Names = companyNames,
90
                        IsActive = isActive,
91
                        Page = page,
92
                        PageSize = pageSize,
93
                        Columns = columns
94
                    };
95
                    return companyService.GetCompanies(request);
96
                });
97
​
98
            #endregion
99
        }
100
    }
101
}
Copied!
Build & Run & Test
Create Database
Öncelikle yeni bir SQL SERVER veritabanı açmalısınız.
Sonrasında database klasörü içerisinde yer alan create-table.sql dosyasını çalıştırmalısınız.
create-table.sql
1
-- auto-generated definition
2
create table Company
3
(
4
    Id       int identity
5
        constraint Company_pk
6
            primary key nonclustered,
7
    Name     nvarchar(200) not null,
8
    IsActive bit default 1 not null
9
)
10
go
11
​
12
create unique index Company_Id_uindex
13
    on Company (Id)
14
go
15
​
16
​
Copied!
Sizlerin projeyi test edebilmesi için; database klasörünün içerisinde yer alan bulk-data.sql dosyasını oluşturdum, bu dosyayı çalıştırabilirsiniz. 
Projenin AppSettings dosyasını kendi connectionString değerlerinize göre güncellemesiniz.
appsettings.json
1
{
2
  "Logging": {
3
    "LogLevel": {
4
      "Default": "Information",
5
      "Microsoft": "Warning",
6
      "Microsoft.Hosting.Lifetime": "Information"
7
    }
8
  },
9
  "AllowedHosts": "*",
10
  "ConnectionStrings": {
11
    "SqlServerDatabaseConnection": "Server=localhost;Database=GraphQLSample;User Id=sa;Password=Aa123456;"
12
  }
13
}
14
​
Copied!
DotNet Restore & Build & Run
Aşağıdaki komutları çalıştırıp projeyi ayağa kaldırabilirsiniz.
1
dotnet restore
2
dotnet build
3
dotnet run
Copied!
UI PlayGround 
Tarayıcınızdan https://localhost:5001/ui/playground adresine gitmek istediğinizde; sorgularınızı test edebileceğiniz bir arayüze erişebilmeniz gerekmektedir.
Hello GraphQL For .Net
Aşağıdaki sorguyu yazdığınızda çıktısını almalısınız.
1
query {
2
  company(companyId:5) {
3
    id
4
    name
5
    isActive
6
  }
7
}
Copied!
​