- java.lang.Object
-
- java.nio.channels.Channels
-
-
Method Summary
Methods Modifier and Type Method and Description static ReadableByteChannel
newChannel(InputStream in)
Constructs a channel that reads bytes from the given stream.static WritableByteChannel
newChannel(OutputStream out)
Constructs a channel that writes bytes to the given stream.static InputStream
newInputStream(AsynchronousByteChannel ch)
Constructs a stream that reads bytes from the given channel.static InputStream
newInputStream(ReadableByteChannel ch)
Constructs a stream that reads bytes from the given channel.static OutputStream
newOutputStream(AsynchronousByteChannel ch)
Constructs a stream that writes bytes to the given channel.static OutputStream
newOutputStream(WritableByteChannel ch)
Constructs a stream that writes bytes to the given channel.static Reader
newReader(ReadableByteChannel ch, CharsetDecoder dec, int minBufferCap)
Constructs a reader that decodes bytes from the given channel using the given decoder.static Reader
newReader(ReadableByteChannel ch, String csName)
Constructs a reader that decodes bytes from the given channel according to the named charset.static Writer
newWriter(WritableByteChannel ch, CharsetEncoder enc, int minBufferCap)
Constructs a writer that encodes characters using the given encoder and writes the resulting bytes to the given channel.static Writer
newWriter(WritableByteChannel ch, String csName)
Constructs a writer that encodes characters according to the named charset and writes the resulting bytes to the given channel.
-
-
-
Method Detail
-
newInputStream
public static InputStream newInputStream(ReadableByteChannel ch)
Constructs a stream that reads bytes from the given channel.The read methods of the resulting stream will throw an
IllegalBlockingModeException
if invoked while the underlying channel is in non-blocking mode. The stream will not be buffered, and it will not support themark
orreset
methods. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.- Parameters:
ch
- The channel from which bytes will be read- Returns:
- A new input stream
-
newOutputStream
public static OutputStream newOutputStream(WritableByteChannel ch)
Constructs a stream that writes bytes to the given channel.The write methods of the resulting stream will throw an
IllegalBlockingModeException
if invoked while the underlying channel is in non-blocking mode. The stream will not be buffered. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.- Parameters:
ch
- The channel to which bytes will be written- Returns:
- A new output stream
-
newInputStream
public static InputStream newInputStream(AsynchronousByteChannel ch)
Constructs a stream that reads bytes from the given channel.The stream will not be buffered, and it will not support the
mark
orreset
methods. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.- Parameters:
ch
- The channel from which bytes will be read- Returns:
- A new input stream
- Since:
- 1.7
-
newOutputStream
public static OutputStream newOutputStream(AsynchronousByteChannel ch)
Constructs a stream that writes bytes to the given channel.The stream will not be buffered. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.
- Parameters:
ch
- The channel to which bytes will be written- Returns:
- A new output stream
- Since:
- 1.7
-
newChannel
public static ReadableByteChannel newChannel(InputStream in)
Constructs a channel that reads bytes from the given stream.The resulting channel will not be buffered; it will simply redirect its I/O operations to the given stream. Closing the channel will in turn cause the stream to be closed.
- Parameters:
in
- The stream from which bytes are to be read- Returns:
- A new readable byte channel
-
newChannel
public static WritableByteChannel newChannel(OutputStream out)
Constructs a channel that writes bytes to the given stream.The resulting channel will not be buffered; it will simply redirect its I/O operations to the given stream. Closing the channel will in turn cause the stream to be closed.
- Parameters:
out
- The stream to which bytes are to be written- Returns:
- A new writable byte channel
-
newReader
public static Reader newReader(ReadableByteChannel ch, CharsetDecoder dec, int minBufferCap)
Constructs a reader that decodes bytes from the given channel using the given decoder.The resulting stream will contain an internal input buffer of at least minBufferCap bytes. The stream's read methods will, as needed, fill the buffer by reading bytes from the underlying channel; if the channel is in non-blocking mode when bytes are to be read then an
IllegalBlockingModeException
will be thrown. The resulting stream will not otherwise be buffered, and it will not support themark
orreset
methods. Closing the stream will in turn cause the channel to be closed.- Parameters:
ch
- The channel from which bytes will be readdec
- The charset decoder to be usedminBufferCap
- The minimum capacity of the internal byte buffer, or -1 if an implementation-dependent default capacity is to be used- Returns:
- A new reader
-
newReader
public static Reader newReader(ReadableByteChannel ch, String csName)
Constructs a reader that decodes bytes from the given channel according to the named charset.An invocation of this method of the form
behaves in exactly the same way as the expressionChannels.newReader(ch, csname)
Channels.newReader(ch, Charset.forName(csName) .newDecoder(), -1);
- Parameters:
ch
- The channel from which bytes will be readcsName
- The name of the charset to be used- Returns:
- A new reader
- Throws:
UnsupportedCharsetException
- If no support for the named charset is available in this instance of the Java virtual machine
-
newWriter
public static Writer newWriter(WritableByteChannel ch, CharsetEncoder enc, int minBufferCap)
Constructs a writer that encodes characters using the given encoder and writes the resulting bytes to the given channel.The resulting stream will contain an internal output buffer of at least minBufferCap bytes. The stream's write methods will, as needed, flush the buffer by writing bytes to the underlying channel; if the channel is in non-blocking mode when bytes are to be written then an
IllegalBlockingModeException
will be thrown. The resulting stream will not otherwise be buffered. Closing the stream will in turn cause the channel to be closed.- Parameters:
ch
- The channel to which bytes will be writtenenc
- The charset encoder to be usedminBufferCap
- The minimum capacity of the internal byte buffer, or -1 if an implementation-dependent default capacity is to be used- Returns:
- A new writer
-
newWriter
public static Writer newWriter(WritableByteChannel ch, String csName)
Constructs a writer that encodes characters according to the named charset and writes the resulting bytes to the given channel.An invocation of this method of the form
behaves in exactly the same way as the expressionChannels.newWriter(ch, csname)
Channels.newWriter(ch, Charset.forName(csName) .newEncoder(), -1);
- Parameters:
ch
- The channel to which bytes will be writtencsName
- The name of the charset to be used- Returns:
- A new writer
- Throws:
UnsupportedCharsetException
- If no support for the named charset is available in this instance of the Java virtual machine
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
06/11/2024 00:13:38 Cette version de la page est en cache (à la date du 06/11/2024 00:13:38) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 27/07/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/nio/channels/channels.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.