Nullable Value Support

• JsonQL supports using nullable syntax using ‘?’ with types returned by overloaded methods JsonQL.Query.IQueryManager.QueryObject<TQueriedObject>(…) (e.g., queryManager.QueryObject<IEmployee?[]>(…), queryManager.QueryObject<IReadOnlyList<double?[]>>(…)) as well as nullable syntax with properties in returned type.

• Nullable syntax can be used with both C# reference types as well as value types (e.g., System.Double, System.Boolean).

• If the returned type is specified to have non-nullable, and the value is missing, there will be conversion errors of type JsonQL.JsonToObjectConversion.IConversionError in result with value of ErrorType equal to one of the following enum values: ValueNotSet, NonNullableCollectionItemValueNotSet.

• If the property is non-nullable in returned type (or in one of the classes used by return type class), there will be conversion errors of type JsonQL.JsonToObjectConversion.IConversionError in result with value of ErrorType equal to one of the following enum values: ValueNotSet, NonNullablePropertyNotSet.

• Errors related to non-nullable values being null in result are reported as errors by default, however specific errors can be configured to be reported as warnings, or to be ignored (not reported at all) in conversion settings configuration or in setting overrides in calls to JsonQL.Query.IQueryManager.QueryObject<T>(…). See Conversion Settings for more configuring conversion rules.

• Nullable Syntax in Query Result Type
  • Examples
    • Result as Value Type
    • Result as Reference Type
    • Result as List of Value Type Items
    • Result as Arrays of Reference Type Items
    • Result as List of Arrays of Value Type Items
    • Result as List of Lists of Reference Type Items
• Nullable Syntax in Queried Object Properties