Meme transcription: Panel 1. Two images of JSON, one is the empty object, one is an object in which the key name maps to the value null. Caption: “Corporate needs you to find the difference between this picture and this picture”

Panel 2. The Java backend dev answers, “They’re the same picture.”

  • kakes@sh.itjust.works
    link
    fedilink
    arrow-up
    4
    ·
    2 days ago

    Yeah, I’m also confused. If an attribute is null, I would prefer to simply not serialize it.

    I’m sure there are edge cases where someone might prefer to include null attributes, but generally they should be treated the same either way.

    • PeriodicallyPedantic@lemmy.ca
      link
      fedilink
      arrow-up
      3
      ·
      1 day ago

      Imagine you’re writing a CRUD API, which is pretty common.
      If null attributes aren’t included in the payload, and someone does an update (typically a PATCH), how do you know which fields should be nulled out and which should be ignored?

      I agree for many cases the two are semantically equivalent, but it’s common enough to not have them be equivalent that I’m surprised that it causes arguments

      • kakes@sh.itjust.works
        link
        fedilink
        arrow-up
        1
        ·
        edit-2
        1 day ago

        For an API there should always be a version parameter/endpoint, imho.

        Edit for further context: Ideally, a parameter.

        • PeriodicallyPedantic@lemmy.ca
          link
          fedilink
          arrow-up
          2
          ·
          edit-2
          21 hours ago

          I wasn’t taking about new fields. I was talking about resource partial updates (eg PATCH, or commonly the U in CRUD).

          If you just want to update a single field on a resource with 100 fields, rather than GETting the entire resource, updating the single field, and PUTting whole thing back, just do a PATCH with the single field.

          Likewise if you’re POSTing a resource that has nullable fields, but the default value isn’t null, how do you indicate that you want the default value for a given field? Do you have to first query some metadata API? That doesn’t seem ideal, when this existing pattern exists

    • bleistift2@sopuli.xyzOP
      link
      fedilink
      English
      arrow-up
      15
      ·
      2 days ago

      If an attribute is null, I would prefer to simply not serialize it.

      That’s interesting. I’m on the opposite team. If a customer model defines an optional birthday, for instance, I’d rather have it serialized as a null value if it’s not available for a specific customer.

      • kakes@sh.itjust.works
        link
        fedilink
        arrow-up
        9
        ·
        2 days ago

        The biggest reason for me is that it’s less data to send over a network. Especially when I’m working with lists of objects, including null fields can add a noticeable chunk to the payload.

        There are some cases where it might be worth it to differentiate “No value” and “No attribute”, but in most cases they can be treated the same, since the data should really be validated against a schema anyway.