Aliran keluaran

1. OutputStreamkelas

Kami baru sahaja meneroka aliran input. Sudah tiba masanya untuk bercakap tentang aliran keluaran.

Kelas OutputStreamialah kelas induk untuk semua kelas yang menyokong output bait. Ini ialah kelas abstrak yang tidak melakukan apa-apa dengan sendirinya, tetapi ia mempunyai kelas turunan untuk setiap kesempatan.

Kedengarannya sangat rumit. Untuk meletakkannya dengan lebih mudah, kelas ini beroperasi pada bait, dan bukan, sebagai contoh, aksara atau jenis data lain. Dan hakikat bahawa ia adalah abstrak bermakna bahawa kita biasanya tidak menggunakannya, sebaliknya salah satu daripada kelas keturunannya. Contohnya, FileOutputStreamdan seumpamanya.

Tetapi kembali ke OutputStreamkelas. Kelas ini mempunyai kaedah yang mesti dilaksanakan oleh semua kelas keturunannya. Berikut adalah yang utama:

void write(int b)

void write(byte[] buffer)

void write(byte[] buffer, off, len)

void flush()

void close()

Apabila anda mencipta objek kelas yang mewarisi InputStream, anda biasanya menentukan objek sumber yang InputStreammembaca data daripadanya. Apabila anda mencipta objek kelas yang mewarisi OutputStream, anda juga biasanya menentukan objek sasaran atau strim yang data akan ditulis.

Mari kita lihat secara ringkas semua kaedah kelas OutputStream:

write(int b)kaedah

Kaedah ini menulis satu bait (bukan an int) kepada aliran keluaran. Nilai yang dihantar dihantar ke bait, dan tiga bait pertama int dibuang.

write(byte[] buffer)kaedah

Menulis tatasusunan bait yang diberikan kepada aliran keluaran. Itu sahaja.

write(byte[] buffer, int offset, int length)kaedah

Menulis sebahagian daripada tatasusunan bait yang diluluskan kepada aliran keluaran. Pembolehubah mengimbangi menunjukkan indeks elemen pertama tatasusunan, dan lengthialah panjang subset yang akan ditulis.

flush()kaedah

Kaedah ini flush()digunakan untuk memaksa mana-mana data yang berpotensi buffer dalam aliran semasa untuk ditulis ke aliran sasaran. Ini berkaitan apabila menggunakan penimbalan dan/atau objek berbilang aliran yang disusun dalam rantai.

close()kaedah

Menulis sebarang data tidak bertulis kepada objek sasaran. Kaedah close()tidak perlu dipanggil jika anda menggunakan try-with-resourcesblok.

Contoh menyalin fail

String src = "c:\\projects\\log.txt";
String dest = "c:\\projects\\copy.txt";

try(FileInputStream input = new FileInputStream(src);
FileOutputStream output = new FileOutputStream(dest))
{
   byte[] buffer = new byte[65536]; // 64Kb
   while (input.available() > 0)
   {
      int real = input.read(buffer);
      output.write(buffer, 0, real);
   }
}

2. Writerkelas

Kelas Writeradalah sama dengan OutputStreamkelas, tetapi hanya satu perbezaan sekali lagi: ia berfungsi dengan aksara ( char) dan bukannya bait.

Ini ialah kelas abstrak: anda tidak boleh mencipta objek kelas Writer. Matlamat utamanya adalah untuk menjadi kelas induk biasa untuk ratusan kelas keturunan dan memberi mereka kaedah biasa untuk bekerja dengan aliran aksara.

Kaedah kelas Writer(dan semua kelas keturunannya):

void write(int b)

void write(char[] buffer)

void write(char[] buffer, off, len)

void write(String str)

void write(String str, off, len)

void flush()

void close()

Kaedah ini sangat serupa dengan kaedah kelas OutputStream, tetapi ia berfungsi dengan aksara dan bukannya bait.

Penerangan kaedah:

write(int b)kaedah

Kaedah ini menulis satu aksara ( char— bukan an int) kepada aliran keluaran. Nilai yang diluluskan dibuang ke a char, dan dua bait pertama dibuang.

write(char[] buffer)kaedah

Menulis tatasusunan aksara yang diberikan kepada aliran keluaran.

write(char[] buffer, int offset, int length)kaedah

Menulis sebahagian daripada tatasusunan aksara yang diluluskan ke aliran keluaran. Pembolehubah offsetmenunjukkan indeks elemen pertama tatasusunan, dan lengthialah panjang subset yang akan ditulis.

write(String str)kaedah

Menulis rentetan yang diberikan kepada aliran keluaran.

write(String str, int offset, int length)kaedah

Menulis sebahagian daripada rentetan yang diberikan kepada aliran keluaran: rentetan itu ditukar kepada tatasusunan aksara. Pembolehubah offsetmenunjukkan indeks elemen pertama tatasusunan, dan lengthialah panjang subset yang akan ditulis.

flush()kaedah

Kaedah ini flush()digunakan untuk memaksa mana-mana data yang berpotensi buffer dalam aliran semasa untuk ditulis ke aliran sasaran. Ini berkaitan apabila menggunakan penimbalan dan/atau objek berbilang aliran yang disusun dalam rantai.

close()kaedah

Menulis sebarang data tidak bertulis kepada objek sasaran. Kaedah close()tidak perlu dipanggil jika anda menggunakan try-with-resourcesblok.

Contoh program yang menyalin fail teks:

String src = "c:\\projects\\log.txt";
String dest = "c:\\projects\\copy.txt";

try(FileReader reader = new FileReader(src);
FileWriter writer = new FileWriter(dest))
{
   char[] buffer = new char[65536]; // 128Kb
   while (reader.ready())
   {
      int real = reader.read(buffer);
      writer.write(buffer, 0, real);
   }
}

StringWriterkelas

Terdapat satu lagi kelas menarik yang mewarisi Writerkelas: ia dipanggil StringWriter. Ia mengandungi rentetan boleh ubah — StringBufferobjek. Dan setiap kali anda "menulis" sesuatu pada StringWriterobjek, teks itu hanya ditambahkan pada penimbal dalamannya.

Contoh:

StringWriter writer = new StringWriter();
writer.write("Hello");
writer.write(String.valueOf(123));

String result = writer.toString();

Dalam kes ini, StringWriterkelas pada asasnya ialah pembalut ke atas StringBufferkelas, tetapi StringWriterkelas itu adalah keturunan Writerkelas aliran, dan ia boleh digunakan dalam rantaian objek aliran. Ini adalah harta yang cukup berguna dalam amalan.

3. PrintStreamkelas

Kelas aliran output juga boleh dimasukkan ke dalam rantaian dengan aliran perantara yang menulis data ke aliran sasaran yang dihantar kepada mereka. Pandangan umum interaksi aliran ini kelihatan seperti ini:

Yang paling menarik dan serba boleh daripada semua aliran keluaran perantaraan ialah PrintStream. Ia mempunyai berpuluh-puluh kaedah dan sebanyak 12 pembina.

Kelas PrintStreammewarisi FilterOutputStreamkelas, yang mewarisi OutputStream. Ini bermakna bahawa PrintStreamkelas mempunyai semua kaedah kelas induk sebagai tambahan kepada kaedahnya sendiri . Berikut adalah yang paling menarik:

void print(obj)

void println(obj)

void println()

PrintStream format(String format, args...)

Dan di manakah berpuluh-puluh kaedah ini, anda bertanya?

Nah, ia mempunyai banyak varian print()dan println()kaedah dengan parameter yang berbeza. Mereka boleh diringkaskan dalam jadual ini.

Kami tidak akan menyelami kaedah ini, kerana anda sudah mengetahuinya dengan baik. Bolehkah anda meneka apa yang saya dapat?

Ingat tak System.out.println()? Tetapi ia boleh ditulis dalam dua baris:

PrintStream stream = System.out;
stream.println("Hello!");

Hello!

Perintah kegemaran kami ialah panggilan kepada kaedah pada pembolehubah statik kelas . Dan jenis pembolehubah ini ialah .System.out.println()println()outSystemPrintStream

Dalam banyak peringkat CodeGym, dan dalam hampir setiap tugas, anda telah memanggil kaedah kelas PrintStreamtanpa mengetahuinya!

Penggunaan praktikal

Java mempunyai kelas yang menarik ini dipanggil ByteArrayOutputStream, yang merupakan tatasusunan bait yang berkembang secara dinamik yang mewarisi OutputStream.

Objek ByteArrayOutputStreamdan PrintStreamobjek boleh dirantai seperti ini:

ByteArrayOutputStream baos = new ByteArrayOutputStream();

try(PrintStream stream = new PrintStream(baos))
{
   stream.println("Hello");
   stream.println(123);
}

String result = baos.toString();

System.out.println(result);

Hello!
123