ByteBuffer Klasse

Definition

[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

Vererbung

Object

Object

Buffer

ByteBuffer

Abgeleitet

Java.Nio.MappedByteBuffer

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IComparable IDisposable

Hinweise

Ein Bytepuffer.

Diese Klasse definiert sechs Kategorien von Vorgängen auf Bytepuffern:

<ul>

<Li>

Absolute und relative #get() <i>get</i> Methoden #put(byte) <i>put</i> , die einzelne Bytes lesen und schreiben;

</Li>

<Li>

Relative #get(byte[]) <i>bulk get</i> Methoden, die zusammenhängende Bytesequenzen aus diesem Puffer in ein Array übertragen;

</Li>

<Li>

Relative #put(byte[]) <i>bulk put</i> Methoden, die zusammenhängende Bytesequenzen aus einem Bytearray oder einen anderen Bytepuffer in diesen Puffer übertragen;

</Li>

<Li>

Absolute und relative #getChar() <i>get</i> Methoden #putChar(char) <i>put</i> , die Werte anderer Grundtypen lesen und schreiben, sie in Bytereihenfolgen in eine bestimmte Bytereihenfolge übersetzen und aus diesen schreiben;

</Li>

<Li>

Methoden zum Erstellen von Ansichtspuffern, mit denen ein Bytepuffer als Puffer angezeigt werden kann, der Werte eines anderen Grundtyps enthält; und

</Li>

<Li>

Methoden für #compact compacting, #duplicate duplicating, und #slice slicing ein Bytepuffer.

</Li>

</ul>

Bytepuffer können entweder durch #allocate <i>allocation</i>erstellt werden, wodurch Speicherplatz für die Puffer zugewiesen wird.

Inhalt oder durch #wrap(byte[]) <i>wrapping</i> ein vorhandenes Bytearray in einen Puffer.

"direct"><h2> Direct vs. non-direct buffers </h2>

Ein Bytepuffer ist entweder direkt oder nicht direkt. Angesichts eines direkten Bytepuffers versucht der virtuelle Java-Computer, systemeigene E/A-Vorgänge direkt darauf auszuführen. Das heißt, es wird versucht, das Kopieren des Inhalts des Puffers in einen Zwischenpuffer vor (oder nach) jedem Aufruf einer der systemeigenen E/A-Vorgänge des zugrunde liegenden Betriebssystems zu vermeiden.

Ein direkter Bytepuffer kann durch Aufrufen der #allocateDirect(int) allocateDirect Factorymethode dieser Klasse erstellt werden. Die von dieser Methode zurückgegebenen Puffer weisen in der Regel etwas höhere Zuordnungs- und Deallocation-Kosten auf als nicht direkte Puffer. Der Inhalt von direkten Puffern kann sich außerhalb des normalen garbage-collection heap befinden, sodass ihre Auswirkungen auf den Speicherbedarf einer Anwendung möglicherweise nicht offensichtlich sind. Daher wird empfohlen, direkte Puffer hauptsächlich für große, langlebige Puffer zuzuordnen, die den systemeigenen E/A-Vorgängen des zugrunde liegenden Systems unterliegen. Im Allgemeinen empfiehlt es sich, direkte Puffer nur zuzuweisen, wenn sie eine messbare Verstärkung der Programmleistung erzielen.

Ein direkter Bytepuffer kann auch von java.nio.channels.FileChannel#map mapping einem Bereich einer Datei direkt in den Arbeitsspeicher erstellt werden. Eine Implementierung der Java-Plattform kann optional die Erstellung von direkten Bytepuffern aus systemeigenem Code über JNI unterstützen. Wenn eine Instanz dieser Arten von Puffern auf einen nicht zugänglichen Speicherbereich verweist, ändert ein Versuch, auf diesen Bereich zuzugreifen, den Inhalt des Puffers nicht und führt zu einer nicht angegebenen Ausnahme, die entweder zum Zeitpunkt des Zugriffs oder zu einem späteren Zeitpunkt ausgelöst wird.

Ob ein Bytepuffer direkt oder nicht direkt ist, kann durch aufrufende #isDirect isDirect Methode bestimmt werden. Diese Methode wird bereitgestellt, damit die explizite Pufferverwaltung im leistungskritischen Code erfolgen kann.

"bin"><h2> Access to binary data </h2>

Diese Klasse definiert Methoden zum Lesen und Schreiben von Werten aller anderen Grundtypen mit Ausnahme booleanvon . Primitive Werte werden gemäß der aktuellen Bytereihenfolge des Puffers in Bytesequenzen (oder aus) übersetzt, die über die #order order Methoden abgerufen und geändert werden können. Bestimmte Bytereihenfolgen werden durch Instanzen der ByteOrder Klasse dargestellt. Die anfängliche Reihenfolge eines Bytepuffers ist immer ByteOrder#BIG_ENDIAN BIG_ENDIAN.

Für den Zugriff auf heterogene Binärdaten, d. h. Sequenzen von Werten unterschiedlicher Typen, definiert diese Klasse eine Familie absoluter und relativer Get - und Put-Methoden für jeden Typ. Für 32-Bit-Gleitkommawerte definiert diese Klasse beispielsweise Folgendes:

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

Entsprechende Methoden werden für die Typen char, short, , int, longund double. Die Indexparameter der absoluten Get - und Put-Methoden beziehen sich auf Bytes und nicht auf den Typ, der gelesen oder geschrieben wird.

"Views">

Für den Zugriff auf homogene Binärdaten, d. h. Sequenzen von Werten desselben Typs, definiert diese Klasse Methoden, die Ansichten eines bestimmten Bytepuffers erstellen können. Ein Ansichtspuffer ist einfach ein anderer Puffer, dessen Inhalt vom Bytepuffer unterstützt wird. Änderungen am Inhalt des Bytepuffers werden im Ansichtspuffer angezeigt und umgekehrt; Die Position, das Limit und die Markierungswerte der beiden Puffer sind unabhängig. Die #asFloatBuffer() asFloatBuffer Methode erstellt z. B. eine Instanz der FloatBuffer Klasse, die vom Bytepuffer unterstützt wird, auf dem die Methode aufgerufen wird. Entsprechende Ansichtserstellungsmethoden werden für die Typen char, , , int, und longdouble. short

Ansichtspuffer haben drei wichtige Vorteile gegenüber den familienspezifischen Get - und Put-Methoden , die oben beschrieben werden:

<ul>

<Li>

Ein Ansichtspuffer wird nicht in Bezug auf Bytes, sondern in Bezug auf die typspezifische Größe seiner Werte indiziert;

</Li>

<Li>

Ein Ansichtspuffer bietet relative Massenvorgänge und Put-Methoden, mit denen zusammenhängende Werteabfolgen zwischen einem Puffer und einem Array oder einem anderen Puffer desselben Typs übertragen werden können;

</Li>

<Li>

Ein Ansichtspuffer ist potenziell viel effizienter, da er direkt ist, wenn und nur dann, wenn der zugrunde liegende Bytepuffer direkt ist.

</Li>

</ul>

Die Bytereihenfolge eines Ansichtspuffers wird so festgelegt, dass er zum Zeitpunkt der Erstellung der Ansicht dem Bytepuffer entspricht.

<h2> Aufrufverkettung </h2>

Methoden in dieser Klasse, die andernfalls keinen Wert zurückgeben sollen, werden angegeben, um den Puffer zurückzugeben, für den sie aufgerufen werden. Dadurch können Methodenaufrufe verkettet werden.

Die Abfolge von Anweisungen

<Blockquote>

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

</blockquote>

kann z. B. durch die einzelne Anweisung ersetzt werden.

<Blockquote>

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

</blockquote>

In 1.4 hinzugefügt.

Java-Dokumentation für java.nio.ByteBuffer.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für: