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 InvalidNameException if name does not have a length of 1 - 32 (inclusive), and optimizeFor is not set to OptimizeFor.dontOptimize.

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

Implementation

Map<String, dynamic> toJson({OptimizeFor optimizeFor = OptimizeFor.put}) {
  // Validate [name].
  if (!identical(optimizeFor, OptimizeFor.dontOptimize)) {
    if (!Validators.isValidName(name)) {
      if (!identical(optimizeFor, OptimizeFor.put) || name != _originalName) {
        throw InvalidNameException.withValue(name);
      }
    }
  }

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

    if (name != _originalName) {
      toReturn[ApiFields.name] = name;
    }

    return toReturn;
  }

  // PUT FULL
  if (identical(optimizeFor, OptimizeFor.putFull)) {
    return {
      ApiFields.name: name,
    };
  }

  // DEFAULT
  return {
    ApiFields.name: name,
    ApiFields.image: image.toJson(optimizeFor: optimizeFor),
  };
}