Utgångsströmmar

1. OutputStreamklass

Vi har nyligen utforskat indataströmmar. Det är dags att prata om utgångsströmmar.

Klassen OutputStreamär den överordnade klassen för alla klasser som stöder byte-utdata. Det här är en abstrakt klass som inte gör något på egen hand, men den har efterkommande klasser för varje tillfälle.

Det låter extremt komplicerat. För att uttrycka det enklare, den här klassen fungerar på bytes, och inte till exempel tecken eller andra datatyper. Och det faktum att det är abstrakt betyder att vi vanligtvis inte använder det, utan snarare en av dess efterkommande klasser. Till exempel FileOutputStreamoch liknande.

Men tillbaka till OutputStreamklassen. Den här klassen har metoder som alla dess underliggande klasser måste implementera. Här är de viktigaste:

void write(int b)

void write(byte[] buffer)

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

void flush()

void close()

När du skapar ett objekt av en klass som ärver InputStreamanger du vanligtvis ett källobjekt som InputStreamläser data från. När du skapar ett objekt av en klass som ärver OutputStreamanger du vanligtvis också målobjektet eller strömmen som data ska skrivas till.

Låt oss kort gå igenom klassens alla metoder OutputStream:

write(int b)metod

Denna metod skriver en byte (inte en int) till utgångsströmmen. Det godkända värdet castas till en byte, och int:s första tre byte kasseras.

write(byte[] buffer)metod

Skriver den givna arrayen av byte till utgångsströmmen. Det är allt.

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

Skriver en del av den passerade arrayen av byte till utgångsströmmen. Offsetvariabeln indikerar indexet för det första elementet i matrisen och lengthär längden på delmängden som ska skrivas.

flush()metod

Metoden flush()används för att tvinga all data som potentiellt är buffrad i den aktuella strömmen att skrivas till målströmmen. Detta är relevant när man använder buffring och/eller flera strömobjekt arrangerade i en kedja.

close()metod

Skriver all oskriven data till målobjektet. Metoden close()behöver inte anropas om du använder ett try-with-resourcesblock.

Exempel på kopiering av en fil

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. Writerklass

Klassen Writerär exakt samma som OutputStreamklassen, men bara en skillnad igen: den fungerar med tecken ( char) istället för byte.

Det här är en abstrakt klass: du kan inte skapa objekt i Writerklassen. Dess huvudsakliga mål är att vara en gemensam föräldraklass för hundratals efterkommande klasser och att ge dem gemensamma metoder för att arbeta med karaktärsströmmar.

Metoder för Writerklassen (och alla dess underliggande klasser):

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()

Metoderna är väldigt lika metoderna i klassen, OutputStreammen de fungerar med tecken istället för byte.

Beskrivning av metoder:

write(int b)metod

Denna metod skriver ett enstaka tecken ( char— inte ett int) till utmatningsströmmen. Det godkända värdet kastas till a charoch de första två byten kasseras.

write(char[] buffer)metod

Skriver den givna uppsättningen av tecken till utdataströmmen.

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

Skriver en del av den passerade arrayen av tecken till utdataströmmen. Variabeln offsetindikerar indexet för det första elementet i arrayen och lengthär längden på delmängden som ska skrivas.

write(String str)metod

Skriver den givna strängen till utgångsströmmen.

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

Skriver en del av den givna strängen till utdataströmmen: strängen konverteras till en array av tecken. Variabeln offsetindikerar indexet för det första elementet i arrayen och lengthär längden på delmängden som ska skrivas.

flush()metod

Metoden flush()används för att tvinga all data som potentiellt är buffrad i den aktuella strömmen att skrivas till målströmmen. Detta är relevant när man använder buffring och/eller flera strömobjekt arrangerade i en kedja.

close()metod

Skriver all oskriven data till målobjektet. Metoden close()behöver inte anropas om du använder ett try-with-resourcesblock.

Exempel på ett program som kopierar en textfil:

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);
   }
}

StringWriterklass

Det finns en annan intressant klass som ärver Writerklassen: den heter StringWriter. Den innehåller en föränderlig sträng — ett StringBufferobjekt. Och varje gång du "skriver" något till objektet StringWriterläggs texten helt enkelt till i dess interna buffert.

Exempel:

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

String result = writer.toString();

I det här fallet StringWriterär klassen i huvudsak ett omslag över StringBufferklassen, men StringWriterklassen är en ättling till Writerströmklassen och den kan användas i kedjor av strömobjekt. Detta är en ganska användbar egenskap i praktiken.

3. PrintStreamklass

Utdataströmsklasser kan också läggas in i en kedja med mellanliggande strömmar som skriver data till målströmmen som skickas till dem. Den allmänna synen på interaktionen mellan dessa strömmar ser ut så här:

Den mest intressanta och mångsidiga av alla mellanliggande utdataströmmar är PrintStream. Den har tiotals metoder och så många som 12 konstruktörer.

Klassen PrintStreamärver FilterOutputStreamklassen, som ärver OutputStream. Det betyder att PrintStreamklassen har alla metoder för de överordnade klasserna förutom sina egna metoder . Här är de mest intressanta:

void print(obj)

void println(obj)

void println()

PrintStream format(String format, args...)

Och var är dessa tiotals metoder, frågar du dig?

Tja, den har många varianter av print()och println()metoder med olika parametrar. De kan sammanfattas i denna tabell.

Vi kommer inte att fördjupa oss i dessa metoder, eftersom du redan känner till dem väl. Kan du gissa vad jag menar?

Kommer du ihåg System.out.println()? Men det kan skrivas på två rader:

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

Hello!

Vårt favoritkommando är ett anrop till metoden på klassens statiska variabel . Och denna variabels typ är .System.out.println()println()outSystemPrintStream

På många CodeGym-nivåer, och i nästan varje uppgift, har du anropat klassens metoder PrintStreamutan att ens veta om det!

Praktisk användning

Java har denna intressanta klass som heter ByteArrayOutputStream, som är en dynamiskt växande byte-array som ärver OutputStream.

Ett ByteArrayOutputStreamobjekt och PrintStreamobjekt kan kedjas ihop så här:

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