javax.sound.midi.spi
類別 MidiFileReader

java.lang.Object
  javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader
extends Object

MidiFileReader 提供 MIDI 檔案讀取服務。實作此介面的類別可從一種或多種型別的 MIDI 檔案解析格式資訊，並可從這些型別的檔案產生 Sequence 物件。

從以下版本開始：

1.3

建構子摘要

MidiFileReader()

方法摘要

abstract MidiFileFormat	getMidiFileFormat(File file) 獲得提供的 File 的 MIDI 檔案格式。
abstract MidiFileFormat	getMidiFileFormat(InputStream stream) 獲得所提供的輸入串流的 MIDI 檔案格式。
abstract MidiFileFormat	getMidiFileFormat(URL url) 獲得提供的 URL 的 MIDI 檔案格式。
abstract Sequence	getSequence(File file) 從提供的 File 獲得 MIDI 序列。
abstract Sequence	getSequence(InputStream stream) 從提供的輸入串流獲得 MIDI 序列。
abstract Sequence	getSequence(URL url) 從提供的 URL 獲得 MIDI 序列。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

MidiFileReader

public MidiFileReader()

方法詳細資訊

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(InputStream stream)
                                          throws InvalidMidiDataException,
                                                 IOException

獲得所提供的輸入串流的 MIDI 檔案格式。串流必須指向有效的 MIDI 檔案資料。通常，MIDI 檔案 reader 可能需要在確定它們是否支持串流之前從中讀取一些資料。這些解析器必須能夠標記串流，讀取足夠多的資料來確定它們是否支持串流，並且如果不支持，則將串流的閱讀指針重新設置到其初始位置。如果輸入串流不支持此操作，則此方法可能會失敗，並拋出 IOException。

參數：

stream - 應該從中提取檔案格式資訊的輸入串流

返回：

描述 MIDI 檔案格式的 MidiFileFormat 物件

拋出：

InvalidMidiDataException - 如果串流沒有指向系統識別的有效 MIDI 檔案資料

IOException - 如果發生 I/O 異常

另請參見：

InputStream.markSupported(), InputStream.mark(int)

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(URL url)
                                          throws InvalidMidiDataException,
                                                 IOException

獲得提供的 URL 的 MIDI 檔案格式。URL 必須指向有效的 MIDI 檔案資料。

參數：

url - 應該從中提取檔案格式資訊的 URL

返回：

描述 MIDI 檔案格式的 MidiFileFormat 物件

拋出：

InvalidMidiDataException - 如果 URL 沒有指向系統識別的有效 MIDI 檔案資料

IOException - 如果發生 I/O 異常

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(File file)
                                          throws InvalidMidiDataException,
                                                 IOException

獲得提供的 File 的 MIDI 檔案格式。File 必須指向有效的 MIDI 檔案資料。

參數：

file - 應該從中提取檔案格式資訊的 File

返回：

描述 MIDI 檔案格式的 MidiFileFormat 物件

拋出：

InvalidMidiDataException - 如果 File 沒有指向系統識別的有效 MIDI 檔案資料

IOException - 如果發生 I/O 異常

getSequence

public abstract Sequence getSequence(InputStream stream)
                              throws InvalidMidiDataException,
                                     IOException

從提供的輸入串流獲得 MIDI 序列。串流必須指向有效的 MIDI 檔案資料。通常，MIDI 檔案 reader 可能需要在確定它們是否支持串流之前從中讀取一些資料。這些解析器必須能夠標記串流，讀取足夠多的資料來確定它們是否支持串流，並且如果不支持，則將串流的閱讀指針重新設置到其初始位置。如果輸入串流不支持此操作，則此方法可能會失敗，並拋出 IOException。

參數：

stream - 應該從中建構 Sequence 的輸入串流

返回：

基於包含在輸入串流中的 MIDI 檔案資料的 Sequence 物件。

拋出：

InvalidMidiDataException - 如果該串流沒有指向系統識別的有效 MIDI 檔案資料

IOException - 如果發生 I/O 異常

另請參見：

InputStream.markSupported(), InputStream.mark(int)

getSequence

public abstract Sequence getSequence(URL url)
                              throws InvalidMidiDataException,
                                     IOException

從提供的 URL 獲得 MIDI 序列。URL 必須指向有效的 MIDI 檔案資料。

參數：

url - 應該為其建構 Sequence 的 URL

返回：

基於由 URL 指向的 MIDI 檔案資料的 Sequence 物件

拋出：

InvalidMidiDataException - 如果 URL 沒有指向系統識別的有效 MIDI 檔案資料

IOException - 如果發生 I/O 異常

getSequence

public abstract Sequence getSequence(File file)
                              throws InvalidMidiDataException,
                                     IOException

從提供的 File 獲得 MIDI 序列。File 必須指向有效的 MIDI 檔案資料。

參數：

file - 應該從中建構 Sequence 的 File

返回：

基於由 File 指向的 MIDI 檔案資料的 Sequence 物件

拋出：

InvalidMidiDataException - 如果 File 沒有指向系統識別的有效 MIDI 檔案資料

IOException - 如果發生 I/O 異常