Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

GraphQL Server With .NET Framework (Not .NET Core)

DZone's Guide to

GraphQL Server With .NET Framework (Not .NET Core)

Wondering whether you can set up a GraphQL server implementation using the regular ole .NET Framework? Then read on.

· Integration Zone ·
Free Resource

How to Transform Your Business in the Digital Age: Learn how organizations are re-architecting their integration strategy with data-driven app integration for true digital transformation.

In a recent post, we had listed out analyses done and conclusions made when asked by a customer to convert their existing API to GraphQL. While exploring GraphQL with .NET framework, we realized there is a large gap in examples and demos on using GraphQL with full scale .NET framework and EntityFramework. We took some time out to create a sample repo and put it out there so that other programmers don’t have to wonder whether its even possible.

The repo is available at https://github.com/anshulee/GraphQLHobbyAPI

Why Another GraphQL Repo?

Most GraphQL solutions showing usage of GraphQL on the client side. The ones on the server side are either using APOLLO servers with javascript frameworks or .NET Core. The project we wanted to use GraphQL in was using standard .NET framework with ADO.NET .

We used various samples and demos to build out a simple demo app showcasing the use of GraphQL and graphiql with .NET framework. In some senses this is the simplest and most vanilla GraphQL server demo you will see which is what we were looking for.

Technology Stack

  • GraphQL server with full .NET 4.5 framework
  • Code First Entity Framework 6.0
  • Graphiql

Development Platform

  • Windows Machine
  • Visual Studio
  • Visual Studio Code

This Example Showcases

  1. Parameterized Queries
  2. Nested Queries
  3. Parameterized Mutations
  4. Does NOT use Dependency Injection

References

Functioning

The API exposes a simple Person-Hobby system with the following relationship

clip_image002

The Schema allows for the following operations:

  1. Query Person by ID (allows nested queries to get person’s hobbies)

queryPerson

  1. Query Hobby by ID (Including GET count of people interested in that hobby)

queryHobby

  1. Create new Hobby (Mutation)

createHobby

Using Graphiql

The nuget at https://www.nuget.org/packages/graphiql/ is made for .NET Core and does not work with the standard .NET framework. We tried using the Graphiql repo at https://github.com/graphql/graphiql directly but it had some issues building on a windows machine.(https://github.com/graphql/graphiql/issues/318) . We finally used the fork at https://github.com/mattferrin/graphiql to get this working on a Windows Machine.

Steps were as under

  1. Clone repo from https://github.com/mattferrin/graphiql
  2. Install Yarn from https://yarnpkg.com/en/docs/install#windows-stable
  3. Open Command Prompt and Navigate to main project
  4. Use “Yarn Install” to install all dependencies
  5. “npm run build” on the parent directory
  6. Navigate to Example directory
  7. npm install”
  8. Update function graphQLFetcher in example/index.html to hit the HobbyAPIServer

clip_image010

9. “npm start”

10. Navigate to localhost:8080

What is shown here is simply how to connect the various pieces. However if someone needs specific steps, please ping us at anshulee@cennest.com and we will write up a tutorial

Happy coding!

Make your mark on the industry’s leading annual report. Fill out the State of API Integration 2019 Survey and receive $25 to the Cloud Elements store.

Topics:
graphql ,.net ,.net framework ,server ,repo ,integration

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}