Give a Star! ⭐

Running

Development (secrets)

dotnet user-secrets initdotnet user-secretsset"ConnectionStrings:DefaultConnection""Server=localhost,1433;Database=Store;User=sa;Password=!MyComplexPassword"

dotnet user-secrets initdotnet user-secretsset"HttpClient:Store""http://localhost:5000"

AppSettings

{"ConnectionStrings":{"DefaultConnection":"Server=localhost,1433;Database=Store;User=sa;Password=!MyComplexPassword"}}

{"HttpClient":{"Store":"http://localhost:5000"}}

Production

AppSettings

{"ConnectionStrings":{"DefaultConnection":"Server=mssql;Database=Store;User=sa;Password=!MyComplexPassword"}}

{"HttpClient":{"Store":"http://webapi:5000"}}

Docker

docker-compose up -d

version:"3.7"services:mssql:container_name:mssqlimage:mcr.microsoft.com/mssql/serverports:      -1433:1433environment:SA_PASSWORD:"!MyComplexPassword"ACCEPT_EULA:"Y"healthcheck:test:/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P "$$SA_PASSWORD" -Q "SELECT 1" || exit 1interval:10stimeout:3sretries:10start_period:10snetworks:      -graphqlstorewebapi:container_name:webapiimage:antoniofalcaojr/dotnet6-graphql4-webapienvironment:      -ASPNETCORE_URLS=http://*:5000ports:      -5000:5000depends_on:mssql:condition:service_healthynetworks:      -graphqlstorewebmvc:container_name:webmvcimage:antoniofalcaojr/dotnet6-graphql4-webmvcenvironment:      -ASPNETCORE_URLS=http://*:7000ports:      -7000:7000depends_on:      -webapinetworks:      -graphqlstorehealthchecks:container_name:healthchecks-uiimage:xabarilcoding/healthchecksuidepends_on:mssql:condition:service_healthyenvironment:      -storage_provider=SqlServer      -storage_connection=Server=mssql;Database=Store;User=sa;Password=!MyComplexPassword      -Logging:LogLevel:Default=Debug      -Logging:Loglevel:Microsoft=Warning      -Logging:LogLevel:HealthChecks=Debug      -HealthChecksUI:HealthChecks:0:Name=webapi      -HealthChecksUI:HealthChecks:0:Uri=http://webapi:5000/healthz      -HealthChecksUI:HealthChecks:1:Name=webmvc      -HealthChecksUI:HealthChecks:1:Uri=http://webmvc:7000/healthzports:      -8000:80networks:      -graphqlstorenetworks:graphqlstore:driver:bridge

GraphQL Playground

app.UseGraphQLPlayground(options:new(){BetaUpdates=true,RequestCredentials=RequestCredentials.Omit,HideTracingResponse=false,EditorCursorShape=EditorCursorShape.Line,EditorTheme=EditorTheme.Dark,EditorFontSize=14,EditorReuseHeaders=true,EditorFontFamily="JetBrains Mono"},path:"/ui/playground");

Health checks

{"status":"Healthy","totalDuration":"00:00:00.2344435","entries": {"Sql Server (Ready)": {"data": {},"duration":"00:00:00.2251420","status":"Healthy","tags": ["ready"      ]    }  }}

Dump configuration

publicvoidConfigure(IApplicationBuilderapp){app.UseEndpoints(endpoints=>{endpoints.MapDumpConfig(pattern:"/dump-config",configurationRoot:_configurationasIConfigurationRoot,isProduction:_env.IsProduction());});}

Highlights

UnitOfWork + Execution Strategy + Transaction Scope

publicTask<Review>AddReviewAsync(ReviewModelreviewModel,CancellationTokencancellationToken){returnUnitOfWork.ExecuteInTransactionScopeAsync(operationAsync:async ct=>{varproduct=awaitRepository.GetByIdAsync(id:reviewModel.ProductId,include: products=>products.Include(x=>x.Reviews),asTracking:true,cancellationToken:ct);varreview=Mapper.Map<Review>(reviewModel);product?.AddReview(review);awaitOnEditAsync(product,ct);returnreview;},condition: _=>NotificationContext.AllValidAsync,cancellationToken:cancellationToken);}

Notifications (pattern/context)

protectedboolOnValidate<TEntity>(TEntityentity,AbstractValidator<TEntity>validator){ValidationResult=validator.Validate(entity);returnIsValid;}protectedvoidAddError(stringerrorMessage,ValidationResultvalidationResult=default){ValidationResult.Errors.Add(newValidationFailure(default,errorMessage));validationResult?.Errors.ToList().ForEach(failure=>ValidationResult.Errors.Add(failure));}

publicoverrideasyncTask<ExecutionResult>ExecuteAsync(stringoperationName,stringquery,Inputsvariables,IDictionary<string,object>context,IServiceProviderrequestServices,CancellationTokencancellationToken=newCancellationToken()){varresult=awaitbase.ExecuteAsync(operationName,query,variables,context,requestServices,cancellationToken);varnotification=requestServices.GetRequiredService<INotificationContext>();if(notification.HasNotificationsisfalse)returnresult;result.Errors=notification.ExecutionErrors;result.Data=default;returnresult;}

ResolvingScoped dependencies withSingleton Schema.

varoptions=base.GetOptions(operationName,query,variables,context,cancellationToken);options.RequestServices=_serviceProvider;

Abstractions

publicabstractclassEntity<TId>whereTId:struct

publicabstractclassBuilder<TBuilder,TEntity,TId>:IBuilder<TEntity,TId>whereTBuilder:Builder<TBuilder,TEntity,TId>whereTEntity:Entity<TId>whereTId:struct

publicabstractclassRepository<TEntity,TId>:IRepository<TEntity,TId>whereTEntity:Entity<TId>whereTId:struct{privatereadonlyDbSet<TEntity>_dbSet;protectedRepository(DbContextdbDbContext){_dbSet=dbDbContext.Set<TEntity>();}

publicabstractclassService<TEntity,TModel,TId>:IService<TEntity,TModel,TId>whereTEntity:Entity<TId>whereTModel:Model<TId>whereTId:struct{protectedreadonlyIMapperMapper;protectedreadonlyINotificationContextNotificationContext;protectedreadonlyIRepository<TEntity,TId>Repository;protectedreadonlyIUnitOfWorkUnitOfWork;protectedService(IUnitOfWorkunitOfWork,IRepository<TEntity,TId>repository,IMappermapper,INotificationContextnotificationContext){UnitOfWork=unitOfWork;Repository=repository;Mapper=mapper;NotificationContext=notificationContext;}

publicabstractclassMessageService<TMessage,TModel,TId>:IMessageService<TMessage,TModel,TId>whereTMessage:classwhereTModel:Model<TId>whereTId:struct{privatereadonlyIMapper_mapper;privatereadonlyISubject<TMessage>_subject;protectedMessageService(IMappermapper,ISubject<TMessage>subject){_mapper=mapper;_subject=subject;}

FromEF TPH toGraphQL Interface

publicclassProductConfig:IEntityTypeConfiguration<Product>{publicvoidConfigure(EntityTypeBuilder<Product>builder){builder.HasDiscriminator().HasValue<Boot>(nameof(Boot)).HasValue<Kayak>(nameof(Kayak)).HasValue<Backpack>(nameof(Backpack));}}

publicclassKayakConfig:IEntityTypeConfiguration<Kayak>{publicvoidConfigure(EntityTypeBuilder<Kayak>builder){builder.HasBaseType<Product>();}}

publicsealedclassProductInterfaceGraphType:InterfaceGraphType<Product>{publicProductInterfaceGraphType(BootGraphTypebootGraphType,BackpackGraphTypebackpackGraphType,KayakGraphTypekayakGraphType){Name="product";ResolveType= @object=>{return@objectswitch{Boot _=>bootGraphType,Backpack _=>backpackGraphType,Kayak _=>kayakGraphType,                _=>default};};}}

publicsealedclassKayakGraphType:ObjectGraphType<Kayak>{publicKayakGraphType(){Name="kayak";Interface<ProductInterfaceGraphType>();IsTypeOf= o=>oisProduct;}}

Queries

Fragment for comparison and Arguments

{  First: product(id: "2c05b59b-8fb3-4cba-8698-01d55a0284e5") {    ...comparisonFields  }  Second: product(id: "65af82e8-27f6-44f3-af4a-029b73f14530") {    ...comparisonFields  }}fragment comparisonFields on product {  id  name  rating  description}

{"data":{"First":{"id":"2c05b59b-8fb3-4cba-8698-01d55a0284e5","name":"libero","rating":5,"description":"Deleniti voluptas quidem accusamus est debitis quisquam enim."},"Second":{"id":"65af82e8-27f6-44f3-af4a-029b73f14530","name":"debitis","rating":10,"description":"Est veniam unde."}}}

Query named's and Variables

query all {  products {    items {      id      name    }  }}query byid($productId: Guid!) {  product(id: $productId) {    id    name  }}

{"productId":"2c05b59b-8fb3-4cba-8698-01d55a0284e5"}

{    "operationName": "byid",    "variables": {        "productId": "2c05b59b-8fb3-4cba-8698-01d55a0284e5"    },    "query": "query all {        products {          items {                      id            name         }       }    }    query byid($productId: Guid!) {        product(id: $productId) {          id          name        }    }"}

Variables with include, skip and default value

query all($showPrice: Boolean = false) {  products {    items {      id      name      price@include(if: $showPrice)      rating@skip(if: $showPrice)    }  }}

{"showPrice":true}

{    "operationName": "all",    "variables": {        "showPrice": false    },    "query": "query all($showPrice: Boolean = false) {          products {            items {              id              name              price@include(if: $showPrice)              rating@skip(if: $showPrice)            }        }    }"}

Pagination

{  products(pageParams: { index: 2, size: 1 }) {    items {      id    }    pageInfo {      current      hasNext      hasPrevious      size    }  }}

{"data":{"products":{"items":[{"id":"3b2f6ce4-1b1d-4376-80a6-0b8d51932757"}],"pageInfo":{"current":2,"hasNext":true,"hasPrevious":true,"size":1}}}}

Mutations

mutation($review: reviewInput!) {  createReview(review: $review) {    id  }}

{"review":{"title":"some title","comment":"some comment","productId":"0fb8ec7e-7af1-4fe3-a2e2-000996ffd20f"}}

{"data":{"createReview":{"title":"some title"}}}

Subscriptions

subscription {  reviewAdded {    title  }}

{"data":{"reviewAdded":{"title":"Some title"}}}

Built With

Microsoft Stack - v6 - preview 2

GraphQL Stack - v4

Community Stack

Contributing

Versioning

Authors

License