graphql-dotnet - GraphQL.Client 2.0.0-alpha.4
A GraphQL Client
PM> Install-Package GraphQL.Client -Version 2.0.0-alpha.4 -Source https://www.myget.org/F/graphql-dotnet/api/v3/index.json
> nuget.exe install GraphQL.Client -Version 2.0.0-alpha.4 -Source https://www.myget.org/F/graphql-dotnet/api/v3/index.json
> dotnet add package GraphQL.Client --version 2.0.0-alpha.4 --source https://www.myget.org/F/graphql-dotnet/api/v3/index.json
source https://www.myget.org/F/graphql-dotnet/api/v3/index.json
nuget GraphQL.Client ~> 2.0.0-alpha.4
Copy to clipboard
> choco install GraphQL.Client --version 2.0.0-alpha.4 --source https://www.myget.org/F/graphql-dotnet/api/v2
Import-Module PowerShellGet
Register-PSRepository -Name "graphql-dotnet" -SourceLocation "https://www.myget.org/F/graphql-dotnet/api/v2"
Install-Module -Name "GraphQL.Client" -RequiredVersion "2.0.0-alpha.4" -Repository "graphql-dotnet" -AllowPreRelease
Copy to clipboard
GraphQL.Client
A GraphQL Client for .NET Standard over HTTP.
Provides the following packages:
Specification
The Library will try to follow the following standards and documents:
Usage
Create a GraphQLHttpClient
// To use NewtonsoftJsonSerializer, add a reference to
// NuGet package GraphQL.Client.Serializer.Newtonsoft
var graphQLClient = new GraphQLHttpClient(
"https://api.example.com/graphql",
new NewtonsoftJsonSerializer());
[!NOTE] GraphQLHttpClient is meant to be used as a single long-lived instance per endpoint (i.e. register as singleton in a DI system), which should be reused for multiple requests.
Create a GraphQLRequest:
Simple Request:
var heroRequest = new GraphQLRequest {
Query = """
{
hero {
name
}
}
"""
};
OperationName and Variables Request:
var personAndFilmsRequest = new GraphQLRequest {
Query ="""
query PersonAndFilms($id: ID) {
person(id: $id) {
name
filmConnection {
films {
title
}
}
}
}
""",
OperationName = "PersonAndFilms",
Variables = new {
id = "cGVvcGxlOjE="
}
};
[!WARNING] Be careful when using
byte[]
in your variables object, as most JSON serializers will treat that as binary data.If you really need to send a list of bytes with a
byte[]
as a source, then convert it to aList<byte>
first, which will tell the serializer to output a list of numbers instead of a base64-encoded string.
Execute Query/Mutation
public class ResponseType
{
public PersonType Person { get; set; }
}
public class PersonType
{
public string Name { get; set; }
public FilmConnectionType FilmConnection { get; set; }
}
public class FilmConnectionType {
public List<FilmContentType> Films { get; set; }
}
public class FilmContentType {
public string Title { get; set; }
}
var graphQLResponse = await graphQLClient.SendQueryAsync<ResponseType>(personAndFilmsRequest);
var personName = graphQLResponse.Data.Person.Name;
Using the extension method for anonymously typed responses (namespace GraphQL.Client.Abstractions
) you could achieve the same result with the following code:
var graphQLResponse = await graphQLClient.SendQueryAsync(
personAndFilmsRequest,
() => new { person = new PersonType()});
var personName = graphQLResponse.Data.person.Name;
[!IMPORTANT] Note that the field in the GraphQL response which gets deserialized into the response object is the
data
field.A common mistake is to try to directly use the
PersonType
class as response type (because thats the thing you actually want to query), but the returned response object contains a propertyperson
containing aPersonType
object (like theResponseType
modelled above).
Use Subscriptions
public class UserJoinedSubscriptionResult {
public ChatUser UserJoined { get; set; }
public class ChatUser {
public string DisplayName { get; set; }
public string Id { get; set; }
}
}
Create subscription
var userJoinedRequest = new GraphQLRequest {
Query = @"
subscription {
userJoined{
displayName
id
}
}"
};
IObservable<GraphQLResponse<UserJoinedSubscriptionResult>> subscriptionStream
= client.CreateSubscriptionStream<UserJoinedSubscriptionResult>(userJoinedRequest);
var subscription = subscriptionStream.Subscribe(response =>
{
Console.WriteLine($"user '{response.Data.UserJoined.DisplayName}' joined")
});
End Subscription
subscription.Dispose();
Syntax Highlighting for GraphQL strings in IDEs
.NET 7.0 introduced the StringSyntaxAttribute to have a unified way of telling what data is expected in a given string
or ReadOnlySpan<char>
. IDEs like Visual Studio and Rider can then use this to provide syntax highlighting and checking.
From v6.0.4 on all GraphQL string parameters in this library are decorated with the [StringSyntax("GraphQL")]
attribute.
Currently, there is no native support for GraphQL formatting and syntax highlighting in Visual Studio, but the GraphQLTools Extension provides that for you.
For Rider, JetBrains provides a Plugin, too.
To leverage syntax highlighting in variable declarations, the GraphQLQuery
value record type is provided:
GraphQLQuery query = new("""
query PersonAndFilms($id: ID) {
person(id: $id) {
name
filmConnection {
films {
title
}
}
}
}
""");
var graphQLResponse = await graphQLClient.SendQueryAsync<ResponseType>(
query,
"PersonAndFilms",
new { id = "cGVvcGxlOjE=" });
Useful Links
Blazor WebAssembly Limitations
Blazor WebAssembly differs from other platforms as it does not support all features of other .NET runtime implementations. For instance, the following WebSocket options properties are not supported and will not be set:
- .NETStandard 2.0: 2.0.0.0
OwnersRaul Hidalgo graphql-dotnet-ci |
AuthorsDeinok, graphql-dotnet |
Project URLhttps://github.com/graphql-dotnet/graphql-client |
LicenseGPL-3.0 |
TagsGraphQL |
Info105 total downloads |
32 downloads for version 2.0.0-alpha.4 |
Download (14.39 KB) |
Found on the current feed only |
Package history
Version | Size | Last updated | Downloads | Mirrored? | |||
---|---|---|---|---|---|---|---|
2.0.0-alpha.4 | 14.39 KB | Thu, 23 May 2019 10:19:41 GMT | 32 | ||||
2.0.0-alpha.3 | 14.53 KB | Tue, 11 Dec 2018 22:47:43 GMT | 12 | ||||
2.0.0-alpha.2 | 27.13 KB | Tue, 06 Nov 2018 18:11:10 GMT | 10 | ||||
2.0.0-alpha.1 | 26.77 KB | Thu, 13 Sep 2018 09:51:04 GMT | 10 | ||||
1.0.3 | 26.88 KB | Mon, 07 May 2018 19:03:28 GMT | 15 | ||||
1.0.2 | 26.05 KB | Mon, 07 May 2018 08:53:50 GMT | 7 | ||||
1.0.1 | 26.26 KB | Mon, 12 Mar 2018 09:53:51 GMT | 5 | ||||
1.0.0 | 17.85 KB | Wed, 20 Dec 2017 21:22:46 GMT | 5 | ||||
1.0.0-beta3 | 17.35 KB | Sun, 17 Dec 2017 00:54:20 GMT | 5 | ||||
1.0.0-beta2 | 17.36 KB | Sun, 17 Dec 2017 00:52:11 GMT | 4 |