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

Class MutationFetcher<MutationModelT extends MutationModel,ResultT>

java.lang.Object

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

io.stargate.sgv2.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 io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe	keyspace
protected MappingModel	mappingModel
protected MutationModelT	model

Fields inherited from class io.stargate.sgv2.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, io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace)

Method Summary

Modifier and Type	Method and Description
protected List<BuiltCondition>	bindIf(List<ConditionModel> conditions, Predicate<String> hasArgument, Function<String,Object> getArgument, io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace)
protected List<BuiltCondition>	bindWhere(List<ConditionModel> conditions, Predicate<String> hasArgument, Function<String,Object> getArgument, Function<List<ConditionModel>,Optional<String>> validator, io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace) Given the WHERE conditions that were inferred from an operation signature, find out which arguments are actually present in a runtime invocation, and bind the corresponding conditions.
protected io.stargate.bridge.proto.QueryOuterClass.QueryParameters	buildParameters()
protected List<io.stargate.sgv2.graphql.schema.graphqlfirst.fetchers.deployed.TypedKeyValue>	computePrimaryKey(EntityModel entity, List<BuiltCondition> whereConditions) Given the where conditions generated for the current GraphQL query, try to identify the primary key targeted by the generated CQL query.
protected void	copyRowToEntity(io.stargate.bridge.proto.QueryOuterClass.Row row, List<io.stargate.bridge.proto.QueryOuterClass.ColumnSpec> columns, Map<String,Object> entityData, EntityModel entity) Copies a CQL row to a map representing the given entity.
protected CompletionStage<ResultT>	get(graphql.schema.DataFetchingEnvironment environment, StargateGraphqlContext context)
protected graphql.language.SourceLocation	getCurrentFieldLocation(graphql.schema.DataFetchingEnvironment environment)
protected Function<List<io.stargate.sgv2.graphql.schema.graphqlfirst.fetchers.deployed.MutationResult>,graphql.execution.DataFetcherResult<Object>>	getDeleteOrUpdateResultBuilder(graphql.schema.DataFetchingEnvironment environment)
protected abstract io.stargate.sgv2.graphql.schema.graphqlfirst.fetchers.deployed.MutationPayload<ResultT>	getPayload(graphql.schema.DataFetchingEnvironment environment, StargateGraphqlContext context)
protected io.stargate.bridge.proto.QueryOuterClass.ResultSet	query(EntityModel entity, List<BuiltCondition> whereConditions, Optional<Integer> limit, io.stargate.bridge.proto.QueryOuterClass.QueryParameters parameters, StargateGraphqlContext context) Queries one or more instances of an entity for the given conditions.
protected io.stargate.bridge.proto.QueryOuterClass.Value	toCqlValue(Object graphqlValue, io.stargate.bridge.proto.QueryOuterClass.TypeSpec cqlType, io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace)
protected List<Map<String,Object>>	toEntities(io.stargate.bridge.proto.QueryOuterClass.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(io.stargate.bridge.proto.QueryOuterClass.Value cqlValue, io.stargate.bridge.proto.QueryOuterClass.TypeSpec cqlType, graphql.language.Type<?> graphqlType)
protected Map<String,Object>	toSingleEntity(io.stargate.bridge.proto.QueryOuterClass.ResultSet resultSet, EntityModel entity)

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

get, isApplied, isApplied

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

keyspace

protected final io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace

Constructor Detail

MutationFetcher

protected MutationFetcher(MutationModelT model,
                          MappingModel mappingModel,
                          io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace)

Method Detail

getPayload

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

get

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

Specified by:

get in class CassandraFetcher<CompletionStage<ResultT>>

buildParameters

protected io.stargate.bridge.proto.QueryOuterClass.QueryParameters 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.sgv2.graphql.schema.graphqlfirst.fetchers.deployed.MutationResult>,graphql.execution.DataFetcherResult<Object>> getDeleteOrUpdateResultBuilder(graphql.schema.DataFetchingEnvironment environment)

computePrimaryKey

protected List<io.stargate.sgv2.graphql.schema.graphqlfirst.fetchers.deployed.TypedKeyValue> computePrimaryKey(EntityModel entity,
                                                                                                               List<BuiltCondition> whereConditions)

Given the where conditions generated for the current GraphQL query, try to identify the primary key targeted by the generated CQL query.

If the query targets multiple rows, we'll get a partial PK, but it doesn't matter because we won't end up using it (see explanations in MutationPayload.getPrimaryKeys()).

toCqlValue

protected io.stargate.bridge.proto.QueryOuterClass.Value toCqlValue(Object graphqlValue,
                                                                    io.stargate.bridge.proto.QueryOuterClass.TypeSpec cqlType,
                                                                    io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace)

toGraphqlValue

protected Object toGraphqlValue(io.stargate.bridge.proto.QueryOuterClass.Value cqlValue,
                                io.stargate.bridge.proto.QueryOuterClass.TypeSpec cqlType,
                                graphql.language.Type<?> graphqlType)

query

protected io.stargate.bridge.proto.QueryOuterClass.ResultSet query(EntityModel entity,
                                                                   List<BuiltCondition> whereConditions,
                                                                   Optional<Integer> limit,
                                                                   io.stargate.bridge.proto.QueryOuterClass.QueryParameters parameters,
                                                                   StargateGraphqlContext context)

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

toSingleEntity

protected Map<String,Object> toSingleEntity(io.stargate.bridge.proto.QueryOuterClass.ResultSet resultSet,
                                            EntityModel entity)

toEntities

protected List<Map<String,Object>> toEntities(io.stargate.bridge.proto.QueryOuterClass.ResultSet resultSet,
                                              EntityModel entity)

copyRowToEntity

protected void copyRowToEntity(io.stargate.bridge.proto.QueryOuterClass.Row row,
                               List<io.stargate.bridge.proto.QueryOuterClass.ColumnSpec> columns,
                               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.

bindWhere

protected List<BuiltCondition> bindWhere(List<ConditionModel> conditions,
                                         Predicate<String> hasArgument,
                                         Function<String,Object> getArgument,
                                         Function<List<ConditionModel>,Optional<String>> validator,
                                         io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace)

Given the WHERE conditions that were inferred from an operation signature, find out which arguments are actually present in a 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,
                                      io.stargate.bridge.proto.Schema.CqlKeyspaceDescribe keyspace)