io.stargate.graphql.schema.graphqlfirst.fetchers.deployed

Class MutationFetcher<MutationModelT extends MutationModel,ResultT>

java.lang.Object

io.stargate.graphql.schema.CassandraFetcher<ResultT>

io.stargate.graphql.schema.graphqlfirst.fetchers.deployed.MutationFetcher<MutationModelT,ResultT>

All Implemented Interfaces:

graphql.schema.DataFetcher<CompletionStage<ResultT>>

Direct Known Subclasses:

DeleteFetcher, InsertFetcher, UpdateFetcher

public abstract class MutationFetcher<MutationModelT extends MutationModel,ResultT>
extends CassandraFetcher<ResultT>

An INSERT, UPDATE or DELETE mutation.

Field Summary

Fields

Modifier and Type	Field and Description
protected MappingModel	mappingModel
protected MutationModelT	model

Fields inherited from class io.stargate.graphql.schema.CassandraFetcher

DEFAULT_CONSISTENCY, DEFAULT_PAGE_SIZE, DEFAULT_PARAMETERS, DEFAULT_SERIAL_CONSISTENCY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MutationFetcher(MutationModelT model, MappingModel mappingModel)

Method Summary

Modifier and Type	Method and Description
protected List<BuiltCondition>	bindIf(List<ConditionModel> conditions, Predicate<String> hasArgument, Function<String,Object> getArgument, Keyspace keyspace)
protected List<BuiltCondition>	bindWhere(List<ConditionModel> conditions, Predicate<String> hasArgument, Function<String,Object> getArgument, Function<List<ConditionModel>,Optional<String>> validator, Keyspace keyspace) Given the WHERE conditions that were inferred from an operation signature, find out which arguments are actually present in an runtime invocation, and bind the corresponding conditions.
protected Parameters	buildParameters()
protected void	copyRowToEntity(Row row, Map<String,Object> entityData, EntityModel entity) Copies a CQL row to a map representing the given entity.
protected ResultSet	executeUnchecked(AbstractBound<?> query, Parameters parameters, StargateGraphqlContext context)
protected CompletableFuture<ResultT>	get(graphql.schema.DataFetchingEnvironment environment, StargateGraphqlContext context)
protected graphql.language.SourceLocation	getCurrentFieldLocation(graphql.schema.DataFetchingEnvironment environment)
protected Function<List<io.stargate.graphql.schema.graphqlfirst.fetchers.deployed.MutationResult>,graphql.execution.DataFetcherResult<Object>>	getDeleteOrUpdateResultBuilder(graphql.schema.DataFetchingEnvironment environment)
protected abstract io.stargate.graphql.schema.graphqlfirst.fetchers.deployed.MutationPayload<ResultT>	getPayload(graphql.schema.DataFetchingEnvironment environment, StargateGraphqlContext context)
protected ResultSet	query(EntityModel entity, List<BuiltCondition> whereConditions, Optional<Integer> limit, Parameters parameters, StargateGraphqlContext context) Queries one or more instances of an entity for the given conditions.
protected Object	toCqlValue(Object graphqlValue, Column.ColumnType cqlType, Keyspace keyspace)
protected List<Map<String,Object>>	toEntities(ResultSet resultSet, EntityModel entity)
protected graphql.ExceptionWhileDataFetching	toGraphqlError(MutationResult.Failure failure, graphql.language.SourceLocation location, graphql.schema.DataFetchingEnvironment environment)
protected graphql.ExceptionWhileDataFetching	toGraphqlError(Throwable error, graphql.language.SourceLocation location, graphql.schema.DataFetchingEnvironment environment)
protected Object	toGraphqlValue(Object cqlValue, Column.ColumnType cqlType, graphql.language.Type<?> graphqlType)
protected Map<String,Object>	toSingleEntity(ResultSet resultSet, EntityModel entity)

Methods inherited from class io.stargate.graphql.schema.CassandraFetcher

get, isAppliedBatch

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

model

protected final MutationModelT extends MutationModel model

mappingModel

protected final MappingModel mappingModel

Constructor Detail

MutationFetcher

protected MutationFetcher(MutationModelT model,
                          MappingModel mappingModel)

Method Detail

getPayload

protected abstract io.stargate.graphql.schema.graphqlfirst.fetchers.deployed.MutationPayload<ResultT> getPayload(graphql.schema.DataFetchingEnvironment environment,
                                                                                                                 StargateGraphqlContext context)
                                                                                                          throws UnauthorizedException

Throws:

UnauthorizedException

get

protected CompletableFuture<ResultT> get(graphql.schema.DataFetchingEnvironment environment,
                                         StargateGraphqlContext context)

Specified by:

get in class CassandraFetcher<CompletionStage<ResultT>>

buildParameters

protected Parameters buildParameters()

toGraphqlError

protected graphql.ExceptionWhileDataFetching toGraphqlError(MutationResult.Failure failure,
                                                            graphql.language.SourceLocation location,
                                                            graphql.schema.DataFetchingEnvironment environment)

toGraphqlError

protected graphql.ExceptionWhileDataFetching toGraphqlError(Throwable error,
                                                            graphql.language.SourceLocation location,
                                                            graphql.schema.DataFetchingEnvironment environment)

getCurrentFieldLocation

protected graphql.language.SourceLocation getCurrentFieldLocation(graphql.schema.DataFetchingEnvironment environment)

getDeleteOrUpdateResultBuilder

protected Function<List<io.stargate.graphql.schema.graphqlfirst.fetchers.deployed.MutationResult>,graphql.execution.DataFetcherResult<Object>> getDeleteOrUpdateResultBuilder(graphql.schema.DataFetchingEnvironment environment)

toCqlValue

protected Object toCqlValue(Object graphqlValue,
                            Column.ColumnType cqlType,
                            Keyspace keyspace)

toGraphqlValue

protected Object toGraphqlValue(Object cqlValue,
                                Column.ColumnType cqlType,
                                graphql.language.Type<?> graphqlType)

query

protected ResultSet query(EntityModel entity,
                          List<BuiltCondition> whereConditions,
                          Optional<Integer> limit,
                          Parameters parameters,
                          StargateGraphqlContext context)
                   throws UnauthorizedException

Queries one or more instances of an entity for the given conditions.

Throws:

UnauthorizedException

toSingleEntity

protected Map<String,Object> toSingleEntity(ResultSet resultSet,
                                            EntityModel entity)

toEntities

protected List<Map<String,Object>> toEntities(ResultSet resultSet,
                                              EntityModel entity)

copyRowToEntity

protected void copyRowToEntity(Row row,
                               Map<String,Object> entityData,
                               EntityModel entity)

Copies a CQL row to a map representing the given entity. Only the columns that correspond to the entity's fields are considered. If some fields were already present in the map, they are overridden.

executeUnchecked

protected ResultSet executeUnchecked(AbstractBound<?> query,
                                     Parameters parameters,
                                     StargateGraphqlContext context)

bindWhere

protected List<BuiltCondition> bindWhere(List<ConditionModel> conditions,
                                         Predicate<String> hasArgument,
                                         Function<String,Object> getArgument,
                                         Function<List<ConditionModel>,Optional<String>> validator,
                                         Keyspace keyspace)

Given the WHERE conditions that were inferred from an operation signature, find out which arguments are actually present in an runtime invocation, and bind the corresponding conditions.

Example:

 // Query definition
 type Query { readings(sensorId: ID!, hour: Int, minute: Int): [SensorReading] }

 // Inferred conditions:
 sensorId = ? AND hour = ? AND minute = ?

 // GraphQL call:
 { readings(sensorId: "xyz", hour: 12) { value } }

 // Actual conditions:
 sensorId = 'xyz' AND hour = 12
 

Parameters:

hasArgument - how to know if an argument is present (this is abstracted because in some cases the values are not directly arguments, but instead inner fields of an object argument).

getArgument - how to get the value of an argument (same).

validator - a validation function that will be applied to the actual conditions, to check that they form a valid where clause.

bindIf

protected List<BuiltCondition> bindIf(List<ConditionModel> conditions,
                                      Predicate<String> hasArgument,
                                      Function<String,Object> getArgument,
                                      Keyspace keyspace)