SSLEngine.Wrap Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| Wrap(ByteBuffer, ByteBuffer) |
Versucht, einen Puffer von Nur-Text-Anwendungsdaten in SSL/TLS-Netzwerkdaten zu codieren. |
| Wrap(ByteBuffer[], ByteBuffer) |
Versucht, Nur-Text-Bytes aus einer Abfolge von Datenpuffern in SSL/TLS-Netzwerkdaten zu codieren. |
| Wrap(ByteBuffer[], Int32, Int32, ByteBuffer) |
Versucht, Nur-Text-Bytes aus einer Untermenge von Datenpuffern in SSL/TLS-Netzwerkdaten zu codieren. |
Wrap(ByteBuffer, ByteBuffer)
Versucht, einen Puffer von Nur-Text-Anwendungsdaten in SSL/TLS-Netzwerkdaten zu codieren.
[Android.Runtime.Register("wrap", "(Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_Ljava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")]
public virtual Javax.Net.Ssl.SSLEngineResult? Wrap(Java.Nio.ByteBuffer? src, Java.Nio.ByteBuffer? dst);
[<Android.Runtime.Register("wrap", "(Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_Ljava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")>]
abstract member Wrap : Java.Nio.ByteBuffer * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResult
override this.Wrap : Java.Nio.ByteBuffer * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResult
Parameter
- src
- ByteBuffer
ein ByteBuffer enthaltende ausgehende Anwendungsdaten
- dst
- ByteBuffer
a ByteBuffer to hold outbound network data
Gibt zurück
ein SSLEngineResult Beschreiben des Ergebnisses dieses Vorgangs.
- Attribute
Ausnahmen
wenn beim Verarbeiten der Daten ein Problem aufgetreten ist.
wenn der Zielpuffer schreibgeschützt ist.
wenn src oder dst ist null.
wenn das Modul nicht über alle erforderlichen Einstellungen verfügt (z. B. Client-/Servermodus nicht festgelegt).
Hinweise
Versucht, einen Puffer von Nur-Text-Anwendungsdaten in SSL/TLS-Netzwerkdaten zu codieren.
Ein Aufruf dieser Methode verhält sich genauso wie der Aufruf: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(new ByteBuffer [] { src }, 0, 1, dst);}
</blockquote>
Java Dokumentation für javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer, java.nio.ByteBuffer).
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.
Gilt für:
Wrap(ByteBuffer[], ByteBuffer)
Versucht, Nur-Text-Bytes aus einer Abfolge von Datenpuffern in SSL/TLS-Netzwerkdaten zu codieren.
[Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")]
public virtual Javax.Net.Ssl.SSLEngineResult? Wrap(Java.Nio.ByteBuffer[]? srcs, Java.Nio.ByteBuffer? dst);
[<Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")>]
abstract member Wrap : Java.Nio.ByteBuffer[] * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResult
override this.Wrap : Java.Nio.ByteBuffer[] * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResult
Parameter
- srcs
- ByteBuffer[]
ein Array mit ByteBuffers den ausgehenden Anwendungsdaten
- dst
- ByteBuffer
a ByteBuffer to hold outbound network data
Gibt zurück
ein SSLEngineResult Beschreiben des Ergebnisses dieses Vorgangs.
- Attribute
Ausnahmen
wenn beim Verarbeiten der Daten ein Problem aufgetreten ist.
wenn der Zielpuffer schreibgeschützt ist.
wenn srcs oder dst ist null.
wenn das Modul nicht über alle erforderlichen Einstellungen verfügt (z. B. Client-/Servermodus nicht festgelegt).
Hinweise
Versucht, Nur-Text-Bytes aus einer Abfolge von Datenpuffern in SSL/TLS-Netzwerkdaten zu codieren.
Ein Aufruf dieser Methode verhält sich genauso wie der Aufruf: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(srcs, 0, srcs.length, dst);}
</blockquote>
Java Dokumentation für javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer[], java.nio.ByteBuffer).
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.
Gilt für:
Wrap(ByteBuffer[], Int32, Int32, ByteBuffer)
Versucht, Nur-Text-Bytes aus einer Untermenge von Datenpuffern in SSL/TLS-Netzwerkdaten zu codieren.
[Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;IILjava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_IILjava_nio_ByteBuffer_Handler")]
public abstract Javax.Net.Ssl.SSLEngineResult? Wrap(Java.Nio.ByteBuffer[]? srcs, int offset, int length, Java.Nio.ByteBuffer? dst);
[<Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;IILjava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_IILjava_nio_ByteBuffer_Handler")>]
abstract member Wrap : Java.Nio.ByteBuffer[] * int * int * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResult
Parameter
- srcs
- ByteBuffer[]
ein Array mit ByteBuffers den ausgehenden Anwendungsdaten
- offset
- Int32
Der Offset innerhalb des Pufferarrays des ersten Puffers, aus dem Bytes abgerufen werden sollen; sie darf nicht negativ und nicht größer als srcs.length
- length
- Int32
Die maximale Anzahl von Puffern, auf die zugegriffen werden soll; sie darf nicht negativ und nicht größer als srcs.length - offset
- dst
- ByteBuffer
a ByteBuffer to hold outbound network data
Gibt zurück
ein SSLEngineResult Beschreiben des Ergebnisses dieses Vorgangs.
- Attribute
Ausnahmen
wenn beim Verarbeiten der Daten ein Problem aufgetreten ist.
wenn length größer als srcs.length - offset.
wenn der Zielpuffer schreibgeschützt ist.
if srcs, dst, oder einer der Einträge in srcs ist .null
wenn das Modul nicht über alle erforderlichen Einstellungen verfügt (z. B. Client-/Servermodus nicht festgelegt).
Hinweise
Versucht, Nur-Text-Bytes aus einer Untermenge von Datenpuffern in SSL/TLS-Netzwerkdaten zu codieren. Dieser "Gathering"- Vorgang codiert in einem einzelnen Aufruf eine Abfolge von Bytes aus einer oder mehreren einer bestimmten Sequenz von Puffern. Das Sammeln von Umbruchumbruchen ist häufig hilfreich, wenn Netzwerkprotokolle oder Dateiformate implementiert werden, die z. B. Daten in Segmente gruppieren, die aus einem oder mehreren Headern mit fester Länge bestehen, gefolgt von einem Textkörper mit variabler Länge. Weitere Informationen zum Sammeln und java.nio.channels.GatheringByteChannel#write(ByteBuffer[], int, int) weitere Informationen zum Subsequence-Verhalten finden Sie java.nio.channels.GatheringByteChannel unter .
Abhängig vom Status der SSLEngine kann diese Methode Netzwerkdaten erzeugen, ohne Anwendungsdaten zu verbrauchen (z. B. kann es Handshake-Daten generieren.)
Die Anwendung ist dafür verantwortlich, die Netzwerkdaten zuverlässig an den Peer zu transportieren und sicherzustellen, dass daten, die von mehreren Aufrufen von Wrap() erstellt wurden, in derselben Reihenfolge transportiert werden, in der sie generiert wurde. Die Anwendung muss mehrere Aufrufe dieser Methode ordnungsgemäß synchronisieren.
Wenn dies SSLEngine noch nicht den ersten Handshake gestartet hat, startet diese Methode automatisch den Handshake.
Diese Methode versucht, SSL/TLS-Einträge zu erstellen und verbraucht so viele Quelldaten wie möglich, verbraucht aber niemals mehr als die Summe der in jedem Puffer verbleibenden Bytes. Jede ByteBufferPosition wird aktualisiert, um die Menge der verbrauchten oder produzierten Daten widerzuspiegeln. Die Grenzwerte bleiben unverändert.
Der zugrunde liegende Arbeitsspeicher, der von den srcs und dst ByteBufferden n verwendet wird, darf nicht identisch sein.
Weitere Informationen zum Schließen des Moduls finden Sie in der Klassenbeschreibung.
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.