Buffer Klasse

Definition

[Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)]
public abstract class Buffer : Java.Lang.Object

[<Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)>]
type Buffer = class
    inherit Object

Vererbung

Object

JavaObject

Object

Buffer

Abgeleitet

Java.Nio.ByteBuffer

Java.Nio.CharBuffer

Java.Nio.DoubleBuffer

Java.Nio.FloatBuffer

Java.Nio.IntBuffer

Mehr…

Attribute

RegisterAttribute

Hinweise

Ein Container für Daten eines bestimmten Grundtyps.

Ein Puffer ist eine lineare, endliche Abfolge von Elementen eines bestimmten Grundtyps. Neben dem Inhalt sind die wesentlichen Eigenschaften eines Puffers die Kapazität, begrenzung und Position:

<Blockquote>

Die Kapazität eines Puffers ist die Anzahl der darin enthaltenen Elemente. Die Kapazität eines Puffers ist nie negativ und ändert sich nie.

Der Grenzwert eines Puffers ist der Index des ersten Elements, das nicht gelesen oder geschrieben werden soll. Der Grenzwert eines Puffers ist nie negativ und ist nie größer als seine Kapazität.

Die Position eines Puffers ist der Index des nächsten Elements, das gelesen oder geschrieben werden soll. Die Position eines Puffers ist nie negativ und ist nie größer als seine Grenze.

</blockquote>

Für jeden nicht booleschen Grundtyp gibt es eine Unterklasse dieser Klasse.

<h2> Übertragen von Daten </h2>

Jede Unterklasse dieser Klasse definiert zwei Kategorien von Get - und Put-Vorgängen :

<Blockquote>

Relative Vorgänge lesen oder schreiben ein oder mehrere Elemente beginnend an der aktuellen Position und erhöhen dann die Position um die Anzahl der übertragenen Elemente. Wenn die angeforderte Übertragung den Grenzwert überschreitet, löst ein relativer Get-Vorgang einen BufferUnderflowException und ein relativer Put-Vorgang löst einen BufferOverflowException; in beiden Fällen werden keine Daten übertragen.

Absolute Vorgänge nehmen einen expliziten Elementindex und wirken sich nicht auf die Position aus. Absolute get and put operations throw an IndexOutOfBoundsException if the index argument exceeds the limit.

</blockquote>

Daten können natürlich auch von den E/A-Vorgängen eines geeigneten Kanals, die immer relativ zur aktuellen Position sind, in oder aus einem Puffer übertragen werden.

<h2> Markieren und Zurücksetzen </h2>

Die Markierung eines Puffers ist der Index, auf den seine Position zurückgesetzt wird, wenn die #reset reset Methode aufgerufen wird. Die Markierung ist nicht immer definiert, aber wenn sie definiert wird, ist sie nie negativ und ist nie größer als die Position. Wenn die Markierung definiert ist, wird sie verworfen, wenn die Position oder der Grenzwert an einen Wert angepasst wird, der kleiner als die Marke ist. Wenn die Markierung nicht definiert ist, wird durch Aufrufen der #reset reset Methode ein InvalidMarkException Auslösen ausgelöst.

<h2> Invariants </h2>

Die folgenden invarianten Haltebereiche für die Werte für Mark, Position, Limit und Kapazität:

<Blockquote>0<=mark<=position<=limit<=capacity</blockquote>

Ein neu erstellter Puffer hat immer eine Position von Null und eine Markierung, die nicht definiert ist. Der anfängliche Grenzwert kann null sein, oder es kann ein anderer Wert sein, der vom Typ des Puffers und der Art und Weise abhängt, in der er erstellt wird. Jedes Element eines neu zugeordneten Puffers wird auf Null initialisiert.

<h2> Zusätzliche Vorgänge </h2>

Zusätzlich zu Methoden für den Zugriff auf positions-, limit- und kapazitätswerte sowie zum Markieren und Zurücksetzen definiert diese Klasse auch die folgenden Vorgänge bei Puffern:

<Ul>

<li>

#clear macht einen Puffer für eine neue Sequenz von Kanallese- oder relativen Put-Vorgängen bereit: Er legt den Grenzwert auf die Kapazität und die Position auf Null fest.

</li>

<li>

#flip macht einen Puffer für eine neue Sequenz von Kanalschreib- oder relativen Get-Vorgängen bereit: Er legt den Grenzwert auf die aktuelle Position fest und legt dann die Position auf Null fest.

</li>

<li>

#rewind macht einen Puffer bereit, um die bereits enthaltenen Daten erneut zu lesen: Er lässt den Grenzwert unverändert und legt die Position auf Null fest.

</li>

<li>

Die #slice Methoden #slice(int,int) slice(index,length) erstellen eine Untermenge eines Puffers: Sie lassen den Grenzwert und die Position unverändert.

</li>

<li>

#duplicate erstellt eine flache Kopie eines Puffers: Er hinterlässt den Grenzwert und die Position unverändert.

</li>

</ul>

<h2> Schreibgeschützte Puffer </h2>

Jeder Puffer ist lesbar, aber nicht jeder Puffer ist schreibbar. Die Mutationsmethoden jeder Pufferklasse werden als optionale Vorgänge angegeben, die beim Aufrufen eines schreibgeschützten Puffers einen ReadOnlyBufferException Auslösen auslösen. Ein schreibgeschützter Puffer lässt nicht zu, dass der Inhalt geändert werden kann, aber seine Markierung, Position und Grenzwerte sind änderbar. Gibt an, ob ein Puffer schreibgeschützt ist, kann durch Aufrufen seiner #isReadOnly isReadOnly Methode bestimmt werden.

<h2> Threadsicherheit </h2>

Puffer sind nicht für die Verwendung durch mehrere gleichzeitige Threads sicher. Wenn ein Puffer von mehr als einem Thread verwendet werden soll, sollte der Zugriff auf den Puffer durch die entsprechende Synchronisierung gesteuert werden.

<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; z. B. die Abfolge von Anweisungen

<Blockquote>

b.flip();
            b.position(23);
            b.limit(42);

</blockquote>

kann durch die einzelne, kompaktere Anweisung ersetzt werden

<Blockquote>

b.flip().position(23).limit(42);

</blockquote>

In 1.4 hinzugefügt.

Java Dokumentation für java.nio.Buffer.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.