Decodificando JSON usando json.Unmarshal vs json.NewDecoder.Decode

Estou desenvolvendo um cliente de API em que preciso codificar uma carga JSON mediante solicitação e decodificar um corpo JSON da resposta.

Eu li o código fonte de várias bibliotecas e, pelo que vi, tenho basicamente duas possibilidades para codificar e decodificar uma string JSON.

Use json.Unmarshalpassar toda a cadeia de resposta

data, err := ioutil.ReadAll(resp.Body)
if err == nil && data != nil {
    err = json.Unmarshal(data, value)
}

ou usando json.NewDecoder.Decode

err = json.NewDecoder(resp.Body).Decode(value)

No meu caso, ao lidar com respostas HTTP implementadas io.Reader, a segunda versão parece exigir menos código, mas desde que eu vi as duas, fico imaginando se há alguma preferência se devo usar uma solução em vez da outra.

Além disso, a resposta aceita desta pergunta diz

Por favor use em json.Decodervez de json.Unmarshal.

mas não mencionou o motivo. Devo realmente evitar o uso json.Unmarshal?

Realmente depende de qual é a sua entrada. Se você observar a implementação do Decodemétodo json.Decoder, ele armazena em buffer todo o valor JSON na memória antes de descompactá-lo para um valor Go. Portanto, na maioria dos casos, não será mais eficiente em termos de memória (embora isso possa mudar facilmente em uma versão futura do idioma).

Portanto, uma melhor regra geral é esta:

• Use json.Decoderse seus dados vierem de um io.Readerfluxo ou se você precisar decodificar vários valores a partir de um fluxo de dados.
• Use json.Unmarshalse você já possui os dados JSON na memória.

No caso de ler de uma solicitação HTTP, eu escolheria json.Decoderuma vez que você obviamente está lendo de um fluxo.