Input/Output Streams - Revizia istoricului

Rhobincu: /* Fluxuri de intrare-ieșire la nivel de caracter */

2013-12-15T11:59:17Z

Fluxuri de intrare-ieșire la nivel de caracter

Rhobincu: /* Byte Output Streams */

2013-12-15T11:53:16Z

Byte Output Streams

Rhobincu: /* Fluxuri de ieșire orientate pe octet */

2013-12-15T11:50:59Z

Fluxuri de ieșire orientate pe octet

Rhobincu: /* Byte Input/Output Streams */

2013-12-15T11:27:22Z

Byte Input/Output Streams

Rhobincu: /* Byte Input/Output Streams */

2013-12-15T11:23:31Z

Byte Input/Output Streams

Rhobincu: /* Byte Input/Output Streams */

2013-12-15T11:15:35Z

Byte Input/Output Streams

Rhobincu: /* Byte Input/Output Streams */

2013-12-15T11:00:24Z

Byte Input/Output Streams

Rhobincu: /* Byte Input/Output Streams */

2013-12-15T10:56:24Z

Byte Input/Output Streams

Rhobincu: /* Fluxuri de intrare-ieșire la nivel de octet */

2013-12-15T10:56:09Z

Fluxuri de intrare-ieșire la nivel de octet

Rhobincu: /* Console Streams */

2013-12-15T10:51:03Z

Console Streams

@@ Linia 126: / Linia 126: @@
 '''ByteArrayOutputStream''', in order to obtain a reference to the buffer, a call to ''toByteArray()'' is required. This method returns a copy of the buffer.
-== Fluxuri de intrare-ieșire la nivel de caracter ==
+== Character Input/Output Streams ==
-Clasele pentru fluxurile la nivel de caracter au la bază clasa '''Reader''' pentru citirea datelor și clasa '''Writer''' pentru scrierea datelor. Majoritatea acestor clase se suprapun peste clasele pentru fluxurile la nivel de octet, oferind în principal aceleași funcționalități. Deosebirea între clasele de tip '''InputStream/OutputStream''' și cele de tip '''Reader/Writer''' este aceea că primele clase lucrează cu fluxuri de octeți (8 biți), în timp ce ultimele lucrează cu fluxuri de caractere reprezentate pe 16 biți în format [http://en.wikipedia.org/wiki/Unicode Unicode] (standard internațional de codare a caracterelor care este capabil să reprezinte caracterele tuturor limbilor scrie).
+Classes for character streams are extended from class [http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html java.io.Reader] for reading data and http://docs.oracle.com/javase/7/docs/api/java/io/Writer.html java.io.Writer] for writing data. Most of these classes overlap with byte stream classes, having the same functionality. The difference between them is that '''InputStream/OutputStream''' classes work (read/ write) with bytes (8 bits), as '''Reader/Writer''' work with characters represented in the [http://en.wikipedia.org/wiki/Unicode Unicode] standard, on 16 bits.
-Cu toate că noile clase '''Reader/Writer''' dublează clasele '''InputStream/OutputStream''', acestea din urmă nu au fost abandonate, datorită în principal cerinței de compatibilitate cu aplicațiile dezvoltate într-o versiune mai veche de Java. Totuși, există unele metode din vechile clase care se recomandă a nu a mai fi folosite, fiind caracterizare ca depășite (''deprecated''). Funcțiile oferite de clasele '''InputStream/OutputStream''' se regăsesc în clasele '''Reader/Writer''' cu mici deosebiri, acest lucru reflectându-se și în denumirile asemănătoare ale celor două tipuri de clase de tip flux, prefixele fiind aceleași.
+The corespondence between bytes streams and character streams are as follow:
-În cazul claselor de citire a datelor se pot observa următoarele corespondențe:
 * '''InputStream''' - [http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html Reader]
 * '''ByteArrayInputStream''' – [http://docs.oracle.com/javase/7/docs/api/java/io/CharArrayReader.html CharArrayReader]
 * '''StringBufferInputStream''' – [http://docs.oracle.com/javase/7/docs/api/java/io/StringReader.html StringReader]
 * '''FileInputStream''' – [http://docs.oracle.com/javase/7/docs/api/java/io/FileReader.html FileReader]
-* Există unele clase, '''SequenceInputStream''', și '''DataInputStream''' care nu au o versiune de tip '''Reader'''.
+* There are classes, like '''SequenceInputStream''' and '''DataInputStream''' that don't have a '''Reader''' version.
-În cazul claselor pentru scriere, se pot observa următoarele corespondențe:
+In case of output streams:
 * '''OutputStream''' - [http://docs.oracle.com/javase/7/docs/api/java/io/Writer.html Writer]
 * '''ByteArrayOutputStream''' – [http://docs.oracle.com/javase/7/docs/api/java/io/CharArrayWriter.html CharArrayWriter]
 * '''FileOutputStream''' – [http://docs.oracle.com/javase/7/docs/api/java/io/FileWriter.html FileWriter]

@@ Linia 124: / Linia 124: @@
 Class '''ByteArrayOutputStream''' corresponds to '''ByteArrayInputStream''' and allows the connection of a stream to a buffer (a byte array). The buffer is created when an object of type '''ByteArrayOutputStream''' is instantiated by using one of the two constructors. This class offers a method of storing data in memory before processing or sending them somewhere else. In order to transmit data, method ''writeTo()'' is used.
 In the example above, the buffer is written to the ''out'' stream, passed as a parameter. Opposite to class '''ByteArrayInputStream''', where the buffer was passed as an argument to the constructor, in the case of
-'''ByteArrayOutputStream''', in order to
+'''ByteArrayOutputStream''', in order to obtain a reference to the buffer, a call to ''toByteArray()'' is required. This method returns a copy of the buffer.
 == Fluxuri de intrare-ieșire la nivel de caracter ==

@@ Linia 82: / Linia 82: @@
 By using class '''ByteArrayInputStream''', you can read data from an array using stream reading methods, without having to manually manage the current read index in the array. The connection is easily done by giving the existing array as an argument to the stream constructor. The example above creates a 10 bytes array, filling it with value from 0 to 9 and then creating a ByteArrayInputStream and using it to sequentially read the data, byte by byte and displaying it on the screen. You can also see that the reading is only done until the ''read()'' method returns -1, signaling the end of the stream, thus the end of the array.
-=== Fluxuri de ieșire orientate pe octet ===
+=== Byte Output Streams ===
-[[Fișier:outputstream.png|Reprezentare grafică a unui OutputStream generic și a unui FileOutputStream]]
+[[Fișier:outputstream.png|Graphical representation of a generic OutputStream and a FileOutputStream]]
 <syntaxhighlight lang="java">
 public abstract class OutputStream{
@@ Linia 97: / Linia 98: @@
 </syntaxhighlight>
-Funcţia ''write()'' scrie în flux octetul cel mai puțin semnficativ al argumentului, care este de tip '''int'''. Celelalte funcții permit scrierea în flux a unui tablou de octeți sau a unei secțiuni din tabloul de octeți ''b'' începând de la poziția ''off'' și având lungimea ''len''.
+Method ''write()'' writes the lest significant bytes of the argument, which is of type '''int''' to the stream. The other methods write the contents of a byte array ''b'' or a section of it, starting from position ''off'' and having a length of ''len''.
-Funcția ''flush()'' forțează scriea datelor în stream și este utilă în cazul în care se folosește un buffer de scriere (golește buffer-ul).
+Method ''flush()'' forces writing data to the stream, and it is useful when a write buffer is used.
-Funcția ''close()'' închide fluxul deschis prin operația de creare a fluxului, eliberând astfel orice resursă de sistem ocupată de fluxul respectiv.
+Method ''close()'' closes the stream and frees and resource associated with it.
-Ca și în cazul clasei ''InputStream'', clasele derivate din ''OutputStream'' pot fi separate în două categorii: fluxuri propriu-zise ([http://docs.oracle.com/javase/7/docs/api/java/io/ByteArrayOutputStream.html ByteArrayOutputStream], [http://docs.oracle.com/javase/7/docs/api/java/io/FileOutputStream.html FileOutputStream], etc) care se conectează la o destinație, și fluxuri de tip filtru (derivate din [http://docs.oracle.com/javase/7/docs/api/java/io/FilterOutputStream.html FilterOutputStream]). Ultimele tipuri de fluxuri se conectează la primele, îmbogățind funcționarea acestora.
+Just like ''InputStream'', classes derived from ''OutputStream'' can be split in two categories: data streams ([http://docs.oracle.com/javase/7/docs/api/java/io/ByteArrayOutputStream.html ByteArrayOutputStream], [http://docs.oracle.com/javase/7/docs/api/java/io/FileOutputStream.html FileOutputStream], etc.) which connect to a destination, and filter streams (derived from [http://docs.oracle.com/javase/7/docs/api/java/io/FilterOutputStream.html FilterOutputStream]) which are wrappers over the first ones, enhancing their functionality.
-Fluxurile standard de ieșire ('''System.out''') și de eroare ('''System.err''') sunt membri statici ai clasei '''System''' de tipul [http://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html PrintStream], care extinde clasa '''FilterOutputStream'''. Acestea sunt conectate cu display-ul și se folosesc prin convenție în două situații distincte: primul pentru afișarea mesajelor către utilizatorul programului, şi al doilea pentru afișarea mesajelor de eroare (de cele mai multe ori în scop de depanare).
+Standard output stream ('''System.out''') and standard error streams ('''System.err''') are static fields of class '''System''', of type [http://docs.oracle.com/javase/7/docs/api/java/io/PrintStream.html PrintStream], which extends class '''FilterOutputStream'''. These are connected to the display and by conventions are used in two distinct situations: first to display messages for the program user, and the second, to display error messages (usually for debugging purposes).
-În continuare este prezentat un exemplu de utilizare a clasei '''ByteArrayOutputStream''', prin care se afișează toate valorile pe 8 biţi:
+Next, let's see an example of using a '''ByteArrayOutputStream''', used to display all 8-bits values:
 <syntaxhighlight lang="java">
 ByteArrayOutputStream _buffer = new ByteArrayOutputStream(256);
@@ Linia 121: / Linia 122: @@
 </syntaxhighlight>
 Clasa '''ByteArrayOutputStream''' este clasa corespondentă clasei '''ByteArrayInputStream''' și permite conectarea unui flux la un buffer (un tablou de octeți). Buffer-ul se crează în momentul în care un obiect de tipul '''ByteArrayOutputStream''' se instanțiază folosind unul dintre cei doi constructori. Această clasă oferă o metodă de stocare a datelor în memorie înainte de a le trimite mai departe. Pentru transmiterea datelor se folosește metoda ''writeTo()''. Această funcție scrie conținutul buffer-ului în fluxul ''out'' transmis ca parametru. Spre deosebire de clasa '''ByteArrayInputStream''' unde tabloul (buffer-ul) era transmis prin constructorul clasei, în cazul clasei '''ByteArrayOutputStream''', pentru a avea o referintă la acest buffer, este nevoie să se apeleze funcția ''toByteArray()''. Această funcție creează un tablou de dimensiune egală cu numărul de octeți înscriși în flux și care conține acești octeți.

@@ Linia 80: / Linia 80: @@
 </syntaxhighlight>
-Prin intermediul clasei '''ByteArrayInputStream''' se pot citi datele din tablou utilizând operațiile de citire din flux, fără a mai fi nevoie de a contoriza poziția de citire din tablou. Conectarea se face simplu prin transmiterea tabloului respectiv ca și parametru în constructorul fluxului. Exemplul construiește un tablou de 10 octeți, inițializându-l cu valori de la 0 la 9, după care se citesc aceste valori din tablou prin intermediul fluxului creat. Se observă că citirea din flux se face până în momentul în care funcția ''read()'' returnează –1, semnalizând că s-a ajuns la sfârșitul fluxului, deci la sfârşitul tabloului.
+By using class '''ByteArrayInputStream''', you can read data from an array using stream reading methods, without having to manually manage the current read index in the array. The connection is easily done by giving the existing array as an argument to the stream constructor. The example above creates a 10 bytes array, filling it with value from 0 to 9 and then creating a ByteArrayInputStream and using it to sequentially read the data, byte by byte and displaying it on the screen. You can also see that the reading is only done until the ''read()'' method returns -1, signaling the end of the stream, thus the end of the array.
 === Fluxuri de ieșire orientate pe octet ===

@@ Linia 61: / Linia 61: @@
 * [http://docs.oracle.com/javase/7/docs/api/javax/sound/sampled/AudioInputStream.html AudioInputStream] can read from an audio source.
-O altă categorie importantă de clase derivate din '''InputStream''', de data aceasta însă nu direct, sunt clasele de tip filtru derivate din clasa [http://docs.oracle.com/javase/7/docs/api/java/io/FilterInputStream.html FilterInputStream] care este la rândul ei derivată din clasa '''InputStream'''. Aceste tipuri de clase nu oferă nici o alta sursă pentru fluxuri față de clasele amintite anterior. Ele lucrează ca o înfășurătoare a claselor care se conectează direct la sursă, oferind acestora din urmă funcții (proprietăți) suplimentare de citire din flux (exemplu: citire pe linie, citire numere, etc). Ca exemple de astfel de clase amintim:
+Next, an example of using class '''ByteArrayInputStream''':
 <syntaxhighlight lang="java">
 byte _buffer[] = new byte[10];

@@ Linia 43: / Linia 43: @@
 </syntaxhighlight>
-Funcția ''read()'', fără nici un parametru, citește octetul curent din flux și îl returnează sub forma unui întreg cu valori între 0 şi 255. Dacă s-a ajuns la capătul fluxului, se returnează valoarea –1.
+Method ''read()'', with no arguments, reads the next byte from the stream and return it as an '''int''' with values between 0 and 255. If the end of stream has been reached, it returns -1.
-Funcțiile ''read()'', având ca parametru un tablou de octeți, citesc de la poziția curentă din flux un număr de octeți egal cu ''len'' sau cu lungimea tabloului ''b'' și îl scriu în vectorul ''b'', la poziția ''off'', dacă aceasta este specificată. Ele returnează numărul de octeţi citiți în buffer-ul ''b'' sau –1 dacă s-a ajuns la capătul fluxului.
+Methods ''read()'', having as arguments an array of bytes, read a number of ''len'' or the length of the array ''b'' (whichever is smaller) of bytes from the stream and write them in array ''b'' at index ''off'', if this is specified. They return the number of bytes read from the stream (and subsequently written in ''b'') or -1 if the end of stream has been reached.
-Funcţia ''skip()'' este utilizată pentru a muta poziția cursorului de citire peste un anumit număr de octeți specificat prin parametrul ''n''.
+Method ''skip()'' is used to discard a number of bytes from the input stream, specified in argument ''n''.
-Funcțiile ''mark()'' și ''reset()'' se folosesc împreună, oferind posibilitatea reluării citirii din flux. Prin funcția ''mark()'' se memorează poziția curentă în flux, specificând prin argumentul ''readlimit'' maximul de octeți (se crează un buffer de dimensiune ''readlimit'') care se pot citi până la apelul funcției ''reset()''. Prin funcția ''reset()'' se repoziționează cursorul de citire din flux la poziția la care s-a făcut marcarea prin funcția ''mark()''. Aceste două funcții sunt valabile doar în cazul în care fluxul suportă marcarea. Verificarea acestui lucru se face prin apelul funcției ''markSupported()''.
+Methods ''mark()'' and ''reset()'' are used together, so that portions of the stream that have been already read can be read again. Through method ''mark()'', the current position in the stream is memorized, specifying the maximum size of the buffer that will store the following data through the argument ''readLimit'' that can be written before calling ''reset()''. The ''reset()'' method re-position the read index to the position where it was when the ''mark()'' method was called. These two methods are only valid if the stream supports marking. Checking for this is done by calling method ''markSupported()''.
-Funcţia ''available()'' returnează numărul de octeți disponibili pentru citire din flux.
+Method ''available()'' returns the number of bytes available to be read from the stream without blocking execution. Be aware that some classes (like file streams) only return an estimate value when calling ''available()''. Check the documentation.
-Funcția ''close()'' este funcția care închide un flux. Odată terminat lucrul cu un flux, acesta trebuie închis, eliberând astfel resursele de sistem ocupate de acel flux. În mod normal JVM închide aceste fluxuri în momentul în care programul se termină.
+Method ''close()'' is used to close a stream. Once work with a stream is done, it needs to be closed in order to free the associated resources. Normally, JVM will automatically close all streams then the program ends, but a programmer should not count on this feature and clean up after him/herself.
-Pentru a utiliza clasa '''InputStream''' în aplicații, a fost nevoie de construirea unor clase derivate din aceasta, clase care să fie conectate cu surse de date reale, existente în sistem. Din categoria claselor pentru fluxuri de intrare la nivel de octet conectate la diferite tipuri de resurse fac parte:
+In order to use class '''InputStream''' in applications, it needs to be extended by classes that are connected to real data sources, existing in the system. Some of these classes, defined in Java, are:
-* [http://docs.oracle.com/javase/7/docs/api/java/io/ByteArrayInputStream.html ByteArrayInputStream] permite conectarea unui flux la un tablou de octeți;
+* [http://docs.oracle.com/javase/7/docs/api/java/io/ByteArrayInputStream.html ByteArrayInputStream] can read data from an array of bytes, acting as an input stream;
-* [http://docs.oracle.com/javase/7/docs/api/java/io/FileInputStream.html FileInputStream] oferă posibilitatea conectării cu un fișier pentru a citi datele înregistrate în acesta;
+* [http://docs.oracle.com/javase/7/docs/api/java/io/FileInputStream.html FileInputStream] oferă can read bytes coming from a file on the file system;
-* [http://docs.oracle.com/javase/7/docs/api/java/io/SequenceInputStream.html SequenceInputStream] permite combinarea mai multor fluxuri având ca rezultat obținerea unui singur flux;
+* [http://docs.oracle.com/javase/7/docs/api/java/io/SequenceInputStream.html SequenceInputStream] can combine multiple input streams in a single stream;
-* [http://docs.oracle.com/javase/7/docs/api/javax/sound/sampled/AudioInputStream.html AudioInputStream] permite conectarea cu un stream audio.
+* [http://docs.oracle.com/javase/7/docs/api/javax/sound/sampled/AudioInputStream.html AudioInputStream] can read from an audio source.

@@ Linia 26: / Linia 26: @@
 [[Fișier:inputstream.png|Graphical representation of a generic InputStream and a FileInputStream]]
-Classes implementing byte input streams are extended from [http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html java.io.InputStream], an [[http://dcae.pub.ro/wikilabs/index.php/Java_Syntax;_A_Program%27s_Lexical_Structure#Abstract_Modifier abstract]] class which offers generic read methods. The definition of the class is:
+Classes implementing byte input streams are extended from [http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html java.io.InputStream], an
 <syntaxhighlight lang="Java">

@@ Linia 18: / Linia 18: @@
 Classes that implement IO operations are placed in package [http://docs.oracle.com/javase/7/docs/api/java/io/package-summary.html java.io]. This package contains two categories of streams: bytes streams and character streams. Byte streams have been introduced from JDK version 1.0.2 and character streams are available since JDK 1.1. The latter ones do not replace, but complete stream functionality by being able to directly read and write characters (which in Java have 2 bytes each).
-== Fluxuri de intrare-ieșire la nivel de octet ==
+== Byte Input/Output Streams ==
-Fluxurile la nivel de octet (ca și fluxurile la nivel de caracter) se împart în fluxuri de intrare și fluxuri de ieșire.
+Bytes streams (as character streams) are split in two categories: input streams and output streams.
-=== Fluxuri de intrare la nivel de octet ===
+=== Bytes Input Streams
-[[Fișier:inputstream.png|Reprezentare grafică a unui InputStream generic și a unui FileInputStream]]
+[[Fișier:inputstream.png|Graphical representation of a generic InputStream and a FileInputStream]]
-Clasele pentru fluxurile la nivel de octet au ca rădăcină clasa '''InputStream''', o clasa abstractă care oferă funcțiile de citire general valabile. Definiția clasei [http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html InputStream] este:
+Classes implementing byte input streams are extended from [http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html java.io.InputStream], an [[http://dcae.pub.ro/wikilabs/index.php/Java_Syntax;_A_Program%27s_Lexical_Structure#Abstract_Modifier abstract] class which offers generic read methods. The definition of the class is:
 <syntaxhighlight lang="Java">

@@ Linia 9: / Linia 9: @@
 == Console Streams ==
-Limbajul Java pune la dispoziția utilizatorului trei fluxuri standard pentru comunicare cu consola:
+In Java, all standard streams are accessible through class [http://docs.oracle.com/javase/7/docs/api/java/lang/System.html java.lang.System]. So, for standard input, there is [http://docs.oracle.com/javase/7/docs/api/java/lang/System.html#in System.in], for standard output there is [http://docs.oracle.com/javase/7/docs/api/java/lang/System.html#out System.out] and for standard error, there is [http://docs.oracle.com/javase/7/docs/api/java/lang/System.html#err System.err]. The three members '''in''', '''out''' and '''err''' of class '''System''' are static.
-În Java, toate fluxurile standard sunt accesate prin clasa '''java.lang.System'''. Astfel, pentru Standard Input există fluxul '''System.in''', pentru Standard Output, '''System.out''' iar pentru Standard Error, '''System.err'''. Cei trei membri '''in''', '''out''', '''err''' ai clasei '''System''' sunt statici.
+Classes that implement IO operations are placed in package [http://docs.oracle.com/javase/7/docs/api/java/io/package-summary.html java.io]. This package contains two categories of streams: bytes streams and character streams. Byte streams have been introduced from JDK version 1.0.2 and character streams are available since JDK 1.1. The latter ones do not replace, but complete stream functionality by being able to directly read and write characters (which in Java have 2 bytes each).
 == Fluxuri de intrare-ieșire la nivel de octet ==