toJson method

Map<String, dynamic> toJson({
  1. OptimizeFor optimizeFor = OptimizeFor.put,
})

Converts this object into JSON format.

optimizeFor lets the program know what information to include in the JSON data map.

  • OptimizeFor.put (the default value) is used when making a data map that is being placed in a PUT request. This only includes data that has changed.
  • OptimizeFor.putFull is used when a parent object updates; so, all of the children are required to be present for the PUT request.
  • OptimizeFor.post is used when making a data map for a POST request.
  • OptimizeFor.dontOptimize is used to get all of the data contained in this object.

Throws InvalidIdException if target.id is empty and optimizeFor is not set to OptimizeFor.dontOptimize.

Implementation

Map<String, dynamic> toJson({OptimizeFor optimizeFor = OptimizeFor.put}) {
  // PUT
  if (identical(optimizeFor, OptimizeFor.put)) {
    Map<String, dynamic> toReturn = {};

    if (target != _originalTarget) {
      toReturn[ApiFields.target] =
          target.toJson(optimizeFor: OptimizeFor.putFull);
    }

    if (action != _originalAction) {
      toReturn[ApiFields.action] =
          action.toJson(optimizeFor: OptimizeFor.putFull);
    }

    return toReturn;
  }

  // DEFAULT
  return {
    ApiFields.target: target.toJson(optimizeFor: optimizeFor),
    ApiFields.action: action.toJson(optimizeFor: optimizeFor),
  };
}