Класс MidiFileReader

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

public abstract class MidiFileReader
extends Object

Класс MidiFileReader предоставляет сервисы чтения файлов MIDI. Классы, реализующие этот интерфейс, могут анализировать информацию о формате из одного или нескольких типов файлов MIDI и создавать объект Sequence из файлов этих типов.

Since:: 1.3

Краткое описание конструкторов

Конструктор	Описание
`MidiFileReader()`

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract MidiFileFormat`	`getMidiFileFormat(File file)`	Получает формат файла MIDI предоставленного `File`.
`abstract MidiFileFormat`	`getMidiFileFormat(InputStream stream)`	Получает формат файла MIDI предоставленного входного потока.
`abstract MidiFileFormat`	`getMidiFileFormat(URL url)`	Получает формат файла MIDI предоставленного `URL`.
`abstract Sequence`	`getSequence(File file)`	Получает последовательность MIDI из предоставленного `File`.
`abstract Sequence`	`getSequence(InputStream stream)`	Получает последовательность MIDI из предоставленного входного потока.
`abstract Sequence`	`getSequence(URL url)`	Получает последовательность MIDI из предоставленного `URL`.

Методы, унаследованные от класса 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 могут потребовать прочитать некоторые данные из потока, прежде чем определить, поддерживают ли они его. Эти анализаторы должны быть способны отметить поток, прочитать достаточно данных, чтобы определить, поддерживают ли они поток, и, если нет, сбросить указатель чтения потока в его исходную позицию. Если входной поток не поддерживает это, этот метод может завершиться ошибкой IOException.

Parameters:: stream - входной поток, из которого должна быть извлечена информация о формате файла
Returns:: объект MidiFileFormat, описывающий формат файла MIDI
Throws:: InvalidMidiDataException - если поток не указывает на данные файла MIDI, распознанные системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если stream является null
See Also:: InputStream.markSupported(), InputStream.mark(int)

getMidiFileFormat

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

Получает формат файла MIDI предоставленного URL. URL должен указывать на данные файла MIDI.

Parameters:: url - URL , из которого должна быть извлечена информация о формате файла
Returns:: объект MidiFileFormat, описывающий формат файла MIDI
Throws:: InvalidMidiDataException - если URL не указывает на данные файла MIDI, распознанные системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если url является null

getMidiFileFormat

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

Получает формат файла MIDI предоставленного File. File должен указывать на данные файла MIDI.

Parameters:: file - File , из которого должна быть извлечена информация о формате файла
Returns:: объект MidiFileFormat, описывающий формат файла MIDI
Throws:: InvalidMidiDataException - если File не указывает на данные файла MIDI, распознанные системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если file является null

getSequence

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

Получает последовательность MIDI из предоставленного входного потока. Поток должен указывать на данные файла MIDI. Как правило, читатели файлов MIDI могут потребовать прочитать некоторые данные из потока, прежде чем определить, поддерживают ли они его. Эти анализаторы должны быть способны отметить поток, прочитать достаточно данных, чтобы определить, поддерживают ли они поток, и, если нет, сбросить указатель чтения потока в его исходную позицию. Если входной поток не поддерживает это, этот метод может завершиться ошибкой IOException.

Parameters:: stream - входной поток, из которого должна быть построена Sequence
Returns:: объект Sequence, основанный на данных файла MIDI, содержащихся во входном потоке
Throws:: InvalidMidiDataException - если поток не указывает на данные файла MIDI, распознанные системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если stream является null
See Also:: InputStream.markSupported(), InputStream.mark(int)

getSequence

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

Получает последовательность MIDI из предоставленного URL. URL должен указывать на данные файла MIDI.

Parameters:: url - URL , для которого должна быть построена Sequence
Returns:: объект Sequence, основанный на данных файла MIDI, на которые указывает URL
Throws:: InvalidMidiDataException - если URL не указывает на данные файла MIDI, распознанные системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если url является null

getSequence

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

Получает последовательность MIDI из предоставленного File. File должен указывать на данные файла MIDI.

Parameters:: file - File , из которого должна быть построена Sequence
Returns:: объект Sequence, основанный на данных файла MIDI, на которые указывает File
Throws:: InvalidMidiDataException - если File не указывает на данные файла MIDI, распознанные системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если file является null