/// <summary>
/// Creates a subscription to a GraphQL server. The connection is not established until the first actual subscription is made.<br/>
/// All subscriptions made to this stream share the same hot observable.<br/>
/// All <see cref="WebSocketException"/>s are passed to the <paramref name="webSocketExceptionHandler"/> to be handled externally.<br/>
/// If the <paramref name="webSocketExceptionHandler"/> completes normally, the subscription is recreated with a new connection attempt.<br/>
/// Other <see cref="Exception"/>s or any exception thrown by <paramref name="webSocketExceptionHandler"/> will cause the sequence to fail.
/// </summary>
/// <param name="client">the GraphQL client</param>
/// <param name="request">the GraphQL request for this subscription</param>
/// <param name="webSocketExceptionHandler">an external handler for all <see cref="WebSocketException"/>s occurring within the sequence</param>
/// <returns>an observable stream for the specified subscription</returns>
public static IObservable <GraphQLResponse <TResponse> > CreateSubscriptionStream <TResponse>(this IGraphQLClient client,
GraphQLRequest request, Action <WebSocketException> webSocketExceptionHandler) =>
client.CreateSubscriptionStream <TResponse>(request, e =>
{
if (e is WebSocketException webSocketException)
{
webSocketExceptionHandler(webSocketException);
}
else
{
throw e;
}
});
public void SubscribeToUpdates()
{
var query = new GraphQLRequest
{
Query = @"subscription { reviewAdded { title productId } }"
};
IObservable <GraphQLResponse <ProductReviewModel> > response =
_graphQLClient.CreateSubscriptionStream <ProductReviewModel>(query);
var subscription = response.Subscribe(response =>
{
Console.WriteLine(response.Data);
});
subscription.Dispose();
}
/// <inheritdoc cref="GraphQLHttpClient.CreateSubscriptionStream{TResponse}(GraphQLRequest)"/>
public static IObservable <GraphQLResponse <TResponse> > CreateSubscriptionStream <TResponse>(
this IGraphQLClient client, GraphQLRequest request, Func <TResponse> defineResponseType)
{
_ = defineResponseType;
return(client.CreateSubscriptionStream <TResponse>(request));
}
/// <inheritdoc cref="CreateSubscriptionStream{TResponse}(IGraphQLClient,GraphQLRequest,Action{WebSocketException})"/>
public static IObservable <GraphQLResponse <TResponse> > CreateSubscriptionStream <TResponse>(
this IGraphQLClient client, GraphQLRequest request, Func <TResponse> defineResponseType, Action <WebSocketException> webSocketExceptionHandler)
{
_ = defineResponseType;
return(client.CreateSubscriptionStream <TResponse>(request, webSocketExceptionHandler));
}
public static IObservable <GraphQLResponse <TResponse> > CreateSubscriptionStream <TResponse>(
this IGraphQLClient client, GraphQLRequest request, Func <TResponse> defineResponseType, Action <Exception> exceptionHandler)
=> client.CreateSubscriptionStream <TResponse>(request, exceptionHandler);