ByteBuffer Класс

Определение

[Android.Runtime.Register("java/nio/ByteBuffer", DoNotGenerateAcw=true)]
public abstract class ByteBuffer : Java.Nio.Buffer, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IComparable

[<Android.Runtime.Register("java/nio/ByteBuffer", DoNotGenerateAcw=true)>]
type ByteBuffer = class
    inherit Buffer
    interface IComparable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Наследование

Object

Object

Buffer

ByteBuffer

Производный

Java.Nio.MappedByteBuffer

Атрибуты

RegisterAttribute

Реализации

IJavaObject IJavaPeerable IComparable IDisposable

Комментарии

Буфер байтов.

Этот класс определяет шесть категорий операций при буферах байтов:

<ul>

<Литий>

Абсолютные и относительные и методы #get() <i>get</i>#put(byte) <i>put</i> , которые считывают и записывают отдельные байты;

</Литий>

<Литий>

Относительные #get(byte[]) <i>bulk get</i> методы, которые передают смежные последовательности байтов из этого буфера в массив;

</Литий>

<Литий>

Относительные #put(byte[]) <i>bulk put</i> методы, которые передают последовательные последовательности байтов из массива байтов или другого буфера байтов в этот буфер;

</Литий>

<Литий>

Абсолютные и относительные #getChar() <i>get</i>#putChar(char) <i>put</i> и методы, которые считывают и записывают значения других примитивных типов, переводя их в последовательности байтов в определенном порядке байтов;

</Литий>

<Литий>

Методы создания буферов представления, позволяющие буферу байтов рассматриваться как буфер, содержащий значения другого примитивного типа;

</Литий>

<Литий>

Методы для #compact compacting, #duplicate duplicatingа также #slice slicing буфера байтов.

</Литий>

</ul>

Буферы байтов можно создать с помощью #allocate <i>allocation</i>этого буфера, который выделяет пространство для буфера.

содержимое или существующий #wrap(byte[]) <i>wrapping</i> массив байтов в буфер.

"direct"><h2> Direct и ненаправовые буферы </h2>

Буфер байтов — прямой или не прямой. Учитывая прямой буфер байтов, виртуальная машина Java сделает все возможное для выполнения собственных операций ввода-вывода непосредственно на нем. Т. е. он попытается избежать копирования содержимого буфера в промежуточный буфер до (или после) каждого вызова одной из собственных операций ввода-вывода базовой операционной системы.

Прямой буфер байтов может быть создан путем вызова #allocateDirect(int) allocateDirect метода фабрики этого класса. Буферы, возвращаемые этим методом, обычно имеют несколько более высокие затраты на выделение и распределение сделки, чем не прямые буферы. Содержимое прямых буферов может находиться за пределами обычной сборки мусора, поэтому их влияние на объем памяти приложения может оказаться не очевидным. Поэтому рекомендуется выделить прямые буферы в первую очередь для больших, длительных буферов, которые подвергаются собственным операциям ввода-вывода базовой системы. Как правило, рекомендуется выделять прямые буферы только в том случае, если они обеспечивают измеряемую производительность программы.

Прямой буфер байтов также может быть создан java.nio.channels.FileChannel#map mapping областью файла непосредственно в память. Реализация платформы Java может при необходимости поддерживать создание прямых буферов байтов из машинного кода с помощью JNI. Если экземпляр одного из этих типов буферов ссылается на недоступный регион памяти, попытка доступа к данному региону не изменит содержимое буфера и приведет к возникновению непреднамеренных исключений в момент доступа или в некоторое время.

Определяется ли буфер байтов прямым или ненаправным путем вызова метода #isDirect isDirect . Этот метод предоставляется таким образом, чтобы явное управление буферами можно было выполнять в критическом коде для производительности.

"bin"><h2 Access к двоичным данным </h2>>

Этот класс определяет методы для чтения и записи значений всех других примитивных типов, кроме boolean. Примитивные значения претворяются в последовательности байтов (или из) в соответствии с текущим порядком байтов буфера, которые могут быть извлечены и изменены с помощью #order order методов. Конкретные порядки байтов представлены экземплярами ByteOrder класса. Начальный порядок буфера байтов всегда ByteOrder#BIG_ENDIAN BIG_ENDIAN.

Для доступа к разнородным двоичным данным, то есть последовательности значений разных типов, этот класс определяет семейство абсолютных и относительных методов получения и помещать методы для каждого типа. Например, для 32-разрядных значений с плавающей запятой этот класс определяет:

<blockquote>

float  {@link #getFloat()}
            float  {@link #getFloat(int) getFloat(int index)}
             void  {@link #putFloat(float) putFloat(float f)}
             void  {@link #putFloat(int,float) putFloat(int index, float f)}

</blockquote>

Соответствующие методы определяются для типовchar, short, , intи longdouble. Параметры индекса абсолютного метода get и put являются с точки зрения байтов, а не типа, считываемого или записанного.

"представления">

Для доступа к однородным двоичным данным, то есть последовательности значений одного типа, этот класс определяет методы, которые могут создавать представления заданного буфера байтов. Буфер представления — это просто другой буфер, содержимое которого поддерживается буфером байтов. Изменения содержимого буфера байтов будут отображаться в буфере представления, и наоборот; Положение, ограничение и метки двух буферов являются независимыми. Например #asFloatBuffer() asFloatBuffer , метод создает экземпляр FloatBuffer класса, который поддерживается буфером байтов, на котором вызывается метод. Соответствующие методы создания представлений определяются для типов char, , short, intи longdouble.

Буферы представления имеют три важных преимущества по сравнению с семействами типов получения и установки методов, описанных выше:

<ul>

<Литий>

Буфер представления индексируется не с точки зрения байтов, а скорее с точки зрения размера его значений, зависящих от типа;

</Литий>

<Литий>

Буфер представления предоставляет относительные методы массового получения и помещать методы, которые могут передавать последовательные последовательности значений между буфером и массивом или другим буфером того же типа;

</Литий>

<Литий>

Буфер представления может быть гораздо эффективнее, так как он будет прямым, если, и только если его резервный буфер байтов является прямым.

</Литий>

</ul>

Порядок байтов буфера представления фиксирован таким образом, чтобы его буфер байтов был создан во время создания представления.

<цепочка вызовов <h2> /h2>

Методы в этом классе, которые не имеют возвращаемого значения, указываются для возврата буфера, при котором они вызываются. Это позволяет выполнять цепочку вызовов методов.

Последовательность операторов

<blockquote>

bb.putInt(0xCAFEBABE);
            bb.putShort(3);
            bb.putShort(45);

</blockquote>

может, например, замениться одной инструкцией

<blockquote>

bb.putInt(0xCAFEBABE).putShort(3).putShort(45);

</blockquote>

Добавлено в версии 1.4.

Документация по Java для java.nio.ByteBuffer.

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Методы расширения

Применяется к