クラスChannels

java.lang.Object
java.nio.channels.Channels
public final class Channels extends Object
チャネルとストリー のためのユーティリティ・メソッドです。

このクラスは、java.ioパッケージのストリー ・クラスとこのパッケージのチャネル・クラスの相互運用をサポートする静的メソッドを定義します。

導入されたバージョン:
1.4

  • メソッドの詳細

    • newInputStream

      public static InputStream newInputStream(ReadableByteChannel ch)
      指定されたチャネルからバイトを読み取るストリー を構築します。

      結果のストリー のreadおよびtransferToメソッドは、基礎となるチャネルが非ブロッキング・モードであるときに起動された 合、IllegalBlockingModeExceptionをスローします。 transferToメソッドは、非ブロッキング・モードで基礎となるチャネルに書込みを行う出力ストリー にバイトを転送するために呼び出された 合も、IllegalBlockingModeExceptionをスローします。 ストリー はバッファされず、markメソッドもresetメソッドもサポートしません。 ストリー は複数の並行スレッドからのアクセスに対して安全です。 ストリー をクローズするとチャネルもクローズします。

      パラメータ:
      ch - バイトが読み取られるチャネル
      戻り値:
      新しい入力ストリー 

    • newOutputStream

      public static OutputStream newOutputStream(WritableByteChannel ch)
      指定されたチャネルへバイトを書き込むストリー を構築します。

      基礎となるチャネルが非ブロッキング・モードであるときに呼び出された 合、結果のストリー のwriteメソッドはIllegalBlockingModeExceptionをスローします。 ストリー はバッファに書き込まれません。 ストリー は複数の並行スレッドからのアクセスに対して安全です。 ストリー をクローズするとチャネルもクローズします。

      パラメータ:
      ch - バイトが書き込まれるチャネル
      戻り値:
      新しい出力ストリー 

    • newInputStream

      public static InputStream newInputStream(AsynchronousByteChannel ch)
      指定されたチャネルからバイトを読み取るストリー を構築します。

      ストリー はバッファされず、markメソッドもresetメソッドもサポートしません。 ストリー は複数の並行スレッドからのアクセスに対して安全です。 ストリー をクローズするとチャネルもクローズします。

      パラメータ:
      ch - バイトが読み取られるチャネル
      戻り値:
      新しい入力ストリー 
      導入されたバージョン:
      1.7

    • newOutputStream

      public static OutputStream newOutputStream(AsynchronousByteChannel ch)
      指定されたチャネルへバイトを書き込むストリー を構築します。

      ストリー はバッファに書き込まれません。 ストリー は複数の並行スレッドからのアクセスに対して安全です。 ストリー をクローズするとチャネルもクローズします。

      パラメータ:
      ch - バイトが書き込まれるチャネル
      戻り値:
      新しい出力ストリー 
      導入されたバージョン:
      1.7

    • newChannel

      public static ReadableByteChannel newChannel(InputStream in)
      指定されたストリー からバイトを読み取るチャネルを構築します。

      結果として得られるチャネルはバッファされず、指定されたストリー に入出力操作をリダイレクトします。 結果のチャネルからの読取りは、入力ストリー から読み取られるため、入力が使用可能になるか、ファイルの終わりに達するまでブロックされます。 チャネルをクローズするとストリー もクローズします。

      パラメータ:
      in - バイトの読込み先ストリー 
      戻り値:
      新しい読込み可能なバイト・チャネル

    • newChannel

      public static WritableByteChannel newChannel(OutputStream out)
      指定されたストリー へバイトを書き込むチャネルを構築します。

      結果として得られるチャネルはバッファされず、指定されたストリー に入出力操作をリダイレクトします。 チャネルをクローズするとストリー もクローズします。

      パラメータ:
      out - バイトの書込み先ストリー 
      戻り値:
      新しい書込み可能なバイト・チャネル

    • newReader

      public static Reader newReader(ReadableByteChannel ch, CharsetDecoder dec, int minBufferCap)
      指定されたデコーダを使って指定されたチャネルからバイトをデコードするリーダーを構築します。

      結果のストリー には、少なくともminBufferCapバイトの内部入力バッファが含まれます。 ストリー のreadメソッドは、必要に応じて、基礎となるチャネルからバイトを読み取ることによってバッファを埋めます。バイトを読み取るときにチャネルが非ブロッキング・モードの 合、IllegalBlockingModeExceptionがスローされます。 結果として得られるストリー はそれ以外の点ではバッファされず、markメソッドもresetメソッドもサポートされません。 ストリー をクローズするとチャネルもクローズします。

      パラメータ:
      ch - バイトが読み取られるチャネル
      dec - 使用する文字セット・デコーダ
      minBufferCap - 内部バイト・バッファの最小容量。実装依存のデフォルト容量を使用する 合は-1
      戻り値:
      新しいリーダー

    • newReader

      public static Reader newReader(ReadableByteChannel ch, String csName)
      指定文字セットに従って指定されたチャネルからバイトをデコードするリーダーを構築します。

      次のフォー のメソッド呼出しは、 

          Channels.newReader(ch, csname)
      上記のメソッドは、次の表現と同様に動作します。 
          Channels.newReader(ch, Charset.forName(csName))

      パラメータ:
      ch - バイトが読み取られるチャネル
      csName - 使用する文字セットの名前
      戻り値:
      新しいリーダー
      スロー:
      UnsupportedCharsetException - 指定された文字セットが現在のJava仮想マシンでは利用できない 合

    • newReader

      public static Reader newReader(ReadableByteChannel ch, Charset charset)
      指定されたcharsetに従って、指定されたチャネルのバイトをデコードするリーダーを構築します。

      次のフォー のメソッド呼出しは、 

          Channels.newReader(ch, charset)
      上記のメソッドは、次の表現と同様に動作します。 
          Channels.newReader(ch, charset.newDecoder(), -1)

      不正な入力およびマッピング不可能な文字エラーに対するリーダーのデフォルトのアクションは、reportです。 エラー処理をより詳細に制御する必要がある 合は、CharsetDecoderを使用するコンストラクタを使用する必要があります。

      パラメータ:
      ch - バイトが読み取られるチャネル
      charset - 使用される文字セット
      戻り値:
      新しいリーダー
      導入されたバージョン:
      10

    • newWriter

      public static Writer newWriter(WritableByteChannel ch, CharsetEncoder enc, int minBufferCap)
      指定されたエンコーダを使って文字をエンコードし、結果として得られるバイトを指定されたチャネルに書き込むライターを構築します。

      結果のストリー には、少なくともminBufferCapバイトの内部出力バッファが含まれます。 ストリー のwriteメソッドは、必要に応じて、基礎となるチャネルにバイトを書き込むことによってバッファをフラッシュします。バイトを書き込むときにチャネルが非ブロッキング・モードの 合は、IllegalBlockingModeExceptionがスローされます。 結果として得られるストリー は、それ以外の点ではバッファされません。 ストリー をクローズするとチャネルもクローズします。

      実装上のノート:
      minBufferCapの値は無視されます。
      パラメータ:
      ch - バイトが書き込まれるチャネル
      enc - 使用する文字セット・エンコーダ
      minBufferCap - 内部バイト・バッファの最小容量。実装に依存するデフォルト容量を使用する 合は-1。 minBufferCapの値は無視できます。
      戻り値:
      新しいライター

    • newWriter

      public static Writer newWriter(WritableByteChannel ch, String csName)
      指定文字セットに従って文字をエンコードし、結果として得られるバイトを指定されたチャネルに書き込むライターを構築します。

      次のフォー のメソッド呼出しは、 

          Channels.newWriter(ch, csname)
      上記のメソッドは、次の表現と同様に動作します。 
          Channels.newWriter(ch, Charset.forName(csName))

      パラメータ:
      ch - バイトが書き込まれるチャネル
      csName - 使用する文字セットの名前
      戻り値:
      新しいライター
      スロー:
      UnsupportedCharsetException - 指定された文字セットが現在のJava仮想マシンでは利用できない 合

    • newWriter

      public static Writer newWriter(WritableByteChannel ch, Charset charset)
      指定された文字セットに従って文字を符号化し、結果のバイトを指定されたチャネルに書き込むライターを構築します。

      次のフォー のメソッド呼出しは、 

          Channels.newWriter(ch, charset)
      上記のメソッドは、次の表現と同様に動作します。 
          Channels.newWriter(ch, charset.newEncoder(), -1)

      不正な入力エラーおよびマップ不可文字エラーに対するライターのデフォルト・アクションは、reportです。 エラー処理をより詳細に制御する必要がある 合は、CharsetEncoderを使用するコンストラクタを使用する必要があります。

      パラメータ:
      ch - バイトが書き込まれるチャネル
      charset - 使用される文字セット
      戻り値:
      新しいライター
      導入されたバージョン:
      10