ByteArrayOutputStream (Платформа Java SE 7)

java.lang. Объект
- java.io. OutputStream
- - java.io. ByteArrayOutputStream

Все Реализованные Интерфейсы:

Closeable, Flushable, AutoCloseable
```
public class ByteArrayOutputStream
extends OutputStream
```
Этот класс реализует поток вывода, в котором данные пишутся в байтовый массив. Буфер автоматически растет, поскольку данные пишутся ему. Данные могут быть получены, используя toByteArray() и toString().
Закрытие ByteArrayOutputStream не имеет никакого эффекта. Методы в этом классе можно вызвать после того, как поток был закрыт, не генерируя IOException.

С тех пор:

JDK1.0

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected byte[]`	`buf` Буфер, где данные хранятся.
`protected int`	`количество` Число допустимых байтов в буфере.

Сводка конструктора

Конструкторы
Конструктор и Описание
`ByteArrayOutputStream()` Создает новый поток вывода байтового массива.
`ByteArrayOutputStream(int size)` Создает новый поток вывода байтового массива, с буферностью указанного размера, в байтах.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`close()` Закрытие `ByteArrayOutputStream` не имеет никакого эффекта.
`void`	`reset()` Сбросы `count` поле этого потока вывода байтового массива, чтобы обнулить, так, чтобы весь в настоящий момент накопленный вывод в потоке вывода был отброшен.
`int`	`size()` Возвращает текущий размер буфера.
`byte[]`	`toByteArray()` Создает недавно выделенный байтовый массив.
`Строка`	`toString()` Преобразовывает содержание буфера в строку, декодирующую байты, используя набор символов платформы по умолчанию.
`Строка`	`toString(int hibyte)` Осуждаемый. Этот метод должным образом не преобразовывает байты в символы. С JDK 1.1, привилегированный способ сделать это через `toString(String enc)` метод, который берет параметр имени кодирования, или `toString()` метод, который использует кодировку символов платформы по умолчанию.
`Строка`	`toString(String charsetName)` Преобразовывает содержание буфера в строку, декодируя байты, используя указанное `charsetName`.
`void`	`write(byte[] b, int off, int len)` Записи `len` байты от указанного байтового массива, запускающегося при смещении `off` к этому потоку вывода байтового массива.
`void`	`write(int b)` Пишет указанный байт в этот поток вывода байтового массива.
`void`	`writeTo(OutputStream out)` Пишет полное содержание этого потока вывода байтового массива к указанному параметру потока вывода, как будто, вызывая использование метода записи потока вывода `out.write(buf, 0, count)`.

Методы java.io унаследованный от класса. OutputStream
flush, write

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - buf
```
protected byte[] buf
```
    Буфер, где данные хранятся.
  - количество
```
protected int count
```
    Число допустимых байтов в буфере.
- Деталь конструктора
  - ByteArrayOutputStream
```
public ByteArrayOutputStream()
```
    Создает новый поток вывода байтового массива. Буферность - первоначально 32 байта, хотя ее размер увеличивается в случае необходимости.
  - ByteArrayOutputStream
```
public ByteArrayOutputStream(int size)
```
    Создает новый поток вывода байтового массива, с буферностью указанного размера, в байтах.
    
    Параметры:
    size - начальный размер.
    
    Броски:
    
    IllegalArgumentException - если размер отрицателен.
- Деталь метода
  - записать
```
public void write(int b)
```
    Пишет указанный байт в этот поток вывода байтового массива.
    
    Определенный:
    
    write в классе OutputStream
    
    Параметры:
    b - байт, который будет записан.
  - записать
```
public void write(byte[] b,
         int off,
         int len)
```
    Записи len байты от указанного байтового массива, запускающегося при смещении off к этому потоку вывода байтового массива.
    
    Переопределения:
    
    write в классе OutputStream
    
    Параметры:
    b - данные.
    off - запуск смещается в данных.
    len - число байтов, чтобы записать.
  - writeTo
```
public void writeTo(OutputStream out)
             throws IOException
```
    Пишет полное содержание этого потока вывода байтового массива к указанному параметру потока вывода, как будто, вызывая использование метода записи потока вывода out.write(buf, 0, count).
    
    Параметры:
    out - поток вывода, в который можно записать данные.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - сброс
```
public void reset()
```
    Сбросы count поле этого потока вывода байтового массива, чтобы обнулить, так, чтобы весь в настоящий момент накопленный вывод в потоке вывода был отброшен. Поток вывода может использоваться снова, снова используя уже выделенное пространство буфера.
    
    См. Также:
    ByteArrayInputStream.count
  - toByteArray
```
public byte[] toByteArray()
```
    Создает недавно выделенный байтовый массив. Его размер является текущим размером этого потока вывода, и допустимое содержание буфера было скопировано в это.
    
    Возвраты:
    текущее содержание этого потока вывода, как байтовый массив.
    См. Также:
    size()
  - размер
```
public int size()
```
    Возвращает текущий размер буфера.
    
    Возвраты:
    значение count поле, которое является числом допустимых байтов в этом потоке вывода.
    См. Также:
    count
  - toString
```
public String toString()
```
    Преобразовывает содержание буфера в строку, декодирующую байты, используя набор символов платформы по умолчанию. Длина нового String является функцией набора символов, и следовательно, возможно, не равна размеру буфера.
    Этот метод всегда заменяет уродливый ввод и неотображаемо-символьные последовательности с заменяющей строкой по умолчанию для набора символов платформы по умолчанию. Класс CharsetDecoder должен использоваться, когда больше управления процессом декодирования требуется.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    Строка декодируется от содержания буфера.
    С тех пор:
    
    JDK1.1
  - toString
```
public String toString(String charsetName)
                throws UnsupportedEncodingException
```
    Преобразовывает содержание буфера в строку, декодируя байты, используя указанное charsetName. Длина нового String является функцией набора символов, и следовательно, возможно, не равна длине байтового массива.
    Этот метод всегда заменяет уродливый ввод и неотображаемо-символьные последовательности с заменяющей строкой этого набора символов по умолчанию. CharsetDecoder класс должен использоваться, когда больше управления процессом декодирования требуется.
    
    Параметры:
    charsetName - имя поддерживаемого набор символов
    Returns: String decoded from the buffer's contents. Throws: UnsupportedEncodingException - If the named charset is not supported Since: JDK1.1
  toString @Deprecated public String toString(int hibyte) Deprecated. This method does not properly convert bytes into characters. As of JDK 1.1, the preferred way to do this is via the toString(String enc) method, which takes an encoding-name argument, or the toString() method, which uses the platform's default character encoding. Creates a newly allocated string. Its size is the current size of the output stream and the valid contents of the buffer have been copied into it. Each character c in the resulting string is constructed from the corresponding element b in the byte array such that: c == (char)(((hibyte & 0xff) << 8) | (b & 0xff)) Parameters: hibyte - the high byte of each resulting Unicode character. Returns: the current contents of the output stream, as a string. See Also: size(), toString(String), toString() close public void close() throws IOException Closing a ByteArrayOutputStream has no effect. The methods in this class can be called after the stream has been closed without generating an IOException. Specified by: close in interface Closeable Specified by: close in interface AutoCloseable Overrides: close in class OutputStream Throws: IOException - if an I/O error occurs.

Класс ByteArrayOutputStream

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.io унаследованный от класса. OutputStream

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

buf

количество

Деталь конструктора

ByteArrayOutputStream

ByteArrayOutputStream

Деталь метода

записать

записать

writeTo

сброс

toByteArray

размер

toString

toString

toString

close