Instance Method

set(_:at:)

Called by individual database properties to register a given field key and associated database value as part of the data set represented by the DatabaseInput.

func set(_ value: DatabaseQuery.Value, at key: FieldKey)

Discussion

Implemented by conforming types to handle key/value pairs provided by callers.

Setting a value for a key which has already been registered is expected to overwrite the old value with the new. Conforming types can choose alternative semantics, but must take care that doing so is compatible with the expectations of callers.

Note

As a rule, a key being set multiple times for a single input usually indicates or at least implies buggy behavior (such as a Model which specifies a particular key in more than one of its properties). However, there are cases where doing so is useful; as such, no attempt is made to diagnose multiple sets for the same key and the API must permit said behavior unless the semantics of the conforming type explicitly require otherwise and the alternate behavior is clearly documented.