Package com.generated.graphql.util

Class SubscriptionTypeExecutor

java.lang.Object
com.generated.graphql.util.SubscriptionTypeExecutor
All Implemented Interfaces:
GraphQLSubscriptionExecutor
@Component public class SubscriptionTypeExecutor extends Object implements GraphQLSubscriptionExecutor
This class contains the methods that allows the execution of the subscriptions that are defined in the SubscriptionType of the GraphQL schema.
These methods allows:
  • Preparation of partial subscription requests
  • Execution of partial prepared subscription requests
  • Execution of partial direct subscription requests
You'll find all the documentation on the client page doc.
Author:
generated by graphql-java-generator

  • Constructor Details

    • SubscriptionTypeExecutor

      public SubscriptionTypeExecutor()

  • Method Details

    • execWithBindValues

      public SubscriptionClient execWithBindValues(String queryResponseDef, SubscriptionCallback<?> subscriptionCallback, Map<String,Object> parameters) throws GraphQLRequestExecutionException, GraphQLRequestPreparationException
      This method takes a full request definition, and executes it against the GraphQL server. As this class is a subscription executor, the provided request must be a subscription full request. It may only return one subscription's field.
      It offers a logging of the call (if in debug mode), or of the call and its parameters (if in trace mode).
      Here is a sample on how to use it: 
      

      

      Parameters:
      

      queryResponseDef - The response definition of the subscription, in the native GraphQL format (see here above). It's a full
            request, as you would write it in graphiql. Is must include the subscription keyword.
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the class of the 
            subscription, that is the GraphQL type of the subscription's field that is subscribed.
      

      parameters - The map of values, for the bind variables defined in the query. If there is no bind variable in the
            defined Query, this argument may be null or an empty Map. The key is the parameter name, as
            defined in the query (in the above sample: heroParam is an optional parameter and skip is a mandatory
            one). The value is the parameter vale in its Java type (for instance a Date for the
            GraphQLScalarTypeDate). The parameters which value is missing in this map will no be
            transmitted toward the GraphQL server.
      

      Returns:
      

      The SubscriptionClient that allows the caller to act on the subscribed subscription.
      

      Throws:
      

      GraphQLRequestPreparationException - When an error occurs during the request preparation, typically when building the
             ObjectResponse
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      exec
      

      public SubscriptionClient exec(String queryResponseDef,
 SubscriptionCallback<?> subscriptionCallback,
 Object... paramsAndValues)
                        throws GraphQLRequestExecutionException,
GraphQLRequestPreparationException
      

      This method takes a full request definition, and executes it against the GraphQL server. As this class is 
 a subscription executor, the provided request must be a subscription full request. It may only return one 
 subscription's field.
      
 It offers a logging of the call (if in debug mode), or of the call and its parameters (if in trace mode).
      
 Here is a sample on how to use it:
 
 
      

      

      Parameters:
      

      queryResponseDef - The response definition of the subscription, in the native GraphQL format (see here above). It's a full
            request, as you would write it in graphiql. Is must include the subscription keyword.
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the class of the 
            subscription, that is the GraphQL type of the subscription's field that is subscribed.
      

      paramsAndValues - This parameter contains all the name and values for the Bind Variables defined in the objectResponse
            parameter, that must be sent to the server. Optional parameter may not have a value. They will be
            ignored and not sent to the server. Mandatory parameter must be provided in this argument.
      
            This parameter contains an even number of parameters: it must be a series of name and values :
            (paramName1, paramValue1, paramName2, paramValue2...)
      

      Returns:
      

      The SubscriptionClient that allows the caller to act on the subscribed subscription.
      

      Throws:
      

      GraphQLRequestPreparationException - When an error occurs during the request preparation, typically when building the
             ObjectResponse
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      execWithBindValues
      

      public SubscriptionClient execWithBindValues(ObjectResponse objectResponse,
 SubscriptionCallback<?> subscriptionCallback,
 Map<String,Object> parameters)
                                      throws GraphQLRequestExecutionException
      

      This method takes a full request definition, and executes it against the GraphQL server. As this class is 
 a subscription executor, the provided request must be a subscription full request. It may only return one 
 subscription's field.
      
 It offers a logging of the call (if in debug mode), or of the call and its parameters (if in trace mode).
      
 Here is a sample on how to use it:
 
 
      

      

      Parameters:
      

      objectResponse - The definition of the response format, that describes what the GraphQL server is expected to return
      
            Note: the ObjectResponse type of this parameter is defined for backward compatibility. In new implementations,
            the expected type is the generated GraphQLRequest POJO, as returned by the
            getGraphQLRequest(java.lang.String) method or one of the getXxxxGraphQLRequest(String) methods.
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the class of the 
            subscription, that is the GraphQL type of the subscription's field that is subscribed.
      

      parameters - The map of values, for the bind variables defined in the query. If there is no bind variable in the
            defined Query, this argument may be null or an empty Map
      

      Returns:
      

      The SubscriptionClient that allows the caller to act on the subscribed subscription.
      

      Throws:
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      exec
      

      public SubscriptionClient exec(ObjectResponse objectResponse,
 SubscriptionCallback<?> subscriptionCallback,
 Object... paramsAndValues)
                        throws GraphQLRequestExecutionException
      

      This method takes a full request definition, and executes it against the GraphQL server. As this class is 
 a subscription executor, the provided request must be a subscription full request. It may only return one 
 subscription's field.
      
 You must also provide a callback instance of the SubscriptionCallback, that will be called each time a message
 or an error is sent by this subscribed subscription.
      
 It offers a logging of the call (if in debug mode), or of the call and its parameters (if in trace mode).
      
 Here is a sample on how to use it:
 
 
      

      

      Parameters:
      

      objectResponse - The definition of the response format, that describes what the GraphQL server is expected to return
      
            Note: the ObjectResponse type of this parameter is defined for backward compatibility. In new implementations,
            the expected type is the generated GraphQLRequest POJO, as returned by the
            getGraphQLRequest(java.lang.String) method or one of the getXxxxGraphQLRequest(String) methods.
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the class of the 
            subscription, that is the GraphQL type of the subscription's field that is subscribed.
      

      paramsAndValues - This parameter contains all the name and values for the Bind Variables defined in the objectResponse
            parameter, that must be sent to the server. Optional parameter may not have a value. They will be
            ignored and not sent to the server. Mandatory parameter must be provided in this argument.
      
            This parameter contains an even number of parameters: it must be a series of name and values :
            (paramName1, paramValue1, paramName2, paramValue2...)
      

      Returns:
      

      The SubscriptionClient that allows the caller to act on the subscribed subscription.
      

      Throws:
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      getResponseBuilder
      

      public Builder getResponseBuilder()
                           throws GraphQLRequestPreparationException
      

      Get the Builder for a full request, as expected by the exec 
 and execWithBindValues methods.
      

      

      Returns:
      

      Throws:
      

      GraphQLRequestPreparationException
      

      

      

      • 

    • 

      

      getGraphQLRequest
      

      public GraphQLRequest getGraphQLRequest(String fullRequest)
                                 throws GraphQLRequestPreparationException
      

      Get the GraphQLRequest, to obtain a prepared full request. For instance:
 
       GraphQLRequest request = new GraphQLRequest(fullRequest);
 
      

      

      Parameters:
      

      fullRequest - The full GraphQL request, as specified in the GraphQL specification
      

      Returns:
      

      Throws:
      

      GraphQLRequestPreparationException
      

      

      

      • 

    • 

      

      newCharacterWithBindValues
      

      public SubscriptionClient newCharacterWithBindValues(String queryResponseDef,
 SubscriptionCallback<Character> subscriptionCallback,
 Map<String,Object> parameters)
                                              throws GraphQLRequestExecutionException,
GraphQLRequestPreparationException
      

      This method registers a subscription, by executing a direct partial newCharacter subscription against the GraphQL server. 
 This subscription is one of the fields defined in the GraphQL subscription object. The queryResponseDef contains the
 part of the subscription that is after the subscription name (see the sample below), for instance
 "{id name}" if you want these two fields to be sent in the notifications you'll receive for this
 subscription.
      
 You must also provide a callback instance that will be called each time a message
 or an error is sent by this subscribed subscription. As the plugin limits the actual subscriptions at one par call (one
 field from the SubscriptionType GraphQL type), it allows the deserialization of this exact field. So the callback is expected 
 to be an instance of SubscriptionCallback, as the SubscriptionType.newCharacter 
 is of type Character. 
 Here is a sample on how to use it:
 
 
      

      

      Parameters:
      

      queryResponseDef - The response definition of the subscription, in the native GraphQL format (see here above)
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the newCharacter
            subscription field.
      

      parameters - The list of values, for the bind variables defined in the subscription. If there is no bind variable in the
            defined subscription, this argument may be null or an empty Map
      

      Throws:
      

      GraphQLRequestPreparationException - When an error occurs during the request preparation, typically when building the
             ObjectResponse
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      newCharacter
      

      public SubscriptionClient newCharacter(String queryResponseDef,
 SubscriptionCallback<Character> subscriptionCallback,
 Object... paramsAndValues)
                                throws GraphQLRequestExecutionException,
GraphQLRequestPreparationException
      

      This method registers a subscription, by executing a direct partial newCharacter subscription against the GraphQL server. 
 This subscription is one of the fields defined in the GraphQL subscription object. The queryResponseDef contains the
 part of the subscription that is after the subscription name (see the sample below), for instance
 "{id name}" if you want these two fields to be sent in the notifications you'll receive for this
 subscription.
      
 You must also provide a callback instance that will be called each time a message
 or an error is sent by this subscribed subscription. As the plugin limits the actual subscriptions at one par call (one
 field from the SubscriptionType GraphQL type), it allows the deserialization of this exact field. So the callback is expected 
 to be an instance of SubscriptionCallback, as the SubscriptionType.newCharacter 
 is of type Character. 
 Here is a sample on how to use it:
 
 
      

      

      Parameters:
      

      queryResponseDef - The response definition of the subscription, in the native GraphQL format (see here above)
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the newCharacter
            subscription field.
      

      parameters - The list of values, for the bind variables defined in the subscription. If there is no bind variable in the
            defined subscription, this argument may be null or an empty Map
      

      Throws:
      

      GraphQLRequestPreparationException - When an error occurs during the request preparation, typically when building the
             ObjectResponse
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      newCharacterWithBindValues
      

      public SubscriptionClient newCharacterWithBindValues(ObjectResponse objectResponse,
 SubscriptionCallback<Character> subscriptionCallback,
 Map<String,Object> parameters)
                                              throws GraphQLRequestExecutionException
      

      This method registers a subscription, by executing a direct partial newCharacter subscription against the GraphQL server. 
 This subscription is one of the fields defined in the GraphQL subscription object. The queryResponseDef contains the
 part of the subscription that is after the subscription name (see the sample below), for instance
 "{id name}" if you want these two fields to be sent in the notifications you'll receive for this
 subscription.
      
 You must also provide a callback instance that will be called each time a message
 or an error is sent by this subscribed subscription. As the plugin limits the actual subscriptions at one par call (one
 field from the SubscriptionType GraphQL type), it allows the deserialization of this exact field. So the callback is expected 
 to be an instance of SubscriptionCallback, as the SubscriptionType.newCharacter 
 is of type Character. 
 Here is a sample on how to use it:
 
 
      

      

      Parameters:
      

      objectResponse - The definition of the response format, that describes what the GraphQL server is expected to return
      
            Note: the ObjectResponse type of this parameter is defined for backward compatibility. In new implementations,
            the expected type is the generated GraphQLRequest POJO, as returned by the
            getNewCharacterGraphQLRequest(java.lang.String) method.
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the newCharacter
            subscription field.
      

      parameters - The list of values, for the bind variables defined in the subscription. If there is no bind variable in the
            defined Query, this argument may be null or an empty Map
      

      Throws:
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      newCharacter
      

      public SubscriptionClient newCharacter(ObjectResponse objectResponse,
 SubscriptionCallback<Character> subscriptionCallback,
 Object... paramsAndValues)
                                throws GraphQLRequestExecutionException
      

      This method registers a subscription, by executing a direct partial newCharacter subscription against the GraphQL server. 
 This subscription is one of the fields defined in the GraphQL subscription object. The queryResponseDef contains the
 part of the subscription that is after the subscription name (see the sample below), for instance
 "{id name}" if you want these two fields to be sent in the notifications you'll receive for this
 subscription.
      
 You must also provide a callback instance that will be called each time a message
 or an error is sent by this subscribed subscription. As the plugin limits the actual subscriptions at one par call (one
 field from the SubscriptionType GraphQL type), it allows the deserialization of this exact field. So the callback is expected 
 to be an instance of SubscriptionCallback, as the SubscriptionType.newCharacter 
 is of type Character. 
 Here is a sample on how to use it:
 
 
      

      

      Parameters:
      

      objectResponse - The definition of the response format, that describes what the GraphQL server is expected to return
      
            Note: the ObjectResponse type of this parameter is defined for backward compatibility. In new implementations,
            the expected type is the generated GraphQLRequest POJO, as returned by the
            getNewCharacterGraphQLRequest(java.lang.String) method.
      

      subscriptionCallback - The instance that will be called for each notification (message or error) received for this subscription.
      
            It's an instance of SubscriptionCallback<clazz>, where clazz is the newCharacter
            subscription field.
      

      paramsAndValues - This parameter contains all the name and values for the Bind Variables defined in the objectResponse
            parameter, that must be sent to the server. Optional parameter may not have a value. They will be
            ignored and not sent to the server. Mandatory parameter must be provided in this argument.
      
            This parameter contains an even number of parameters. It must be a series of name and values, like :
            paramName1, paramValue1, paramName2, paramValue2...
      

      Throws:
      

      GraphQLRequestExecutionException - When an error occurs during the request execution, typically a network error, an error from the
             GraphQL server or if the server response can't be parsed
      

      

      

      • 

    • 

      

      getNewCharacterResponseBuilder
      

      public Builder getNewCharacterResponseBuilder()
                                       throws GraphQLRequestPreparationException
      

      Get the Builder for the Character, 
 as expected by the newCharacter subscription.
      

      

      Returns:
      

      Throws:
      

      GraphQLRequestPreparationException
      

      

      

      • 

    • 

      

      getNewCharacterGraphQLRequest
      

      public GraphQLRequest getNewCharacterGraphQLRequest(String partialRequest)
                                             throws GraphQLRequestPreparationException
      

      Get the GraphQLRequest for the newCharacter EXECUTOR, created with the given Partial request.
      

      

      Parameters:
      

      partialRequest - The Partial GraphQL request, as explained in the 
                                plugin client documentation
      

      Returns:
      

      Throws:
      

      GraphQLRequestPreparationException
      

      

      

      • 

    

    

    •