Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

ByteArrayOutputStream: copiar bytes e fechar o fluxo

Obtém uma cópia independente dos bytes escritos em memória e descobre por que motivo o fluxo continua a funcionar após `close()`.

Versão: Java SE 21

Sintaxe

import java.io.ByteArrayOutputStream;

// Java SE 21: instance method signatures
public byte[] toByteArray()
public void close() throws java.io.IOException

java.io.ByteArrayOutputStream guarda os bytes num array interno em memória. O buffer cresce automaticamente quando necessário, pelo que a sua capacidade pode ultrapassar o número de bytes escritos.

ByteArrayOutputStream.toByteArray() cria um novo byte[] em cada chamada. O array contém apenas os bytes escritos, pela ordem de escrita. O seu comprimento corresponde ao valor de size() no momento da chamada. As escritas posteriores não alteram a cópia, e alterar a cópia não altera o buffer. Não é preciso fechar primeiro o fluxo.

ByteArrayOutputStream.close() não tem efeito: não esvazia nem liberta o buffer. Depois da chamada, ainda podes escrever bytes e obter cópias. A assinatura continua a declarar a exceção verificada IOException, pelo que o código que chama o método tem de a capturar ou declarar. Não partas do princípio de que os outros fluxos de saída se comportam da mesma forma.

Exemplos

import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.util.Arrays;

public class Main {
    public static void main(String[] args) throws IOException {
        ByteArrayOutputStream buffer = new ByteArrayOutputStream();
        buffer.write(10);
        buffer.write(20);
        byte[] snapshot = buffer.toByteArray();

        buffer.close();
        buffer.write(30);
        System.out.println(Arrays.toString(snapshot));

        snapshot[0] = 99;
        System.out.println(Arrays.toString(buffer.toByteArray()));
    }
}

Resultado

[10, 20]
[10, 20, 30]

A primeira linha mostra que acrescentar `30` depois de fechar o fluxo não alterou a cópia anterior. A segunda mostra que atribuir `99` a `snapshot[0]` não alterou o buffer, que aceitou `30` apesar do fecho.

Lições relacionadas

  • Java · Lição 60 · Intermédio · Versão: 2

Fontes