モジュール java.desktop
パッケージ javax.sound.sampled.spi

クラスAudioFileWriter

java.lang.Object
javax.sound.sampled.spi.AudioFileWriter
public abstract class AudioFileWriter extends Object
オーディオ・ファイル書込みサービスのプロバイダです。 具象実装を提供するクラスは、オーディオ・ストリームから1種類かそれ以上のオーディオ・ファイルに書き込むことができます。
導入されたバージョン:
1.3

  • コンストラクタのサマリー

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    AudioFileWriter()
    サブクラスが呼び出すためのコンストラクタ。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract AudioFileFormat.Type[]
    getAudioFileTypes()
    このオーディオ・ファイル・ライターがファイル書込みサポートを提供するファイル・タイプを取得します。
    abstract AudioFileFormat.Type[]
    getAudioFileTypes​(AudioInputStream stream)
    指定されたオーディオ入力ストリームからこのオーディオ・ファイル・ライターが書込みできるファイル・タイプを取得します。
    boolean
    isFileTypeSupported​(AudioFileFormat.Type fileType)
    指定されたファイル・タイプのファイル書込みサポートをこのオーディオ・ファイル・ライターが提供しているかどうかを示します。
    boolean
    isFileTypeSupported​(AudioFileFormat.Type fileType, AudioInputStream stream)
    指定されたタイプのオーディオ・ファイルを示されたオーディオ入力ストリームから書込み可能かどうかを示します。
    abstract int
    write​(AudioInputStream stream, AudioFileFormat.Type fileType, File out)
    指定されたファイル形式のオーディオ・ファイルを表すバイト・ストリームを、指定された外部ファイルへ書き込みます。
    abstract int
    write​(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out)
    指定されたファイル・タイプのオーディオ・ファイルを表すバイトのストリームを、指定された出力ストリームへ書き込みます。

    クラス java.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • コンストラクタの詳細

    • AudioFileWriter

      protected AudioFileWriter()
      サブクラスが呼び出すためのコンストラクタ。

  • メソッドの詳細

    • getAudioFileTypes

      public abstract AudioFileFormat.Type[] getAudioFileTypes()
      このオーディオ・ファイル・ライターがファイル書込みサポートを提供するファイル・タイプを取得します。
      戻り値:
      ファイル・タイプの配列。 サポートされているファイル・タイプがない場合、長さ0の配列が返される。

    • isFileTypeSupported

      public boolean isFileTypeSupported​(AudioFileFormat.Type fileType)
      指定されたファイル・タイプのファイル書込みサポートをこのオーディオ・ファイル・ライターが提供しているかどうかを示します。
      パラメータ:
      fileType - 書込み機能が照会されるファイル・タイプ
      戻り値:
      ファイル・タイプがサポートされている場合はtrue、そうでない場合はfalse
      例外:
      NullPointerException - fileTypeがnullの場合

    • getAudioFileTypes

      public abstract AudioFileFormat.Type[] getAudioFileTypes​(AudioInputStream stream)
      指定されたオーディオ入力ストリームからこのオーディオ・ファイル・ライターが書込みできるファイル・タイプを取得します。
      パラメータ:
      stream - オーディオ・ファイル・タイプのサポートが照会されるオーディオ入力ストリーム
      戻り値:
      ファイル・タイプの配列。 サポートされているファイル・タイプがない場合、長さ0の配列が返される。
      例外:
      NullPointerException - streamがnullの場合

    • isFileTypeSupported

      public boolean isFileTypeSupported​(AudioFileFormat.Type fileType, AudioInputStream stream)
      指定されたタイプのオーディオ・ファイルを示されたオーディオ入力ストリームから書込み可能かどうかを示します。
      パラメータ:
      fileType - 書込み機能が照会されるファイル・タイプ
      stream - ファイル書込みサポートの照会対象
      戻り値:
      ファイル・タイプがこのオーディオ入力ストリームに対してサポートされている場合はtrue、そうでない場合はfalse
      例外:
      NullPointerException - fileTypeまたはstreamがnullの場合

    • write

      public abstract int write​(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out) throws IOException
      指定されたファイル・タイプのオーディオ・ファイルを表すバイトのストリームを、指定された出力ストリームへ書き込みます。 ファイル・タイプによっては長さをファイル・ヘッダーに書き込む必要があり、あらかじめ長さがわかっていないと最初から最後まで書き込むことができません。 オーディオ・ファイル形式の長さがAudioSystem.NOT_SPECIFIEDの場合、IOExceptionでこのようなファイル・タイプを書き込もうとすると失敗します。
      パラメータ:
      stream - 出力ストリームに書き込まれるオーディオ・データを含むオーディオ入力ストリーム
      fileType - 出力ストリームへ書き込まれるファイル・タイプ
      out - ファイル・データが書き込まれるストリーム
      戻り値:
      出力ストリームへ書き込まれるバイト数
      例外:
      IOException - 入出力例外が発生した場合
      IllegalArgumentException - システムがそのファイル・タイプをサポートしていない場合
      NullPointerException - streamまたはfileTypeまたはoutがnull
      関連項目:
      isFileTypeSupported(Type, AudioInputStream), getAudioFileTypes()

    • write

      public abstract int write​(AudioInputStream stream, AudioFileFormat.Type fileType, File out) throws IOException
      指定されたファイル形式のオーディオ・ファイルを表すバイト・ストリームを、指定された外部ファイルへ書き込みます。
      パラメータ:
      stream - ファイルに書き込まれるオーディオ・データを含むオーディオ入力ストリーム
      fileType - ファイルへ書き込まれるファイル・タイプ
      out - ファイル・データが書き込まれる外部ファイル
      戻り値:
      ファイルへ書き込まれるバイト数
      例外:
      IOException - 入出力例外が発生した場合
      IllegalArgumentException - システムがそのファイル形式をサポートしていない場合
      NullPointerException - streamまたはfileTypeまたはoutがnull
      関連項目:
      isFileTypeSupported(Type, AudioInputStream), getAudioFileTypes()